Object Storage Swift - Getting started

Ver como Markdown

Find out how to create and manage your Swift Object Storage containers using the OVHcloud Console, the OVHcloud CLI, Swift S3 API, or python-swiftclient

Objective

The Object Storage Swift solution for Public Cloud offers unlimited storage with simple billing tailored to your needs. Containers can be configured for different use cases:

Static hosting (static website)
Private hosting (e.g. personal data storage)
Public hosting (publicly accessible content)
Cold storage (archiving)

This guide explains how to create and manage your Swift Object Storage containers.

Requirements

A Public Cloud project in your OVHcloud account

Depending on the tool you plan to use:

OVHcloud CLI: The OVHcloud CLI installed and configured
Swift S3¹ API: An environment prepared for the OpenStack API with python-openstackclient and awscli installed
Swift client: An environment prepared for the OpenStack API with python-swiftclient installed

OVHcloud Console Access

Direct link:
Navigation path: Public Cloud > Select your project > Storage > Object Storage

Instructions

Preparation

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

In the left-hand menu of your Public Cloud project, click Object Storage under Storage.

Set the OpenStack environment variables

source <user_name>-openrc.sh
Please enter your OpenStack Password for project <project_name> as user <user_name>:

Install the OpenStack client if needed

pip install python-openstackclient

OpenStack client command reference: docs.openstack.org

Create EC2 credentials

S3 tokens require two parameters — access and secret — generated from Keystone:

openstack ec2 credentials create
+------------+----------------------------------------------------------------------------------------------------------------------------+
| Field      | Value                                                                                                                      |
+------------+----------------------------------------------------------------------------------------------------------------------------+
| access     | 5a4d8b8d88104123a862c527ede5a3d3                                                                                           |
| links      | {u'self': u'https://auth.cloud.ovh.net/v3/users/d74d05ff121b44bea9216495e7f0df61/credentials/OS-EC2/5a4d8b8d88104123a862c527ede5a3d3'} |
| project_id | 20e124b71be141299e111ec26b1892fa                                                                                           |
| secret     | 925d5fcfcd9f436d8ffcb20548cc53a2                                                                                           |
| trust_id   | None                                                                                                                       |
| user_id    | d74d05ff121b44bea9216495e7f0df61                                                                                           |
+------------+----------------------------------------------------------------------------------------------------------------------------+

Configure the AWS client

Install awscli:

Python package

pip install awscli

Debian-based OS

sudo apt install awscli

RHEL-based OS

sudo yum install awscli

Then configure it with the EC2 credentials generated above:

CLI method

aws configure

Follow the prompts and enter your access key and secret key when asked.

Manual method

cat ~/.aws/credentials

[default]
aws_access_key_id = <access_key>
aws_secret_access_key = <secret_key>

cat ~/.aws/config

[plugins]
endpoint = awscli_plugin_endpoint
[default]
region = <region>
s3 =
  endpoint_url = https://s3.<region>.cloud.ovh.net
  signature_version = s3v4
s3api =
  endpoint_url = https://s3.<region>.cloud.ovh.net

Info

Both virtual-hosted-style and path-style access are supported; virtual-hosted-style is recommended, as path-style was deprecated after September 30, 2020.

Create a container

Info

When using the Swift S3 API, bucket names must follow these rules:

Between 3 and 63 characters long
Lowercase letters, numbers, periods, and dashes only
Must start with a lowercase letter or number
No underscores, no consecutive periods, no dashes adjacent to periods
Not formatted as an IP address (e.g. 198.51.100.24)

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

In the Containers tab, click Create an object container.

Fill in the creation form:

Container type: Select Swift API.
Container name: Enter a name for your container.
Region: Select the region where your container will be created.
Container type: Choose the access type Private, Public, or Static hosting.

Warning

If you want to link your container to a domain name, the container name must not contain . or _, and must not use capital letters. See: Linking a container to a domain name.

Review the summary panel, then click Create.

Create the container:

swift post container1

To make the container publicly accessible:

swift post --header "X-Container-Read: .r:*" container1

Verify the configuration:

swift stat container1

Account: AUTH_b3e26xxxxxxxxxxxxxxxxxxxb0ba29
Container: container1
Objects: 0
Bytes: 0
Read ACL: .r:*
Write ACL:
Sync To:
Sync Key:
Accept-Ranges: bytes
X-Trans-Id: B2210C05:8D93_052711A1:01BB_561CC9DF_1B305:30D7
X-Storage-Policy: Policy-0
Connection: close
X-Timestamp: 1444726875.27475
Content-Type: text/plain; charset=utf-8

List your containers

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

Click Object Storage under Storage in the left-hand menu of your Public Cloud project. Your containers are listed in the Containers tab; Swift containers show Swift in the Offer column.

Upload objects

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

In the Containers tab, click the name of your container, open its Objects tab, then click Add an object.

You can enter a Prefix, then drag and drop your files or click Browse files, and click Upload.

Upload a single file:

swift upload container1 file.txt

Upload an entire folder (a prefix matching the folder name is automatically added to the objects):

swift upload container1 images/

images/OVHlogo.png
images/OVHSummitKeynote.jpg

List objects in a container

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

Click the name of your container, then open its Objects tab to view its objects.

swift list container1

images/OVHSummitKeynote.jpg
images/OVHlogo.png
text1.txt
text2.txt
text3.txt

Filter by prefix:

swift list container1 --prefix images

images/OVHSummitKeynote.jpg
images/OVHlogo.png

If the container is public, objects are accessible directly via URL:

https://storage.gra1.cloud.ovh.net/v1/AUTH_b3e26xxxxxxxxxxxxxxxxxxxb0ba29/container1/images/OVHlogo.png

This URL is composed of an endpoint (available from the Horizon interface), the container name, and the object name (including prefix).

Download objects

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

In the Objects tab of your container, click the Download icon on the object row.

Download a single file:

swift download container1 text1.txt

text1.txt [auth 0.328s, headers 0.452s, total 0.453s, 0.000 MB/s]

Download all files with a given prefix:

swift download container1 --prefix images

images/OVHlogo.png [auth 0.383s, headers 0.520s, total 0.522s, 0.135 MB/s]
images/OVHSummitKeynote.jpg [auth 0.371s, headers 0.514s, total 0.559s, 2.657 MB/s]

Delete objects and containers

OVHcloud Console

OVHcloud CLI

Swift S3 API

Swift client

Delete an object: In the Objects tab, click the Delete icon on the object row, then click Delete to confirm.

Delete a container: In the Containers tab, click the ... button on the container row, then select Delete. Type TERMINATE (EMPTY AND TERMINATE if the container still contains objects), then click Delete.

Delete a file:

swift delete container1 text1.txt

text1.txt

Delete multiple files using a prefix:

swift delete container1 images/*

images/OVHSummitKeynote.jpg
images/OVHlogo.png

Delete a container (also deletes all objects inside it):

swift delete container1

text2.txt
text3.txt

Go further

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analysed by our experts.

Join our community of users.

¹: S3 is a trademark of Amazon Technologies, Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies, Inc.

Esta página foi útil?