Installer gsutil

Cette page décrit l'installation et la configuration de gsutil, un outil qui vous permet d'accéder à Cloud Storage à partir de la ligne de commande.

Il vous suffit d'installer gsutil pour bénéficier d'un accès immédiat en lecture et/ou en écriture aux données publiques. L'authentification auprès du service Cloud Storage vous permet d'accéder en lecture et/ou en écriture aux données protégées qui vous ont été transmises. L'activation de la facturation vous donne la possibilité de créer et de gérer vos propres buckets.

Configuration système requise

  • L'outil gsutil s'exécute sous Linux/Unix, Mac OS et Windows (XP ou version ultérieure).

  • Si vous envisagez d'utiliser des objets composites, vous devez installer la bibliothèque compilée crcmod. Sous Windows, cette option n'est disponible que pour Python 32 bits.

Installer gsutil

La méthode d'installation et de mise à jour officielle pour gsutil intègre l'utilisation du SDK Google Cloud.

Installer gsutil dans le cadre du SDK Google Cloud

Suivez les instructions correspondant à votre système d'exploitation pour installer gsutil dans le cadre du SDK Google Cloud :

Linux
  1. Saisissez la commande suivante dans une invite :
    curl https://sdk.cloud.google.com | bash
  2. Redémarrez votre interface système :
    exec -l $SHELL
  3. Exécutez gcloud init pour initialiser l'environnement gcloud :
    gcloud init
Debian/Ubuntu

Le SDK Cloud est disponible sous forme de package pour l'installation sur des systèmes Debian et Ubuntu. Ce package ne contient que les commandes gcloud, gcloud alpha, gcloud beta, gsutil et bq. Il n'inclut pas kubectl ni les extensions App Engine requises pour déployer une application à l'aide des commandes gcloud. Si vous voulez ces composants, vous devez les installer séparément, comme indiqué dans la suite de cette section.

Vous pouvez installer le SDK Cloud à partir d'un package Debian/Ubuntu pour l'ensemble des versions officielles d'Ubuntu qui ne sont pas arrivées en fin de vie et des versions stables de Debian à partir de Wheezy.

Remarque : Si vous utilisez une instance sur Google Compute Engine, le SDK Cloud est installé par défaut. Vous pouvez toujours installer manuellement le SDK Cloud en suivant les instructions ci-dessous.

  1. Créez une variable d'environnement pour la distribution concernée :
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. Ajoutez l'URI de distribution du SDK Cloud en tant que source de package :
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    Remarque : Si vous avez installé apt-transport-https, vous pouvez utiliser "https" au lieu de "http" à cette étape.
  3. Importez la clé publique de Google Cloud :
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    Conseil de dépannage : Si vous ne parvenez pas à obtenir les dernières mises à jour en raison d'une clé arrivée à expiration, procurez-vous le dernier fichier de clé apt-get.gpg.
  4. Mettez à jour le SDK Cloud, puis installez-le :
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Remarque : Pour en savoir plus sur d'autres options apt-get, telles que la désactivation des invites ou des simulations, consultez les pages relatives à man apt-get.
  5. (Facultatif) Installez l'un de ces composants supplémentaires :
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-bigtable-emulator
    • kubectl

    Par exemple, vous pouvez installer le composant google-cloud-sdk-app-engine-java comme suit :

    sudo apt-get install google-cloud-sdk-app-engine-java
  6. Pour commencer, exécutez gcloud init :
    gcloud init
macOS
  1. Saisissez la commande suivante dans une invite :
    curl https://sdk.cloud.google.com | bash
  2. Redémarrez votre interface système :
    exec -l $SHELL
  3. Exécutez gcloud init pour initialiser l'environnement gcloud :
    gcloud init
Windows
  1. Téléchargez le programme d'installation du SDK Cloud. Ce programme est signé par Google Inc.

  2. Lancez le programme d'installation, puis suivez les instructions.

    Le SDK Cloud nécessite Python 2 avec un numéro de version Python supérieur ou égal à 2.7.9. Le programme d'installation installe par défaut toutes les dépendances nécessaires, y compris la version Python requise. Si Python 2.x.y est déjà installé et que vous souhaitez utiliser l'installation existante, vous pouvez décocher l'option d'installation de Python groupée.

  3. Une fois l'installation terminée, acceptez les options suivantes :

    • Start Cloud SDK Shell (Démarrer l'interface système du SDK Cloud)
    • Run gcloud init (Exécuter gcloud init)

  4. Le programme d'installation affiche une fenêtre de terminal, puis exécute la commande gcloud init.

  5. L'installation par défaut n'inclut pas les extensions App Engine requises pour déployer une application à l'aide des commandes gcloud. Ces composants peuvent être installés à l'aide du gestionnaire de composants du SDK Cloud.

Remarque : Sur les instances Google Compute Engine sous Windows Server, la configuration de sécurité renforcée d'Internet Explorer est activée. Ce paramètre vous empêche d'exécuter le programme d'installation ci-dessus. Désactivez d'abord la configuration de sécurité renforcée, redémarrez Internet Explorer, puis exécutez le programme d'installation. Pour obtenir des instructions sur la désactivation de la sécurité renforcée sur votre instance Windows Server, ouvrez le centre d'aide et de support de Windows et recherchez "CSR IE".

Effectuez des mises à jour avec la commande components update : gcloud components update.

Pour apprendre à utiliser gsutil, consultez le guide de démarrage rapide sur l'utilisation de l'outil gsutil ou exécutez gsutil help.

Autres méthodes d'installation

Il existe plusieurs façons d'installer gsutil en tant que produit autonome. Vous pouvez suivre l'une de ces méthodes si vous ne souhaitez utiliser aucun des composants fournis avec le SDK Cloud ou si vous gérez des packages avec PyPI.

Si vous installez gsutil de manière autonome, Python 2.7.x doit également être installé sur votre ordinateur. L'outil gsutil ne fonctionne pas actuellement sur Python 3.x. Python est installé par défaut sur la plupart des distributions de Linux et macOS, mais pas sur Windows. Vous devez installer Python avant de pouvoir exécuter gsutil sous Windows.

Développez la méthode souhaitée pour voir les instructions.

Configurer des identifiants pour l'accès aux données protégées

L'installation de gsutil vous permet de télécharger des objets accessibles au public et d'y accéder, mais pour accéder à des données protégées ou écrire sur un bucket protégé, vous devez configurer des identifiants (authentification). Par exemple, si une autre personne a créé un compte Cloud Storage et importé des données accessibles seulement à vous-même ou à d'autres personnes, vous devez configurer vos identifiants sur le service Cloud Storage pour pouvoir accéder à ces données.

Si vous avez installé gsutil dans le cadre du SDK Google Cloud, suivez ces instructions. Sinon, consultez la section Authentifier l'outil gsutil autonome.

Authentifier le SDK Google Cloud

Lorsque vous utilisez gsutil dans le cadre du SDK Google Cloud, OAuth2 est utilisé pour l'authentification et l'autorisation de l'accès. Notez que vous avez peut-être déjà accompli les étapes suivantes si vous avez procédé à l'installation de gsutil dans le cadre du SDK Google Cloud ci-dessus. Si vous avez déjà exécuté gcloud init, il vous est demandé si vous souhaitez réinitialiser la configuration ou en créer une nouvelle.

  1. Ouvrez une instance d'invite de commande.

  2. Exécutez gcloud init dans l'invite de commande.

    Vous obtenez le résultat suivant :

    Welcome! This command will take you through the configuration of gcloud.
    
    Your current configuration has been set to: [default]
    
    To continue, you must login. Would you like to login (Y/n)?
    

  3. Appuyez sur la touche "Y", puis sur Entrée pour vous connecter.

    • La commande imprime une URL et tente d'ouvrir une fenêtre de navigateur pour demander l'accès à votre projet. Si une fenêtre de navigateur peut être ouverte, vous obtenez le résultat suivant :

      Your browser has been opened to visit:
      
      https://accounts.google.com/o/oauth2/auth?redirect_uri=http%3A%2F%2F...
      

      Passez à l'étape suivante.

    • Si vous travaillez sur un ordinateur local et que votre navigateur ne charge pas automatiquement l'URL, exécutez de nouveau la commande gcloud init avec l'indicateur --console-only :

      gcloud init --console-only
      

      Si vous utilisez cette commande ou si le SDK Cloud détecte qu'un navigateur ne peut pas être ouvert (par exemple, si vous travaillez sur un ordinateur à distance), vous obtenez le résultat suivant :

      Go to the following link in your browser:
      
      https://accounts.google.com/o/oauth2/auth?redirect_uri=urn%3Aietf%3Awg%3A...
      
      Enter verification code:
      

      Ouvrez un navigateur et accédez à l'URL fournie.

  4. Si vous y êtes invité, connectez-vous avec le compte Google associé à vos données Cloud Storage dans la fenêtre du navigateur.

  5. Accordez l'accès.

    • Si la fenêtre du navigateur s'est ouverte automatiquement, vérifiez les autorisations de l'application, puis cliquez sur Accepter lorsque vous êtes prêt. Le code de vérification est ensuite automatiquement envoyé à l'outil de ligne de commande.

    • Si vous travaillez sur un ordinateur à distance ou si vous avez utilisé l'indicateur --console-only, copiez le code de validation à partir de l'URL et collez-le sur la ligne de commande du terminal, après le message Enter verification code (Saisissez le code de validation).

  6. Choisissez le projet par défaut pour cette configuration.

    Une fois vos identifiants configurés, l'outil de ligne de commande gcloud vous demande de désigner un projet par défaut pour cette configuration et vous fournit une liste des projets disponibles. Sélectionnez un ID de projet dans la liste.

    Lorsque vous définissez cette propriété, les commandes gsutil nécessitant un projet, telles que gsutil mb, utilisent l'ID du projet par défaut, sauf si vous les remplacez par l'indicateur -p ou si vous définissez la variable d'environnement CLOUDSDK_CORE_PROJECT.

Et voilà ! Vous pouvez désormais accéder aux données protégées. Pour consulter la liste des commandes gsutil, saisissez gsutil dans l'invite de commande.

Authentifier l'outil gsutil autonome

Authentifier avec HMAC

La méthode OAuth 2.0 est recommandée pour authentifier gsutil, mais vous pouvez également utiliser les clés d'authentification et de développement HMAC. Pour ce faire, spécifiez l'indicateur -a dans la commande gsutil config :

gsutil config -a

L'utilisation de cette commande est semblable au processus d'authentification de l'outil gsutil autonome (voir la section précédente), si ce n'est que vous êtes invité à saisir votre ID de clé d'accès Google et votre clé d'accès secrète Google.

Si vous utilisez le SDK Google Cloud, vous devez également désactiver la transmission des identifiants à l'aide de la commande suivante :

gcloud config set pass_credentials_to_gsutil false

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

Envoyer des commentaires concernant…

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