Object Storage Swift - Premiers pas

Voir en Markdown

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

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 :

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é
CLI OVHcloud : disposer de la CLI OVHcloud installée et configurée

Accès à l'espace client OVHcloud

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

En pratique

Préparation

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Connectez-vous à votre espace client OVHcloud et ouvrez Object Storage dans le menu de gauche sous Storage & backup.

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)

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Cliquez sur Créer un conteneur d'objets.

Remplissez le formulaire de création :

Nom du conteneur : Saisissez un nom pour votre conteneur.
Type de conteneur : Sélectionnez Swift API.
Localisation : Choisissez un type de zone de disponibilité (Région 3-AZ, Région 1-AZ ou Local Zone), puis sélectionnez une zone géographique.
Type de conteneur : Choisissez le type d'accès — Hébergement statique, Privé ou Public.

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 panneau 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

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Accédez à Object Storage dans le menu de gauche. Vos conteneurs sont listés sous l'onglet Mes conteneurs.

Téléverser des objets

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Cliquez sur le nom de votre conteneur, puis cliquez sur Ajouter des objets dans l'onglet Objets.

Sélectionnez le fichier à téléverser et cliquez sur Importer.

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

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Cliquez sur le nom de votre conteneur pour visualiser ses objets dans l'onglet 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

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Cliquez sur l'icône de téléchargement sur 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

Espace client OVHcloud

API Swift S3

Client Swift

CLI OVHcloud

Supprimer un objet : Cliquez sur l'icône de suppression (corbeille) sur la ligne de l'objet et confirmez.

Supprimer un conteneur : Cliquez sur le bouton ... sur la ligne du conteneur, puis sélectionnez Supprimer et confirmez.

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 de 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é ?