Skip to content

Objectspaces

An Objectspace is an object storage build on the commonly used S3 protocol. Objectspaces allow you to store large amounts of unstructured blobs of data ( images, videos, text files, HTML files..) or any blob of bytes.

An Objectspace can be connected to one or more Cloudspaces, however, Cloudspaces with overlapping networks cannot connect to the same Objectspace.

When connecting an Objectspace to your cloudspace, it's served over HTTP. You can expose an Objectspace with a reverse-proxy publicly, serving it over HTTPS. You can read more about reverse-proxies in the Ingress Documentation

Before you begin

Objectspaces can only connect to Cloudspaces in the same location. You can manage your buckets (create/delete/edit) in an Objectspace by using a client compatible with S3 such as MinIO or from the whitesky.cloud BV user interface. To access your S3 content, you can use the MinIO client which offers UNIX like commands to manage buckets and objects. Next to MinIO there are tons of other clients and applications that support the S3 protocol.

Creating Objectspaces

To create an objectspace

  1. On the left side of the page in the navigation drawer, click Objectspaces. The previously created Objectspaces will be listed.
  2. At the top of the page, click CREATE OBJECTSPACE.
  3. Select the location where you want to create your Objectspace. Keep in mind that Objectspaces can only connect to Cloudspaces residing in the same location.
  4. Enter your Objectspace's name. Optionally: choose the Cloudspace to connect to.
  5. Click CREATE OBJECTSPACE.

Your Objectspace will be created and added to the list of available Objectspaces.

Connecting Objectspaces to Cloudspaces

To connect an existing Objectspace to a Cloudspace

  1. On the left side of the page in the navigation drawer, click Objectspaces. The previously created Objectspaces will be listed.
  2. Click the Objectspace you want to connect to a Cloudspace
  3. At the top of the page, click CONNECT. A list of available Cloudspaces will appear.
  4. Choose a Cloudspace from the list. A message will appear asking you to confirm this action. Click CONFIRM.

A message will appear indicating that the Objectspace has been successfully connected to the Cloudspace.

Accessing Objectspaces with the MinIO Client

In this section, you will learn how to connect to your Objectspace using the MinIO client internally in your connected Cloudspace. If you have exposed you Objectspace using a reverse proxy, keep in mind that you might need to use HTTPS instead of HTTP when your reverse proxy is handling TLS.

  1. Download MinIO client on a VM within your connected Cloudspace.
Function Command Example
To access your Objectspace and give it an alias ./mc alias set <ALIAS> http://<CLOUDSPACE-IP> <ACCESS-KEY> <SECRET>
  • ALIAS is the alias you choose for your Objectspace.
  • You can find CLOUDSPACE-IP, ACCESS-KEY, and SECRET values in the Objectspace details page.
  • CLOUDSPACE-IP is the Cloudspace IP address under the CLOUDSPACE CONNECTIONS tab
 ./mc alias set mys3 [http://192.168.103.1](http://192.168.103.1/) NVZWGMSDSHQNHJRQHRTO 1QisYhq/mu3jpMOTwpIQi3vstnOuvf86Yt35rLKv
To make a new bucket ./mc mb <ALIAS>/<NEW-BUCKET-NAME> ./mc mb mys3/newbucket
To copy a file to your bucket ./mc cp <FILE-NAME> <ALIAS>/<BUCKET-NAME> ./mc cp myfile.txt mys3/newbucket
To list your buckets ./mc ls <ALIAS> ./mc ls mys3
To list a bucket's content ./mc ls <ALIAS>/<BUCKET-NAME> ./mc ls mys3/newbucket
To remove a bucket and all its content ./mc rb <ALIAS>/<BUCKET-NAME> --force ./mc rb mys3/newbucket --force
To summarize disk usage recursively ./mc du <ALIAS> ./mc du mys3

If your access key and secret get comprised, you can generate a new pair by clicking RESET CREDENTIALS at the top of the page.

Creating Buckets from whitesky.cloud BV Portal

You can also create a Bucket from the whitesky.cloud BV user interface. The user interface also allows you to set IOPS limitations per bucket.

To create a bucket in the user interface

  1. On the left side of the page in the navigation drawer, click Objectspaces. The previously created Objectspaces will be listed.
  2. Select the Objectspace from the list, and the Objectspace details page will appear.
  3. Select the Buckets tab, then at the top of the page, click ADD BUCKET.
  4. Enter the bucket name and configure the performance limit in IOPS that is suitable for your application, where the minimum limit is 2000 IOPs and the maximum is 25000 IOPS.
  5. Click CREATE BUCKET.

The bucket will be added to the list of created buckets.

Managing Buckets from whitesky.cloud BV Portal

You can change the performance limit for a bucket from the bucket details page. Under Limit (IOPS) click and change the value.

To reset the performance limit of a bucket to the default value of 2000 IOPS, click RESET LIMIT at the top of the bucket details page.

To delete a bucket, click DELETE at the top of the bucket details page.

Notice

The Objectspaces server contains code derived from the MinIO Inc. Apache 2.0 licensed MinIO server from commit c4e12dc846ca04c03cab9de69c828b1351631cfc through a gateway implementation towards the proprietary Alba object storage technology developed by GIG.tech NV.