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 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 gcloud CLI

Si vous êtes un utilisateur de gsutil et que vous souhaitez migrer vers 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 gcloud CLI, commencez par installer gcloud CLI.

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

Une fois 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 à faire vos premiers pas:

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 à une page d'aide sur les commandes et à une page d'aide sur les rubriques.

Pour obtenir des informations sur votre 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 relative au projet gsutil sur GitHub.

Limites

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

Étapes suivantes