Anfragen zur Größenanpassung in einer MIG erstellen

In diesem Dokument wird beschrieben, wie Sie Anfragen zur Größenänderung in einer verwalteten Instanzgruppe (Managed Instance Group, MIG) von VM-Instanzen mit angehängten GPUs erstellen.

Hinweise

  • Lesen Sie Funktionsweise von Anfragen zur Größenänderung.
  • Prüfen Sie Ihr GPU-Kontingent, damit Ihr Kontingent für die angeforderten Ressourcen ausreicht.
  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen für das Projekt die IAM-Rolle Compute Instance Admin (Version 1) (roles/compute.instanceAdmin.v1) zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Anfragen zur Größenanpassung in einer MIG benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von Anfragen zur Größenanpassung in einer MIG erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Anfragen zur Größenänderung in einer MIG zu erstellen:

  • Zum erstellen einer Instanzvorlage: compute.instanceTemplates.create für das Projekt
  • Zum Erstellen einer zonale MIG: compute.instanceGroupManagers.create für das Projekt
  • Zum Erstellen von Anfragen zur Größenanpassung in einer MIG: compute.instanceGroupManagers.update für das Projekt

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

MIG für Anfragen zur Größenänderung vorbereiten

Zum Erstellen von Anfragen zur Größenänderung in einer MIG müssen Sie eine Instanzvorlage und die MIG konfigurieren, wie in den folgenden Abschnitten beschrieben.

Instanzvorlage erstellen

Wenn Sie Anfragen zur Größenanpassung in einer MIG erstellen möchten, muss die MIG eine Instanzvorlage mit den folgenden Konfigurationen verwenden:

Console

So erstellen Sie eine Instanzvorlage, die zum Erstellen von Größenanfragen in einer MIG konfiguriert ist:

  1. Rufen Sie in der Google Cloud Console die Seite Instanzvorlagen auf.

    Zu Instanzvorlagen

  2. Klicken Sie auf Instanzvorlage erstellen.

  3. Geben Sie im Feld Name einen Namen für die Instanzvorlage ein.

  4. Wählen Sie im Bereich Standort eine der folgenden Optionen aus:

    • Zum Erstellen einer globalen Instanzvorlage wählen Sie Global (Standardeinstellung) aus.

    • Um eine regionale Instanzvorlage zu erstellen, wählen Sie Regional und dann die Region aus, in der Sie die Instanzvorlage erstellen möchten.

  5. Führen Sie im Abschnitt Maschinenkonfiguration die folgenden Schritte aus:

    1. Klicken Sie auf den Tab GPUs.

    2. Wählen Sie im Menü GPU-Typ den GPU-Typ.

    3. Wählen Sie in der Liste Anzahl der GPUs die Anzahl der GPUs aus.

    4. Optional: Wenn Ihr GPU-Modell NVIDIA RTX Virtual Workstations (vWS) für Grafikarbeitslasten unterstützt und Sie grafikintensive Arbeitslasten ausführen möchten, wählen Sie Virtuelle aktivieren Workstation (NVIDIA GRID).

    5. Wählen Sie im Abschnitt Maschinentyp einen Maschinentyp aus.

  6. Klicken Sie im Abschnitt Bootlaufwerk auf Ändern, um den Standardwert für den Bootlaufwerktyp oder das Image zu ändern. Folgen Sie dann den Aufforderungen, um das Bootlaufwerk zu ändern.

  7. Maximieren Sie den Abschnitt Erweiterte Optionen und gehen Sie dann so vor:

    1. Maximieren Sie den Bereich Verwaltung.

    2. Wählen Sie im Menü Reservierungen die Option Nicht verwenden aus.

  8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie zum Erstellen einer Instanzvorlage, die zum Erstellen von Größenanfragen in einer MIG konfiguriert ist, den Befehl instance-templates create mit den folgenden Flags:

  • Das Flag --maintenance-policy, das auf TERMINATE gesetzt ist.

  • Das Flag --reservation-affinity, das auf none gesetzt ist.

Verwenden Sie zum Beispiel den folgenden Befehl:

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --reservation-affinity=none

Ersetzen Sie Folgendes:

  • INSTANCE_TEMPLATE_NAME ist der Name der zu erstellenden Instanzvorlage.

  • IMAGE_PROJECT ist das Image-Projekt, das das Image enthält; Beispiel: debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

  • Für IMAGE oder IMAGE_FAMILY muss eine der folgenden Optionen angegeben werden:

    • IMAGE ist eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-10-buster-v20200309.

    • IMAGE_FAMILY ist eine Image-Familie. Damit wird das neueste nicht verworfene Betriebssystem-Image angegeben. Wenn Sie beispielsweise debian-10 angeben, wird die neueste Version in der Debian 10-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

  • MACHINE_TYPE ist ein Maschinentyp, der GPUs unterstützt. Wenn Sie einen N1-Maschinentyp angeben, fügen Sie das Flag --accelerator ein, um die Anzahl und den Typ der GPUs anzugeben, die an Ihre VMs angehängt werden sollen.

REST

Zum Erstellen einer Instanzvorlage, die zum Erstellen von Größenanfragen in einer MIG konfiguriert ist, senden Sie eine POST-Anfrage an die Methode instanceTemplates.insert. Gehen Sie im Anfragetext so vor:

  • Setzen Sie das Feld scheduling.onHostMaintenance auf TERMINATE.

  • Setzen Sie das Feld reservationAffinity.consumeReservationType auf NO_RESERVATION.

Stellen Sie beispielsweise eine POST-Anfrage:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "mode": "READ_WRITE",
        "type": "PERSISTENT",
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ],
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "onHostMaintenance": "TERMINATE"
    }
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID ist die ID des Projekts, in dem die Instanzvorlage erstellt werden soll.

  • INSTANCE_TEMPLATE_NAME ist der Name der zu erstellenden Instanzvorlage.

  • IMAGE_PROJECT ist das Image-Projekt, das das Image enthält; Beispiel: debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

  • Für IMAGE oder IMAGE_FAMILY muss eine der folgenden Optionen angegeben werden:

    • IMAGE ist eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-10-buster-v20200309.

    • IMAGE_FAMILY ist eine Image-Familie. Damit wird das neueste nicht verworfene Betriebssystem-Image angegeben. Wenn Sie beispielsweise debian-10 angeben, wird die neueste Version in der Debian 10-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

  • MACHINE_TYPE ist ein Maschinentyp, der GPUs unterstützt. Wenn Sie einen N1-Maschinentyp angeben, fügen Sie das Feld guestAccelerators in den Anfragetext ein, um die Anzahl und den Typ der GPUs anzugeben, die an Ihre VMs angehängt werden sollen.

Weitere Informationen zum Erstellen einer Instanzvorlage finden Sie unter Instanzvorlagen erstellen.

MIG erstellen oder aktualisieren

Nachdem Sie die Instanzvorlage wie im vorherigen Abschnitt beschrieben erstellt haben, verwenden Sie diese Instanzvorlage, um eine MIG zu erstellen oder eine MIG zu aktualisieren. Damit die MIG alle VMs über Anfragen zur Größenänderung erstellt, legen Sie die Größe der MIG auf 0 fest. Außerdem müssen Sie Folgendes tun, um die MIG auf Anfragen zur Größenänderung vorzubereiten:

Console

So erstellen Sie eine zonale MIG, die zum Erstellen von Größenanfragen konfiguriert ist:

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen

  2. Klicken Sie auf Instanzgruppe erstellen.

    Die Seite Instanzgruppe erstellen wird geöffnet.

  3. Geben Sie im Feld Name einen Namen für die MIG ein.

  4. Wählen Sie im Menü Instanzvorlage die Instanzvorlage aus, die Sie im vorherigen Abschnitt erstellt haben. Wenn Sie eine regionale Instanzvorlage auswählen, wird die Liste Region auf die Region der Instanzvorlage festgelegt.

  5. Das Feld Anzahl der Instanzen ist standardmäßig deaktiviert. Nachdem Sie das Autoscaling in den nächsten Schritten gelöscht haben, geben Sie 0 ein.

  6. Führen Sie im Abschnitt Standort folgende Schritte aus:

    1. Wählen Sie Einzelne Zone (Standardeinstellung) aus.

    2. Wählen Sie die Region und Zone der MIG aus.

  7. Klicken Sie im Menü Autoscaling-Modus auf Autoscaling-Konfiguration löschen und dann auf Löschen.

  8. Wählen Sie im Menü Standardaktion bei Fehler die Option Keine Aktion aus.

  9. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie zum Erstellen einer zonalen MIG, die für das Erstellen von Größenanfragen konfiguriert ist, den Befehl beta instance-groups managed create, wobei das Flag --default-action-on-vm-failure auf do_nothing gesetzt ist.

gcloud beta compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE_NAME \
    --size=0 \
    --zone=ZONE \
    --default-action-on-vm-failure=do_nothing

Ersetzen Sie Folgendes:

  • INSTANCE_GROUP_NAME: Name der MIG, die erstellt werden soll.

  • INSTANCE_TEMPLATE_NAME ist der Name der Instanzvorlage, die Sie im vorherigen Abschnitt erstellt haben.

  • ZONE ist die Zone, in der die VM erstellt werden soll.

REST

Zum Erstellen einer zonalen MIG, die zum Erstellen von Größenanfragen konfiguriert ist, senden Sie eine POST-Anfrage an die Methode beta.instanceGroupManagers.insert. Geben Sie im Anfragetext das Feld defaultActionOnFailure an, das auf DO_NOTHING gesetzt ist.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers

{
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    }
  ],
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": 0,
  "instanceLifecyclePolicy": {
    "defaultActionOnFailure": "DO_NOTHING"
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID ist die ID des Projekts, in dem sich die im vorherigen Abschnitt erstellte Instanzvorlage befindet.

  • ZONE ist die Zone, in der die VM erstellt werden soll.

  • INSTANCE_TEMPLATE_NAME ist der Name der Instanzvorlage, die Sie im vorherigen Abschnitt erstellt haben.

  • INSTANCE_GROUP_NAME: Name der MIG, die erstellt werden soll.

Anfrage zur Größenänderung in einer MIG erstellen

Bevor Sie Anfragen zur Größenänderung erstellen, müssen Sie die MIG wie im vorherigen Abschnitt beschrieben vorbereitet haben.

Nachdem Sie eine Anfrage zur Größenanpassung erstellt haben und alle angeforderten Ressourcen verfügbar sind, erstellt die MIG die angeforderte Anzahl von VMs auf einmal. Die VMs werden ausgeführt, bis die MIG sie nach Ablauf der angegebenen Ausführungsdauer löscht oder bis Sie sie löschen.

gcloud

Verwenden Sie zum Erstellen einer Anfrage zur Größenanpassung in einer MIG den Befehl beta instance-groups managed resize-requests create.

gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --resize-by=COUNT \
    --requested-run-duration=RUN_DURATION \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_GROUP_NAME ist der Name einer vorhandenen zonalen MIG, die zum Erstellen von Anfragen zur Größenanpassung darin konfiguriert ist.

  • RESIZE_REQUEST_NAME ist der Name der Anfrage zur Größenänderung, der innerhalb der angegebenen MIG eindeutig sein muss. Andernfalls schlägt das Erstellen der Anfrage zur Größenänderung fehl.

  • COUNTist die Anzahl der VMs, die gleichzeitig zur MIG hinzugefügt werden sollen.

  • RUN_DURATION ist die Dauer, nach der die angeforderten VMs ausgeführt werden sollen, bevor die MIG sie automatisch löscht. Der Wert muss als Anzahl der Tage, Stunden, Minuten oder Sekunden gefolgt von d, h, m oder s formatiert werden. Geben Sie beispielsweise 30m für 30 Minuten oder 1d2h3m4s für 1 Tag, 2 Stunden, 3 Minuten und 4 Sekunden an. Der Wert muss zwischen 10 Minuten und 7 Tagen liegen.

  • ZONE: Die Zone, in der sich die MIG befindet.

REST

Um eine Anfrage zur Größenänderung in einer MIG zu erstellen, senden Sie eine POST-Anfrage an die Methode beta.instanceGroupManagerResizeRequests.insert.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests

{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT,
  "requestedRunDuration": {
    "seconds": "RUN_DURATION"
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID ist die ID des Projekts, in dem sich die angegebene MIG befindet.

  • ZONE: Die Zone, in der sich die MIG befindet.

  • INSTANCE_GROUP_NAME ist der Name einer vorhandenen zonalen MIG, die zum Erstellen von Anfragen zur Größenanpassung darin konfiguriert ist.

  • RESIZE_REQUEST_NAME ist der Name der Anfrage zur Größenänderung, der innerhalb der angegebenen MIG eindeutig sein muss. Andernfalls schlägt das Erstellen der Anfrage zur Größenänderung fehl.

  • COUNT ist die Anzahl der VMs, die alle gleichzeitig zur MIG hinzugefügt werden sollen.

  • RUN_DURATION ist die Dauer in Sekunden, in der die angeforderten VMs ausgeführt werden sollen, bevor die MIG sie automatisch löscht. Der Wert muss zwischen 600, d. h. 600 Sekunden (10 Minuten) und 604800, also 604.800 Sekunden (7 Tage) liegen.

Nächste Schritte