Guide de démarrage rapide sur l'utilisation de l'outil gsutil

Cette page explique comment effectuer des tâches de base dans Cloud Storage à l'aide de l'outil de ligne de commande gsutil.

Vous ne payez que pour les ressources que vous utilisez dans Cloud Storage. Ce guide de démarrage rapide utilise généralement moins de 0,01 USD de ressources Cloud Storage.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Dans la console GCP, accédez à la page Gérer les ressources et créez un projet.

    Accéder à la page "Gérer les ressources"

  3. Assurez-vous que la facturation est activée pour votre projet Google Cloud Platform.

    Découvrir comment activer la facturation

  4. Installez le SDK Cloud.

    Lorsque vous y êtes invité, choisissez le projet que vous avez créé ci-dessus.

  5. Installez Python 2.7.

    Si vous utilisez Windows et que vous avez laissé la case correspondante cochée lors de l'installation du SDK Cloud, cette opération a été effectuée automatiquement.

Créer un bucket

Les buckets sont les conteneurs de base dans lesquels sont stockées vos données dans Cloud Storage.

Pour créer un bucket :

  1. Ouvrez une fenêtre de terminal.
  2. Utilisez la commande gsutil mb et un nom unique pour créer un bucket.
    gsutil mb -l us-east1 gs://my-awesome-bucket/
    

    Cette commande utilise un bucket nommé "my-awesome-bucket". Vous devez choisir un nom unique pour votre bucket.

    Si l'opération réussit, la commande affiche les éléments suivants :

    Creating gs://my-awesome-bucket/...
    
  3. Vous venez de créer un bucket dans lequel vous pouvez stocker vos contenus.

Transférer un objet dans un bucket

Image d'un chaton.

  1. Cliquez avec le bouton droit sur l'image ci-dessus et enregistrez-la sur votre ordinateur, par exemple sur le bureau.

  2. Exécutez la commande gsutil cp pour copier l'image à partir de l'emplacement où vous l'avez enregistrée dans le bucket que vous avez créé :

    gsutil cp Desktop/kitten.png gs://my-awesome-bucket

    Si l'opération réussit, la commande affiche les éléments suivants :

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    Vous venez de stocker un objet dans votre bucket.

Télécharger un objet se trouvant dans votre bucket

  1. Exécutez la commande gsutil cp pour télécharger l'image que vous avez stockée dans votre bucket sur votre ordinateur, par exemple sur le bureau :

    gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    Si l'opération réussit, la commande affiche les éléments suivants :

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    Vous venez de télécharger un objet à partir de votre bucket.

Copier un objet dans un dossier du bucket

  1. Utilisez la commande gsutil cp pour créer un dossier et y copier l'image :

    gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    Si l'opération réussit, la commande affiche les éléments suivants :

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    Vous venez de copier votre objet dans un nouveau dossier de votre bucket.

Répertorier le contenu d'un bucket ou d'un dossier

  1. Utilisez la commande gsutil ls pour répertorier le contenu du niveau supérieur de votre bucket :

    gsutil ls gs://my-awesome-bucket

    Si l'opération réussit, la commande affiche un message semblable à celui indiqué ci-dessous :

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    Vous venez d'afficher le contenu du niveau supérieur de votre bucket.

Afficher les détails d'un objet

  1. Utilisez la commande gsutil ls avec l'indicateur -l pour obtenir des détails sur un objet :

    gsutil ls -l gs://my-awesome-bucket/kitten.png

    Si l'opération réussit, la commande affiche un message semblable à celui indiqué ci-dessous :

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    Vous venez d'obtenir des informations relatives à la taille de l'objet et à sa date de création.

Rendre l'objet accessible publiquement

  1. Exécutez la commande gsutil acl ch pour accorder à tous les utilisateurs l'autorisation en lecture pour l'objet stocké dans votre bucket :

    gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png

    Si l'opération réussit, la commande affiche les éléments suivants :

    Updated ACL on gs://my-awesome-bucket/kitten.png

    Votre objet est à présent accessible publiquement.

  2. Pour supprimer cette autorisation, exécutez la commande suivante :

    gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png

    Si l'opération réussit, la commande affiche les éléments suivants :

    Updated ACL on gs://my-awesome-bucket/kitten.png

    Vous avez supprimé l'accès public à cet objet.

Autoriser l'accès au bucket

  1. Utilisez la commande gsutil iam ch pour autoriser une adresse e-mail spécifique à accéder aux objets de votre bucket en lecture et écriture :

    gsutil iam ch user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    La commande aboutit si aucune erreur n'est affichée.

    Un autre utilisateur peut maintenant ajouter des éléments à votre bucket ou afficher son contenu.

  2. Pour supprimer cette autorisation, exécutez la commande suivante :

    gsutil iam ch -d user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    La commande aboutit si aucune erreur n'est affichée.

    Vous venez de supprimer l'accès de l'utilisateur à ce bucket.

Supprimer des objets

  1. Utilisez la commande gsutil rm pour supprimer un objet :

    gsutil rm gs://my-awesome-bucket/kitten.png

    Si l'opération réussit, la commande affiche les éléments suivants :

    Removing gs://my-awesome-bucket/kitten.png...

    Cette copie de l'objet n'est plus stockée dans Cloud Storage (mais la copie que vous en avez faite dans le dossier just-a-folder/ existe encore).

Effectuer un nettoyage

Afin d'éviter que des frais ne soient facturés sur votre compte GCP pour les ressources utilisées dans ce démarrage rapide, procédez comme suit :

  1. Ouvrez une fenêtre de terminal (si aucune n'est déjà ouverte).
  2. Utilisez la commande rm command avec l'indicateur -r pour supprimer le bucket et les éléments qu'il contient :

    gsutil rm -r gs://my-awesome-bucket

    Si l'opération réussit, la commande affiche un message semblable à celui indiqué ci-dessous :

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    Vous venez de supprimer votre bucket et son contenu.

Étapes suivantes

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.