Anfragen zur Größenanpassung in einer MIG erstellen

Console

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

   Zu Instanzvorlagen

2. Klicken Sie auf Instanzvorlage erstellen. Die Seite Instanzvorlage erstellen wird geöffnet.

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:

   • Wenn Sie eine regionale Instanzvorlage erstellen möchten, wählen Sie Regional (empfohlen) und dann die Region aus, in der Sie die Vorlage erstellen möchten.

   • Wenn Sie eine globale Instanzvorlage erstellen möchten, wählen Sie Global aus.

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

   1. Klicken Sie auf den Tab GPUs.

   2. Wählen Sie in der Liste GPU-Typ einen GPU-Typ aus.

   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 Workstation (NVIDIA GRID) aktivieren aus.

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

6. Führen Sie im Abschnitt Bereitstellungsmodell die folgenden Schritte aus:

   1. Wählen Sie in der Liste VM-Bereitstellungsmodell die Option Flex-Start aus.

   2. Wenn Sie eine Laufzeit für die über die Instanzvorlage erstellten VMs festlegen möchten, geben Sie im Feld Anzahl der Stunden eingeben die Anzahl der Stunden ein. Der Wert muss zwischen einer Stunde (1) und sieben Tagen (168) liegen.

7. Optional: 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.

8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie zum Erstellen einer Instanzvorlage, die zum Erstellen von Größenanfragen für verwaltete Instanzgruppen konfiguriert ist, den Befehl beta instance-templates create mit den folgenden Flags:

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

• Das Flag --instance-termination-action, das auf DELETE gesetzt ist.

• Das Flag --max-run-duration.

• Das Flag --provisioning-model, das auf FLEX_START gesetzt ist.

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

Mit dem folgenden Befehl wird eine regionale Instanzvorlage erstellt. Wenn Sie eine globale Instanzvorlage erstellen möchten, verwenden Sie denselben Befehl ohne das Flag --instance-template-region.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-termination-action=DELETE \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --max-run-duration=RUN_DURATION \
    --provisioning-model=FLEX_START \
    --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, z. B. debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

• IMAGE_FAMILY ist eine Image-Familie. Diese gibt das neueste nicht verworfene Betriebssystem-Image an. Beispiel: Wenn Sie debian-12 angeben, wird die aktuelle Version in der Debian 12-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

• REGION: Region, in der die Instanzvorlage erstellt werden soll.

• MACHINE_TYPE: ein GPU-Maschinentyp. 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.

• RUN_DURATION ist die Dauer, für die die angeforderten VMs ausgeführt werden sollen. Der Wert muss als Anzahl von Tagen, Stunden, Minuten oder Sekunden gefolgt von d, h, m bzw. s formatiert werden. Geben Sie beispielsweise 30m für 30 Minuten oder 1d2h3m4s für einen Tag, zwei Stunden, drei Minuten und vier Sekunden an. Der Wert muss zwischen 10 Minuten und 7 Tagen liegen.

REST

Wenn Sie eine Instanzvorlage erstellen möchten, die zum Erstellen von Größenanfragen in einer verwalteten Instanzgruppe konfiguriert ist, senden Sie eine POST-Anfrage an eine der folgenden Methoden:

• Um eine regionale Instanzvorlage zu erstellen: beta.regionInstanceTemplates.insert-Methode

• Um eine globale Instanzvorlage zu erstellen: beta.instanceTemplates.insert-Methode

Geben Sie im Anfragetext die folgenden Felder an:

• Das Feld scheduling.onHostMaintenance ist auf TERMINATE gesetzt.

• Das Feld scheduling.instanceTerminationAction ist auf DELETE gesetzt.

• Das Feld scheduling.maxRunDuration.

• Das Feld scheduling.provisioningModel ist auf FLEX_START gesetzt.

• Das Feld reservationAffinity.consumeReservationType ist auf NO_RESERVATION gesetzt.

So erstellen Sie beispielsweise eine regionale Instanzvorlage und senden eine POST-Anfrage:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "NO_RESERVATION"
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "maxRunDuration": {
        "seconds": RUN_DURATION
      },
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "FLEX_START"
    }
  }
}

Ersetzen Sie Folgendes:

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

• REGION: Region, in der 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, z. B. debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

• IMAGE: Wählen Sie eine der folgenden Optionen aus:

  • Eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-12-bookworm-v20240617.

  • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Diese gibt das neueste nicht verworfene Betriebssystem-Image an. Beispiel: Wenn Sie family/debian-12 angeben, wird die aktuelle Version in der Debian 12-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

• MACHINE_TYPE: ein GPU-Maschinentyp. 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.

• RUN_DURATION ist die Dauer in Sekunden, für die die angeforderten VMs ausgeführt werden sollen. Der Wert muss zwischen 600, d. h. 600 Sekunden (10 Minuten) und 604800, also 604.800 Sekunden (7 Tage) liegen.

Console

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. Bevor Sie eine Instanzvorlage auswählen, müssen Sie die Autoscaling-Konfiguration löschen und Reparaturen so deaktivieren:

   1. So löschen Sie die Autoscaling-Konfiguration:

      1. Klicken Sie im Abschnitt Autoscaling auf die Liste Autoscaling-Modus und dann auf Autoscaling-Konfiguration löschen.

      2. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

   2. Wenn Sie Reparaturen deaktivieren möchten, klicken Sie im Abschnitt Lebenszyklus von VM-Instanzen auf die Liste Standardaktion bei Fehler und wählen Sie dann Keine Aktion aus.

5. Kehren Sie zum Feld Instanzvorlage zurück. Wählen Sie in der Liste 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 Vorlage festgelegt.

6. Führen Sie einen der folgenden Schritte aus:

   • So erstellen Sie beim Erstellen der MIG eine Anfrage zur Größenänderung:

     1. Geben Sie im Feld Anzahl der Instanzen die Anzahl der VMs ein, die Sie auf einmal erstellen möchten.

     2. Klicken Sie das Kästchen Anfrage zur Größenanpassung verwenden, um VMs auf einmal zu erstellen an.

     3. Optional: Wenn Sie für die VMs eine andere Laufzeit als in der Instanzvorlage festgelegt angeben möchten, geben Sie im Feld Angeforderte Laufzeit und in den Listen Einheit eine Laufzeit an. Die Dauer muss zwischen einer Stunde und sieben Tagen liegen.

   • Wenn Sie nach dem Erstellen der MIG eine Anfrage zur Größenänderung erstellen möchten, geben Sie im Feld Anzahl der Instanzen die Zahl 0 ein.

7. Geben Sie im Abschnitt Standort an, ob Sie eine zonale oder eine regionale MIG erstellen möchten:

   1. Wenn Sie eine zonale MIG erstellen möchten, wählen Sie Einzelne Zone aus. Wenn Sie eine regionale MIG erstellen möchten, wählen Sie Mehrere Zonen aus.

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

   3. Wenn Sie eine regionale MIG erstellen, gehen Sie so vor:

      1. Wählen Sie im Feld Zielverteilungsform die Option Beliebige einzelne Zone aus.

      2. Klicken Sie im angezeigten Dialogfeld auf Instanzredistribution deaktivieren.

8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie den Befehl instance-groups managed create, wobei das Flag --default-action-on-vm-failure auf do_nothing gesetzt ist. Wenn Sie eine regionale MIG erstellen, müssen Sie außerdem das Flag --target-distribution-shape auf any-single-zone und das Flag --instance-redistribution-type auf none setzen.

• Führen Sie den folgenden Befehl aus, um eine zonale verwaltete Instanzgruppe zu erstellen:

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

• Führen Sie den folgenden Befehl aus, um eine regionale verwaltete Instanzgruppe zu erstellen:

  gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
      --template=INSTANCE_TEMPLATE_URL \
      --size=0 \
      --region=REGION \
      --target-distribution-shape=any-single-zone \
      --instance-redistribution-type=none \
      --default-action-on-vm-failure=do_nothing
  

Ersetzen Sie Folgendes:

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

• INSTANCE_TEMPLATE_URL: Die teilweise URL der Instanzvorlage, die Sie im vorherigen Abschnitt erstellt haben. Wenn Sie eine regionale Instanzvorlage zum Erstellen der MIG verwenden möchten, können Sie die MIG nur in der Region der Vorlage erstellen. Geben Sie einen der folgenden Werte an:

  • Für eine regionale Instanzvorlage: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • Für eine globale Instanzvorlage: INSTANCE_TEMPLATE_NAME

• ZONE: die Zone, in der die verwaltete Instanzgruppe erstellt werden soll.

• REGION: die Region, in der die verwaltete Instanzgruppe erstellt werden soll.

REST

• So erstellen Sie eine zonale MIG: Senden Sie eine POST-Anfrage mit der Methode instanceGroupManagers.insert:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
  
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": 0,
    "instanceLifecyclePolicy": {
      "defaultActionOnFailure": "DO_NOTHING"
    }
  }
  

• So erstellen Sie eine regionale MIG: Senden Sie eine POST-Anfrage mit der regionInstanceGroupManagers.insert-Methode:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers
  
  {
    "versions": [
      {
        "instanceTemplate": "INSTANCE_TEMPLATE_URL"
      }
    ],
    "name": "INSTANCE_GROUP_NAME",
    "targetSize": 0,
    "distributionPolicy": {
      "targetShape": "ANY_SINGLE_ZONE"
    },
    "updatePolicy": {
      "instanceRedistributionType": "NONE"
    },
    "instanceLifecyclePolicy": {
      "defaultActionOnFailure": "DO_NOTHING"
    }
  }
  

Ersetzen Sie Folgendes:

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

• INSTANCE_TEMPLATE_URL: Die teilweise URL der Instanzvorlage, die Sie im vorherigen Abschnitt erstellt haben. Wenn Sie eine regionale Instanzvorlage zum Erstellen der MIG verwenden möchten, können Sie die MIG nur in der Region der Vorlage erstellen. Geben Sie einen der folgenden Werte an:

  • Für eine regionale Instanzvorlage: regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • Für eine globale Instanzvorlage: global/instanceTemplates/INSTANCE_TEMPLATE_NAME

• ZONE: die Zone, in der die verwaltete Instanzgruppe erstellt werden soll.

• REGION: die Region, in der die verwaltete Instanzgruppe erstellt werden soll.

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

Console

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

   Zu den Instanzgruppen

2. Klicken Sie in der Spalte Name auf den Namen der MIG, in der die Anfrage zur Größenanpassung erstellt werden soll.

   Die Übersichtsseite der MIG wird geöffnet.

3. Klicken Sie in der Zeile Anfrage zur Größenanpassung auf edit Anfragen zur Größenanpassung bearbeiten.

4. Klicken Sie auf add Neue Anfrage zur Größenanpassung.

   Der Bereich Neue Anfragen zur Größenanpassung wird angezeigt.

5. Geben Sie im Feld Name den Namen der Anfrage ein.

6. Geben Sie im Feld Anzahl erforderlicher zusätzlicher Instanzen die Anzahl der VMs ein, die der MIG gleichzeitig hinzugefügt werden sollen.

7. Optional: Wenn Sie für die VMs eine andere Ausführungsdauer als in der Instanzvorlage festgelegt angeben möchten, geben Sie in den Feldern Angeforderte Ausführungsdauer und Einheit eine Dauer an. Die Dauer muss zwischen einer Stunde und sieben Tagen liegen.

8. Klicken Sie auf Erstellen.

gcloud

• Verwenden Sie den Befehl instance-groups managed resize-requests create, um eine Anfrage zur Größenänderung in einer zonalen MIG zu erstellen.

  gcloud compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
      --resize-request=RESIZE_REQUEST_NAME \
      --resize-by=COUNT \
      --zone=ZONE
  

• Verwenden Sie den Befehl beta instance-groups managed resize-requests create, um eine Anfrage zur Größenanpassung in einer regionalen MIG zu erstellen.

  gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \
      --resize-request=RESIZE_REQUEST_NAME \
      --resize-by=COUNT \
      --region=REGION
  

Ersetzen Sie Folgendes:

• INSTANCE_GROUP_NAME ist der Name der 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 gleichzeitig zur MIG hinzugefügt werden sollen.

• ZONE: die Zone, in der sich die verwaltete Instanzgruppe befindet.

• REGION: Die Region, in der sich die MIG befindet.

Optional können Sie Folgendes tun:

• Wenn Sie für die VMs eine andere Laufzeit als die in der Instanzvorlage der MIG festgelegte angeben möchten, fügen Sie das Flag --requested-run-duration ein.

• Wenn für Ihre Arbeitslast bestimmte VM-Namen erforderlich sind, können Sie mit dem Befehl beta instance-groups managed resize-requests create eine Liste der Namen der zu erstellenden VMs angeben. Ersetzen Sie im Befehl das Flag --resize-request durch das Flag --instances.

REST

• Wenn Sie eine Anfrage zur Größenänderung in einer zonalen MIG erstellen möchten, senden Sie eine POST-Anfrage mithilfe der Methode instanceGroupManagerResizeRequests.insert.

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

• Wenn Sie eine Anfrage zur Größenänderung in einer regionalen MIG erstellen möchten, senden Sie eine POST-Anfrage mit der Methode beta.regionInstanceGroupManagerResizeRequests.insert.

Geben Sie im Anfragetext Folgendes an:

{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT
}

Ersetzen Sie Folgendes:

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

• ZONE: die Zone, in der sich die verwaltete Instanzgruppe befindet.

• REGION: Die Region, in der sich die MIG befindet.

• INSTANCE_GROUP_NAME ist der Name der 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 gleichzeitig zur MIG hinzugefügt werden sollen.

Optional können Sie Folgendes tun:

• Wenn Sie für die VMs eine andere Laufzeit als die in der Instanzvorlage der MIG festgelegte angeben möchten, fügen Sie das Feld requestedRunDuration in den Anfragetext ein.

• Wenn für Ihre Arbeitslast bestimmte VM-Namen erforderlich sind, können Sie eine Liste der Namen der zu erstellenden VMs angeben. Senden Sie dazu eine POST-Anfrage an die Methode beta.regionInstanceGroupManagerResizeRequests.insert für eine regionale MIG oder an die Methode beta.instanceGroupManagerResizeRequests.insert für eine zonale MIG. Ersetzen Sie im Anfragetext das Feld resizeBy durch das Feld instanceNames.