Gérer les composants de gcloud CLI

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 gcloud CLI aux niveaux de version Alpha, Bêta ou Preview, ou un package contenant des dépendances utilisées par un outil dans gcloud CLI.

Les composants les plus couramment utilisés sont installés par défaut. Si vous exécutez une commande gcloud alpha, gcloud beta ou gcloud preview de manière interactive et que le composant alpha, beta ou preview n'est pas installé, la gcloud CLI 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 gcloud CLI 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 sans frais pour exécuter, tester et déployer des charges de travail.

Essayer sans frais

Composants par défaut

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

ID Nom Description
gcloud Commandes gcloud CLI par défaut Outil permettant d'interagir avec Google Cloud. Seules les commandes au niveau de la version en disponibilité générale sont installées avec ce composant. Vous devez installer séparément les composants gcloud alpha Commands, gcloud beta Commands et/ou gcloud preview Commands 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 Outil d'ancienne génération permettant d'effectuer des tâches Cloud Storage. Utilisez plutôt les commandes gcloud storage.
core Bibliothèques principales de la gcloud CLI Bibliothèques utilisées en interne par les outils de la gcloud CLI.

Composants alpha, bêta et preview

La gcloud CLI fournit des composants qui contiennent des commandes alpha, bêta et en version preview de la gcloud CLI. Ces composants ne sont pas installés par défaut, mais vous pouvez les installer manuellement à tout moment après l'installation initiale de la gcloud CLI. Ces composants sont les suivants :

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

Les commandes gcloud CLI au niveau de la version en disponibilité générale font partie du composant gcloud CLI et sont installées automatiquement lorsque vous installez gcloud CLI.

Vous trouverez ci-dessous la liste de tous les composants supplémentaires et gestionnaires de packages externes disponibles, qui ne sont pas installés par défaut.

Gérer les composants de gcloud CLI

Vous pouvez lister, installer, mettre à jour et supprimer des composants de la gcloud CLI en fonction de vos besoins.

Remarque : Ces instructions ne fonctionneront pas si vous avez installé gcloud CLI à l'aide d'un gestionnaire de paquets tel que APT ou yum, car le gestionnaire de composants gcloud CLI 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. Pour afficher les dernières offres de composants, mettez à jour votre installation de gcloud CLI, puis exécutez gcloud components list.

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

Installer des composants

Pour installer un composant sur la version actuelle de votre installation de gcloud CLI, exécutez gcloud components install :

gcloud components install [COMPONENT-ID]

La gcloud CLI 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 ancienne version de la gcloud CLI est installée, la gcloud CLI met à jour tous les composants installés.

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

gcloud components update --version VERSION
Pour revenir aux versions antérieures de la gcloud CLI installées avec un gestionnaire de paquets, reportez-vous à ces instructions pour spécifier les versions lors du téléchargement via 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

Des composants supplémentaires contenant des dépendances pour les commandes gcloud CLI sont également disponibles dans gcloud CLI, mais ne sont pas installés 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 gcloud CLI via les gestionnaires de packages apt ou yum, vous pouvez également installer des composants gcloud CLI supplémentaires à l'aide de ces mêmes gestionnaires de packages. 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 google-cloud-cli-docker-credential-gcr google-cloud-cli-docker-credential-gcr
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