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 Platform. 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

Exécutez 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 efficace antérieure 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. Voici certains de ces composants (exécutez $ gcloud components list pour obtenir une liste exhaustive) :

ID Nom Description
app-engine-python Extensions Python d'application gcloud Packages du SDK Google App Engine pour Python. Installés lorsque vous exécutez la commande gcloud app deploy pour déployer une application Python sur App Engine.
app-engine-java Extensions Java d'application gcloud Packages du SDK Google App Engine pour Java. Installés lorsque vous exécutez la commande gcloud app deploy pour déployer une application Java sur App Engine.
app-engine-go Extensions Go d'application gcloud Packages du SDK Google App Engine pour Go. Installés lorsque vous exécutez la commande gcloud app deploy pour déployer une application Go sur App Engine.
gcd-emulator Émulateur Cloud Datastore Émulateur pour Google Cloud Datastore. Installé lorsque vous utilisez des commandes dans le groupe de commandes gcloud beta emulators datastore.
pubsub-emulator Émulateur Cloud Pub/Sub Émulateur pour Google Cloud Pub/Sub. Installé lorsque vous utilisez des commandes dans le groupe de commandes gcloud beta emulators pubsub.
cbt CLI Cloud Bigtable Outil de ligne de commande Google Cloud Bigtable.
cloud-build-local Outil de compilation local Cloud Build Outil de compilation local Google Cloud Build.
bigtable Émulateur Cloud Bigtable Émulateur pour Google Cloud Bigtable. Installé lorsque vous utilisez des commandes dans le groupe de commandes gcloud beta emulators bigtable.
kubectl kubectl Outil de ligne de commande Kubernetes. Lorsque vous exécutez des commandes dans le groupe de commandes gcloud container, vous êtes invité à installer ce composant. kubectl n'est pas requis pour créer des clusters de conteneurs, mais est requis pour les exécuter.
docker-credential-gcr docker-credential-gcr Assistant d'identification Docker pour Google Container Registry. Après l'installation, activez l'assistant d'identification en exécutant docker-credential-gcr configure-docker. Pour plus d'informations, consultez le projet sur GitHub.
datalab datalab Outil de ligne de commande Cloud Datalab.
cloud-build-local Google Cloud Build Local Outil de compilation local pour Cloud Build. Après l’installation, vous pouvez exécuter des versions sur votre machine locale. Pour plus d'informations, consultez la page Compiler et déboguer en local.

Gestionnaires de packages externes

Si vous avez eu recours à un gestionnaire de packages externe, tel que APT (via le format deb) ou YUM pour installer le SDK Cloud, vous pouvez installer des composants supplémentaires en vous reportant au tableau suivant.

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
Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Documentation du SDK Cloud