1. Home
  2. Binero.Cloud
  3. Storage
  4. Binero Object Storage

Binero Object Storage

In this getting started guide we will go over what you need to do to get started with our object storage.

We will go through how you use is via the CLI and the GUI, we will also go through some of object storage functions.

Prerequisites

To get started with the CLI you will need to install the AWS CLI or some other CLI tool that works with the S3 API. In this guide we will use the AWS CLI. The client is available for download herehttps://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html
When you have installed the AWS CLI you can confirm that it works by running aws --version

To run openstack commands via CLI, we also need to install that client on our computer, information on how to do it can be found here: https://docs.openstack.org/python-openstackclient/train

Getting started

When we have the AWS and Openstack CLI installed we can begin with creating the authentication keys needed to work with object storage. We do this with the command openstack ec2 credentials create, we will then get an answer similar to this

+------------+-------------------------------------------------------------------------------------------------------------------------------------------+
| Field      | Value                                                                                                                                     |
+------------+-------------------------------------------------------------------------------------------------------------------------------------------+
| access     | 09876543210987654321098765432109                                                                                                          |
| links      | {u'self': u'http://auth.binero.cloud:5000/v3/users/01234567890123456789012345678901/credentials/OS-EC2/09876543210987654321098765432109'} |
| project_id | abc123abc123abc123abc123abc123ab                                                                                                          |
| secret     | cba321cba321cba321cba321cba321cb                                                                                                          |
| trust_id   | None                                                                                                                                      |
| user_id    | 01234567890123456789012345678901                                                                                                          |
+------------+-------------------------------------------------------------------------------------------------------------------------------------------+


We need to save the access and secret in a configuration file to use the cli as an authenticated user, that file is saved here on linux ~/.aws/credentialscode> and must contain:

[default]
aws_access_key_id=
aws_secret_access_key=


Now we are ready to create our first container/bucket, we can do this either with the GUI (horizon) or with the S3 API. To create a container via Horizon, go to Project -> Object Store -> Containerscode> and press +Container. There you can name your container and choose a storage policy.

Image showing the horizon interface where you choose the name of the container and storage policy.

There are 4 storage policies, gp.archive, gp.intermittent, gp.recurring och hp.intensive. In the table, you can see which policy is best suited based on what kind of data you are storing.

hp.intensivegp.recurringgp.intermittentgp.archive
Data typePrimaryPrimaryPrimary/SecondarySecondary/Backups
Data set sizeSmall to mediumSmall to hugeMedium to hugeLarge to huge
Data accessedConstantlyConstantlyIntermittentlySeldom
OptimizedFast access and low latencyRecurring accessIntermittent accessLong time storage
Storage mediumSSD/FlashHDD/MechanicalHDD/MechanicalHDD/Mechanical
Data reliability99.999%99.999%99.999%99.9%

You can also create a bucket with the AWS CLI with

aws --endpoint=https://object-eu-se-1a.binero.cloud s3api create-bucket --bucket BUCKET_NAME --create-bucket-configuration LocationConstraint=europe-se-1:gp.recurring

After this we see our newly created container/bucket on the container page in horizon.

Image showing list of containers and files/folders in the containers.

You can also list the containers/buckets via the CLI

demo@binero:~$ aws --endpoint=https://object-eu-se-1a.binero.cloud s3 ls
2020-10-07 13:40:00 DEMO
Updated on 2021-02-26

Related Articles