Gérer les composants de la CLI gcloud

Les composants sont les parties installables de 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, 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 ou gcloud beta de manière interactive et que le composant alpha ou beta correspondant n'est pas installé, 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 gcloud CLI lorsque vous exécutez des commandes qui les nécessitent.

Composants par défaut

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

ID Nom Description
gcloud Commandes de la gcloud CLI par défaut Outil permettant d'interagir avec Trusted 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 plutôt les commandes gcloud storage.
core Bibliothèques principales de gcloud CLI Bibliothèques utilisées en interne par les outils gcloud CLI.

Composants alpha et bêta

Gcloud CLI fournit deux composants qui contiennent les commandes alpha et bêta de 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 gcloud CLI. Ces composants sont les suivants :

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

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

La liste de tous les composants supplémentaires disponibles et des gestionnaires de packages externes (non installés par défaut) est disponible ci-dessous.

Gérer les composants de gcloud CLI

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

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 obtenir les dernières offres de composants, mettez à jour votre installation de gcloud CLI et exécutez gcloud components list.

Status Nom du composant ID Size (Taille)
Installé Extensions Go d'App Engine app-engine-go 97,7 Mio
Installé Outil de ligne de commande Cloud Bigtable cbt 4,0 Mio
Installé Émulateur Cloud Bigtable bigtable 3,8 Mio
Installé Émulateur Cloud Datastore cloud-datastore-emulator 17,8 Mio
Non installée Émulateur Cloud Firestore cloud-firestore-emulator 60,4 Mio
Installé Émulateur Cloud Pub/Sub pubsub-emulator 33,2 Mio
Installé Proxy Cloud SQL cloud_sql_proxy 7,6 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 gcloud app app-engine-java 118,9 Mio
Installé Extensions PHP gcloud app app-engine-php 21,9 Mio
Installé Extensions Python d'application gcloud (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
Installé Extensions Python 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 la commande 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 gcloud CLI :

gcloud components update

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

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

gcloud components update --version VERSION

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 de 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 la commande gcloud components list. Les composants supplémentaires pouvant être installés sont signalés par l'état Not Installed.