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.

In einer Richtlinie für kompakte Platzierung ist angegeben, dass Ihre Compute-Instanzen räumlich näher beieinander platziert werden sollen. Dies kann die Leistung verbessern und die Netzwerklatenz zwischen Ihren Compute-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:

    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. 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, verwenden 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 das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Erstellen und Anwenden einer Richtlinie für kompakte Platzierung auf Compute-Instanzen haben:

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. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

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

  • Zum Erstellen von Platzierungsrichtlinien: compute.resourcePolicies.create für das Projekt
  • So wenden Sie eine Platzierungsrichtlinie auf vorhandene Compute-Instanzen an: compute.instances.addResourcePolicies für das Projekt
  • So erstellen Sie Compute-Instanzen:
    • compute.instances.create für das Projekt
    • Zum Erstellen der VM mit einem benutzerdefinierten Image: compute.images.useReadOnly für das Image
    • Zum Erstellen der VM mit einem Snapshot: compute.snapshots.useReadOnly für den Snapshot
    • Zum Erstellen der VM mit einer Instanzvorlage: compute.instanceTemplates.useReadOnly für die Instanzvorlage
    • Zum Zuweisen eines Legacy-Netzwerks zur VM: compute.networks.use für das Projekt
    • Zum Festlegen einer statische IP-Adresse für die VM: compute.addresses.use für das Projekt
    • Zum Zuweisen einer externen IP-Adresse zur VM bei Verwendung eines Legacy-Netzwerks: compute.networks.useExternalIp für das Projekt
    • Zum Angeben eines Subnetzes für die VM: compute.subnetworks.use für das Projekt oder für das ausgewählte Subnetz
    • Zum Zuweisen einer externen IP-Adresse zur VM, wenn Sie ein VPC-Netzwerk verwenden: compute.subnetworks.useExternalIp für das Projekt oder für das ausgewählte Subnetz
    • Zum Festlegen von Metadaten der VM-Instanz für die VM: compute.instances.setMetadata für das Projekt
    • Zum Festlegen von Tags für die VM: compute.instances.setTags für die VM
    • Zum Festlegen von Labels für die VM: compute.instances.setLabels für die VM
    • Zum Festlegen eines Dienstkontos, das die VM verwenden soll: compute.instances.setServiceAccount für die VM
    • Zum Erstellen eines neuen Laufwerks für die VM: compute.disks.create für das Projekt
    • Zum Anhängen eines vorhandenen Laufwerks im Lese- oder Lese-/Schreibmodus: 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
  • Zum Erstellen einer verwalteten Instanzgruppe (MIG): compute.instanceGroupManagers.create für das Projekt
  • So rufen Sie die Details einer Compute-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

Beachten Sie vor dem Erstellen einer Richtlinie für kompakte Platzierung Folgendes:

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

  • Wenn Sie eine Richtlinie für kompakte Platzierung auf eine A3 Mega-, A3 High- oder A3 Edge-Instanz anwenden möchten, die vor dem 1. Oktober 2025 erstellt wurde, wenden Sie sich an Ihr Account-Team.

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 M3-, M2-, M1-, N2D- oder N2-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 Compute-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 Compute-Instanzen. Der Wert muss zwischen 1, was bedeutet, dass die Compute-Instanzen für eine möglichst geringe Netzwerklatenz im selben Rack platziert werden, und 3 liegen, was bedeutet, dass die Compute-Instanzen in benachbarten Clustern platziert werden sollen.

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

REST

  • Wenn Sie die Richtlinie für kompakte Platzierung auf M3-, M2-, M1-, N2D- oder N2-Instanzen anwenden möchten, erstellen Sie die Richtlinie 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 Compute-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 Compute-Instanzen. Der Wert muss zwischen 1, was bedeutet, dass die Compute-Instanzen für eine möglichst geringe Netzwerklatenz im selben Rack platziert werden, und 3 liegen, was bedeutet, dass die Compute-Instanzen in benachbarten Clustern platziert werden sollen.

Richtlinie für kompakte Platzierung anwenden

Sie können eine Richtlinie für kompakte Platzierung auf eine vorhandene Compute-Instanz oder verwaltete Instanzgruppe (MIG) anwenden oder beim Erstellen von Compute-Instanzen, Instanzvorlagen, MIGs oder Reservierungen von Compute-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 Compute-Instanz fehl. Wenn für die Compute-Instanz bereits eine Platzierungsrichtlinie angegeben ist und Sie diese ersetzen möchten, lesen Sie stattdessen den Abschnitt Platzierungsrichtlinie in einer Compute-Instanz ersetzen.

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

gcloud

  1. Beenden Sie die Compute-Instanz.

  2. Verwenden Sie den Befehl gcloud compute instances add-resource-policies, um eine Richtlinie für kompakte Platzierung auf eine vorhandene Compute-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 Compute-Instanz.

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

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

  3. Starten Sie die Instanz neu.

REST

  1. Beenden Sie die Compute-Instanz.

  2. Senden Sie eine POST-Anfrage an die Methode instances.addResourcePolicies, um eine Richtlinie für kompakte Platzierung auf eine vorhandene Compute-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 Compute-Instanz befinden.

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

    • INSTANCE_NAME: der Name einer vorhandenen Compute-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 Compute-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 Compute-Instanz zu erstellen, die eine Richtlinie für kompakte Platzierung angibt:

gcloud

Verwenden Sie zum Erstellen einer Compute-Instanz, die eine Richtlinie für kompakte Platzierung angibt, 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: Der Name der Compute-Instanz, die erstellt werden soll.

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

  • MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der Compute-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 Compute-Instanz erstellt werden soll.

REST

Wenn Sie eine Compute-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 Compute-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: Der Name der Compute-Instanz, die erstellt werden soll.

  • 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: Geben Sie eine der folgenden Optionen an:

    • Eine bestimmte Version des Betriebssystem-Images, z. B. debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Dieser Wert 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 Compute-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 Compute-Instanz finden Sie unter Compute-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 mehrere Compute-Instanzen auf einmal zu erstellen, die eine Richtlinie für kompakte Platzierung angeben:

gcloud

Wenn Sie Compute-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 Compute-Instanzen im Bulk in einer einzelnen Zone erstellen und ein Namensmuster für die Compute-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 Compute-Instanzen. Diese darf nicht höher sein als die maximal unterstützte Anzahl von Compute-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 Compute-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: das Namensmuster für die Compute-Instanzen. Wenn Sie eine Zahlenfolge in einem Namen einer Compute-Instanz ersetzen möchten, verwenden Sie eine Folge von Hash-Zeichen (#). Wenn Sie z. B. vm-# für das Namensmuster verwenden, werden Instanzen mit Namen erzeugt, die mit vm-1, vm-2 usw. beginnen, bis die Anzahl der in COUNT angegebenen Compute-Instanzen erreicht ist.

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

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

REST

Wenn Sie Compute-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 Compute-Instanzen im Bulk in einer einzelnen Zone erstellen und ein Namensmuster für die Compute-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 Compute-Instanzen im Bulk erstellt werden sollen.

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

  • NAME_PATTERN: das Namensmuster für die Compute-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 Compute-Instanzen mit Namen erzeugt, die mit vm-1, vm-2 usw. beginnen, bis die Anzahl der in COUNT angegebenen Compute-Instanzen erreicht ist.

  • 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: Geben Sie eine der folgenden Optionen an:

    • Eine bestimmte Version des Betriebssystem-Images, z. B. debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Dieser Wert 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 Compute-Instanzen im Bulk finden Sie unter Compute-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 Compute-Instanzen, die die Reservierung nutzen, Folgendes:

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

  • Die Compute-Instanzen müssen speziell auf die Reservierung abzielen, um sie nutzen zu können. Weitere Informationen finden Sie unter Compute-Instanzen aus 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:

Console

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

    Zu „Reservierungen“

  2. Klicken Sie auf Reservierung erstellen. Die Seite Reservierung erstellen wird angezeigt.

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

  4. Wählen Sie in den Listen Region und Zone die Region und Zone aus, in der Sie Ressourcen reservieren möchten.

  5. Wählen Sie im Abschnitt Mit VM-Instanz verwenden die Option Spezifische Reservierung auswählen aus.

  6. Führen Sie im Abschnitt VM-Instanzen und GPUs die folgenden Schritte aus:

    1. Geben Sie im Feld Anzahl der VM-Instanzen die Anzahl der zu reservierenden VMs ein.

    2. Geben Sie eine Maschinenserie und einen Maschinentyp an, die Richtlinien für kompakte Platzierung unterstützen.

  7. Klicken Sie im Bereich Richtlinie für die Gruppenplatzierung auf die Liste Richtlinie für die Gruppenplatzierung auswählen oder erstellen und führen Sie einen der folgenden Schritte aus:

    • So erstellen Sie eine Richtlinie für kompakte Platzierung:

      1. Klicken Sie auf Gruppenplatzierungsrichtlinie erstellen. Der Bereich Gruppenplatzierungsrichtlinie erstellen wird angezeigt.

      2. Geben Sie im Feld Richtlinienname einen Namen für die Richtlinie ein.

      3. Klicken Sie auf Erstellen.

    • Wenn Sie eine vorhandene Richtlinie für kompakte Platzierung auswählen möchten, wählen Sie eine Richtlinie aus, die sich in derselben Region befindet, in der Sie Instanzen reservieren möchten.

  8. Klicken Sie zum Erstellen der Reservierung auf Erstellen.

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 Compute-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 Compute-Instanzen reserviert werden sollen. Sie können Compute-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 Compute-Instanzen reserviert werden sollen. Sie können Compute-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 Compute-Instanzen. Diese darf nicht höher sein als die unterstützte maximale Anzahl von Compute-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 sich die Vorlage und die Richtlinie für kompakte Platzierung in derselben Region befinden. 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:

Verwenden Sie eine der folgenden Methoden, um eine Instanzvorlage zu erstellen, die eine Richtlinie für kompakte Platzierung angibt:

  • Verwenden Sie die Google Cloud console, um eine regionale Instanzvorlage mit einer neuen Richtlinie für kompakte Platzierung zu erstellen. In der neuen Richtlinie ist kein maximaler Abstand festgelegt. Sie können sie auf maximal 22 Instanzen anwenden.

  • Verwenden Sie die gcloud CLI oder die REST API, um eine globale oder regionale Instanzvorlage zu erstellen, die eine vorhandene Richtlinie für kompakte Platzierung angibt.

Wählen Sie eine der folgenden Optionen aus, um die Instanzvorlage zu 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 angezeigt.

  3. Geben Sie im Feld Region die Region an, in der Sie die Richtlinie für kompakte Platzierung und die Instanzvorlage erstellen möchten.

  4. Geben Sie im Abschnitt Maschinenkonfiguration eine unterstützte Maschinenserie und einen unterstützten Maschinentyp für Richtlinien für kompakte Platzierung an.

  5. Wählen Sie im Bereich Richtlinie für die Platzierung in der Liste Richtlinie für die Platzierung die Option Kompakt aus. Wenn Sie diese Option auswählen, generiert dieGoogle Cloud -Konsole automatisch eine Richtlinie für kompakte Platzierungen ohne Wert für die maximale Entfernung, die bis zu 22 Instanzen unterstützt.

  6. Klicken Sie auf Erstellen.

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. 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: Geben Sie eine der folgenden Optionen an:

    • Eine bestimmte Version des Betriebssystem-Images, z. B. debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Dieser Wert 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. 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 Compute-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.

Wenn Sie beispielsweise eine zonale verwaltete Instanzgruppe mit einer globalen Instanzvorlage erstellen möchten, die eine Richtlinie für kompakte Platzierung angibt, führen Sie den folgenden Befehl aus:

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

Ersetzen Sie Folgendes:

  • INSTANCE_GROUP_NAME: der 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 Platzierungen 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"
    }
  ]
}

Ersetzen Sie Folgendes:

  • 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: der Name der verwalteten Instanzgruppe, 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 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 Compute-Instanzen aus der verwalteten Instanzgruppe durch neue Compute-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 verwaltete Instanzgruppe 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 verwaltete Instanzgruppe 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 Compute-Instanzen in der verwalteten Instanzgruppe 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 Compute-Instanzen aus der verwalteten Instanzgruppe durch neue Compute-Instanzen ersetzen möchten, die die Attribute der Vorlage angeben, stellen Sie die folgende PATCH-Anfrage:

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 verwaltete Instanzgruppe 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 Compute-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 Compute-Instanz in Bezug auf andere Instanzen ansehen. Dieser Vergleich ist auf Compute-Instanzen beschränkt, die in Ihrem Projekt vorhanden sind und dieselbe Richtlinie für kompakte Platzierung angeben. Wenn Sie den physischen Standort einer Compute-Instanz kennen, können Sie Folgendes tun:

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

  • Ermitteln, welche Compute-Instanzen sich am nächsten sind.

Wenn Sie den physischen Standort einer Compute-Instanz in Bezug auf andere Compute-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 Compute-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 Compute-Instanz, die eine Richtlinie für kompakte Platzierung angibt.

  • ZONE: die Zone, in der sich die Compute-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 Compute-Instanz befindet.

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

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

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

  • /CCCCCCC/BBBBBB/AAAA: Die beiden Compute-Instanzen verwenden denselben Host. Compute-Instanzen, die im selben 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 Compute-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 die Compute-Instanz vorhanden ist.

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

  • INSTANCE_NAME: Der Name einer vorhandenen Compute-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 Compute-Instanz befindet.

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

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

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

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

Nächste Schritte