Latenzen durch die Verwendung von Richtlinien für kompakte Platzierung reduzieren

In diesem Dokument wird beschrieben, wie Sie die Netzwerklatenz zwischen Ihren Compute Engine-Instanzen reduzieren, indem Sie Richtlinien für kompakte Platzierung erstellen und auf sie anwenden. Weitere Informationen zu Platzierungsrichtlinien, einschließlich der unterstützten Maschinenserien, Einschränkungen und Preise, finden Sie unter Platzierungsrichtlinien – Übersicht.

Eine Richtlinie für kompakte Platzierung gibt an, dass Ihre Instanzen physisch näher beieinander platziert werden sollen. Dies kann die Leistung verbessern und die Netzwerklatenz zwischen Ihren Instanzen reduzieren, wenn Sie beispielsweise HPC- (Hochleistungs-Computing), ML- (maschinelles Lernen) oder Datenbankserver-Arbeitslasten ausführen.

Hinweise

  • 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. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

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

    gcloud

    1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

      gcloud init

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    2. Set a default region and zone.

    REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, nutzen Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

      gcloud init

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Anwenden einer Richtlinie für kompakte Platzierung auf Compute-Instanzen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen und Anwenden einer Richtlinie für kompakte Platzierung auf Compute-Instanzen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um eine Richtlinie für kompakte Platzierung zu erstellen und auf Compute-Instanzen anzuwenden:

  • Zur Erstellung von Platzierungsrichtlinien: compute.resourcePolicies.create für das Projekt
  • So wenden Sie eine Platzierungsrichtlinie auf vorhandene Instanzen an: compute.instances.addResourcePolicies für das Projekt
  • So erstellen Sie Instanzen:
    • compute.instances.create für das Projekt
    • Zur Erstellung der VM mit einem benutzerdefinierten Image: compute.images.useReadOnly für das Image
    • Zur Erstellung der VM mithilfe eines Snapshots: compute.snapshots.useReadOnly für den Snapshot
    • Zur Erstellung der VM mithilfe einer Instanzvorlage: compute.instanceTemplates.useReadOnly für die Instanzvorlage
    • Um der VM ein Legacy-Netzwerk zuzuweisen: compute.networks.use für das Projekt
    • Zum Festlegen einer statische IP-Adresse für die VM: compute.addresses.use für das Projekt
    • Zur Zuweisung einer externen IP-Adresse zur VM bei Verwendung eines Legacy-Netzwerks: compute.networks.useExternalIp für das Projekt
    • Um ein Subnetz für die VM anzugeben: compute.subnetworks.use für das Projekt oder für das ausgewählte Subnetz
    • Um der VM eine externe IP-Adresse zuzuweisen, wenn Sie ein VPC-Netzwerk verwenden: compute.subnetworks.useExternalIp für das Projekt oder für das ausgewählte Subnetz
    • Um die Metadaten der VM-Instanz für die VM festzulegen: compute.instances.setMetadata für das Projekt
    • Um Tags für die VM festzulegen: compute.instances.setTags für die VM
    • Um Labels für die VM festzulegen: compute.instances.setLabels für die VM
    • Um ein Dienstkonto festzulegen, das die VM verwenden soll: compute.instances.setServiceAccount für die VM
    • Um ein neues Laufwerk für die VM zu erstellen: compute.disks.create für das Projekt
    • Um ein vorhandenes Laufwerk im Lese- oder Lese‑/Schreibmodus anzuhängen: compute.disks.use für das Laufwerk
    • Um ein vorhandenes Laufwerk im Lesemodus anzuhängen: compute.disks.useReadOnly für das Laufwerk
  • Um eine Reservierung zu erstellen: compute.reservations.create für das Projekt
  • Um eine Instanzvorlage zu erstellen: compute.instanceTemplates.create für das Projekt
  • Um eine verwaltete Instanzgruppe (MIG) zu erstellen: compute.instanceGroupManagers.create für das Projekt
  • So rufen Sie die Details einer Instanz auf: compute.instances.get für das Projekt

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

Kompakte Platzierungsrichtlinie erstellen

Bevor Sie eine Richtlinie für kompakte Platzierung erstellen, sollten Sie Folgendes berücksichtigen:

  • Wenn Sie eine Richtlinie für kompakte Platzierung auf eine Compute-Instanz anwenden möchten, die keine N2- oder N2D-Instanz ist, empfehlen wir, einen Wert für die maximale Entfernung anzugeben.

  • Sie können Richtlinien für kompakte Platzierung nur auf A4- oder A3-Ultra-Instanzen anwenden, die mit den von Cluster Director bereitgestellten Funktionen bereitgestellt werden. Weitere Informationen finden Sie unter Cluster Director in der AI Hypercomputer-Dokumentation.

  • Standardmäßig können Sie keine Richtlinien für kompakte Platzierung mit einem Wert für „max-distance“ auf A3-Mega-, A3-High- oder A3-Edge-Instanzen anwenden. Wenn Sie Zugriff auf diese Funktion anfordern möchten, wenden Sie sich an Ihren zugewiesenen Technical Account Manager (TAM) oder das Vertriebsteam.

Wählen Sie eine der folgenden Optionen aus, um eine Richtlinie für kompakte Platzierung zu erstellen:

gcloud

  • Wenn Sie die Richtlinie für kompakte Platzierung auf N2- oder N2D-Instanzen anwenden möchten, erstellen Sie die Richtlinie mit dem Befehl gcloud compute resource-policies create group-placement und dem Flag --collocation=collocated.

    gcloud compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --region=REGION

    Ersetzen Sie Folgendes:

    • POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.

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

  • Wenn Sie die Richtlinie für kompakte Platzierung auf andere unterstützte Instanzen anwenden möchten, erstellen Sie die Richtlinie mit dem Befehl gcloud beta compute resource-policies create group-placement und den Flags --collocation=collocated und --max-distance.

    gcloud beta compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --max-distance=MAX_DISTANCE \
    --region=REGION

    Ersetzen Sie Folgendes:

    • POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.

    • MAX_DISTANCE: die maximale Entfernung zwischen den Instanzen. Der Wert muss zwischen 1, was bedeutet, dass die Instanzen für eine möglichst geringe Netzwerklatenz im selben Rack platziert werden, und 3 liegen, was bedeutet, dass die Instanzen in benachbarten Clustern platziert werden sollen. Wenn Sie die Richtlinie für kompakte Platzierung auf eine Reservierung oder eine A4- oder A3-Ultra-Instanz anwenden möchten, können Sie keinen Wert von 1 angeben.

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

REST

  • Wenn Sie die Richtlinie für kompakte Platzierung auf N2- oder N2D-Instanzen anwenden möchten, erstellen Sie sie mit einer POST-Anfrage an die Methode resourcePolicies.insert. Fügen Sie im Anfragetext das Feld collocation ein und legen Sie es auf COLLOCATED fest.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  }
}

    Dabei gilt:

    • PROJECT_ID: die ID des Projekts, in dem Sie die Platzierungsrichtlinie erstellen möchten.

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

    • POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.

  • Wenn Sie die Richtlinie für kompakte Platzierung auf andere unterstützte Instanzen anwenden möchten, erstellen Sie sie mit einer POST-Anfrage an die Methode beta.resourcePolicies.insert. Geben Sie im Anfragetext Folgendes an:

    • Das Feld collocation ist auf COLLOCATED gesetzt.

    • Das Feld maxDistance.

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

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED",
    "maxDistance": MAX_DISTANCE
  }
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts, in dem Sie die Platzierungsrichtlinie erstellen möchten.

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

    • POLICY_NAME: der Name der Richtlinie für kompakte Platzierung.

    • MAX_DISTANCE: die maximale Entfernung zwischen den Instanzen. Der Wert muss zwischen 1, was bedeutet, dass die Instanzen für eine möglichst geringe Netzwerklatenz im selben Rack platziert werden, und 3 liegen, was bedeutet, dass die Instanzen in benachbarten Clustern platziert werden sollen. Wenn Sie die Richtlinie für kompakte Platzierung auf eine Reservierung oder eine A4- oder A3-Ultra-Instanz anwenden möchten, können Sie keinen Wert von 1 angeben.

Richtlinie für kompakte Platzierung anwenden

Sie können eine Richtlinie für kompakte Platzierung auf eine vorhandene Compute-Instanz oder verwaltete Instanzgruppe anwenden oder beim Erstellen von Instanzen, Instanzvorlagen, verwalteten Instanzgruppen oder Reservierungen von Instanzen.

Wählen Sie eine der folgenden Methoden aus, um eine Richtlinie für kompakte Platzierung auf eine Compute Engine-Ressource anzuwenden:

Nachdem Sie eine Richtlinie für kompakte Platzierung auf eine Instanz angewendet haben, können Sie den physischen Standort der Instanz in Bezug auf andere Instanzen prüfen, die dieselbe Platzierungsrichtlinie angeben.

Richtlinie auf eine vorhandene Instanz anwenden

Bevor Sie eine Richtlinie für kompakte Platzierung auf eine vorhandene Compute-Instanz anwenden, achten Sie auf Folgendes:

Andernfalls schlägt das Anwenden der Richtlinie für kompakte Platzierung auf die Instanz fehl. Wenn für die Instanz bereits eine Platzierungsrichtlinie angegeben ist und Sie diese ersetzen möchten, lesen Sie stattdessen den Abschnitt Platzierungsrichtlinie in einer Instanz ersetzen.

Wählen Sie eine der folgenden Optionen aus, um eine Richtlinie für kompakte Platzierung auf eine vorhandene Instanz anzuwenden:

gcloud

  1. Beenden Sie die Instanz.

  2. Verwenden Sie den Befehl gcloud compute instances add-resource-policies, um eine Richtlinie für kompakte Platzierung auf eine vorhandene Instanz anzuwenden.

    gcloud compute instances add-resource-policies INSTANCE_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

    Ersetzen Sie Folgendes:

    • INSTANCE_NAME: der Name einer vorhandenen Instanz.

    • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

    • ZONE: die Zone, in der sich die Instanz befindet.

  3. Starten Sie die Instanz neu.

REST

  1. Beenden Sie die Instanz.

  2. Senden Sie eine POST-Anfrage an die Methode instances.addResourcePolicies, um eine Richtlinie für kompakte Platzierung auf eine vorhandene Instanz anzuwenden.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID des Projekts, in dem sich die Richtlinie für kompakte Platzierung und die Instanz befinden.

    • ZONE: die Zone, in der sich die Instanz befindet.

    • INSTANCE_NAME: der Name einer vorhandenen Instanz.

    • REGION: die Region, in der sich die Richtlinie für kompakte Platzierung befindet.

    • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  3. Starten Sie die Instanz neu.

Richtlinie beim Erstellen einer Instanz anwenden

Sie können eine Compute-Instanz, die eine Richtlinie für kompakte Platzierung angibt, nur in der Region erstellen, in der sich die Platzierungsrichtlinie befindet.

Wählen Sie eine der folgenden Optionen aus, um eine Instanz zu erstellen, die eine Richtlinie für kompakte Platzierung angibt:

gcloud

Verwenden Sie zum Erstellen einer Instanz mit einer Richtlinie für kompakte Platzierung den Befehl gcloud compute instances create mit den Flags --maintenance-policy und --resource-policies.

gcloud compute instances create INSTANCE_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Name der zu erstellenden Instanz.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Instanz. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung einen Wert von 1 oder 2 für die maximale Entfernung verwendet oder der von Ihnen ausgewählte Maschinentyp keine Live-Migration unterstützt, können Sie nur TERMINATE angeben. Andernfalls können Sie MIGRATE oder TERMINATE angeben.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • ZONE: Die Zone, in der die Instanz erstellt werden soll.

REST

Wenn Sie eine Instanz mit einer Richtlinie für kompakte Platzierung erstellen möchten, senden Sie eine POST-Anfrage an die Methode instances.insert. Geben Sie im Anfragetext die Felder onHostMaintenance und resourcePolicies an.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Dabei gilt:

  • PROJECT_ID: die ID des Projekts, in dem sich die Richtlinie für kompakte Platzierung befindet.

  • ZONE: die Zone, in der die Instanz erstellt werden soll und in der sich der Maschinentyp befindet. Sie können nur eine Zone in der Region der Richtlinie für kompakte Platzierung angeben.

  • INSTANCE_NAME: Name der zu erstellenden Instanz.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • IMAGE_PROJECT: 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.

  • REGION: die Region, in der sich die Richtlinie für kompakte Platzierungen befindet.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Instanz. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung einen Wert von 1 oder 2 für die maximale Entfernung verwendet oder der von Ihnen ausgewählte Maschinentyp keine Live-Migration unterstützt, können Sie nur TERMINATE angeben. Andernfalls können Sie MIGRATE oder TERMINATE angeben.

Weitere Informationen zu den Konfigurationsoptionen zum Erstellen einer Instanz finden Sie unter Instanz erstellen und starten.

Richtlinie beim Erstellen von Instanzen im Bulk anwenden

Sie können Compute-Instanzen im Bulk mit Richtlinien für kompakte Platzierung nur in der Region erstellen, in der sich die Platzierungsrichtlinie befindet.

Wählen Sie eine der folgenden Optionen aus, um Instanzen im Bulk zu erstellen, die eine Richtlinie für kompakte Platzierung angeben:

gcloud

Wenn Sie Instanzen im Bulk erstellen möchten, die eine Richtlinie für kompakte Platzierung angeben, verwenden Sie den Befehl gcloud compute instances bulk create mit den Flags --maintenance-policy und --resource-policies.

Wenn Sie beispielsweise Instanzen im Bulk in einer einzelnen Zone erstellen und ein Namensmuster für die Instanzen angeben möchten, führen Sie den folgenden Befehl aus:

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • COUNT: die Anzahl der zu erstellenden Instanzen. Diese darf nicht höher sein als die maximal unterstützte Anzahl von Instanzen der angegebenen Richtlinie für kompakte Platzierung.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Instanz. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung einen Wert von 1 oder 2 für die maximale Entfernung verwendet oder der von Ihnen ausgewählte Maschinentyp keine Live-Migration unterstützt, können Sie nur TERMINATE angeben. Andernfalls können Sie MIGRATE oder TERMINATE angeben.

  • NAME_PATTERN ist das Namensmuster für die Instanzen. Wenn Sie eine Zahlenfolge in einem Instanznamen ersetzen möchten, verwenden Sie eine Folge von Hash-Zeichen (#). Wenn Sie z. B. vm-# für das Namensmuster verwenden, werden Instanzen mit Namen erstellt, die mit vm-1, vm-2 usw. beginnen und bis zur Anzahl der Instanzen fortgesetzt werden, die durch COUNT angegeben sind.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • ZONE: Die Zone, in der die Instanzen im Bulk erstellt werden sollen.

REST

Wenn Sie Instanzen im Bulk erstellen möchten, die eine Richtlinie für kompakte Platzierungen angeben, erstellen Sie eine POST-Anfrage an die Methode instances.bulkInsert. Geben Sie im Anfragetext die Felder onHostMaintenance und resourcePolicies an.

Wenn Sie beispielsweise Instanzen im Bulk in einer einzelnen Zone erstellen und ein Namensmuster für die Instanzen angeben möchten, stellen Sie eine POST-Anfrage wie hier beschrieben:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": "COUNT",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
    ],
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem sich die Richtlinie für kompakte Platzierung befindet.

  • ZONE: Die Zone, in der die Instanzen im Bulk erstellt werden sollen.

  • COUNT: die Anzahl der zu erstellenden Instanzen. Diese darf nicht höher sein als die maximal unterstützte Anzahl von Instanzen der angegebenen Richtlinie für kompakte Platzierung.

  • NAME_PATTERN ist das Namensmuster für die Instanzen. Wenn Sie eine Zahlenfolge in einem Instanznamen ersetzen möchten, verwenden Sie eine Folge von Hash-Zeichen (#). Wenn Sie z. B. vm-# für das Namensmuster verwenden, werden Instanzen mit Namen erstellt, die mit vm-1, vm-2 usw. beginnen und bis zur Anzahl der Instanzen fortgesetzt werden, die durch COUNT angegeben sind.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • IMAGE_PROJECT: 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.

  • REGION: die Region, in der sich die Richtlinie für kompakte Platzierungen befindet.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Instanz. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung einen Wert von 1 oder 2 für die maximale Entfernung verwendet oder der von Ihnen ausgewählte Maschinentyp keine Live-Migration unterstützt, können Sie nur TERMINATE angeben. Andernfalls können Sie MIGRATE oder TERMINATE angeben.

Weitere Informationen zu den Konfigurationsoptionen zum Erstellen von Instanzen im Bulk finden Sie unter Instanzen im Bulk erstellen.

Richtlinie beim Erstellen einer Reservierung anwenden

Wenn Sie eine On-Demand-Reservierung für ein einzelnes Projekt erstellen möchten, für die eine Richtlinie für kompakte Platzierungen festgelegt ist, müssen Sie eine Reservierung mit gezielter Ausrichtung erstellen. Beachten Sie beim Erstellen von Instanzen, die die Reservierung nutzen, Folgendes:

  • Für die Instanzen muss dieselbe Richtlinie für kompakte Platzierung angegeben werden, die auch auf die Reservierung angewendet wird.

  • Die Instanzen müssen speziell auf die Reservierung abzielen, um sie nutzen zu können. Weitere Informationen finden Sie unter Instanzen einer bestimmten Reservierung nutzen.

Wählen Sie eine der folgenden Methoden aus, um eine Reservierung für ein einzelnes Projekt mit einer Richtlinie für kompakte Platzierung zu erstellen:

Wenn Sie eine Reservierung für ein einzelnes Projekt mit einer Richtlinie für kompakte Platzierung erstellen möchten, indem Sie Attribute direkt angeben, wählen Sie eine der folgenden Optionen aus:

gcloud

Wenn Sie eine Reservierung für ein einzelnes Projekt mit einer Richtlinie für kompakte Platzierung erstellen möchten, indem Sie Attribute direkt angeben, verwenden Sie den Befehl gcloud compute reservations create mit den Flags --require-specific-reservation und --resource-policies=policy.

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --require-specific-reservation \
    --resource-policies=policy=POLICY_NAME \
    --vm-count=NUMBER_OF_INSTANCES \
    --zone=ZONE

Dabei gilt:

  • RESERVATION_NAME: der Name der Reservierung.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • NUMBER_OF_INSTANCES: die Anzahl der zu reservierenden Instanzen. Diese darf nicht höher sein als die maximal unterstützte Anzahl von Instanzen der angegebenen Richtlinie für kompakte Platzierung.

  • ZONE: die Zone, in der Instanzen reserviert werden sollen. Sie können Instanzen nur in einer Zone in der Region der angegebenen Richtlinie für kompakte Platzierung reservieren.

REST

Wenn Sie eine Reservierung für ein einzelnes Projekt mit einer Richtlinie für kompakte Platzierung erstellen möchten, indem Sie Attribute direkt angeben, senden Sie eine POST-Anfrage an die Methode reservations.insert. Geben Sie im Anfragetext das Feld resourcePolicies und das Feld specificReservationRequired an, das auf true gesetzt ist.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "resourcePolicies": {
    "policy" : "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  },
  "specificReservation": {
    "count": "NUMBER_OF_INSTANCES",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  },
  "specificReservationRequired": true
}

Dabei gilt:

  • PROJECT_ID: die ID des Projekts, in dem sich die Richtlinie für kompakte Platzierung befindet.

  • ZONE: die Zone, in der Instanzen reserviert werden sollen. Sie können Instanzen nur in einer Zone in der Region der angegebenen Richtlinie für kompakte Platzierung reservieren.

  • RESERVATION_NAME: der Name der Reservierung.

  • REGION: die Region, in der sich die Richtlinie für kompakte Platzierungen befindet.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • NUMBER_OF_INSTANCES: die Anzahl der zu reservierenden Instanzen. Diese darf nicht höher sein als die maximal unterstützte Anzahl von Instanzen der angegebenen Richtlinie für kompakte Platzierung.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

Weitere Informationen zu den Konfigurationsoptionen zum Erstellen von Reservierungen für einzelne Projekte finden Sie unter Reservierung für ein einzelnes Projekt erstellen.

Richtlinie beim Erstellen einer Instanzvorlage anwenden

Wenn Sie eine regionale Instanzvorlage erstellen möchten, müssen Sie die Vorlage in der Region erstellen, in der sich auch die Richtlinie für kompakte Platzierung befindet. Andernfalls schlägt das Erstellen der Instanzvorlage fehl.

Nachdem Sie eine Instanzvorlage erstellt haben, die eine Richtlinie für kompakte Platzierung angibt, können Sie mit der Vorlage Folgendes tun:

Wählen Sie eine der folgenden Optionen aus, um eine Instanzvorlage zu erstellen, die eine Richtlinie für kompakte Platzierung angibt:

gcloud

Verwenden Sie zum Erstellen einer Instanzvorlage, die eine Richtlinie für kompakte Platzierung angibt, den Befehl gcloud compute instance-templates create mit den Flags --maintenance-policy und --resource-policies.

Beispiel: Führen Sie folgenden Befehl aus, um eine globale Instanzvorlage zu erstellen, die eine Richtlinie für kompakte Platzierung angibt:

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME

Dabei gilt:

  • INSTANCE_TEMPLATE_NAME ist der Name der Instanzvorlage.

  • MACHINE_TYPE: ein unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Instanz. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung einen Wert von 1 oder 2 für die maximale Entfernung verwendet oder der von Ihnen ausgewählte Maschinentyp keine Live-Migration unterstützt, können Sie nur TERMINATE angeben. Andernfalls können Sie MIGRATE oder TERMINATE angeben.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

REST

Wenn Sie eine Instanzvorlage mit einer Richtlinie für kompakte Platzierung erstellen möchten, senden Sie eine POST-Anfrage an eine der folgenden Methoden:

Geben Sie im Anfragetext die Felder onHostMaintenance und resourcePolicies an.

Wenn Sie beispielsweise eine globale Instanzvorlage erstellen möchten, die eine Richtlinie für kompakte Platzierung angibt, stellen Sie eine POST-Anfrage wie hier beschrieben:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/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"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Dabei gilt:

  • PROJECT_ID: die ID des Projekts, in dem sich die Richtlinie für kompakte Platzierung befindet.

  • INSTANCE_TEMPLATE_NAME ist der Name der Instanzvorlage.

  • IMAGE_PROJECT: 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 unterstützter Maschinentyp für Richtlinien für kompakte Platzierung.

  • POLICY_NAME: der Name einer vorhandenen Richtlinie für kompakte Platzierung.

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Instanz. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung einen Wert von 1 oder 2 für die maximale Entfernung verwendet oder der von Ihnen ausgewählte Maschinentyp keine Live-Migration unterstützt, können Sie nur TERMINATE angeben. Andernfalls können Sie MIGRATE oder TERMINATE angeben.

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

Richtlinie auf Instanzen in einer verwalteten Instanzgruppe anwenden

Nachdem Sie eine Instanzvorlage erstellt haben, die eine Richtlinie für kompakte Platzierung angibt, können Sie mit der Vorlage Folgendes tun:

Richtlinie beim Erstellen einer verwalteten Instanzgruppe anwenden

Sie können Compute-Instanzen, die eine Richtlinie für kompakte Platzierung angeben, nur erstellen, wenn sich die Instanzen in derselben Region wie die Platzierungsrichtlinie befinden.

Wählen Sie eine der folgenden Optionen aus, um eine verwaltete Instanzgruppe mit einer Instanzvorlage zu erstellen, die eine Richtlinie für die kompakte Platzierung angibt:

gcloud

Verwenden Sie den Befehl gcloud compute instance-groups managed create, um eine verwaltete Instanzgruppe mit einer Instanzvorlage zu erstellen, die eine Richtlinie für die kompakte Platzierung angibt.

Beispiel: Führen Sie folgenden Befehl aus, um eine zonale verwaltete Instanzgruppe mit einer globalen Instanzvorlage zu erstellen, die eine Richtlinie für kompakte Platzierungen angibt:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

Dabei gilt:

  • INSTANCE_GROUP_NAME: Name der verwalteten Instanzgruppe, die erstellt werden soll.

  • SIZE: die Größe der verwalteten Instanzgruppe.

  • INSTANCE_TEMPLATE_NAME: Name einer vorhandenen globalen Instanzvorlage, die eine Richtlinie für kompakte Platzierung angibt.

  • ZONE: die Zone, in der die verwaltete Instanzgruppe erstellt werden soll. Sie muss sich in der Region befinden, in der sich die Richtlinie für kompakte Platzierung befindet.

REST

Wenn Sie eine verwaltete Instanzgruppe mit einer Instanzvorlage erstellen möchten, die eine Richtlinie für kompakte Platzierungen angibt, senden Sie eine POST-Anfrage an eine der folgenden Methoden:

Wenn Sie beispielsweise eine zonale verwaltete Instanzgruppe mit einer globalen Instanzvorlage erstellen möchten, die eine Richtlinie für kompakte Platzierung angibt, stellen Sie eine POST-Anfrage:

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

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": SIZE,
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    }
  ]
}

Dabei gilt:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem sich die Richtlinie für kompakte Platzierungen und die Instanzvorlage, die die Platzierungsrichtlinie angibt, befinden.

  • ZONE: die Zone, in der die verwaltete Instanzgruppe erstellt werden soll. Sie muss sich in der Region befinden, in der sich die Richtlinie für kompakte Platzierung befindet.

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

  • INSTANCE_TEMPLATE_NAME: Name einer vorhandenen globalen Instanzvorlage, die eine Richtlinie für kompakte Platzierung angibt.

  • SIZE: die Größe der verwalteten Instanzgruppe.

Weitere Informationen zu den Konfigurationsoptionen zum Erstellen von verwaltete Instanzgruppen finden Sie unter Grundlegende Szenarien zum Erstellen verwalteter Instanzgruppen.

Richtlinie auf eine vorhandene verwaltete Instanzgruppe anwenden

Sie können eine Richtlinie für kompakte Platzierung nur auf eine vorhandene verwaltete Instanzgruppe (MIG, Managed Instance Group) anwenden, wenn sich die verwaltete Instanzgruppe in derselben Region oder (bei zonalen verwalteten Instanzgruppen) in einer Zone innerhalb derselben Region wie die Platzierungsrichtlinie befindet.

Wählen Sie eine der folgenden Optionen aus, um eine verwaltete Instanzgruppe so zu aktualisieren, dass sie eine Instanzvorlage verwendet, die eine Richtlinie für kompakte Platzierung angibt:

gcloud

Verwenden Sie den Befehl gcloud compute instance-groups managed rolling-action start-update, um eine verwaltete Instanzgruppe so zu aktualisieren, dass sie eine Instanzvorlage nutzt, die eine Richtlinie für kompakte Platzierung angibt.

Wenn Sie beispielsweise eine zonale verwaltete Instanzgruppe so aktualisieren möchten, dass sie eine Instanzvorlage verwendet, die eine Richtlinie für kompakte Platzierung angibt, und die vorhandenen Instanzen aus der verwalteten Instanzgruppe durch neue Instanzen ersetzen möchten, die die Attribute der Vorlage angeben, führen Sie den folgenden Befehl aus:

gcloud compute instance-groups managed rolling-action start-update MIG_NAME \
    --version=template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • MIG_NAME: der Name einer vorhandenen verwalteten Instanzgruppe.

  • INSTANCE_TEMPLATE_NAME: Name einer vorhandenen globalen Instanzvorlage, die eine Richtlinie für kompakte Platzierung angibt.

  • ZONE: Die Zone, in der sich die MIG befindet. Sie können die Richtlinie für kompakte Platzierung nur auf eine verwaltete Instanzgruppe anwenden, die sich in derselben Region wie die Platzierungsrichtlinie befindet.

REST

Wenn Sie eine MIG so aktualisieren möchten, dass eine Instanzvorlage verwendet wird, die eine Richtlinie für kompakte Platzierung angibt, und Sie die Attribute der Vorlage und der Platzierungsrichtlinie automatisch auf vorhandene Instanzen in der MIG anwenden möchten, senden Sie eine PATCH-Anfrage an eine der folgenden Methoden:

Wenn Sie beispielsweise eine zonale verwaltete Instanzgruppe so aktualisieren möchten, dass sie eine globale Instanzvorlage verwendet, die eine Richtlinie für kompakte Platzierung angibt, und die vorhandenen Instanzen aus der verwalteten Instanzgruppe durch neue Instanzen ersetzen möchten, die die Attribute der Vorlage angeben, stellen Sie die folgende Anfrage PATCH:

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem sich die verwaltete Instanzgruppe, die Richtlinie für kompakte Platzierungen und die Instanzvorlage, die die Platzierungsrichtlinie angibt, befinden.

  • ZONE: Die Zone, in der sich die MIG befindet. Sie können die Richtlinie für kompakte Platzierung nur auf eine verwaltete Instanzgruppe anwenden, die sich in derselben Region wie die Platzierungsrichtlinie befindet.

  • MIG_NAME: der Name einer vorhandenen verwalteten Instanzgruppe.

  • INSTANCE_TEMPLATE_NAME: Name einer vorhandenen globalen Instanzvorlage, die eine Richtlinie für kompakte Platzierung angibt.

Weitere Informationen zu den Konfigurationsoptionen zum Aktualisieren der Instanzen in einer MIG finden Sie unter Neue Konfigurationen auf Instanzen in einer MIG aktualisieren und anwenden.

Physischen Standort einer Instanz prüfen

Nachdem Sie eine Richtlinie für kompakte Platzierung auf eine Compute-Instanz angewendet haben, können Sie den physischen Standort der Instanz in Bezug auf andere Instanzen ansehen. Dieser Vergleich ist auf Instanzen in Ihrem Projekt beschränkt, für die dieselbe Richtlinie für kompakte Platzierungen angegeben ist. Wenn Sie den physischen Standort einer Instanz kennen, können Sie Folgendes tun:

  • Prüfen Sie, ob die Richtlinie erfolgreich angewendet wurde.

  • Ermitteln Sie, welche Instanzen einander am nächsten sind.

Wenn Sie den physischen Standort einer Instanz in Bezug auf andere Instanzen ansehen möchten, die dieselbe Richtlinie für kompakte Platzierung angeben, wählen Sie eine der folgenden Optionen aus:

gcloud

Verwenden Sie den Befehl gcloud compute instances describe mit dem Flag --format, um den physischen Standort einer Instanz aufzurufen, die eine Richtlinie für kompakte Platzierung angibt.

gcloud compute instances describe INSTANCE_NAME \
    --format="table[box,title=VM-Position](resourcePolicies.scope():sort=1,resourceStatus.physicalHost:label=location)" \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: Der Name einer vorhandenen Instanz, die eine Richtlinie für kompakte Platzierung angibt.

  • ZONE: die Zone, in der sich die Instanz befindet.

Die Ausgabe sieht etwa so aus:

VM-Position

RESOURCE_POLICIES: us-central1/resourcePolicies/example-policy']
PHYSICAL_HOST: /CCCCCCC/BBBBBB/AAAA

Der Wert für das Feld PHYSICAL_HOST besteht aus drei Teilen. Diese Teile stellen jeweils den Cluster, Rack und Host dar, auf dem sich die Instanz befindet.

Beim Vergleich der Position von zwei Instanzen, die dieselbe Richtlinie für kompakte Platzierungen in Ihrem Projekt verwenden, gilt: Je mehr Teile des Felds PHYSICAL_HOST die Instanzen gemeinsam nutzen, desto näher befinden sie sich. Beispiel: Zwei Instanzen geben für das Feld PHYSICAL_HOST einen der folgenden Beispielwerte an:

  • /CCCCCCC/xxxxxx/xxxx: Die beiden Instanzen werden im selben Cluster platziert, was einer maximalen Entfernung von 2 entspricht. Instanzen, die im selben Cluster platziert sind, haben eine geringe Netzwerklatenz.

  • /CCCCCCC/BBBBBB/xxxx: Die beiden Instanzen werden im selben Rack platziert, was einer maximalen Entfernung von 1 entspricht. Instanzen, die im selben Rack platziert sind, haben eine geringere Netzwerklatenz als Instanzen, die im selben Cluster platziert sind.

  • /CCCCCCC/BBBBBB/AAAA: Die beiden Instanzen verwenden denselben Host. Instanzen, die auf demselben Host platziert sind, minimieren die Netzwerklatenz so weit wie möglich.

REST

Führen Sie eine GET-Anfrage an die Methode instances.get aus, um den physischen Standort einer Instanz aufzurufen, die eine Richtlinie für kompakte Platzierungen angibt.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Ersetzen Sie Folgendes:

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

  • ZONE: die Zone, in der sich die Instanz befindet.

  • INSTANCE_NAME: Der Name einer vorhandenen Instanz, die eine Richtlinie für kompakte Platzierung angibt.

Die Ausgabe sieht etwa so aus:

{
  ...
  "resourcePolicies": [
    "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy"
  ],
  "resourceStatus": {
    "physicalHost": "/xxxxxxxx/xxxxxx/xxxxx"
  },
  ...
}

Der Wert für das Feld physicalHost besteht aus drei Teilen. Diese Teile stellen jeweils den Cluster, Rack und Host dar, auf dem sich die Instanz befindet.

Beim Vergleich der Position von zwei Instanzen, die dieselbe Richtlinie für kompakte Platzierungen in Ihrem Projekt verwenden, gilt: Je mehr Teile des Felds physicalHost die Instanzen gemeinsam nutzen, desto näher befinden sie sich. Beispiel: Zwei Instanzen geben für das Feld physicalHost einen der folgenden Beispielwerte an:

  • /CCCCCCC/xxxxxx/xxxx: Die beiden Instanzen werden im selben Cluster platziert, was einer maximalen Entfernung von 2 entspricht. Instanzen, die im selben Cluster platziert sind, haben eine geringe Netzwerklatenz.

  • /CCCCCCC/BBBBBB/xxxx: Die beiden Instanzen werden im selben Rack platziert, was einer maximalen Entfernung von 1 entspricht. Instanzen, die im selben Rack platziert sind, haben eine geringere Netzwerklatenz als Instanzen, die im selben Cluster platziert sind.

  • /CCCCCCC/BBBBBB/AAAA: Die beiden Instanzen verwenden denselben Host. Instanzen, die auf demselben Host platziert sind, minimieren die Netzwerklatenz so weit wie möglich.

Nächste Schritte