Installer gsutil

Conditions préalables: Installez un gestionnaire de versions Python (pyenv) et une version de Python appropriée.

1. Définissez la version Python globale :
   • Pour définir Python 3.12.x comme version globale:

     pyenv global 3.12.x

   • Vous pouvez également définir la version de Python localement pour un dossier de projet spécifique:

     pyenv local 3.12.x

2. Vérifiez que la bonne version de Python est utilisée:

   python --version

   Vous devriez obtenir le résultat suivant :

   Python 3.12.x

1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.8 à 3.13. Notez que le package Linux x86_64 inclut un interpréteur Python groupé qui sera privilégié par défaut. Pour plus d'informations sur le choix et la configuration de votre interpréteur Python, consultez la page gcloud topic startup.
2. Téléchargez l'un des éléments suivants :

   Plate-forme	Nom du package	Taille	Somme de contrôle SHA256
   Linux 64 bits (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	131,6 Mo	beb7c8ef61c46ede9295bf68bfb331fbd158575cc3343db585d37b891c890336
   Linux 64 bits (Arm)	google-cloud-cli-linux-arm.tar.gz	53,9 Mo	44eb95fd169f92c197f88df527c3aa27d5db9aa977c2fa2d28fa1cf506b00c9f
   Linux 32 bits (x86)	google-cloud-cli-linux-x86.tar.gz	53,9 Mo	10303f55226fac633761ae52e1dbcbcaf7c59fe11232f8196e6e361fc38e2e77

   Pour télécharger le fichier d'archive Linux, exécutez la commande suivante :

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

   Reportez-vous au tableau ci-dessus et remplacez google-cloud-cli-linux-x86_64.tar.gz par le nom du package *.tar.gz qui s'applique à votre configuration.

3. Pour extraire le contenu du fichier vers votre système de fichiers (de préférence vers votre répertoire d'accueil), exécutez la commande suivante :

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   Facultatif: Pour remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant, puis extrayez l'archive au même emplacement.
4. Ajoutez gcloud CLI à votre PATH. Exécutez le script d'installation (à partir de la racine du dossier dans lequel vous l'avez extrait) à l'aide de la commande suivante :

   ./google-cloud-sdk/install.sh

   Cette opération peut également être effectuée de manière non interactive (par exemple, à l'aide d'un script) et via des préférences sous forme d'options. Pour afficher les options disponibles, exécutez la commande suivante :

   ./google-cloud-sdk/install.sh --help

   Facultatif :
   • Pour envoyer des statistiques d'utilisation anonymes afin de nous aider à améliorer gcloud CLI, répondez Y lorsque vous y êtes invité.
   • Pour ajouter gcloud CLI à votre PATH et activer l'achèvement de commande, répondez Y lorsque vous y êtes invité.
5. Ouvrez un nouveau terminal pour que les modifications prennent effet.
6. Pour initialiser gcloud CLI, exécutez la commande gcloud init :

./google-cloud-sdk/bin/gcloud init

7. Installez des composants supplémentaires à l'aide du gestionnaire de composants.

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

Avant d'installer gcloud CLI, assurez-vous que votre système d'exploitation remplit les conditions suivantes :

• Il s'agit d'une version d'Ubuntu qui n'est pas encore en fin de vie ou une version stable de Debian qui n'est pas encore en fin de vie
• Les packages ont été mis à jour récemment :

  sudo apt-get update

• apt-transport-https et curl sont installés :

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

1. Importez la clé publique de Google Cloud.

   • Pour les distributions plus récentes (Debian 9+ ou Ubuntu 18.04+), exécutez la commande suivante :

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • Pour les anciennes distributions, exécutez la commande suivante :

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   • Si la commande apt-key de votre distribution n'accepte pas l'argument --keyring, exécutez la commande suivante :

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   • Si vous ne pouvez pas obtenir les dernières mises à jour en raison de l'expiration d'une clé, procurez-vous le dernier fichier de clé apt-get.gpg.

2. Ajoutez l'URI de distribution de gcloud CLI en tant que source de package.
   • Pour les distributions plus récentes (Debian 9+ ou Ubuntu 18.04+), exécutez la commande suivante :

     echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   • Pour les distributions plus anciennes qui ne sont pas compatibles avec l'option de signature, exécutez la commande suivante :

     echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

3. Mettez à jour et installez gcloud CLI :

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Pour en savoir plus sur d'autres options apt-get, telles que la désactivation des invites ou des simulations, consultez les pages man apt-get.

   Conseil Docker : Si vous installez gcloud CLI dans une image Docker, utilisez plutôt une étape RUN unique :

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   Pour les images de base plus anciennes non compatibles avec la commande gpg --dearmor:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
         

4. (Facultatif) Installez l'un des composants supplémentaires suivants :
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

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

   sudo apt-get install google-cloud-cli-app-engine-java

5. Pour commencer, exécutez gcloud init :

   gcloud init

Revenir à une version antérieure de gcloud CLI

Pour revenir à une version spécifique de gcloud CLI, où VERSION est au format 123.0.0, exécutez la commande suivante :

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Les dix dernières versions sont toujours disponibles dans le dépôt.

REMARQUE : Pour les versions antérieures à 371.0.0, le nom du package est google-cloud-sdk.

La gcloud CLI est disponible sous forme de package pour l'installation sur les systèmes Red Hat Enterprise Linux 7, 8 et 9, Fedora 33 et 34, et CentOS 7 et 8. 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 le déploiement d'une application à l'aide des commandes gcloud, que vous pouvez installer séparément comme décrit plus loin dans cette section.

1. Mettez à jour DNF à l'aide des informations correspondant au dépôt gcloud CLI. L'exemple de commande suivant concerne une installation compatible avec Red Hat Enterprise Linux 9. Veillez toutefois à mettre à jour les paramètres selon votre configuration :

   sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
   [google-cloud-cli]
   name=Google Cloud CLI
   baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM

2. Si vous effectuez l'installation sur Fedora 34 ou 35, installez libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Installez gcloud CLI :

   sudo dnf install google-cloud-cli

4. (Facultatif) Installez l'un des composants supplémentaires suivants :
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

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

   sudo dnf install google-cloud-cli-app-engine-java

5. Pour commencer, exécutez gcloud init :

   gcloud init

Revenir à une version antérieure de gcloud CLI

Si vous souhaitez rétablir une version spécifique de gcloud CLI, où VERSION est au format 123.0.0, exécutez : sudo dnf downgrade google-cloud-cli-VERSION Les 10 dernières versions seront toujours disponibles dans le dépôt. REMARQUE : Pour les versions antérieures à 371.0.0, le nom du package est google-cloud-sdk.