Object Storage Swift - Getting started

Ver como Markdown

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

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:

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 CLI: The OVHcloud CLI installed and configured

OVHcloud Control Panel Access

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

Instructions

Preparation

OVHcloud Control Panel

Swift S3 API

Swift client

OVHcloud CLI

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 Control Panel

Swift S3 API

Swift client

OVHcloud CLI

Click Create an object container.

Fill in the creation form:

Container name: Enter a name for your container.
Container type: Select Swift API.
Location: Choose an availability zone type (3-AZ Region, 1-AZ Region, or Local Zone), then select a geographic area.
Container type: Choose the access type Static hosting, Private, or Public.

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 Control Panel

Swift S3 API

Swift client

OVHcloud CLI

Navigate to Object Storage in the left-hand menu. Your containers are listed under the My containers tab.

Upload objects

OVHcloud Control Panel

Swift S3 API

Swift client

OVHcloud CLI

Click on the name of your container, then click Add objects in the Objects tab.

Select the file you want to upload and click Import.

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 Control Panel

Swift S3 API

Swift client

OVHcloud CLI

Click on the name of your container to view its objects in the Objects tab.

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 Control Panel

Swift S3 API

Swift client

OVHcloud CLI

Click the download icon on the object line.

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 Control Panel

Swift S3 API

Swift client

OVHcloud CLI

Delete an object: Click the delete icon (trash can) on the object line and confirm.

Delete a container: Click the ... button on the container line, then select Delete and confirm.

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 analyzed 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.

¿Le ha resultado útil esta página?