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 gcloud CLI en version alpha ou bêta
des niveaux de version ou un package
qui contient les dépendances utilisées par un outil de la gcloud CLI.
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 alpha
ou beta
n'est pas installé, la gcloud CLI vous demande si vous
que vous voulez l'installer. Si vous acceptez, le composant est installé et la commande est exécutée. Les autres composants sont installés à la demande
gcloud CLI 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 gcloud CLI, les composants suivants sont installés par défaut:
ID | Nom | Description |
---|---|---|
gcloud |
Commandes par défaut de la gcloud CLI | 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 |
Ancien outil permettant d'effectuer des tâches Cloud Storage. Utilisez
Commandes gcloud storage
à la place. |
|
core |
Bibliothèques principales de la gcloud CLI | Bibliothèques utilisées en interne par les outils de gcloud CLI. |
Composants alpha et bêta
La gcloud CLI fournit deux composants qui contiennent gcloud CLI alpha et bêta. Ces composants ne sont pas par défaut, mais vous pouvez les installer manuellement l'installation initiale de la gcloud CLI. Ces composants sont les suivants :
ID | Nom | Description |
---|---|---|
alpha |
Commandes de la gcloud CLI alpha | Commandes de gcloud CLI en version alpha. |
beta |
Commandes de la gcloud CLI bêta | Commandes de gcloud CLI en version bêta. |
Les commandes de gcloud CLI en version de disponibilité générale sont du composant gcloud CLI et sont installées automatiquement lorsque vous installez la gcloud CLI.
la liste de tous les composants supplémentaires disponibles ; des gestionnaires de packages externes, qui ne sont pas installés ; par défaut, s'affiche en dessous.
Gérer les composants de la gcloud CLI
Vous pouvez répertorier, installer, mettre à jour et supprimer les composants de la gcloud CLI pour : à 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. À
afficher les dernières offres de composants, mettre à jour votre gcloud CLI
puis exécuter
gcloud components list
Status | Nom du composant | ID | Size (Taille) |
---|---|---|---|
Installée | Extensions Go App Engine | app-engine-go | 97,7 Mio |
Non installée | AppCtl | appctl | 21 Mio |
Installée | Outil de ligne de commande Cloud Bigtable | cbt | 4 Mio |
Installée | Émulateur Cloud Bigtable | bigtable | 3,8 Mio |
Installée | Émulateur Cloud Datastore | cloud-datastore-emulator | 17,8 Mio |
Non installée | Émulateur Cloud Firestore | cloud-firestore-emulator | 60,4 Mio |
Installée | Émulateur Cloud Pub/Sub | pubsub-emulator | 33,2 Mio |
Installée | Proxy Cloud SQL | cloud_sql_proxy | 7,6 Mio |
Installée | Émulateur Cloud Spanner | cloud-spanner-emulator | 21,8 Mio |
Installée | Outil de compilation local Google Cloud Build. | cloud-build-local | 4,4 Mio |
Installée | Extensions Java gcloud app | app-engine-java | 118,9 Mio |
Installée | Extensions PHP pour gcloud app | app-engine-php | 21,9 Mio |
Installée | Extensions Python pour gcloud app (bibliothèques supplémentaires) | app-engine-python-extras | 27,8 Mio |
Installée | kubectl | kubectl | 12,2 Mio |
Installée | Outil de ligne de commande Cloud BigQuery | bq | < 1 Mio |
Installée | Bibliothèques principales du SDK Cloud | core | 7,2 Mio |
Installée | Outil de ligne de commande Cloud Storage | gsutil | 3,3 Mio |
Installée | Commandes gcloud alpha | alpha | < 1 Mio |
Installée | Commandes gcloud bêta | bêta | < 1 Mio |
Installée | Extensions Python gcloud app | app-engine-python | 6,1 Mio |
Installer des composants
Installer un composant dans la version actuelle de la gcloud CLI
d'installation, exécuter
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 le gcloud components update
pour mettre à jour tous les composants installés vers la dernière version disponible de
gcloud CLI:
gcloud components update
Si une ancienne version de la gcloud CLI est installée, Gcloud CLI met à jour tous les composants installés.
Si vous devez revenir à une version opérationnelle auparavant connue et installer
gcloud CLI directement (en dehors d'un gestionnaire de packages, y compris en utilisant
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
Pour revenir à une version antérieure de la gcloud CLI installée à l'aide d'un package
, reportez-vous à ces instructions pour spécifier les versions lors du téléchargement
à l'aide de 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
Composants supplémentaires contenant des dépendances pour gcloud CLI
sont également disponibles dans la gcloud CLI, mais ne sont pas installées
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 gcloud CLI via la apt
ou yum
, vous pouvez également installer
des composants gcloud CLI 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 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 |