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

Ohne feste Anzahl

Sie können eine Richtlinie für kompakte Platzierung mit der gcloud CLI und REST erstellen.

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

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

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

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

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

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

Mit fester Anzahl

Sie können eine Richtlinie für kompakte Platzierung, die eine feste Anzahl von VMs angibt, mit der gcloud CLI und REST erstellen.

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

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

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

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

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

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

gcloud

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

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

Ersetzen Sie Folgendes:

• VM_NAME: Der Name einer vorhandenen VM.

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

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

REST

Senden Sie eine POST-Anfrage an die Methode instances.addResourcePolicies mit dem Feld resourcePolicies, um eine Richtlinie für kompakte Platzierung auf eine vorhandene VM anzuwenden.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_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 VM befinden.

• ZONE: Zone, in der sich die VM befindet. Sie muss sich in der Region befinden, in der sich die Richtlinie für kompakte Platzierung befindet.

• VM_NAME: Der Name einer vorhandenen VM.

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

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

gcloud

Verwenden Sie zum Erstellen einer VM mit einer Richtlinie für kompakte Platzierung den Befehl gcloud compute instances create mit dem Flag --resource-policies.

Führen Sie beispielsweise den folgenden Befehl aus, um eine VM zu erstellen, die einen c2d-standard-2-Maschinentyp angibt:

gcloud compute instances create VM_NAME \
    --machine-type=c2d-standard-2 \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

• VM_NAME: der Name der zu erstellenden VM.

• MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der VM. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung den max-distance-Wert 1 oder 2 verwendet, können Sie nur TERMINATE angeben. Andernfalls können Sie entweder MIGRATE oder TERMINATE angeben.

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

• ZONE: Die Zone, in der die VM erstellt werden soll. Sie können eine VM nur in einer Zone erstellen, die sich innerhalb der Region der von Ihnen angegebenen Richtlinie für kompakte Platzierung befindet.

REST

Senden Sie zum Erstellen einer VM mit einer Richtlinie für kompakte Platzierung eine POST-Anfrage an die Methode instances.insert mit dem Feld resourcePolicies.

Stellen Sie beispielsweise die folgende POST-Anfrage, um eine VM zu erstellen, die den Maschinentyp c2d-standard-2 angibt:

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

{
  "machineType": "zones/ZONE/machineTypes/c2d-standard-2",
  "name": "VM_NAME",
  "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 VM erstellt werden soll und in der sich der Maschinentyp befindet. Sie können eine VM nur in einer Zone erstellen, die sich innerhalb der Region der von Ihnen angegebenen Richtlinie für kompakte Platzierung befindet.

• VM_NAME: der Name der zu erstellenden VM.

• 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 VM. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung den max-distance-Wert 1 oder 2 verwendet, können Sie nur TERMINATE angeben. Andernfalls können Sie entweder MIGRATE oder TERMINATE angeben.

gcloud

Wenn Sie VMs im Bulk erstellen möchten, die eine Richtlinie für kompakte Platzierung angeben, verwenden Sie den Befehl gcloud compute instances bulk create mit dem Flag --resource-policies.

Wenn Sie beispielsweise VMs im Bulk erstellen möchten, die alle einen c2d-standard-2-Maschinentyp und dieselbe Richtlinie für kompakte Platzierung angeben, führen Sie den folgenden Befehl aus:

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

Ersetzen Sie Folgendes:

• COUNT ist die Anzahl der zu erstellenden VMs.

• MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der VM. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung den max-distance-Wert 1 oder 2 verwendet, können Sie nur TERMINATE angeben. Andernfalls können Sie entweder MIGRATE oder TERMINATE angeben.

• NAME_PATTERN: Das Namensmuster für die zu erstellenden VMs. Verwenden Sie das Rautezeichen (#), um es durch eine Zahlenfolge zu ersetzen. Wenn Sie hier beispielsweise vm-# angeben, werden VMs mit den Namen vm-1, vm-2 usw. erstellt, bis die Anzahl der in COUNT angegebenen VMs erreicht ist.

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

• ZONE: Die Zone, in der die VMs im Bulk erstellt werden sollen. Sie können VMs nur in Zonen erstellen, die sich innerhalb der Region der von Ihnen angegebenen Richtlinie für kompakte Platzierungen befinden.

REST

Wenn Sie VMs im Bulk erstellen möchten, die eine Richtlinie für kompakte Platzierungen angeben, erstellen Sie eine POST-Anfrage an die Methode instances.bulkInsert mit dem Feld resourcePolicies.

Wenn Sie beispielsweise VMs im Bulk erstellen möchten, die alle einen c2d-standard-2-Maschinentyp und dieselbe Richtlinie für kompakte Platzierung angeben, stellen Sie folgende POST-Anfrage:

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

{
  "count": "COUNT",
  "machineType": "zones/ZONE/machineTypes/c2d-standard-2",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "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 VMs im Bulk erstellt werden sollen und wo sich der Maschinentyp befindet. Sie können VMs nur in Zonen erstellen, die sich innerhalb der Region der von Ihnen angegebenen Richtlinie für kompakte Platzierungen befinden.

• COUNT ist die Anzahl der zu erstellenden VMs.

• NAME_PATTERN: Das Namensmuster für die zu erstellenden VMs. Verwenden Sie das Rautezeichen (#), um es durch eine Zahlenfolge zu ersetzen. Wenn Sie hier beispielsweise vm-# angeben, werden VMs mit den Namen vm-1, vm-2 usw. erstellt, bis die Anzahl der in COUNT angegebenen VMs erreicht ist.

• 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 VM. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung den max-distance-Wert 1 oder 2 verwendet, können Sie nur TERMINATE angeben. Andernfalls können Sie entweder MIGRATE oder TERMINATE angeben.

gcloud

Verwenden Sie zum Erstellen einer Instanzvorlage, die eine Richtlinie für kompakte Platzierungen angibt, den Befehl gcloud compute instance-templates create mit dem Flag --resource-policies.

Führen Sie beispielsweise den folgenden Befehl aus, um eine globale Instanzvorlage zu erstellen, die einen c2d-standard-2-Maschinentyp und eine vorhandene Richtlinie für kompakte Platzierung angibt:

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

Ersetzen Sie Folgendes:

• INSTANCE_TEMPLATE_NAME: der Name der Instanzvorlage.

• MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der VM. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung den max-distance-Wert 1 oder 2 verwendet, können Sie nur TERMINATE angeben. Andernfalls können Sie entweder MIGRATE oder TERMINATE angeben.

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

REST

Senden Sie zum Erstellen einer Instanzvorlage mit einer Richtlinie für kompakte Platzierungen eine POST-Anfrage an die Methode instanceTemplates.insert. Geben Sie im Anfragetext das resourcePolicies-Feld an:

Wenn Sie beispielsweise eine globale Instanzvorlage erstellen möchten, die einen c2d-standard-2-Maschinentyp und eine vorhandene Richtlinie für kompakte Platzierung angibt, stellen Sie folgende POST-Anfrage:

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "machineType": "zones/ZONE/machineTypes/c2d-standard-2",
  "properties": {
    "resourcePolicies": {
      "POLICY_NAME"
    },
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID des Projekts, in dem sich die Richtlinie für kompakte Platzierungen befindet, die Sie auf die Instanzvorlage anwenden möchten.

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

• INSTANCE_TEMPLATE_NAME: der Name der Instanzvorlage.

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

• MAINTENANCE_POLICY: Die Hostwartungsrichtlinie der VM. Wenn die von Ihnen angegebene Richtlinie für kompakte Platzierung den max-distance-Wert 1 oder 2 verwendet, können Sie nur TERMINATE angeben. Andernfalls können Sie entweder MIGRATE oder TERMINATE angeben.

gcloud

Verwenden Sie zum Erstellen einer MIG mit einer Instanzvorlage, die eine Richtlinie für kompakte Platzierungen angibt, den Befehl gcloud compute instance-groups managed create mit dem Flag --template.

Führen Sie beispielsweise den folgenden Befehl aus, um eine regionale MIG mit der Verteilungsform Beliebige einzelne Zone zu erstellen:

gcloud compute instance-groups managed create MIG_NAME \
    --region=REGION \
    --size=SIZE \
    --target-distribution-shape=any-single-zone \
    --template=INSTANCE_TEMPLATE_NAME

Ersetzen Sie Folgendes:

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

• REGION: Region, in der die MIG erstellt werden soll. Diese muss mit der Region übereinstimmen, in der sich die Richtlinie für kompakte Platzierungen befindet.

• SIZE: Die Größe der MIG.

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

REST

Wenn Sie eine MIG mit einer Instanzvorlage erstellen möchten, die eine Richtlinie für kompakte Platzierungen angibt, stellen Sie eine POST-Anfrage an die Methoden instanceGroupManagers.insert oder regionInstanceGroupManagers.insert, wobei das Feld instanceTemplate auf den Namen der vorhandenen Vorlage gesetzt ist.

Wenn Sie beispielsweise eine regionale MIG mit Standard-VM-Attributen und der Verteilungsform Beliebige einzelne Zone erstellen möchten, stellen Sie folgende POST-Anfrage:

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

{
  "name": "MIG_NAME",
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME",
  "distributionPolicy": {
    "targetShape": "ANY_SINGLE_ZONE"
  },
  "targetSize": SIZE
}

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.

• REGION: Region, in der die MIG erstellt werden soll. Diese muss mit der Region übereinstimmen, in der sich die Richtlinie für kompakte Platzierungen befindet.

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

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

• SIZE: Die Größe der MIG.

gcloud

Verwenden Sie den Befehl gcloud compute instance-groups managed rolling-action start-update mit dem Flag --version=template, um eine verwaltete Instanzgruppe so zu aktualisieren, dass sie eine Instanzvorlage verwendet, die eine Richtlinie für kompakte Platzierungen festlegt.

Wenn Sie beispielsweise eine regionale MIG so aktualisieren möchten, dass sie eine Instanzvorlage verwendet, die eine Richtlinie für kompakte Platzierungen angibt, und die vorhandenen VMs aus der MIG durch neue VMs 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 \
    --region=REGION \
    --type=proactive \
    --version=template=INSTANCE_TEMPLATE_NAME

Ersetzen Sie Folgendes:

• MIG_NAME: Name einer vorhandenen MIG.

• REGION: Die Region, in der sich die MIG befindet. Sie können die Richtlinie für kompakte Platzierung nur auf eine MIG in derselben Region anwenden.

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

REST

Wenn Sie eine MIG so aktualisieren möchten, dass eine Instanzvorlage verwendet wird, die eine Richtlinie für kompakte Platzierungen angibt, und Sie die Attribute der Vorlage und der Platzierungsrichtlinie automatisch auf vorhandene VMs in der MIG anwenden möchten, senden Sie eine PATCH-Anfrage an instanceGroupManagers.insert oder regionInstanceGroupManagers.insert mit dem Feld instanceTemplate.

Wenn Sie beispielsweise eine regionale MIG so aktualisieren möchten, dass sie eine Instanzvorlage verwendet, die eine Richtlinie für kompakte Platzierungen angibt, und die vorhandenen VMs aus der MIG durch neue VMs 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/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME",
  "updatePolicy": {
    "type": "PROACTIVE"
  }
}

Ersetzen Sie Folgendes:

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

• REGION: Die Region, in der sich die MIG befindet. Sie können die Richtlinie für kompakte Platzierung nur auf eine MIG in derselben Region anwenden.

• MIG_NAME: Name einer vorhandenen MIG.

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

gcloud

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

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

Ersetzen Sie Folgendes:

• VM_NAME: Der Name einer vorhandenen VM.

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

Die Ausgabe sieht in 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 VM befindet.

Beim Vergleich der Position von zwei VMs, die dieselbe Richtlinie für kompakte Platzierungen angeben, gilt: Je mehr Teile im Feld PHYSICAL_HOST die VMs teilen, desto näher befinden sie sich. Wenn beispielsweise zwei VMs beide einen der folgenden Beispielwerte für das Feld PHYSICAL_HOST angeben:

• /CCCCCCC/xxxxxx/xxxx: Die beiden VMs werden im selben Cluster platziert. Dies entspricht einem max-distance-Wert von 2. VMs, die im selben Cluster platziert sind, haben eine niedrige Netzwerklatenz.

• /CCCCCCC/BBBBBB/xxxx: Die beiden VMs werden im selben Rack platziert, was dem max-distance-Wert 1 entspricht. VMs, die im selben Rack platziert sind, haben eine geringere Netzwerklatenz als VMs, die im selben Cluster platziert sind.

• /CCCCCCC/BBBBBB/AAAA: Die beiden VMs teilen sich denselben Host. VMs, 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 VM aufzurufen, die eine Richtlinie für kompakte Platzierungen angibt.

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.

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

• VM_NAME: Der Name einer vorhandenen VM, die eine Platzierungsrichtlinie angibt.

Die Ausgabe sieht in 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 VM befindet.

Beim Vergleich der Position von zwei VMs, die dieselbe Richtlinie für kompakte Platzierungen angeben, gilt: Je mehr Teile im Feld physicalHost die VMs teilen, desto näher befinden sie sich. Wenn beispielsweise zwei VMs beide einen der folgenden Beispielwerte für das Feld physicalHost angeben:

• /CCCCCCC/xxxxxx/xxxx: Die beiden VMs werden im selben Cluster platziert. Dies entspricht einem max-distance-Wert von 2. VMs, die im selben Cluster platziert sind, haben eine niedrige Netzwerklatenz.

• /CCCCCCC/BBBBBB/xxxx: Die beiden VMs werden im selben Rack platziert, was dem max-distance-Wert 1 entspricht. VMs, die im selben Rack platziert sind, haben eine geringere Netzwerklatenz als VMs, die im selben Cluster platziert sind.

• /CCCCCCC/BBBBBB/AAAA: Die beiden VMs teilen sich denselben Host. VMs, die im selben Host platziert sind, minimieren die Netzwerklatenz so weit wie möglich.