Cette page présente la Google Cloud CLI, ainsi que ses modèles de commandes et ses fonctionnalités courants.
Qu'est-ce que la gcloud CLI ?
La Google Cloud CLI est un ensemble d'outils permettant de créer et de gérer des ressourcesGoogle Cloud . Ces outils permettent d'effectuer de nombreuses tâches courantes sur la plate-forme, à partir de la ligne de commande ou dans des scripts et autres mécanismes d'automatisation.
Par exemple, vous pouvez utiliser la gcloud CLI pour créer et gérer les éléments suivants :
- Instances de machines virtuelles et autres ressources Compute Engine
- Instances Cloud SQL
- Les clusters Google Kubernetes Engine
- Clusters et jobs Managed Service pour Apache Spark
- Ensembles d'enregistrements et zones gérées Cloud DNS
- Déploiements Cloud Deployment Manager
Vous pouvez également utiliser gcloud CLI pour déployer des applications App Engine, gérer l'authentification, personnaliser la configuration locale et effectuer d'autres tâches.
Télécharger et installer la gcloud CLI
La version actuelle de gcloud CLI est 587.0.0.
Bien que nous vous recommandions vivement d'utiliser la version actuelle de la gcloud CLI, vous pouvez également télécharger et installer les versions précédentes à partir de l'archive de téléchargement.
Si vous utilisez Cloud Shell, gcloud CLI est disponible automatiquement et vous n'avez pas besoin de l'installer. Sinon, téléchargez et installez gcloud CLI, puis initialisez-la.
Par défaut, la gcloud CLI installe les commandes disponibles en version Disponibilité générale. Des fonctionnalités supplémentaires sont disponibles dans les composants gcloud CLI nommés alpha, beta et preview. Ces composants vous permettent d'utiliser la gcloud CLI pour travailler avec Bigtable, Dataflow et d'autres éléments de Google Cloud , alors même qu'ils ne sont pas encore en disponibilité générale.
Aide-mémoire gcloud CLI
Pour une présentation rapide de la gcloud CLI, une liste des commandes couramment utilisées et un aperçu de la structure de ces commandes, consultez l'aide-mémoire de la gcloud CLI.
Niveaux de version
Les commandes gcloud CLI ont les niveaux de version suivants :
| Niveau de version | Libellé | Description |
|---|---|---|
| Disponibilité générale | Aucun | Les commandes sont considérées comme totalement stables et disponibles pour une utilisation en production. Pour être informé à l'avance des modifications apportées aux commandes qui interrompent les fonctionnalités actuelles, consultez les notes de version. |
| Aperçu | preview |
Les commandes sont au niveau de version Preview et sont utilisées pour recueillir les commentaires des clients. Les offres en version preview sont souvent annoncées publiquement, mais elles ne comportent pas nécessairement des fonctionnalités complètes, et ne sont associées à aucun contrat de niveau de service ni aucune obligation d'assistance technique. Sauf indication contraire de la part de Google, les offres en version preview sont destinées à être utilisées dans des environnements de test uniquement. La phase Aperçu dure environ six mois. |
| Bêta | beta |
Les commandes sont complètes sur le plan fonctionnel, mais il pourrait rester des problèmes en suspens. Des modifications destructives peuvent être apportées à ces commandes sans préavis. |
| Alpha | alpha |
Les commandes sont à un stade précoce et peuvent changer sans préavis. |
Les composants alpha, beta et preview ne sont pas installés par défaut lorsque vous installez gcloud CLI. Vous devez installer ces composants séparément à l'aide de la commande gcloud components install. Si vous essayez d'exécuter une commande alpha, bêta ou en version Preview, et que le composant correspondant n'est pas installé, la gcloud CLI vous invite à l'installer.
Groupes de commandes
Dans chaque niveau de version, les commandes gcloud CLI sont organisées dans une hiérarchie imbriquée de groupes de commandes, chacun représentant un produit ou une fonctionnalité de Google Cloud ou de ses sous-groupes fonctionnels.
Exemple :
| Groupe de commandes | Description |
|---|---|
gcloud compute |
Commandes associées à Compute Engine en disponibilité générale |
gcloud compute instances |
Commandes associées aux instances Compute Engine en disponibilité générale |
gcloud beta compute |
Commandes associées à Compute Engine en version bêta |
gcloud preview |
Commandes liées à Google Cloud en version Preview |
gcloud alpha app |
Commandes associées à la gestion des déploiements App Engine en version alpha |
Exécuter des commandes de gcloud CLI
Vous pouvez exécuter des commandes de la gcloud CLI depuis la ligne de commande et à partir de scripts et d'autres mécanismes d'automatisation, par exemple lorsque vous utilisez Jenkins pour automatiser des tâches Google Cloud .
Propriétés
Les propriétés de gcloud CLI sont des paramètres qui affectent le comportement des outils gcloud CLI. Certaines de ces propriétés peuvent être définies par des options globales ou de commande. Dans ce cas, la valeur définie par l'option est prioritaire.
Activer les fonctionnalités d'accessibilité
Pour une expérience de lecture d'écran plus fluide, la gcloud CLI est fournie avec une propriété accessibility/screen_reader.
Pour activer la propriété d'accessibilité, exécutez la commande suivante :
gcloud config set accessibility/screen_reader true
Pour plus d'informations sur les fonctionnalités d'accessibilité disponibles avec l'outil de ligne de commande gcloud, consultez le guide Activer les fonctionnalités d'accessibilité.
Configurations
Une configuration est un ensemble de propriétés gcloud CLI. Une configuration fonctionne comme un profil.
Lorsque vous commencez à utiliser gcloud CLI, vous travaillez avec une seule configuration nommée default. Vous pouvez définir des propriétés en exécutant gcloud init ou gcloud config set. Cette configuration par défaut unique convient à la plupart des cas d'utilisation.
Pour travailler avec plusieurs projets ou comptes d'autorisation, vous pouvez configurer plusieurs configurations avec gcloud config configurations create et passer de l'une à l'autre. Dans une configuration, vous pouvez personnaliser les propriétés.
Par exemple, pour définir votre projet dans une configuration active, utilisez la propriété project :
gcloud config set project <project-id>
Pour une description détaillée de ces concepts, consultez le guide des configurations.
Options globales
gcloud CLI fournit un ensemble d'options gcloud CLI qui régissent le comportement des commandes à chaque appel. Les options remplacent les valeurs définies dans les propriétés de gcloud CLI.
Arguments et options positionnels
Bien que les arguments positionnels et les options affectent le résultat d'une commande gcloud CLI, il existe une subtile différence dans leurs cas d'utilisation. Un argument positionnel est utilisé pour définir une entité sur laquelle une commande opère, tandis qu'une option est nécessaire pour définir une variation dans le comportement d'une commande.
Utilisation de stdout et stderr
Le résultat des commandes gcloud CLI réussies est écrit dans stdout. Tous les autres types de réponses (requêtes, avertissements et erreurs) sont écrits dans stderr. N'écrivez pas de scripts pour les réponses écrites à stderr, car elles ne sont pas stables.
Pour obtenir des consignes sur la gestion des résultats, consultez le guide de script.
Rédaction de prompts
Pour vous protéger contre les actions destructrices involontaires, la gcloud CLI confirme vos intentions avant d'exécuter des commandes telles que gcloud projects delete.
Vous pouvez être invité à fournir des informations supplémentaires.
Par exemple, vous serez invité à choisir une zone lorsque vous créerez une instance de machine virtuelle Compute Engine à l'aide de gcloud compute instances create test-instance.
Pour désactiver l'invite, utilisez l'option --quiet.
Ne créez pas de script selon la formulation des invites, car celle-ci peut changer.
Supprimer les invites, écrire sur le terminal et journaliser
L'option --quiet (également -q) pour la gcloud CLI désactive toutes les invites interactives lors de l'exécution des commandes de la gcloud CLI. Elle est utile pour la création de scripts. Si une entrée est nécessaire, les valeurs par défaut sont utilisées. Si aucune valeur par défaut n'est définie, une erreur est générée.
Pour supprimer l'affichage du résultat de la commande sur la sortie standard et l'erreur standard dans le terminal, utilisez l'option --no-user-output-enabled.
Pour ajuster la verbosité des journaux, spécifiez un niveau de verbosité (debug, info, warning, error, critical ou none) à l'aide de l'option --verbosity.
Déterminer la structure du résultat
Par défaut, lorsqu'une commande gcloud CLI renvoie une liste de ressources, celles-ci sont mises en forme pour être affichées sur la sortie standard. Pour produire des résultats plus pertinents, les options format, filter et projection vous permettent d'affiner vos résultats.
Pour définir uniquement le format de votre sortie, utilisez l'option --format afin de générer une version tabulée ou aplatie de votre sortie (pour l'affichage interactif) ou une version lisible par machine de la sortie (json, csv, yaml, value).
Pour mettre en forme une liste de clés qui sélectionnent les valeurs de données de ressources, utilisez projections. Pour affiner le résultat en fonction d'un critère que vous définissez, utilisez l'option filter.
Étapes suivantes
- Pour en savoir plus sur les commandes gcloud CLI, consultez la documentation de référence de gcloud CLI.