Outil gsutil

gsutil est une application Python qui vous permet d'accéder à Cloud Storage à partir de la ligne de commande. Vous pouvez l'utiliser pour un large panel de tâches de gestion des buckets et des objets, y compris pour :

  • créer et supprimer des buckets ;
  • importer, télécharger et supprimer des objets ;
  • répertorier des buckets et des objets ;
  • déplacer, copier et renommer des objets ;
  • modifier les listes de contrôle d'accès (LCA) des objets et des buckets.

gsutil effectue toutes les opérations à l'aide des protocoles HTTPS et TLS (Transport Layer Security), y compris les importations et les téléchargements.

Faut-il utiliser gsutil ?

En règle générale, vous devez utiliser les commandes gcloud storage plutôt que les commandes gsutil :

  • L'outil gsutil est une ancienne CLI de Cloud Storage, soumise à une procédure de gestion minimaliste.

  • L'outil gsutil ne permet pas d'utiliser les fonctionnalités Cloud Storage plus récentes, telles que la suppression réversible et les dossiers gérés.

  • Les commandes gcloud storage nécessitent moins d'optimisation manuelle pour atteindre les taux d'importation et de téléchargement les plus performants.

Effectuer la migration vers la gcloud CLI

Si vous êtes utilisateur de gsutil et que vous souhaitez migrer vers la gcloud CLI, vous devez d'abord vérifier si vous utilisez une version autonome de gsutil en exécutant la commande suivante :

gsutil version -l

  • Si le résultat de la commande inclut using cloud sdk: False, vous utilisez une version autonome de gsutil. Pour migrer vers la gcloud CLI, commencez par installer la gcloud CLI.

  • Si le résultat de la commande inclut using cloud sdk: True, la gcloud CLI est déjà installée.

Une fois la gcloud CLI installée, vous pouvez utiliser les commandes gcloud storage de la même manière que les commandes gsutil. Les ressources suivantes peuvent vous aider à démarrer :

Syntaxe pour l'accès aux ressources

gsutil utilise le préfixe gs:// pour indiquer une ressource dans Cloud Storage :

gs://BUCKET_NAME/OBJECT_NAME

En plus de spécifier des ressources exactes, gsutil est compatible avec l'utilisation de caractères génériques dans vos commandes.

Aide intégrée

gsutil contient une aide intégrée complète pour chaque commande, ainsi qu'un certain nombre de rubriques, que vous pouvez répertorier et lire à l'aide de la commande gsutil help.

Pour obtenir des informations sur une commande ou un sujet spécifique, utilisez gsutil help suivi du nom de la commande ou du sujet prévu. Par exemple, gsutil help cp et gsutil help options correspondent respectivement à la page d'aide d'une commande et à la page d'aide d'un sujet.

Pour obtenir des informations sur l'installation de gsutil, utilisez la commande gsutil version :

gsutil version -l

Statistiques d'utilisation

Au cours du processus d'installation, vous pouvez choisir d'activer le suivi des statistiques d'utilisation afin d'améliorer l'outil gsutil. Si vous décidez par la suite de désactiver ces statistiques d'utilisation, consultez la page Statistiques d'utilisation.

À propos de gsutil

gsutil est un projet Open Source. Pour télécharger la version développeur de gsutil ou pour participer au développement de gsutil, consultez la page concernant le projet gsutil sur GitHub.

Limites

  • Lorsque vous utilisez gsutil avec Windows, les commandes utilisant le flag global -m ne peuvent pas être annulées à l'aide des touches Ctrl-C.

Étapes suivantes