Commandes gcloud compute courantes

Ce document répertorie certaines des commandes gcloud compute les plus couramment utilisées.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

    1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

      gcloud init
    2. Définissez une région et une zone par défaut.

Décrire des projets

Exécutez la commande suivante pour demander les informations concernant votre projet Compute Engine telles que les métadonnées du projet, les clés SSH et les métriques de quota :

 gcloud compute project-info describe

Pour en savoir plus sur la description de votre projet, consultez la documentation de référence de gcloud compute project-info describe.

Utiliser des VM

Les exemples suivants montrent des tâches courantes avec des instances de machines virtuelles (VM). Pour plus d'informations sur les instances de machine virtuelle (VM), consultez la page Instances de machines virtuelles.

Créer des VM

Exécutez la commande suivante pour créer une VM :

gcloud compute instances create VM_NAME \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    --image-project IMAGE_PROJECT

Remplacez l'élément suivant :

  • VM_NAME : nom de la nouvelle VM.
  • IMAGE ou IMAGE_FAMILY : spécifiez l'un des éléments suivants :
    • IMAGE : version requise d'une image publique. Exemple : --image debian-10-buster-v20200309.
    • IMAGE_FAMILY : famille d'images. Cette action crée la VM à partir de l'image de l'OS la plus récente et non obsolète. Par exemple, si vous spécifiez --image-family debian-10, Compute Engine crée une VM à partir de la dernière version de l'image de l'OS dans la famille d'images Debian 10.
  • IMAGE_PROJECT : projet contenant l'image.

Pour en savoir plus sur la création de VM, consultez la page Créer et démarrer une instance de VM, ainsi que la documentation de référence sur gcloud compute instances create.

Répertorier des VM

Exécutez la commande suivante pour afficher toutes les VM d'un projet :

gcloud compute instances list

Pour savoir comment répertorier les VM, consultez la documentation de référence sur gcloud compute instances list.

Répertorier des VM avec des GPU

Exécutez la commande suivante pour afficher toutes les VM avec des GPU dans un projet :

gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Répertorier les VM dotées de disques SSD locaux

Exécutez la commande suivante pour afficher toutes les VM avec des disques SSD locaux dans un projet :

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Décrire des VM

Exécutez la commande suivante pour afficher toutes les données associées à une VM :

gcloud compute instances describe VM_NAME

Remplacez VM_NAME par le nom de la VM.

Pour en savoir plus sur la description des VM, consultez la documentation de référence sur gcloud compute instances describe.

Démarrer des VM

Exécutez la commande suivante pour démarrer une VM arrêtée :

gcloud compute instances start VM_NAME

Remplacez VM_NAME par le nom de la VM.

Pour en savoir plus sur le démarrage des VM, consultez la page Démarrer et arrêter une instance ainsi que la documentation de référence sur gcloud compute instances start.

Arrêter des VM

Exécutez la commande suivante pour arrêter une VM :

gcloud compute instances stop VM_NAME

Remplacez VM_NAME par le nom de la VM.

Pour en savoir plus sur l'arrêt des VM, consultez la page Démarrer et arrêter une instance ainsi que la documentation de référence sur gcloud compute instances stop.

Ajouter des étiquettes à des VM

Exécutez la commande suivante pour ajouter des étiquettes aux VM :

gcloud compute instances add-labels VM_NAME \
    --labels=KEY=VALUE

Remplacez l'élément suivant :

  • VM_NAME : nom de la VM.
  • KEY=VALUE : paire clé/valeur de l'étiquette.

Pour en savoir plus sur l'ajout d'étiquettes aux VM, consultez la page Ajouter des étiquettes à des ressources et la documentation de référence sur gcloud compute instances add-labels.

Se connecter à des VM

Se connecter à une instance à l'aide de SSH

Exécutez la commande suivante pour vous connecter à une VM à l'aide de SSH :

gcloud compute ssh VM_NAME

Remplacez VM_NAME par le nom de la VM.

Pour en savoir plus sur la connexion aux VM à l'aide de SSH, consultez la section Se connecter à des VM Linux et la documentation de référence gcloud compute ssh.

Utiliser SCP pour transférer des fichiers vers des instances

Exécutez la commande suivante pour copier des fichiers sur une VM :

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

Exécutez la commande suivante pour copier des fichiers depuis une VM :

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

Remplacez l'élément suivant :

  • LOCAL_FILE_PATH : chemin d'accès au fichier sur votre poste de travail.
  • VM_NAME : nom de votre VM.
  • REMOTE_DIRECTORY : chemin d'accès au répertoire de votre VM.

Pour en savoir plus sur le transfert de fichiers vers et depuis des VM à l'aide de SCP, consultez la page Transférer des fichiers à l'aide de Google Cloud CLI ainsi que la documentation de référence de gcloud compute scp.

Utiliser des disques

L'exemple suivant illustre une tâche courante lors de l'utilisation de disques. Pour en savoir plus sur les disques, consultez la page Options de stockage.

Répertorier les disques

Exécutez la commande suivante pour afficher tous les disques d'un projet :

gcloud compute disks list

Pour savoir comment répertorier les disques, consultez la documentation de référence sur gcloud compute disks list.

Utiliser des instantanés

Les exemples suivants illustrent des tâches courantes lors de l'utilisation d'instantanés. Pour en savoir plus sur les instantanés, consultez la page Instantanés de disque persistant.

Répertorier les instantanés

Exécutez la commande suivante pour afficher tous les instantanés d'un projet :

gcloud compute snapshots list

Pour en savoir plus sur la description des instantanés, consultez la documentation de référence sur gcloud compute snapshots list.

Décrire des instantanés

Exécutez la commande suivante pour afficher toutes les données associées à un instantané :

gcloud compute snapshots describe SNAPSHOT_NAME

Remplacez SNAPSHOT_NAME par le nom de l'instantané.

Pour en savoir plus sur la description des instantanés, consultez la documentation de référence sur gcloud compute snapshots describe.

Suppression des instantanés

Exécutez la commande suivante pour supprimer un instantané :

gcloud compute snapshots delete SNAPSHOT_NAME

Remplacez SNAPSHOT_NAME par le nom de l'instantané.

Pour en savoir plus sur la suppression d'instantanés, consultez la page Supprimer un instantané et la documentation de référence de gcloud compute snapshots delete.

Utiliser des règles de pare-feu

Les exemples suivants illustrent des tâches courantes lorsque vous utilisez des règles de pare-feu. Pour plus d'informations sur les règles de pare-feu, consultez la page Présentation des règles de pare-feu VPC.

Décrire les règles de pare-feu

Exécutez la commande suivante pour afficher toutes les données associées à une règle de pare-feu :

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

Remplacez FIREWALL_RULE_NAME par le nom de la règle de pare-feu.

Pour en savoir plus sur la description des règles de pare-feu, consultez la documentation de référence sur gcloud compute firewall-rules describe.

Créer des règles de pare-feu

Exécutez la commande suivante pour créer une règle de pare-feu :

gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]

Spécifiez --allow ou --action et --rules, puis remplacez les éléments suivants :

  • FIREWALL_RULE_NAME : nom de la règle de pare-feu.
  • ACTION : action en cas de correspondance. allow ou deny.
  • PROTOCOL:PORT : protocole et port dont le trafic est affecté par la règle de pare-feu.

Pour en savoir plus sur la création de règles de pare-feu, consultez la section Créer des règles de pare-feu et la documentation de référence sur gcloud compute firewall-rules create.

Utiliser des groupes d'instances gérés (MIG)

Les exemples suivants illustrent des tâches courantes lors de l'utilisation de groupes d'instances gérés. Pour en savoir plus sur les MIG, consultez la page Groupes d'instances gérés (MIG).

Créer des groupes d'instances gérés

Exécutez la commande suivante pour créer un MIG :

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE

Remplacez l'élément suivant :

  • INSTANCE_GROUP_NAME : nom de ce groupe d'instances.
  • SIZE : taille du groupe d'instances.
  • INSTANCE_TEMPLATE : nom du modèle d'instance à utiliser pour ce groupe.

Pour en savoir plus sur la création des MIG, consultez la section Scénarios de base pour la création d'un MIG et la documentation de référence gcloud compute instance-groups managed create.

Configurer l'autoscaling

Exécutez la commande suivante pour définir l'autoscaling sur un groupe d'instances géré, en fonction de l'utilisation du processeur :

gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \
    --max-num-replicas=MAX_NUM_REPLICAS \
    --target-cpu-utilization=TARGET_CPU_UTILIZATION

Remplacez l'élément suivant :

  • INSTANCE_GROUP_NAME : nom d'un MIG
  • MAX_NUM_REPLICAS : nombre maximal d'instances dupliquées que l'autoscaler peut créer.
  • TARGET_CPU_UTILIZATION : niveau d'utilisation de processeur que l'autoscaler doit gérer, entre 0.0 et 1.0

Pour plus d'informations sur la configuration de l'autoscaling, consultez la page Autoscaling des groupes d'instances et la documentation de référence sur gcloud compute instance-groups managed set-autoscaling.

Utiliser des métadonnées

L'exemple suivant illustre une tâche courante lors de l'utilisation de métadonnées. Pour en savoir plus sur les métadonnées, consultez la section Stocker et récupérer des métadonnées.

Ajouter des métadonnées au niveau du projet

Exécutez la commande suivante pour ajouter des métadonnées à votre projet :

gcloud compute project-info add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Remplacez l'élément suivant :

  • VM_NAME : nom de la VM.
  • KEY=VALUE : paire clé/valeur de métadonnées

Pour en savoir plus sur l'ajout de métadonnées aux VM, consultez la section Définir des métadonnées personnalisées à l'échelle du projet, ainsi que la documentation de référence sur gcloud compute project-info add-metadata.

Ajouter des métadonnées au niveau de l'instance

Exécutez la commande suivante pour ajouter des métadonnées à une VM :

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Remplacez l'élément suivant :

  • VM_NAME : nom de la VM.
  • KEY=VALUE : paire clé/valeur de métadonnées

Pour en savoir plus sur l'ajout de métadonnées aux VM, consultez la section Définir des métadonnées d'instance et la documentation de référence sur gcloud compute instances add-metadata.

Obtenir des pages d'aide

Les commandes suivantes vous indiquent comment accéder à différents types d'aide, de l'aide générale sur l'outil gcloud compute à une aide spécifique concernant un groupe de ressources (instances) ou une commande (create). L'aide complète pour toutes les ressources et commandes suit le schéma suivant :

gcloud compute --help
gcloud compute instances --help
gcloud compute instances create --help

Vous pouvez obtenir une aide rapide en utilisant l'option -h au lieu de l'option --help. Vous pouvez également consulter l'aide complète dans la documentation de référence de Google Cloud CLI.

Pour obtenir une aide complète sur les commandes spécifiques à la configuration de gcloud CLI, exécutez la commande suivante :

gcloud topic TOPIC

Remplacez TOPIC par le sujet qui vous intéresse. Pour obtenir la liste des sujets pour lesquels vous pouvez obtenir de l'aide, consultez la documentation de référence de gcloud topic.

Étape suivante