Gérer les composants du SDK Cloud

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

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é, l'outil gcloud vous demande si vous que vous souhaitez l'installer. Une réponse positive installe le composant, puis exécute la commande. D'autres composants sont installés à la demande par l'outil 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 le SDK Cloud, les composants suivants sont installés par défaut:

ID Nom Description
gcloud Commandes de l'outil 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 d'utiliser des données dans BigQuery
gsutil Outil de ligne de commande Cloud Storage Outil permettant d'effectuer des tâches liées à Cloud Storage
core Bibliothèques principales du SDK Cloud Bibliothèques utilisées en interne par les outils du SDK Cloud

Composants alpha et bêta

Le SDK Cloud fournit deux composants qui contiennent les commandes alpha et bêta de l'outil gcloud. 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 Cloud. Ces composants sont les suivants :

ID Nom Description
alpha Commandes alpha de l'outil gcloud Commandes de l'outil gcloud au niveau de la version alpha.
beta Commandes de l'outil gcloud en version bêta Commandes de l'outil gcloud au niveau de la version bêta.

Les commandes de l'outil gcloud au niveau de la version en disponibilité générale font partie du composant gcloud. Elles sont installées automatiquement lorsque vous installez le SDK Cloud.

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 des composants du SDK Cloud selon 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 une liste complète des composants disponibles. Pour afficher les offres de composants les plus récentes, mettez à jour votre installation du SDK Cloud, puis exécutez gcloud components list.


┌────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                  Components                                         │
├───────────────┬─────────────────────────────────────────────────┬──────────────────────────┬───────────┤
│     Status   │                         Name                   │            ID           │    Size   │
├───────────────┼─────────────────────────────────────────────────┼──────────────────────────┼───────────┤
│ Installed     │ App Engine Go Extensions                      │ app-engine-go            │  97.7 MiB │
│ Not Installed │ AppCtl                                        │ appctl                   │  21.0 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 │
| Not Installed | Cloud Datastore Emulator                      | cloud-firestore-emulator | 60.4 MiB  |
│ Installed     │ Cloud Pub/Sub Emulator                        │ pubsub-emulator          │  33.2 MiB │
│ Installed     │ Cloud SQL Proxy                               │ cloud-sql-proxy          │   7.6 MiB │
│ Installed     │ Cloud Spanner Emulator                        │ cloud-spanner-emulator   │  21.8 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     │ Cloud 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 │
└────────────────┴────────────────────────────────────────────────┴───────────────────────────┴───────────┘

Installer des composants

Pour installer un composant dans la version actuelle de votre installation du SDK Cloud, exécutez la commande gcloud components install:

gcloud components install [COMPONENT-ID]

L'outil 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 ancienne version du SDK Cloud est installée, l'outil gcloud met à jour tous les composants installés.

Si vous devez revenir à une version antérieure connue et installer le SDK Cloud 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 de Homebrew), vous devez peut utiliser gcloud components update pour revenir à la version spécifiée:

gcloud components update --version VERSION

Pour revenir à une version antérieure du SDK Cloud installée à l'aide d'un gestionnaire de packages, reportez-vous à ces instructions afin de spécifier des versions lors du téléchargement à l'aide deapt-get ouyum (Installation de Python groupée).

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 l'outil gcloud sont également disponibles dans le SDK Cloud, mais ne sont pas installés par défaut. Pour obtenir une liste exhaustive des composants, exécutez la commande gcloudcomponent 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é 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