Liste de commandes à utiliser pour Google Cloud CLI, la ligne de commande principale pour Google Cloud.
(Également inclus : introduction, comprendre les commandes et document PDF imprimable.)
Aide-mémoire
Premiers pas
Lancez-vous avec la gcloud CLI.
gcloud init
: initialise, autorise et configure la gcloud CLI.gcloud version
: version d'affichage et composants installés.gcloud components install
: installe des composants spécifiques.gcloud components update
: met à jour votre 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 actuels de l'environnement de la gcloud CLI.
Aide
La gcloud CLI est à votre service.
gcloud help
: recherche des termes spécifiques dans les documents de référence de la gcloud CLI.gcloud feedback
: envoyez 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
Personnaliser la gcloud CLI personnaliser votre configuration à l'aide de 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 à la CLI gcloud, et gérez les identifiants.
gcloud auth login
: autorise l'accès à Google Cloud pour la gcloud CLI avec des identifiants utilisateur Google Cloud et définit le compte actuel comme actif.gcloud auth activate-service-account
: autorise l'accès à Google Cloud de manière similaire àgcloud auth login
, mais avec les identifiants du compte de service.gcloud auth application-default
: Gérez 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 le service Identity and Access Management (IAM) Google Cloud.
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 en conteneur sur Kubernetes.
gcloud auth configure-docker
: enregistre la CLI gcloud 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éez 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 la 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 un indicateur facultatif n'est pas défini, la valeur par défaut est utilisée.
- Paire nom/valeur (
Options globales
Certaines options sont disponibles dans l'ensemble de l'expérience 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 aider la découverte de commandes par soi-même.
Rechercher des commandes de CLI gcloud
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
.
Flags
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
.