Démarrer et arrêter une VM

Vous pouvez arrêter, démarrer et redémarrer des VM pour prendre en charge le cycle de vie de vos applications. Par exemple, vous pouvez modifier le nombre de processeurs virtuels (vCPU) attribués ou la quantité de mémoire allouée à une VM. Vous devez arrêter la VM avant de modifier la configuration. Une fois que vous avez terminé, vous devez arrêter l'état d'alimentation pour appliquer les modifications. Cette page explique comment arrêter, démarrer et redémarrer vos VM lors de ces processus.

Avant de commencer

Pour utiliser les commandes de l'interface de ligne de commande (CLI) gdcloud, assurez-vous d'avoir téléchargé, installé et configuré la CLI gdcloud. Toutes les commandes pour Distributed Cloud utilisent la CLI gdcloud ou kubectl et nécessitent un environnement de système d'exploitation (OS).

Obtenir le chemin d'accès au fichier kubeconfig

Pour exécuter des commandes sur le serveur de l'API Management, assurez-vous de disposer des ressources suivantes :

  1. Connectez-vous et générez le fichier kubeconfig pour le serveur d'API Management si vous n'en avez pas.

  2. Utilisez le chemin d'accès au fichier kubeconfig du serveur de l'API Management pour remplacer MANAGEMENT_API_SERVER dans ces instructions.

Si vous souhaitez réduire au minimum le temps de démarrage de votre VM, suivez les instructions de la section Réduire le temps de démarrage de la VM avant de démarrer votre VM.

Demander des autorisations et un accès

Pour effectuer les tâches listées sur cette page, vous devez disposer du rôle Administrateur VirtualMachine du projet. Suivez les étapes pour valider ou demandez à votre administrateur IAM de projet de vous attribuer le rôle Administrateur VirtualMachine du projet (project-vm-admin) dans l'espace de noms du projet dans lequel réside la VM.

Pour les opérations sur les VM à l'aide de la console GDC ou de la CLI gdcloud, demandez à votre administrateur IAM de projet de vous attribuer le rôle Administrateur de machines virtuelles du projet et le rôle Lecteur du projet (project-viewer).

Arrêter une VM

Lorsque vous arrêtez une machine virtuelle (VM), l'hyperviseur libère toutes les ressources associées à l'instance. La VM est arrêtée.

Arrêtez une VM en cours d'exécution à l'aide de la console GDC ou de kubectl.

Console

  1. Dans le menu de navigation, cliquez sur Machines virtuelles > Instances.

  2. Dans la liste des VM, cochez la case correspondant à la VM en cours d'exécution que vous souhaitez arrêter.

  3. Cliquez sur Arrêter.

  4. Dans la boîte de dialogue de confirmation, cliquez sur Arrêter.

gdcloud

Pour arrêter une VM, procédez comme suit :

gdcloud compute instances stop VM_NAME --project PROJECT
  • Remplacez VM_NAME par le nom de la VM.
  • Remplacez PROJECT par le nom du projet GDC dans lequel se trouve la VM.

kubectl

  1. Exécutez la commande suivante :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   edit virtualmachines.virtualmachine.gdc.goog VM_NAME \
   -n PROJECT

  2. Recherchez le champ runningState dans le spec de la VM et remplacez sa valeur par Stopped. Si runningState ne figure pas dans spec, ajoutez runningState à spec et définissez la valeur sur Stopped. 

    spec:
   runningState: Stopped

  3. Vérifiez l'état de la VM :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   get virtualmachines.virtualmachine.gdc.goog VM_NAME \
   -n PROJECT

    Utilisez ces définitions pour les variables précédentes.

    VariableDéfinition
    MANAGEMENT_API_SERVER_KUBECONFIGFichier kubeconfig du serveur de l'API Management.
    VM_NAMENom de la VM.
    PROJECTNom du projet de la VM.

Démarrer une VM

Démarrez une VM à partir d'un état arrêté à l'aide de la console ou de kubectl.

Console

  1. Dans le menu de navigation, cliquez sur Machines virtuelles > Instances.

  2. Dans la liste des VM, cochez la case correspondant à la VM arrêtée que vous souhaitez démarrer.

  3. Cliquez sur Démarrer.

  4. Dans la boîte de dialogue de confirmation, cliquez sur Démarrer.

gdcloud

Pour démarrer une VM :

gdcloud compute instances start VM_NAME --project PROJECT
  • Remplacez VM_NAME par le nom de la VM.
  • Remplacez PROJECT par le nom du projet GDC dans lequel se trouve la VM.

kubectl

  1. Exécutez la commande suivante :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \ 
   edit virtualmachines.virtualmachine.gdc.goog VM_NAME \ 
   -n PROJECT

  2. Recherchez le champ runningState dans le spec de la VM et remplacez sa valeur par Running.

    spec:
   runningState: Running

  3. Vérifiez l'état de la VM :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   get virtualmachines.virtualmachine.gdc.goog VM_NAME \
   -n PROJECT

    Utilisez ces définitions pour les variables dans l'exemple de code.

    VariableDéfinition
    MANAGEMENT_API_SERVER_KUBECONFIGFichier kubeconfig du serveur de l'API Management.
    MANAGEMENT_API_SERVER_NAMENom du serveur de l'API Management.
    NAMESPACEEspace de noms de la VM.
    VM_NAMENom de la VM.
    PROJECTNom du projet de la VM.

Redémarrer une VM

Lorsque vous redémarrez une VM, la machine est réinitialisée à son état initial et le contenu de la mémoire est effacé.

Redémarrez une VM en cours d'exécution à l'aide de la console ou de kubectl.

Console

  1. Dans le menu de navigation, cliquez sur Machines virtuelles > Instances.

  2. Dans la liste des VM, cochez la case correspondant à la VM en cours d'exécution que vous souhaitez redémarrer.

  3. Cliquez sur Réinitialiser.

  4. Dans la boîte de dialogue de confirmation, cliquez sur Réinitialiser.

gdcloud

Pour réinitialiser une VM :

gdcloud compute instances reset VM_NAME --project PROJECT
  • Remplacez VM_NAME par le nom de la VM.
  • Remplacez PROJECT par le nom du projet GDC dans lequel se trouve la VM.

kubectl

  1. Obtenez les données du certificat et de la clé client, ainsi que le serveur de l'API Management. Utilisez ces valeurs dans les étapes suivantes :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG config view --raw -o \
   jsonpath='{.users[?(@.name =="MANAGEMENT_API_SERVER_NAME-admin")].user.client-certificate-data}' | \
   base64 -d > cert
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG config view --raw -o \
   jsonpath='{.users[?(@.name == "MANAGEMENT_API_SERVER_NAME-admin")].user.client-key-data}' | \
   base64 -d > key
export APISERVER=`kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   config view --raw -o \
   jsonpath='{.clusters[?(@.name == "MANAGEMENT_API_SERVER_NAME")].cluster.server}'`

  2. Envoyez une requête d'API pour redémarrer la VM à l'aide de la commande wget et spécifiez le certificat et la clé de l'étape précédente :

    wget --method=PUT -O- --no-check-certificate --certificate cert --private-key key --content-on-error=on $APISERVER/apis/virtualmachineoperations.gdc.goog/v1/namespaces/PROJECT/virtualmachines/VM_NAME/restart

  3. Vérifiez l'état de la VM :

    kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG \
   get virtualmachines.virtualmachine.gdc.goog VM_NAME -n PROJECT

    Utilisez ces définitions pour les variables dans l'exemple de code.

    VariableDéfinition
    MANAGEMENT_API_SERVER_KUBECONFIGFichier kubeconfig du serveur de l'API Management.
    MANAGEMENT_API_SERVER_NAMENom du serveur de l'API Management.
    NAMESPACEEspace de noms de la VM.
    VM_NAMENom de la VM.
    PROJECTNom du projet de la VM.