Les composants sont les parties installables de la Google Cloud CLI. 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 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 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.
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 gratuitComposants par défaut
Lorsque vous installez la CLI gcloud, 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 BigQuery | Outil permettant de travailler avec les données dans Google BigQuery |
gsutil |
Outil obsolète permettant d'effectuer des tâches Cloud Storage. Utilisez plutôt les commandes gcloud storage. |
|
core |
Bibliothèques principales de la gcloud CLI | Bibliothèques utilisées en interne par les outils de la gcloud CLI. |
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 | Nom | Description |
|---|---|---|
alpha |
Commandes alpha de la gcloud CLI | Commandes de la CLI gcloud en version alpha. |
beta |
Commandes de la CLI gcloud bêta | Commandes de CLI gcloud en version bêta. |
Les commandes de CLI gcloud en version de disponibilité générale font partie du composant CLI gcloud et sont installées automatiquement lorsque vous installez la CLI gcloud.
La liste de tous les composants supplémentaires et des gestionnaires de paquets externes disponibles, qui ne sont pas installés par défaut, s'affiche ci-dessous.
Gérer les composants de la CLI gcloud
Vous pouvez répertorier, installer, mettre à jour et supprimer les composants de la gcloud CLI en fonction de vos besoins.
Remarque: Ces instructions ne fonctionneront pas si vous avez installé la CLI gcloud à l'aide d'un gestionnaire de paquets tel que APT ouyum, car le gestionnaire de composants de la CLI gcloud est désactivé avec cette méthode d'installation. Utilisez plutôt ces packages.
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 la gcloud CLI, puis exécutez gcloud components list.
| Status | Nom du composant | ID | Size (Taille) |
|---|---|---|---|
| Installé | Extensions Go App Engine | app-engine-go | 97,7 Mo |
| Non installée | AppCtl | appctl | 21 Mio |
| Installé | Outil de ligne de commande Cloud Bigtable | cbt | 4 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 Mo |
| Installé | Extensions Java d'application gcloud | app-engine-java | 118,9 Mo |
| Installé | Extensions PHP d'application gcloud | app-engine-php | 21,9 Mio |
| Installé | Extensions Python d'application gcloud (bibliothèques supplémentaires) | app-engine-python-extras | 27,8 Mo |
| 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 Mo |
| Installé | Commandes gcloud alpha | alpha | < 1 Mio |
| Installé | Commandes gcloud bêta | bêta | < 1 Mio |
| Installé | Extensions Python d'application gcloud | app-engine-python | 6,1 Mo |
Installer des composants
Pour installer un composant sur 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
Utilisez la commande gcloud components update pour mettre à jour tous les composants installés vers la dernière version disponible de la gcloud CLI:
gcloud components update
Si une version plus ancienne de la CLI gcloud est installée, la CLI gcloud met à jour tous les composants installés.
Si vous devez revenir à une version antérieure fonctionnelle et installer la CLI gcloud directement (en dehors d'un gestionnaire de paquets, y compris via le programme d'installation interactif, les versions statiques, le programme d'installation Windows ou Homebrew), utilisez gcloud components update pour rétablir la version spécifiée:
gcloud components update --version VERSION
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 les commandes de la 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 à l'aide des gestionnaires de paquets apt ou yum, vous pouvez également installer des composants supplémentaires de la CLI gcloud à l'aide de ces mêmes gestionnaires de paquets. 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 gcloud CLI | 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 |
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 |