Object Storage Swift - Premiers pas

Voir en Markdown

Découvrez comment créer et gérer vos conteneurs Object Storage Swift depuis la console OVHcloud, la CLI OVHcloud, l'API Swift S3 ou python-swiftclient

Objectif

L'offre Object Storage Swift pour Public Cloud propose une solution de stockage illimité avec une facturation simple et adaptée à vos besoins. Les conteneurs peuvent être configurés pour différents cas d'usage :

Hébergement statique (site web statique)
Hébergement privé (par exemple, stockage de données personnelles)
Hébergement public (contenu accessible publiquement)
Stockage à froid (archivage)

Ce guide explique comment créer et gérer vos conteneurs Object Storage Swift.

Prérequis

Posséder un projet Public Cloud dans votre compte OVHcloud

Selon l'outil que vous souhaitez utiliser :

CLI OVHcloud : disposer de la CLI OVHcloud installée et configurée
API Swift S3¹ : disposer d'un environnement préparé pour l'API OpenStack avec python-openstackclient et awscli installés
Client Swift : disposer d'un environnement préparé pour l'API OpenStack avec python-swiftclient installé

Accès à la console OVHcloud

Lien direct :
Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Stockage > Object Storage

En pratique

Préparation

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Dans le menu de gauche de votre projet Public Cloud, cliquez sur Object Storage sous Stockage.

Définir les variables d'environnement OpenStack

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

Installer le client OpenStack si nécessaire

pip install python-openstackclient

Référence des commandes du client OpenStack : docs.openstack.org

Créer des identifiants EC2

Les tokens S3 nécessitent deux paramètres — access et secret — générés depuis 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                                                                                           |
+------------+----------------------------------------------------------------------------------------------------------------------------+

Configurer le client AWS

Installez awscli :

Package Python

pip install awscli

OS Debian

sudo apt install awscli

OS RHEL

sudo yum install awscli

Puis configurez-le avec les identifiants EC2 générés précédemment :

Via la CLI

aws configure

Suivez les instructions et saisissez votre clé d'accès et votre clé secrète lorsque cela vous est demandé.

Via les fichiers de configuration

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

Les accès de type virtual-hosted et path-style sont tous deux pris en charge ; le type virtual-hosted est recommandé, car le path-style est obsolète depuis le 30 septembre 2020.

Définissez les variables d'environnement OpenStack :

source <user_name>-openrc.sh

Vérifiez votre configuration :

swift --help

Pour la liste complète des commandes Swift, consultez la documentation OpenStack.

Créer un conteneur

Info

Lors de l'utilisation de l'API Swift S3, les noms de buckets doivent respecter les règles suivantes :

Entre 3 et 63 caractères
Uniquement des lettres minuscules, des chiffres, des points et des tirets
Doit commencer par une lettre minuscule ou un chiffre
Pas de caractères de soulignement, pas de points consécutifs, pas de tirets adjacents à des points
Ne doit pas être formaté comme une adresse IP (ex. 198.51.100.24)

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Dans l'onglet Conteneurs, cliquez sur Créer un conteneur d'objets.

Remplissez le formulaire de création :

Type de conteneur : sélectionnez Swift API.
Nom du conteneur : saisissez un nom pour votre conteneur.
Région : sélectionnez la région où votre conteneur sera créé.
Type de conteneur : choisissez le type d'accès Privé, Public ou Hébergement statique.

Warning

Si vous souhaitez lier votre conteneur à un nom de domaine, le nom de votre conteneur ne doit pas contenir . ou _, et ne doit pas utiliser de majuscules. Pour plus d'informations, consultez le guide « Lier un conteneur à un nom de domaine ».

Vérifiez le récapitulatif, puis cliquez sur Créer.

Créez le conteneur :

swift post container1

Pour rendre le conteneur accessible publiquement :

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

Vérifiez la 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

Lister vos conteneurs

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Cliquez sur Object Storage sous Stockage dans le menu de gauche de votre projet Public Cloud. Vos conteneurs sont listés dans l'onglet Conteneurs ; les conteneurs Swift affichent Swift dans la colonne Offre.

Téléverser des objets

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Dans l'onglet Conteneurs, cliquez sur le nom de votre conteneur, ouvrez son onglet Objets, puis cliquez sur Ajouter un objet.

Vous pouvez saisir un Préfixe, puis glisser-déposer vos fichiers ou cliquer sur Parcourir les fichiers, et cliquer sur Téléverser.

Téléverser un seul fichier :

swift upload container1 file.txt

Téléverser un dossier entier (un préfixe correspondant au nom du dossier est automatiquement ajouté aux objets) :

swift upload container1 images/

images/OVHlogo.png
images/OVHSummitKeynote.jpg

Lister les objets d'un conteneur

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Cliquez sur le nom de votre conteneur, puis ouvrez son onglet Objets pour afficher ses objets.

swift list container1

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

Filtrer par préfixe :

swift list container1 --prefix images

images/OVHSummitKeynote.jpg
images/OVHlogo.png

Si le conteneur est public, les objets sont accessibles directement via URL :

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

Cette URL est composée d'un endpoint (disponible depuis l'interface Horizon), du nom du conteneur et du nom de l'objet (préfixe inclus).

Télécharger des objets

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Dans l'onglet Objets de votre conteneur, cliquez sur l'icône Télécharger de la ligne de l'objet.

Télécharger un seul fichier :

swift download container1 text1.txt

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

Télécharger tous les fichiers avec un préfixe donné :

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]

Supprimer des objets et des conteneurs

Console OVHcloud

CLI OVHcloud

API Swift S3

Client Swift

Supprimer un objet : dans l'onglet Objets, cliquez sur l'icône Supprimer de la ligne de l'objet, puis sur Supprimer pour confirmer.

Supprimer un conteneur : dans l'onglet Conteneurs, cliquez sur le bouton ... de la ligne du conteneur, puis sur Supprimer. Saisissez TERMINATE (EMPTY AND TERMINATE si le conteneur contient encore des objets), puis cliquez sur Supprimer.

Supprimer un fichier :

swift delete container1 text1.txt

text1.txt

Supprimer plusieurs fichiers avec un préfixe :

swift delete container1 images/*

images/OVHSummitKeynote.jpg
images/OVHlogo.png

Supprimer un conteneur (supprime également tous les objets qu'il contient) :

swift delete container1

text2.txt
text3.txt

Aller plus loin

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Échangez avec notre communauté d’utilisateurs.

¹ : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.

Cette page vous a-t-elle aidé ?