Liste des commandes d'accès à la Google Cloud CLI, l'outil de ligne de commande principal pour Google Cloud
(Également inclus : introduction, comprendre les commandes et document PDF imprimable.)
Aide-mémoire
Comment en profiter ?
Lancez-vous avec gcloud CLI.
gcloud init
: initialiser, autoriser et configurer la gcloud CLI.gcloud version
: version d'affichage et composants installés.gcloud components install
: installe des composants spécifiques.gcloud components update
: mettez à jour la gcloud CLI vers la dernière version.gcloud config set project
: définissez un projet Google Cloud par défaut sur lequel travailler.gcloud info
: affiche les détails de l'environnement gcloud CLI actuel.
Aide
gcloud CLI se fera un plaisir de vous aider.
gcloud help
: recherchez des termes spécifiques dans la documentation de référence de la gcloud CLI.gcloud feedback
: envoyer des commentaires à l'équipe de gcloud CLI.gcloud topic
: documents d'aide supplémentaires sur des sujets autres que les commandes, tels que l'accessibilité, le filtrage et la mise en forme.
Personnalisation
Personnalisez la gcloud CLI ; personnalisez votre configuration avec des propriétés.
gcloud config set
: définit une propriété (telle que Zone de calcul) pour la configuration actuelle.gcloud config get
: récupère la valeur d'une propriété de gcloud CLI.gcloud config list
: affiche toutes les propriétés de la configuration actuelle.gcloud config configurations create
: crée une configuration nommée.gcloud config configurations list
: affiche la liste de toutes les configurations disponibles.gcloud config configurations activate
: bascule vers une configuration nommée existante.
Autorisation et identifiants
Accordez et révoquez l'autorisation d'accès à la gcloud CLI, et gérez les identifiants.
gcloud auth login
: autoriser l'accès Google Cloud à la gcloud CLI avec les identifiants de l'utilisateur Google Cloud et définir le compte actuel comme actif.gcloud auth activate-service-account
: autorisez l'accès à Google Cloud d'une manière semblable àgcloud auth login
, mais avec des identifiants du compte de service.gcloud auth application-default
: gère les identifiants par défaut de votre application (ADC) pour les bibliothèques clientes Cloud.gcloud auth list
: répertorie tous les comptes avec identifiant.gcloud auth print-access-token
: affiche le jeton d'accès du compte actuel.gcloud auth revoke
: supprime les identifiants d'accès pour un compte.
Projets
Gérer les règles d'accès aux projets
gcloud projects describe
: affiche les métadonnées d'un projet (y compris son ID).gcloud projects add-iam-policy-binding
: ajoute une liaison de stratégie IAM à un projet spécifié.
IAM
Configurer les préférences et les comptes de service IAM (Identity and Access Management)
gcloud iam list-grantable-roles
: répertorie les rôles IAM à attribuer pour une ressource.gcloud iam roles create
: crée un rôle personnalisé pour un projet ou une organisation.gcloud iam service-accounts create
: crée un compte de service pour un projet.gcloud iam service-accounts add-iam-policy-binding
: ajoute une liaison de stratégie IAM à un compte de service.gcloud iam service-accounts set-iam-policy-binding
: remplace la liaison de stratégie IAM existante.gcloud iam service-accounts keys list
: répertorie les clés d'un compte de service.
Docker et Google Kubernetes Engine (GKE)
Gérez des applications conteneurisées sur Kubernetes
gcloud auth configure-docker
: enregistrer la gcloud CLI en tant qu'assistant d'identification Docker.gcloud container clusters create
: crée un cluster pour exécuter des conteneurs GKEgcloud container clusters list
: répertorie les clusters pour exécuter des conteneurs GKE.gcloud container clusters get-credentials
: met à jourkubeconfig
pour quekubectl
utilise un cluster GKE.gcloud container images list-tags
: répertorie les métadonnées du tag et du condensé pour une image de conteneur.
Machines virtuelles et Compute Engine
Créez, exécutez et gérez des VM sur l'infrastructure Google Cloud.
gcloud compute zones list
: répertorie les zones Compute Engine.gcloud compute instances create
: créer une instance de VM.gcloud compute instances describe
: affiche les détails d'une instance de VM.gcloud compute instances list
: répertorie toutes les instances de VM d'un projet.gcloud compute disks snapshot
: crée un instantané de disques persistants.gcloud compute snapshots describe
: affiche les détails d'un instantané.gcloud compute snapshots delete
: supprime un instantané.gcloud compute ssh
: se connecte à une instance de VM à l'aide de SSH.
Plate-forme sans serveur et App Engine
Créez des applications hautement évolutives sur une plate-forme sans serveur entièrement gérée
gcloud app deploy
: déploie le code et la configuration de votre application sur le serveur App Engine.gcloud app versions list
: répertorie toutes les versions de tous les services déployés sur le serveur App Engine.gcloud app browse
: ouvre l'application actuelle dans un navigateur Web.gcloud app create
: crée une application App Engine dans votre projet actuel.gcloud app logs read
: affiche les journaux de l'application App Engine les plus récents.
Divers
Commandes pouvant être utiles
gcloud kms decrypt
: déchiffre le texte chiffré (en fichier texte brut) à l'aide d'une clé Cloud Key Management Service.gcloud logging logs list
: répertorie les journaux de votre projet.gcloud sql backups describe
: affiche les informations de sauvegarde d'une instance Cloud SQL.gcloud sql export sql
: exporte des données d'une instance Cloud SQL vers un fichier SQL
Introduction
Présentation rapide de gcloud CLI.
Installer Google Cloud CLI
Installez la Google Cloud CLI en suivant ces instructions d'installation.
Options, arguments et autres ajouts exceptionnels
Les arguments peuvent être des indicateurs ou des arguments positionnels:
- Arguments positionnels : définis après le nom de la commande. Ils doivent respecter l'ordre des arguments positionnels.
Options : définies après les arguments de position. L'ordre des options n'a pas d'importance.
Une option peut être l'un des deux éléments suivants :
- Paire nom/valeur (
--foo=bar
), ou - Booléen (
--force/no-force
).
Les options peuvent également être du type suivant :
- Obligatoire
- Facultatif:si aucun indicateur facultatif n'est défini, la valeur par défaut est utilisée.
- Paire nom/valeur (
Options globales
Certains indicateurs sont disponibles dans l'interface de gcloud CLI, par exemple:
--help
: en cas de doute, permet d'afficher une aide détaillée sur une commande.--project
: si vous utilisez un projet autre que le projet actuel.--quiet
: désactive des invites interactives (et applique des valeurs par défaut pour les entrées).--verbosity
: peut définir des niveaux de détail dans les champsdebug
,info
,warning
,error
,critical
etnone
.--version
: affiche les informations de version de l'outilgcloud
.--format
: définit les formats de résultatsconfig
,csv
,default
,diff
,disable
,flattened
,get
,json
,list
,multi
,none
,object
,table
,text
,value
ouyaml
.
Nettoyer les résultats
Extrayez des résultats plus précis grâce aux options de filtre, de format, de limite et de tri.
Pour les instances Compute Engine associées au préfixe us
et non au type de machine f1-micro
:
gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"
Pour obtenir la liste des projets créés à partir du 15 janvier 2018, triés du plus ancien au plus récent, présentés sous forme de table comprenant les numéros de projet, les ID de projet et les colonnes de date de création indiquant des dates et des heures dans le fuseau horaire local :
gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime
Pour obtenir une liste de dix instances Compute Engine associées au libellé my-label
(de n'importe quelle valeur) :
gcloud compute instances list --filter="labels.my-label:*" --limit=10
Comprendre les commandes
Modèles sous-jacents pour les commandes de gcloud CLI, pour faciliter l'auto-découverte des commandes
Rechercher les commandes de gcloud CLI
La gcloud CLI est une arborescence. Les nœuds non-feuilles sont des groupes de commandes, et les nœuds feuilles sont des commandes. (En outre, la saisie semi-automatique via la touche de tabulation fonctionne pour les commandes et les ressources !)
La plupart des commandes gcloud
suivent le format suivant:
gcloud + release level (optional) + component + entity + operation + positional args + flags
Par exemple : gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a
Niveau de version
Le niveau de version fait référence à l'état de publication de la commande.
Exemple : alpha
pour les commandes alpha, beta
pour les commandes en version bêta, pas de niveau de version nécessaire pour les commandes disponibles à tous les utilisateurs.
Composant
Le composant fait référence aux différents services Google Cloud.
Exemple : compute
pour Compute Engine, app
pour App Engine, etc.
Entité
Le terme Entité désigne la forme plurielle d'un élément ou d'un ensemble d'éléments sous un composant.
Exemple : disks
, firewalls
, images
, instances
, regions
, zones
pour le calcul
Opération
L'opération fait référence à la forme de verbe impérative de l'opération à effectuer sur l'entité.
Exemple : Les opérations courantes sont describe
, list
, create/update
, delete/clear
, import
, export
, copy
, remove
, add
, reset
, restart
, restore
, run
et deploy
.
Arguments positionnels
Les arguments positionnels désignent les arguments requis, spécifiques à la commande, pour exécuter la commande.
Exemple : <INSTANCE_NAMES>
est l'argument positionnel requis pour gcloud compute instances create
.
Options
Les options font référence aux arguments supplémentaires, --flag-name(=value)
, transmis à la commande après les arguments positionnels.
Exemple : --machine-type=<MACHINE_TYPE>
et --preemptible
sont des options facultatives pour gcloud compute instances create
.