How to connect to the Fuga Cloud ObjectStore

Using the Fuga object storage is a good way to store lots of data in use cases where speed isn’t the most important factor, but scalability is. First, we need some setup.

Creating an Object Store container

  1. Open the ‘Object Store’ tab and click on ‘Containers’.

  2. Click on ‘+ Container’ and give your new container a fitting name.

Now we can use the Object Store inside the browser, but if we want to use it outside the browser, we need some more setup.

API keys

  1. To list and create API keys for the Object Store we need the Fuga OpenStack CLI. If you haven’t installed it yet check out our tutorial.

  2. After following the tutorial for your operating system it’s time to list the credentials. We need the credentials to access our Object Store container in later steps.

  3. To list all the credentials, enter the command:

openstack ec2 credentials list
  1. If the list of credentials is empty, a new pair of credentials can be generated with:
openstack ec2 credentials create
  1. Either copy the Access and Secret key to the clipboard or save them temporarily

If you are using Linux we can mount the Object Store using s3fs. With MacOS and Windows, we can use Cyberduck to connect to the Object Store.

Mounting your Object Store in Linux

This section shows you how to mount your Fuga object storage to your instance, this allows you to use your object storage like a volume.

  1. SSH into your instance or open a local terminal so that we can save the credentials.

  2. To create a new empty file for our credentials, enter the following command:

sudo touch /etc/passwd-s3fs
  1. To open the new file in a text editor like Nano, enter the following command:
sudo nano /etc/passwd-s3fs
  1. Paste (Ctrl + Shift + V in Nano or Vim) in your access key and secret key into the new file in the following format:

    your_accesskey:your_secret key

    Example: 9f2XXXXX36314b1eaf64XXXXX0e74e3:0541e02XXXXXc79b25b6e0XXXXX32e0

  2. To save the file, first press Ctrl + X and if asked to save changes press ‘Y’. When asked for a filename to write, simply press enter.

  3. After saving our keys we should change the file permissions of this file to 600. Execute the following command:

sudo chmod 600 /etc/passwd-s3fs

Installing s3fs

  1. SSH into your instance or open a local terminal

  2. To install the required packages run the following command:

sudo apt-get install s3fs
  1. Before we can actually mount our Fuga Object Store container we first need to create a mounting point. For this tutorial, we will just mount the container to the standard /mnt. Start by creating an empty folder:
sudo mkdir /mnt
  1. To make our container mount automatically we can edit the fstab file. Open the fstab file with our favorite editor:
sudo nano /etc/fstab
  1. Add the following line in your fstab file, make sure to replace YOUR_CONTAINER with the name of your container that you created on the Fuga dashboard:
s3fs#YOUR_CONTAINER /mnt fuse _netdev,allow_other,use_path_request_style,url=https://object.api.ams.fuga.cloud 0 0

  1. To save the file, first press Ctrl + X and if asked to save changes press ‘Y’. When asked for a filename to write, simply press enter.

  2. To instantly mount your object storage enter the following command:

sudo mount -a

You can find your Object Store at the mount point /mnt.

Now you’re done configuring your Fuga Object Store in Linux!

Using your Object Store in MacOS and Windows

Fuga object storage is compatible with Amazon S3. Chances are, your favorite S3 client supports the Object Store. In this tutorial, we’re using the open source Cyberduck client. To connect to the Object Store we need some data:

  • The Fuga S3 URL: https://object.api.ams.fuga.cloud
  • The Access Key and the Secret Key we created or listed in the first paragraph

Next, create a new connection in Cyberduck. Select S3 (Amazon Simple Storage Service) and fill out the Server (S3 URL, without https://), Username (Access Key) and Password (Secret Key) and click connect.

That’s it. You should be able to see your containers. You can now drag and drop items to and from containers in your object store.

Enjoy working with the object store!