Gérer les composants de la CLI gcloud

Les composants sont les parties installables de la Google Cloud CLI. Un composant peut être un outil de ligne de commande (gcloud, bq et gsutil), un ensemble de Commandes de gcloud CLI en version alpha ou bêta des niveaux de version, qui contient les dépendances utilisées par un outil de la gcloud CLI.

Les composants les plus couramment utilisés sont installés par défaut. Si vous exécutez une commande gcloud alpha ou gcloud beta de manière interactive et que le composant alpha ou beta correspondant n'est pas installé, la CLI gcloud vous demande si vous souhaitez l'installer. Si vous acceptez, le composant est installé et la commande est exécutée. D'autres composants sont installés à la demande par la CLI gcloud lorsque vous exécutez des commandes qui les nécessitent.

Faites l'essai

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 gratuits pour exécuter, tester et déployer des charges de travail.

Essai gratuit

Composants par défaut

Lorsque vous installez la gcloud CLI, les composants suivants sont installés par défaut:

ID Nom Description
gcloud Commandes par défaut de la gcloud CLI Outil permettant d'interagir avec Google Cloud. Seules les commandes en version de disponibilité générale et d'aperçu sont installées avec ce composant. Vous devez installer séparément les composants des commandes gcloud alpha et/ou gcloud beta si vous souhaitez utiliser des commandes à d'autres niveaux de version.
bq Outil de ligne de commande BigQuery Outil permettant de travailler avec les données dans Google BigQuery
gsutil Ancien outil permettant d'effectuer des tâches Cloud Storage. Utilisez Commandes gcloud storage à la place.
core Bibliothèques principales de la CLI gcloud Bibliothèques utilisées en interne par les outils de la gcloud CLI.

Composants alpha et bêta

La CLI gcloud fournit deux composants qui contiennent les commandes alpha et bêta de la CLI gcloud. Ces composants ne sont pas par défaut, mais vous pouvez les installer manuellement l'installation initiale de la gcloud CLI. Ces composants sont les suivants :

ID Nom Description
alpha Commandes alpha de la CLI gcloud Commandes de la CLI gcloud en version alpha.
beta Commandes de la gcloud CLI bêta Commandes de gcloud CLI en version bêta.

Les commandes de gcloud CLI en version de disponibilité générale sont faisant partie de la gcloud CLI et sont installées automatiquement lorsque vous installez la gcloud CLI.

la liste de tous les composants supplémentaires disponibles ; des gestionnaires de packages externes, qui ne sont pas installés ; par défaut, s'affiche en dessous.

Gérer les composants de la gcloud CLI

Vous pouvez répertorier, installer, mettre à jour et supprimer les composants de gcloud CLI en fonction de vos besoins.

Remarque : Ces instructions ne fonctionneront pas si vous avez installé la CLI gcloud à l'aide d'un gestionnaire de paquets tel que APT ou yum, car le gestionnaire de composants de la CLI gcloud est désactivé avec cette méthode d'installation. Utilisez plutôt ces packages.

Répertorier les composants

Pour consulter la liste des composants disponibles et actuellement installés, exécutez la commande gcloud components list :

gcloud components list

L'exemple suivant ne fournit pas la liste complète de tous les composants disponibles. À afficher les dernières offres de composants, mettre à jour votre gcloud CLI puis exécuter gcloud components list

Status Nom du composant ID Size (Taille)
Installée Extensions Go App Engine app-engine-go 97,7 Mio
Non installée AppCtl appctl 21 Mio
Installée Outil de ligne de commande Cloud Bigtable cbt 4 Mio
Installée Émulateur Cloud Bigtable bigtable 3,8 Mio
Installée Émulateur Cloud Datastore cloud-datastore-emulator 17,8 Mio
Non installée Émulateur Cloud Firestore émulateur cloud-firestore 60,4 Mio
Installée Émulateur Cloud Pub/Sub pubsub-emulator 33,2 Mio
Installée Proxy Cloud SQL cloud_sql_proxy 7,6 Mio
Installée Émulateur Cloud Spanner cloud-spanner-emulator 21,8 Mio
Installée Outil de compilation local Google Cloud Build. cloud-build-local 4,4 Mio
Installée Extensions Java d'application gcloud app-engine-java 118,9 Mo
Installée Extensions PHP pour gcloud app app-engine-php 21,9 Mio
Installée Extensions Python pour gcloud app (bibliothèques supplémentaires) app-engine-python-extras 27,8 Mo
Installée kubectl kubectl 12,2 Mio
Installée Outil de ligne de commande Cloud BigQuery bq < 1 Mio
Installée Bibliothèques principales du SDK Cloud core 7,2 Mio
Installée Outil de ligne de commande Cloud Storage gsutil 3,3 Mio
Installée Commandes gcloud alpha alpha < 1 Mio
Installée Commandes gcloud bêta bêta < 1 Mio
Installée Extensions Python gcloud app app-engine-python 6,1 Mio

Installer des composants

Installer un composant dans la version actuelle de votre gcloud CLI l'installation, exécuter gcloud components install:

gcloud components install [COMPONENT-ID]

La CLI gcloud installe le composant spécifié.

Par exemple, si vous souhaitez installer la commande kubectl :

gcloud components install kubectl

Mettre à jour des composants

Utilisez la commande gcloud components update pour mettre à jour tous les composants installés vers la dernière version disponible de la gcloud CLI :

gcloud components update

Si une version plus ancienne de la CLI gcloud est installée, la CLI gcloud met à jour tous les composants installés.

Si vous devez revenir à une version antérieure fonctionnelle et installer la CLI gcloud directement (en dehors d'un gestionnaire de paquets, y compris via le programme d'installation interactif, les versions statiques, le programme d'installation Windows ou Homebrew), utilisez gcloud components update pour rétablir la version spécifiée :

gcloud components update --version VERSION
Pour revenir à une version antérieure de la gcloud CLI installée à l'aide d'un package , reportez-vous à ces instructions pour spécifier les versions lors du téléchargement avec apt-get ou yum.

Supprimer des composants

Exécutez la commande gcloud components remove pour supprimer un composant spécifié à l'aide de son ID :

gcloud components remove [COMPONENT-ID]

Vous pouvez réinstaller un composant à l'aide de la commande gcloud components install à tout moment.

Composants supplémentaires

Composants supplémentaires contenant des dépendances pour gcloud CLI sont également disponibles dans la gcloud CLI, mais ne sont pas installées par défaut. Pour obtenir la liste exhaustive des composants, exécutez gcloud components list. Les composants supplémentaires pouvant être installés sont signalés par l'état Not Installed.

Gestionnaires de packages externes

Si vous avez installé la CLI gcloud à l'aide des gestionnaires de paquets apt ou yum, vous pouvez également installer des composants supplémentaires de la CLI gcloud à l'aide de ces mêmes gestionnaires de paquets. Si votre gestionnaire de packages ne parvient pas à trouver ces packages, consultez le guide Installer avec apt ou Installer avec yum pour découvrir comment configurer https://packages.cloud.google.com/ comme source de packages.

Composant gcloud CLI Package APT Package YUM
app-engine-go google-cloud-cli-app-engine-go google-cloud-cli-app-engine-go
app-engine-java google-cloud-cli-app-engine-java google-cloud-cli-app-engine-java
app-engine-python google-cloud-cli-app-engine-python google-cloud-cli-app-engine-python
bigtable google-cloud-cli-bigtable-emulator google-cloud-cli-bigtable-emulator
cbt google-cloud-cli-cbt google-cloud-cli-cbt
cloud-build-local google-cloud-cli-cloud-build-local google-cloud-cli-cloud-build-local
docker-credential-gcr Pas encore disponible Pas encore disponible
gcd-emulator google-cloud-cli-datastore-emulator google-cloud-cli-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-cli-pubsub-emulator google-cloud-cli-pubsub-emulator