Gérer les composants de CLI gcloud

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

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 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 CLI gcloud, les composants suivants sont installés par défaut:

ID Name Description
gcloud Commandes de CLI gcloud par défaut 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 Outil de ligne de commande Cloud Storage Outil permettant d'effectuer des tâches liées à Cloud Storage.
core Bibliothèques clés CLI gcloud Bibliothèques utilisées en interne par les outils de la CLI gcloud

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 installés par défaut, mais vous pouvez les installer manuellement à tout moment après l'installation initiale de la CLI gcloud. Ces composants sont les suivants :

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

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

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

Gérer les composants de CLI gcloud

Vous pouvez répertorier, installer, mettre à jour et supprimer les composants de CLI gcloud 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 afficher les dernières offres de composants, mettez à jour l'installation de la CLI gcloud, puis exécutez gcloud components list.

Status Nom du composant Identifiant Size (Taille)
Installé Extensions Go App Engine app-engine-go 97,7 Mio
Non installée App tl appctl 21,0 Mio
Installé Outil de ligne de commande Cloud Bigtable cbt 4,0 Mio
Installé Émulateur Cloud Bigtable bigtable 3,8 Mio
Installé Outil de ligne de commande Cloud Datalab datalab < 1 Mio
Installé Émulateur Cloud Datastore cloud-datastore-emulator 17,8 Mio
Non installée Émulateur Cloud Datastore émulateur cloud-firestore 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 émulateur cloud-spanner 21,8 Mio
Installé Outil de compilation local Google Cloud Build. cloud-local/local 4,4 Mio
Installé Extensions Java de l'application gcloud app-engine-java 118,9 Mio
Installé Extensions gcloud app PHP app-engine-php 21,9 Mio
Installé Extensions gcloud app Python (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 de l'application gcloud app-engine-python 6,1 Mio

Installer des composants

Pour installer un composant dans la version actuelle de votre installation de la CLI gcloud, 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

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

gcloud components update

Si vous disposez d'une ancienne version de la CLI gcloud, celle-ci met à jour tous les composants installés.

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

gcloud components update --version VERSION

Pour faire revenir les versions de la CLI gcloud installées à l'aide d'un gestionnaire de packages, reportez-vous à ces instructions afin de spécifier les versions lors du téléchargement à l'aide de apt-get ou de 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 de CLI gcloud sont également disponibles dans la CLI gcloud, 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 CLI gcloud via les gestionnaires de packages apt ou yum, vous pouvez également installer des composants de CLI gcloud 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 de la CLI gcloud 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
datalab google-cloud-cli-datalab google-cloud-cli-datalab
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