Gérer les composants du SDK

Que sont les composants ?

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

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.

Composants par défaut

Lorsque vous installez le SDK, les composants suivants sont installés par défaut :

ID Nom 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 de 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 à Google Cloud Storage.
core Bibliothèques principales du SDK Cloud Bibliothèques utilisées en interne par les outils du SDK.

Composants alpha et bêta

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

ID Nom 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 en version de disponibilité générale et en version d'aperçu font partie du composant CLI gcloud et sont installées automatiquement lorsque vous installez le SDK.

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 du SDK Cloud

Vous pouvez répertorier, installer, mettre à jour et supprimer les composants du SDK Google Cloud 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
┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                          │
├───────────────┬───────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status    │                         Name                  │            ID            │    Size   │
├───────────────┼───────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Installed     │ Cloud Bigtable Command Line Tool              │ cbt                      │   4.0 MiB │
│ Installed     │ Cloud Bigtable Emulator                       │ bigtable                 │   3.8 MiB │
│ Installed     │ Cloud Datalab Command Line Tool               │ datalab                  │   < 1 MiB │
│ Installed     │ Cloud Datastore Emulator                      │ cloud-datastore-emulator │  17.8 MiB │
│ Installed     │ Cloud Datastore Emulator (Legacy)             │ gcd-emulator             │  38.1 MiB │
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Emulator Reverse Proxy                        │ emulator-reverse-proxy   │  14.5 MiB │
│ Installed     │ Google Cloud Build Local Builder              │ cloud-build-local        │   4.4 MiB │
│ Installed     │ gcloud app Java Extensions                    │ app-engine-java          │ 118.9 MiB │
│ Installed     │ gcloud app PHP Extensions                     │ app-engine-php           │  21.9 MiB │
│ Installed     │ gcloud app Python Extensions (Extra Libraries)│ app-engine-python-extras │  27.8 MiB │
│ Installed     │ kubectl                                       │ kubectl                  │  12.2 MiB │
│ Installed     │ BigQuery Command Line Tool                    │ bq                       │   < 1 MiB │
│ Installed     │ Cloud SDK Core Libraries                      │ core                     │   7.2 MiB │
│ Installed     │ Cloud Storage Command Line Tool               │ gsutil                   │   3.3 MiB │
│ Installed     │ gcloud Alpha Commands                         │ alpha                    │   < 1 MiB │
│ Installed     │ gcloud Beta Commands                          │ beta                     │   < 1 MiB │
│ Installed     │ gcloud app Python Extensions                  │ app-engine-python        │   6.1 MiB │
└───────────────┴───────────────────────────────────────────────┴──────────────────────────┴───────────┘

Notez que le résultat affiché ci-dessus ne constitue pas la liste complète de tous les composants disponibles. Pour obtenir les dernières offres de composants, mettez à jour votre installation du SDK Cloud et exécutez gcloud components list.

Installer des composants

Pour installer un composant sur la version actuelle de votre installation du SDK Cloud, 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 du SDK Cloud :

gcloud components update

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

Si vous devez revenir à une version antérieure fonctionnelle et installer le SDK 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), vous pouvez exécuter la commande gcloud components update pour rétablir la version spécifiée :

gcloud components update --version VERSION

Pour revenir aux versions antérieures du SDK Cloud installées avec un gestionnaire de packages, 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 diverses commandes de CLI gcloud sont également disponibles dans le SDK, mais ne sont pas installés par défaut. Vous pouvez exécuter $ gcloud components list pour obtenir une liste exhaustive des composants. Les composants supplémentaires pouvant être installés sont signalés par l'état Not Installed.

Gestionnaires de packages externes

Si vous avez installé le SDK Cloud à l'aide du gestionnaire de packages apt ou yum, vous pouvez utiliser ce même gestionnaire pour installer des composants supplémentaires du SDK Cloud. 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 du SDK Cloud Package APT Package YUM
app-engine-go google-cloud-sdk-app-engine-go google-cloud-sdk-app-engine-go
app-engine-java google-cloud-sdk-app-engine-java google-cloud-sdk-app-engine-java
app-engine-python google-cloud-sdk-app-engine-python google-cloud-sdk-app-engine-python
bigtable google-cloud-sdk-bigtable-emulator google-cloud-sdk-bigtable-emulator
cbt google-cloud-sdk-cbt google-cloud-sdk-cbt
cloud-build-local google-cloud-sdk-cloud-build-local google-cloud-sdk-cloud-build-local
datalab google-cloud-sdk-datalab google-cloud-sdk-datalab
docker-credential-gcr Pas encore disponible Pas encore disponible
gcd-emulator google-cloud-sdk-datastore-emulator google-cloud-sdk-datastore-emulator
kubectl kubectl kubectl
pubsub-emulator google-cloud-sdk-pubsub-emulator google-cloud-sdk-pubsub-emulator