VM starten und anhalten

In diesem Dokument wird erläutert, wie Sie eine VM-Instanz (virtuelle Maschine) in Google Distributed Cloud (GDC) mit Air Gap starten, beenden und neu starten.

Sie können VMs beenden, starten und neu starten, um den Lebenszyklus Ihrer Anwendungen zu unterstützen. Beispielsweise können Sie die Anzahl der zugewiesenen virtuellen zentralen Verarbeitungseinheiten (vCPUs) oder die Größe des Arbeitsspeichers ändern, der einer VM zugewiesen ist. Sie müssen die VM beenden, bevor Sie die Konfiguration bearbeiten. Danach müssen Sie den Leistungsstatus aktivieren, um die Änderungen zu übernehmen.

Dieses Dokument richtet sich an Entwickler in Plattformadministrator- oder Anwendungsoperatorgruppen, die VM-Instanzen in einer Distributed Cloud-Umgebung starten, beenden und neu starten müssen. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

Hinweis

Wenn Sie gdcloud Befehlszeilenschnittstellenbefehle (CLI) verwenden möchten, müssen Sie die gdcloud CLI heruntergeladen, installiert und konfiguriert haben. Alle Befehle für Distributed Cloud verwenden die gdcloud- oder kubectl-CLI und erfordern eine Betriebssystemumgebung.

Pfad der kubeconfig-Datei abrufen

Wenn Sie Befehle für den Management API-Server ausführen möchten, benötigen Sie die folgenden Ressourcen:

  1. Melden Sie sich an und generieren Sie die kubeconfig-Datei für den Management API-Server, falls Sie noch keine haben.

  2. Ersetzen Sie in dieser Anleitung MANAGEMENT_API_SERVER durch den Pfad zur kubeconfig-Datei des Management API-Servers.

Wenn Sie die Startzeit Ihrer VM minimieren möchten, folgen Sie der Anleitung unter VM-Startzeit minimieren , bevor Sie Ihre VM starten.

IAM-Rollen anfordern

Wenden Sie sich an Ihren Projekt-IAM-Administrator, um die folgenden Rollen für Ihr Projekt anzufordern:

  • Virtual Machine Project Admin (project-vm-admin): VMs im Projekt-Namespace erstellen, ändern, auflisten und löschen.

  • Projektbetrachter(project-viewer): Alle Ressourcen in den Projekt-Namespaces ansehen.

Alle VM-Rollen müssen an den Namespace des Projekts gebunden sein, in dem sich die VM befindet. Folgen Sie der Anleitung, um Ihren Zugriff zu überprüfen.

VM beenden

Wenn Sie eine VM beenden, hebt der Hypervisor die Zuweisung aller Ressourcen auf, die mit der Instanz verknüpft sind. Die VM wird heruntergefahren.

Beenden Sie eine VM, die ausgeführt wird, mit der GDC Console oder kubectl.

Console

  1. Klicken Sie im Navigationsmenü auf Virtual Machines > Instances.

  2. Wählen Sie in der Liste der VMs das Kästchen für die laufende VM aus, die Sie beenden möchten.

  3. Klicken Sie auf Beenden.

  4. Klicken Sie im Bestätigungsdialogfeld auf Beenden.

gdcloud

So beenden Sie eine VM:

gdcloud compute instances stop VM_NAME \
  --project PROJECT
  • Ersetzen Sie VM_NAME durch den Namen der VM.
  • Ersetzen Sie PROJECT durch den Namen des GDC-Projekts, in dem sich die VM befindet.

kubectl

  1. Führen Sie dazu diesen Befehl aus:

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

  2. Suchen Sie im spec der VM nach dem Feld runningState und ändern Sie den Wert des Felds in Stopped. Wenn runningState nicht im spec enthalten ist, fügen Sie runningState zum spec hinzu und legen Sie den Wert auf Stopped fest.

    spec:
   runningState: Stopped

  3. Prüfen Sie den Status der VM:

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

    Verwenden Sie diese Definitionen für die vorherigen Variablen.

    VariableDefinition
    MANAGEMENT_API_SERVER_KUBECONFIGDie kubeconfig-Datei des Management API-Servers.
    VM_NAMEDer Name der VM.
    PROJECTDer Projektname der VM.

VM starten

Starten Sie eine VM aus dem Status „Beendet“ mit der Console oder kubectl.

Console

  1. Klicken Sie im Navigationsmenü auf Virtual Machines > Instances.

  2. Wählen Sie in der Liste der VMs das Kästchen für die beendete VM aus, die Sie starten möchten.

  3. Klicken Sie auf Start.

  4. Klicken Sie im Bestätigungsdialogfeld auf Start.

gdcloud

So starten Sie eine VM:

gdcloud compute instances start VM_NAME --project PROJECT
  • Ersetzen Sie VM_NAME durch den Namen der VM.
  • Ersetzen Sie PROJECT durch den Namen des GDC-Projekts, in dem sich die VM befindet.

kubectl

  1. Führen Sie dazu diesen Befehl aus:

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

  2. Suchen Sie im spec der VM nach dem Feld runningState und ändern Sie den Wert des Felds in Running.

    spec:
   runningState: Running

  3. Prüfen Sie den Status der VM:

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

    Verwenden Sie diese Definitionen für die Variablen im Beispielcode.

    VariableDefinition
    MANAGEMENT_API_SERVER_KUBECONFIGDie kubeconfig-Datei des Management API-Servers.
    MANAGEMENT_API_SERVER_NAMEDer Name des Management API-Servers.
    VM_NAMEDer Name der VM.
    PROJECTDer Projektname der VM.

VM neu starten

Wenn Sie eine VM neu starten, wird die Maschine auf ihren Ausgangszustand zurückgesetzt und der Speicherinhalt der Maschine wird gelöscht.

Starten Sie eine VM, die ausgeführt wird, mit der Console oder kubectl neu.

Console

  1. Klicken Sie im Navigationsmenü auf Virtual Machines > Instances.

  2. Wählen Sie in der Liste der VMs das Kästchen für die laufende VM aus, die Sie neu starten möchten.

  3. Klicken Sie auf Zurücksetzen.

  4. Klicken Sie im Bestätigungsdialogfeld auf Zurücksetzen.

gdcloud

So setzen Sie eine VM zurück:

gdcloud compute instances reset VM_NAME --project PROJECT
  • Ersetzen Sie VM_NAME durch den Namen der VM.
  • Ersetzen Sie PROJECT durch den Namen des GDC-Projekts, in dem sich die VM befindet.

kubectl

  1. Rufen Sie das Clientzertifikat und die Schlüsseldaten sowie den Management API-Server ab. Verwenden Sie diese Werte in den folgenden Schritten:

    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. Senden Sie eine API-Anfrage, um die VM mit dem Befehl wget neu zu starten, und geben Sie das Zertifikat und den Schlüssel aus dem vorherigen Schritt an:

    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. Prüfen Sie den Status der VM:

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

    Verwenden Sie diese Definitionen für die Variablen im Beispielcode.

    VariableDefinition
    MANAGEMENT_API_SERVER_KUBECONFIGDie kubeconfig-Datei des Management API-Servers.
    MANAGEMENT_API_SERVER_NAMEDer Name des Management API-Servers.
    VM_NAMEDer Name der VM.
    PROJECTDer Projektname der VM.