Installer Google Cloud CLI

Ce guide de démarrage rapide décrit la méthode recommandée pour installer et initialiser la Google Cloud CLI. Après l'initialisation, exécutez quelques commandes gcloud CLI de base pour afficher des informations sur votre installation et vérifier qu'elle a réussi.

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud , cliquez sur Visite guidée :

Visite guidée

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

Installer gcloud CLI version 577.0.0

Linux
  1. Vérifiez que vous disposez d'une version compatible de Python. Google Cloud CLI nécessite Python 3.10 à 3.14. 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 documentation 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 88,5 Mo 1c478abfe0fbe256b8ecaba2faeff154e44c308064b1c69d9ec15b879a4944bd
    Linux 64 bits

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 61,3 Mo ef8ded3afd45c89bc3900e32579bddfa406b44f7837d993adac417f00b41aa8f
    Linux 32 bits

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 61,4 Mo 52164ff332756c784df60ffcca7f6fd89c5465431b2019cbcd117631b76898c2

    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, exécutez la commande suivante : 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     Pour remplacer une installation existante, supprimez le répertoire google-cloud-sdk existant, puis extrayez l'archive au même emplacement.
  4. Exécutez le script d'installation à partir de la racine du dossier dans lequel vous l'avez extrait : 
    ./google-cloud-sdk/install.sh
     Le script vous invite à effectuer les actions de configuration suivantes. Pour accepter, répondez Y lorsque vous y êtes invité.
    • Ajoutez gcloud CLI à votre PATH.
    • Activez la saisie semi-automatique des commandes.
    • Acceptez d'envoyer des statistiques d'utilisation anonymes pour nous aider à améliorer la gcloud CLI.
    Vous pouvez également effectuer l'installation de manière non interactive en fournissant des options. Pour afficher les options disponibles, exécutez la commande suivante : 
    ./google-cloud-sdk/install.sh --help
  5. Facultatif : Si vous avez mis à jour votre PATH à l'étape précédente, ouvrez un nouveau terminal pour que les modifications prennent effet.
Debian/Ubuntu

Contenu du package

gcloud CLI est disponible sous forme de package pour l'installation sur des systèmes Debian et Ubuntu. Ce package ne contient que les outils de ligne de commande 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 de commencer

Avant d'installer la 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 d'une version stable de Debian qui n'est pas encore en fin de vie.
  • Les packages ont été mis à jour récemment. Pour ce faire, exécutez la commande suivante : 
    sudo apt-get update
  • ca-certificates, gnupg et curl sont installés. Pour installer ces packages, exécutez la commande suivante : 
    sudo apt-get install ca-certificates gnupg curl

Installation

  1. Importez la clé publique 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