Object Storage - Utiliser Object Storage avec S3cmd

Base de connaissances

KB0047681

Object Storage - Utiliser Object Storage avec S3cmd


Icons/System/eye-open Created with Sketch. 330 vues 20.05.2024 Cloud / Object Storage S3

Objectif

S3cmd est un outil de ligne de commande gratuit et un client de gestion des données dans des espaces de stockage qui utilisent le protocole S3, tels que Amazon S3 Object Storage, Google Cloud Storage ou DreamHost DreamObjects.

Ce guide explique comment configurer S3cmd afin gérer vos buckets et objets.

OVHcloud met à votre disposition des services dont la configuration, la gestion et la responsabilité vous incombent. Il vous revient de ce fait d'en assurer le bon fonctionnement.

Nous mettons à votre disposition ce guide afin de vous accompagner au mieux sur des tâches courantes. Néanmoins, nous vous recommandons de faire appel à un prestataire spécialisé et/ou de contacter l'éditeur du logiciel si vous éprouvez des difficultés. En effet, nous ne serons pas en mesure de vous fournir une assistance. Plus d'informations dans la section « Aller plus loin » de ce guide.

Prérequis

  • Avoir créé un bucket
  • Avoir créé un utilisateur et avoir défini les droits d'accès requis sur le bucket
  • Connaître vos informations d'identification Object Storage (access_key et secret_access_key)

Consultez notre guide « Débuter avec Object Storage » pour plus de détails.

Afin d'identifier votre Endpoint correspondant à votre classe de stockage, veuillez vous référer à ce guide : Object Storage - Endpoints et géo-disponibilité de l’Object Storage

En pratique

Pour configurer s3cmd, exécutez la commande suivante :

$ s3cmd --configure

Enter new values or accept defaults in brackets with Enter.
Refer to user manual for detailed description of all options.

Access key and Secret key are your identifiers for Amazon S3. Leave them empty for using the env variables.
Access Key: `<access_key>`
Secret Key: `<secret_key>`
Default Region [US]: `<region_in_lowercase>`

Use "s3.amazonaws.com" for S3 Endpoint and not modify it to the target Amazon S3.
S3 Endpoint [s3.amazonaws.com]: `s3.<region_in_lowercase>.io.cloud.ovh.net`

Use "%(bucket)s.s3.amazonaws.com" to the target Amazon S3. "%(bucket)s" and "%(location)s" vars can be used
if the target S3 system supports dns based buckets.
DNS-style bucket+hostname:port template for accessing a bucket [%(bucket)s.s3.amazonaws.com]: `<bucket>.s3.<region_in_lowercase>.io.cloud.ovh.net`

Encryption password is used to protect your files from reading
by unauthorized persons while in transfer to S3
Encryption password: `<passphrase>`      
Path to GPG program [/usr/bin/gpg]:
When using secure HTTPS protocol all communication with Amazon S3
servers is protected from 3rd party eavesdropping. This method is
slower than plain HTTP, and can only be proxied with Python 2.7 or newer
Use HTTPS protocol [Yes]:

On some networks all internet access must go through a HTTP proxy.
Try setting it here if you can\'t connect to S3 directly
HTTP Proxy server name:

New settings:
  Access Key: ACCESS_KEY
  Secret Key: SECRET_KEY
  Default Region: sbg
  S3 Endpoint: s3.sbg.io.cloud.ovh.net
  DNS-style bucket+hostname:port template for accessing a bucket: hp-bucket.s3.sbg.io.cloud.ovh.net
  Encryption password: passphrase
  Path to GPG program: /usr/bin/gpg
  Use HTTPS protocol: True
  HTTP Proxy server name:
  HTTP Proxy server port: 0

Test access with supplied credentials? [Y/n]
Please wait, attempting to list all buckets...
Success. Your access key and secret key worked fine :-)

Now verifying that encryption works...
Success. Encryption and decryption worked fine :-)

Save settings? [y/N] y
Configuration saved to '/home/user/.s3cfg'

S3cmd est maintenant prêt à être utilisé.

Exemples de commande

Lister tous les buckets :

$ s3cmd ls

Créer un nouveau bucket :

$ s3cmd mb s3://BUCKET

Lister le contenu d'un bucket :

$ s3cmd ls s3://BUCKET[/PREFIX]

Synchroniser /home/user/documents vers un bucket :

$ s3cmd sync /home/user/documents s3://BUCKET[/PREFIX]

Copier un fichier /home/user/file.txt dans un bucket :

$ s3cmd put FILE [FILE...] s3://BUCKET[/PREFIX]

Télécharger un fichier file.txt depuis un bucket :

$ s3cmd get s3://BUCKET/OBJECT LOCAL_FILE

Vous trouverez sur le site officiel de S3cmd une documentation détaillée des actions possibles: Documentation officielle S3cmd.

Aller plus loin

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Échangez avec notre communauté d'utilisateurs.

Articles associés