Riduci la latenza utilizzando criteri di posizionamento compatto

Questo documento spiega come ridurre la latenza di rete tra le tue macchine virtuali (VM) creando e applicandovi criteri di posizionamento compatto.

R criterio di posizionamento compatto specifica che le VM devono essere fisicamente posizionate più vicine tra loro. Questo può aiutare a migliorare le prestazioni e a ridurre la latenza di rete tra le VM quando, ad esempio, Ad esempio, esegui il computing ad alte prestazioni (HPC), il machine learning (ML) carichi di lavoro del server di database.

Prima di iniziare

  • Se non l'hai già fatto, configura l'autenticazione. Autenticazione è la procedura di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

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

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

        gcloud init

      Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e applicare un criterio di posizionamento compatto alle VM, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questi ruoli predefiniti le autorizzazioni necessarie per creare e applicare un criterio di posizionamento compatto alle VM. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare e applicare un criterio di posizionamento compatto alle VM, sono necessarie le autorizzazioni seguenti:

  • Per creare criteri di posizionamento: compute.resourcePolicies.create nel progetto
  • Per applicare un criterio di posizionamento alle VM esistenti: compute.instances.addResourcePolicies nel progetto
  • Per creare le VM:
    • compute.instances.create nel progetto
    • Per utilizzare un'immagine personalizzata per creare la VM: compute.images.useReadOnly sull'immagine
    • Per utilizzare uno snapshot per creare la VM: compute.snapshots.useReadOnly nello snapshot
    • Per utilizzare un modello di istanza per creare la VM: compute.instanceTemplates.useReadOnly nel modello di istanza
    • Per assegnare una rete legacy alla VM,: compute.networks.use nel progetto
    • Per specificare un indirizzo IP statico per la VM: compute.addresses.use nel progetto
    • Per assegnare un indirizzo IP esterno alla VM quando utilizzi una rete legacy: compute.networks.useExternalIp nel progetto
    • Per specificare una subnet per la VM: compute.subnetworks.use nel progetto o nella subnet scelta
    • Per assegnare un indirizzo IP esterno alla VM quando utilizzi una rete VPC,: compute.subnetworks.useExternalIp nel progetto o nella subnet scelta
    • Per impostare i metadati dell'istanza VM per la VM: compute.instances.setMetadata nel progetto
    • Per impostare i tag per la VM: compute.instances.setTags sulla VM
    • Per impostare le etichette per la VM: compute.instances.setLabels sulla VM
    • Per impostare un account di servizio che la VM deve utilizzare: compute.instances.setServiceAccount sulla VM
    • Per creare un nuovo disco per la VM: compute.disks.create nel progetto
    • Per collegare un disco esistente in modalità di sola lettura o lettura/scrittura: compute.disks.use sul disco
    • Per collegare un disco esistente in modalità di sola lettura: compute.disks.useReadOnly sul disco
  • Per creare una prenotazione: compute.reservations.create nel progetto
  • Per creare un modello di istanza: compute.instanceTemplates.create nel progetto
  • Per creare un gruppo di istanze gestite a livello di zona o di regione: compute.instanceGroupManagers.create nel progetto
  • Per visualizzare i dettagli di una VM: compute.instances.get nel progetto

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Crea un criterio di posizionamento compatto

Quando crei un criterio di posizionamento compatto, puoi facoltativamente specificarne uno o entrambi dei seguenti:

  • Un valore massimo della distanza. In questo modo puoi controllare la distanza tra i tuoi VM quando hai requisiti di latenza di rete rigorosi. In base del tipo di macchina e della zona delle VM a cui applichi il criterio, si applicano le seguenti condizioni:

    • Se una zona ha capacità disponibile, viene applicato un criterio di posizionamento compatto con una distanza massima più alta (ad esempio 3) potrebbe causare il posizionamento delle VM più vicini tra loro.

    • Se una zona non dispone di capacità, viene applicato un criterio di posizionamento compatto con un distanza massima (ad esempio 1) ha maggiori probabilità di impedire al criterio di applicati ad alcune VM.

    Inoltre, i valori della distanza massima influiscono sul numero di VM che puoi applicare il criterio di posizionamento compatto, nonché le VM manutenzione dell'host . Per ulteriori informazioni, vedi Limitazioni per i criteri di posizionamento compatto.

  • Un numero fisso di VM. Questo rende efficace il criterio di posizionamento compatto solo quando la applichi a un numero specifico di VM. Stai tentando di applicare il criterio di posizionamento compatto a un numero di VM maggiore rispetto al numero specificato errori. Non puoi applicare criteri di posizionamento compatto con un numero fisso di dalle VM alle prenotazioni.

Per creare un criterio di posizionamento compatto, utilizza gcloud CLI REST.

gcloud

Per creare un criterio di posizionamento compatto, utilizza il metodo Comando gcloud compute resource-policies create group-placement con il flag --collocation=collocated.

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

Sostituisci quanto segue:

  • POLICY_NAME: il nome del criterio da creare.

  • REGION: la regione in cui creare il criterio. Se applicare il criterio di posizionamento compatto a una VM esistente, in una regione che contiene la zona in cui si trova la VM.

Se vuoi, puoi eseguire una delle seguenti operazioni o entrambe:

  • Per controllare meglio la distanza per posizionare le VM, utilizza Comando gcloud beta compute resource-policies create group-placement e includi il flag --max-distance.

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

    Sostituisci MAX_DISTANCE con la distanza massima per le tue VM. Il valore deve essere compreso tra 1, che specifica di collocare le VM nello stesso rack per la rete più bassa latenza minima e 3, che specifica di collocare le VM in cluster. Se vuoi applicare il criterio di posizionamento compatto a una non puoi specificare il valore 1.

  • Per rendere efficace il criterio di posizionamento compatto solo quando applicato a un specifico di VM, includi il flag --vm-count.

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

    Sostituisci VM_COUNT con il numero esatto di VM che a cui puoi applicare il criterio di posizionamento compatto. Il valore deve essere compreso tra 1 e numero massimo di VM a cui puoi applicare il criterio di posizionamento compatto.

REST

Per creare un criterio di posizionamento compatto, invia una richiesta POST a Metodo resourcePolicies.insert. Nel corpo della richiesta, includi il campo collocation e impostalo su COLLOCATED.

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi per creare il criterio di posizionamento.

  • REGION: la regione in cui creare il criterio. Se applicare il criterio di posizionamento compatto a una VM esistente, in una regione che contiene la zona in cui si trova la VM.

  • POLICY_NAME: il nome del criterio di posizionamento compatto per creare.

Se vuoi, puoi eseguire una delle seguenti operazioni o entrambe:

  • Per controllare meglio la distanza tra il posizionamento delle VM, effettua una richiesta POST alla Metodo beta.resourcePolicies.insert. Nel corpo della richiesta, includi il campo maxDistance.

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

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

    Sostituisci MAX_DISTANCE con la distanza massima per le tue VM. Il valore deve essere compreso tra 1, che specifica di collocare le VM nello stesso rack per la rete più bassa latenza minima e 3, che specifica di collocare le VM in cluster. Se vuoi applicare il criterio di posizionamento compatto a una non puoi specificare il valore 1.

  • Per rendere efficace il criterio di posizionamento compatto solo quando applicato a un specifico di VM, includi il campo vmCount nel corpo della richiesta.

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

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

    Sostituisci VM_COUNT con il numero esatto di VM che a cui puoi applicare il criterio di posizionamento compatto. Il valore deve essere compreso tra 1 e numero massimo di VM a cui puoi applicare il criterio di posizionamento compatto.

Applica criteri di posizionamento compatto

Puoi applicare un criterio di posizionamento compatto a una VM esistente oppure, quando crei VM, modelli di istanza, MIG o prenotazioni di VM.

Per creare una risorsa Compute Engine che specifica un posizionamento compatto. seleziona uno dei seguenti metodi:

Dopo aver applicato un criterio di posizionamento compatto a una VM, puoi verificare la posizione fisica di una VM rispetto ad altri VM che specificano lo stesso criterio.

Applica un criterio di posizionamento compatto a una VM esistente

Prima di applicare un criterio di posizionamento compatto a una VM esistente, assicurati che seguenti:

In caso contrario, l'applicazione del criterio di posizionamento compatto alla VM non va a buon fine. Se la VM specifica già un criterio di posizionamento e vuoi sostituirlo, quindi consulta Sostituire un criterio di posizionamento in una VM .

Per applicare un criterio di posizionamento compatto a una VM esistente, seleziona una delle le seguenti opzioni:

gcloud

  1. Arresta la VM.

  2. Per applicare un criterio di posizionamento compatto a una VM esistente, utilizza Comando gcloud compute instances add-resource-policies con il flag --resource-policies.

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

    Sostituisci quanto segue:

    • VM_NAME: il nome di una VM esistente.

    • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento.

    • ZONE: la zona in cui si trova la VM.

  3. Riavvia la VM.

REST

  1. Arresta la VM.

  2. Per applicare un criterio di posizionamento compatto a una VM esistente, crea un POST richiesta alla Metodo instances.addResourcePolicies. Nel corpo della richiesta, includi il campo resourcePolicies.

    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"
  ]
}

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui il criterio di posizionamento compatto e la VM.

    • ZONE: la zona in cui si trova la VM, che deve essere nella regione in cui si trova il criterio di posizionamento compatto.

    • VM_NAME: il nome di una VM esistente.

    • REGION: la regione in cui il posizionamento compatto .

    • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento.

  3. Riavvia la VM.

Crea una VM con un criterio di posizionamento compatto

Puoi creare una VM con un criterio di posizionamento compatto solo in una zona all'interno del nella stessa regione del criterio di posizionamento.

Per creare una VM che specifica un criterio di posizionamento compatto, seleziona una delle le seguenti opzioni:

gcloud

Per creare una VM che specifica un criterio di posizionamento compatto, utilizza Comando gcloud compute instances create con il flag --resource-policies.

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

Sostituisci quanto segue:

  • VM_NAME: il nome della VM da creare.

  • MACHINE_TYPE: un tipo di macchina supportato per i criteri di posizionamento compatto.

  • MAINTENANCE_POLICY: il valore criterio di manutenzione dell'host della VM. Se il criterio di posizionamento compatto specificato utilizza un valore massimo un valore di distanza pari a 1 o 2, puoi specificare solo TERMINATE. In caso contrario, puoi specificare MIGRATE o TERMINATE.

  • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento. Se il criterio di posizionamento compatto specifica un valore fisso di VM, devi includere il flag --no-restart-on-failure. Questo indica che la VM non si riavvia automaticamente dopo che .

  • ZONE: la zona in cui creare la VM.

REST

Per creare una VM che specifica un criterio di posizionamento compatto, crea un POST richiesta alla Metodo instances.insert. Nel corpo della richiesta, includi il campo resourcePolicies.

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

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui la classe compatta criterio di posizionamento.

  • ZONE: la zona in cui creare la VM e in cui del tipo di macchina. Puoi specificare solo un tipo di macchina disponibile all'interno della regione del criterio di posizionamento compatto.

  • VM_NAME: il nome della VM da creare.

  • MACHINE_TYPE: un tipo di macchina supportato per i criteri di posizionamento compatto.

  • REGION: la regione in cui il criterio di posizionamento compatto in cui viene localizzato.

  • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento. Se il criterio di posizionamento compatto specifica un valore fisso di VM, nel campo scheduling devi includere Campo automaticRestart impostato su false. Questo indica che la VM non si riavvia automaticamente dopo un errore dell'host.

  • MAINTENANCE_POLICY: il valore criterio di manutenzione dell'host della VM. Se il criterio di posizionamento compatto specificato utilizza un valore massimo un valore di distanza pari a 1 o 2, puoi specificare solo TERMINATE. In caso contrario, puoi specificare MIGRATE o TERMINATE.

Per saperne di più sulle opzioni di configurazione per creare una VM, consulta Crea e avvia un'istanza VM.

Crea una prenotazione con un criterio di posizionamento compatto

Se vuoi creare una prenotazione on demand per un singolo progetto che specifichi per il criterio di posizionamento compatto, prenotazione mirata. Quando crei VM per consumare la prenotazione, assicurati di quanto segue:

  • Le VM devono specificare lo stesso criterio di posizionamento compatto applicato al prenotazione.

  • Le VM devono avere come target specifico la prenotazione per utilizzarla. Per ulteriori informazioni le informazioni, vedi Utilizza le VM da una prenotazione specifica.

Per creare una prenotazione per un singolo progetto con un criterio di posizionamento compatto, seleziona uno dei seguenti metodi:

Per creare una prenotazione per un singolo progetto con un criterio di posizionamento compatto: specificando direttamente le proprietà, seleziona una delle seguenti opzioni:

gcloud

Per creare una prenotazione per un singolo progetto con un criterio di posizionamento compatto: specificando direttamente le proprietà, utilizza Comando gcloud compute reservations create con i flag --require-specific-reservation e --resource-policies.

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

Sostituisci quanto segue:

  • RESERVATION_NAME: il nome della prenotazione.

  • MACHINE_TYPE: un tipo di macchina supportato per i criteri di posizionamento compatto.

  • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento. Non puoi specificare un criterio di posizionamento compatto con un un numero fisso di VM. In caso contrario, la creazione della prenotazione non va a buon fine.

  • NUMBER_OF_VMS: il numero di VM da prenotare, che non può essere superiore al numero massimo di VM supportato per il criterio di posizionamento compatto specificato.

  • ZONE: la zona in cui prenotare le VM. Puoi solo prenota VM in una zona all'interno della regione del compatto specificato criterio di posizionamento.

REST

Per creare una prenotazione per un singolo progetto con un criterio di posizionamento compatto: specificando direttamente le proprietà, effettua una richiesta POST Metodo reservations.insert. Nel corpo della richiesta, includi il campo resourcePolicies e il Campo specificReservationRequired impostato su true.

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_VMS",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  },
  "specificReservationRequired": true
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui la classe compatta criterio di posizionamento.

  • ZONE: la zona in cui prenotare le VM. Puoi solo prenota VM in una zona all'interno della regione del compatto specificato criterio di posizionamento.

  • RESERVATION_NAME: il nome della prenotazione.

  • REGION: la regione in cui il criterio di posizionamento compatto in cui viene localizzato.

  • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento. Non puoi specificare un criterio di posizionamento compatto con un un numero fisso di VM. In caso contrario, la creazione della prenotazione non va a buon fine.

  • NUMBER_OF_VMS: il numero di VM da prenotare, che non può essere superiore al numero massimo di VM supportato per il criterio di posizionamento compatto specificato.

  • MACHINE_TYPE: un tipo di macchina supportato per i criteri di posizionamento compatto.

Per ulteriori informazioni sulle opzioni di configurazione e sui metodi di creazione per le prenotazioni di singoli progetti, Crea una prenotazione per un singolo progetto.

Crea un modello di istanza con un criterio di posizionamento compatto

Se vuoi creare un modello di istanza regionale, devi creare il nella stessa regione del criterio di posizionamento compatto. Altrimenti, la creazione l'errore del modello di istanza.

Dopo aver creato un modello di istanza, puoi utilizzarlo per:

Per creare un modello di istanza che specifica un criterio di posizionamento compatto, seleziona una delle seguenti opzioni:

gcloud

Per creare un modello di istanza che specifichi un criterio di posizionamento compatto, utilizza la Comando gcloud compute instance-templates create con il flag --resource-policies.

Ad esempio, per creare un modello di istanza globale che specifichi un modello criterio di posizionamento, esegui questo comando:

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

Sostituisci quanto segue:

  • INSTANCE_TEMPLATE_NAME: il nome dell'istanza modello.

  • MACHINE_TYPE: un tipo di macchina supportato per i criteri di posizionamento compatto.

  • MAINTENANCE_POLICY: il valore criterio di manutenzione dell'host della VM. Se il criterio di posizionamento compatto specificato utilizza un valore massimo un valore di distanza pari a 1 o 2, puoi specificare solo TERMINATE. In caso contrario, puoi specificare MIGRATE o TERMINATE.

  • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento. Se il criterio di posizionamento compatto specifica un valore fisso di VM, devi includere il flag --no-restart-on-failure. Questo indica che le VM create utilizzando il modello di istanza non automaticamente dopo un errore dell'host.

REST

Per creare un modello di istanza che specifichi un criterio di posizionamento compatto, effettua una richiesta POST a uno dei seguenti metodi:

Nel corpo della richiesta, specifica il campo resourcePolicies.

Ad esempio, per creare un modello di istanza globale che specifichi un modello criterio di posizionamento, effettua una richiesta POST come segue:

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"
    }
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui la classe compatta si trova il criterio di posizionamento che vuoi applicare al modello di istanza.

  • INSTANCE_TEMPLATE_NAME: il nome dell'istanza modello.

  • IMAGE o IMAGE_FAMILY: specificane uno dei seguenti:

    • IMAGE: una versione specifica dell'immagine del sistema operativo; della ad esempio debian-10-buster-v20200309.

    • IMAGE_FAMILY: un famiglia di immagini. Questo specifica l'immagine del sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-10, la versione più recente della famiglia di immagini Debian 10 . Per ulteriori informazioni sull'utilizzo delle famiglie di immagini, consulta Best practice per le famiglie di immagini.

  • MACHINE_TYPE: un tipo di macchina supportato per i criteri di posizionamento compatto.

  • POLICY_NAME: il nome di un compatto esistente criterio di posizionamento. Se il criterio di posizionamento compatto specifica un valore fisso di VM, nel campo scheduling devi includere Campo automaticRestart impostato su false. Questo indica che le VM creati utilizzando il modello di istanza non si riavviano automaticamente dopo Errore dell'host.

  • MAINTENANCE_POLICY: il valore criterio di manutenzione dell'host della VM. Se il criterio di posizionamento compatto specificato utilizza un valore massimo un valore di distanza pari a 1 o 2, puoi specificare solo TERMINATE. In caso contrario, puoi specificare MIGRATE o TERMINATE.

Per ulteriori informazioni sulle opzioni di configurazione per creare un'istanza vedi il modello Creare modelli di istanza.

Applica un criterio di posizionamento compatto alle VM in un gruppo di istanze gestite

Dopo crea un modello di istanza che specifichi criterio di posizionamento compatto, puoi usare il modello per:

Se vuoi applicare un criterio di posizionamento compatto a un gruppo di istanze gestite, devi creare o applicazione del criterio a un gruppo di istanze gestite a livello di regione con qualsiasi zona singola forma di distribuzione è consigliato. In questo modo, ogni volta che un gruppo di istanze gestite a livello regionale deve fare lo scale out creando VM, seleziona la zona in cui creare le VM in base alle tue prenotazioni, quote e requisiti hardware.

Crea un gruppo di istanze gestite con un criterio di posizionamento compatto

Puoi creare VM che specificano un criterio di posizionamento compatto solo se le VM che si trovano nella stessa regione del criterio di posizionamento.

a creare un gruppo di istanze gestite utilizzando un modello di istanza che specifica un posizionamento compatto. criterio, seleziona una delle seguenti opzioni:

gcloud

a creare un gruppo di istanze gestite utilizzando un modello di istanza che specifica un modello compatto criterio di posizionamento, utilizza Comando gcloud compute instance-groups managed create con il flag --template.

Ad esempio, per creare un gruppo di istanze gestite a livello di regione con una distribuzione qualsiasi zona singola forma, esegui questo comando:

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

Sostituisci quanto segue:

  • MIG_NAME: il nome del gruppo di istanze gestite da creare.

  • REGION: la regione in cui creare il gruppo di istanze gestite, che deve corrispondere alla regione in cui è visualizzato il criterio di posizionamento compatto individuarlo.

  • SIZE: la dimensione del gruppo di istanze gestite.

  • INSTANCE_TEMPLATE_NAME: il nome di un elemento esistente che specifica un criterio di posizionamento compatto.

REST

a creare un gruppo di istanze gestite utilizzando un modello di istanza che specifica un modello compatto criterio di posizionamento, invia una richiesta POST instanceGroupManagers.insert o regionInstanceGroupManagers.insert di machine learning.

Ad esempio, per creare un gruppo di istanze gestite a livello di regione con proprietà VM predefinite e qualsiasi-zona-singola, effettua una richiesta POST come segue:

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
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui la classe compatta il criterio di posizionamento e il modello di istanza che specifica il posizionamento .

  • REGION: la regione in cui creare il gruppo di istanze gestite, che deve corrispondere alla regione in cui è visualizzato il criterio di posizionamento compatto individuarlo.

  • MIG_NAME: il nome del gruppo di istanze gestite da creare.

  • INSTANCE_TEMPLATE_NAME: il nome di un elemento esistente che specifica un criterio di posizionamento compatto.

  • SIZE: la dimensione del gruppo di istanze gestite.

Per ulteriori informazioni sulle opzioni di configurazione per creare gruppi di istanze gestite, consulta Scenari di base per la creazione di gruppi di istanze gestite.

Applica un criterio di posizionamento compatto a un gruppo di istanze gestite esistente

Puoi applicare un criterio di posizionamento compatto a un gruppo di istanze gestite esistente solo se il gruppo di istanze gestite viene situato nella stessa regione del criterio di posizionamento o, per i gruppi di istanze gestite a livello di zona, in una zona all'interno della stessa regione del criterio di posizionamento.

Aggiornare un gruppo di istanze gestite in modo che utilizzi un modello di istanza che specifica un posizionamento compatto. criterio, seleziona una delle seguenti opzioni:

gcloud

aggiorna un gruppo di istanze gestite in modo che utilizzi un modello di istanza che specifichi criterio di posizionamento, utilizza Comando gcloud compute instance-groups managed rolling-action start-update.

Ad esempio, per aggiornare un gruppo di istanze gestite a livello di regione in modo che utilizzi un modello di istanza specifica un criterio di posizionamento compatto e sostituisce le VM esistenti un gruppo di istanze gestite con nuove VM che specificano le proprietà del modello, esegui questo comando :

gcloud compute instance-groups managed rolling-action start-update MIG_NAME \
    --region=REGION \
    --type=proactive \
    --version=template=INSTANCE_TEMPLATE_NAME

Sostituisci quanto segue:

  • MIG_NAME: il nome di un gruppo di istanze gestite esistente.

  • REGION: la regione in cui si trova il gruppo di istanze gestite. Puoi Applicare il criterio di posizionamento compatto solo a un gruppo di istanze gestite che si trova nello stesso regione.

  • INSTANCE_TEMPLATE_NAME: il nome di un elemento esistente che specifica un criterio di posizionamento compatto.

REST

aggiorna un gruppo di istanze gestite in modo che utilizzi un modello di istanza che specifichi criterio di posizionamento e applicare automaticamente le proprietà del modello il criterio di posizionamento alle VM esistenti nel gruppo di istanze gestite, effettua una richiesta PATCH a il instanceGroupManagers.insert o regionInstanceGroupManagers.insert di machine learning.

Ad esempio, per aggiornare un gruppo di istanze gestite a livello di regione in modo che utilizzi un modello di istanza specifica un criterio di posizionamento compatto e sostituisce le VM esistenti gruppo di istanze gestite con nuove VM che specificano le proprietà del modello, apporta le seguenti modifiche Richiesta di 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"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui MIG, il criterio di posizionamento compatto e il modello di istanza che specifica criterio di posizionamento.

  • REGION: la regione in cui si trova il gruppo di istanze gestite. Puoi Applicare il criterio di posizionamento compatto solo a un gruppo di istanze gestite che si trova nello stesso regione.

  • MIG_NAME: il nome di un gruppo di istanze gestite esistente.

  • INSTANCE_TEMPLATE_NAME: il nome di un elemento esistente che specifica un criterio di posizionamento compatto.

Per saperne di più sulle opzioni di configurazione per aggiornare le VM in un gruppo di istanze gestite, vedi Aggiornare e applicare nuove configurazioni alle VM in un gruppo di istanze gestite.

Verifica la località fisica di una VM

Dopo aver applicato un criterio di posizionamento compatto a una VM, puoi vedere come il il criterio di posizionamento compatto ha influenzato la sua posizione fisica rispetto ad altri VM che specificano lo stesso criterio. Questo consente di determinare se la classe compatta il criterio di posizionamento è stato applicato correttamente a una VM e mappa le VM più vicine l'uno con l'altro.

a verificare la posizione fisica di una VM che specifica un criterio di posizionamento in in relazione alle altre VM, seleziona una delle seguenti opzioni:

gcloud

a visualizzare la posizione fisica di una VM che specifica un posizionamento compatto. utilizza Comando gcloud compute instances describe con il flag --format.

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

Sostituisci quanto segue:

  • VM_NAME: il nome di una VM esistente.

  • ZONE: la zona in cui si trova la VM.

L'output è simile al seguente:

VM-Position

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

Il valore del campo PHYSICAL_HOST è composto da tre parti. Questi ciascuna delle parti rappresenta il cluster, il rack e l'host in cui si trova la VM.

Quando confronti la posizione di due VM che specificano lo stesso di posizionamento, più parti nel campo PHYSICAL_HOST condividono le VM più sono vicine tra loro. Ad esempio, se due VM specifica uno dei seguenti valori di esempio per il campo PHYSICAL_HOST:

  • /CCCCCCC/xxxxxx/xxxx: le due VM sono posizionate stesso cluster, che equivale a un valore di distanza massima di 2. VM posizionate in lo stesso cluster avrà una bassa latenza di rete.

  • /CCCCCCC/BBBBBB/xxxx: le due VM sono posizionate stesso rack, il che equivale a un valore di distanza massima di 1. VM posizionate in la stessa esperienza in un rack con latenza di rete più bassa rispetto alle VM nello stesso cluster.

  • /CCCCCCC/BBBBBB/AAAA: le due VM condividono la stessa . Le VM posizionate nello stesso host riducono al minimo la latenza di rete tanto quanto possibile.

REST

a visualizzare la posizione fisica di una VM che specifica un posizionamento compatto. criterio, invia una richiesta GET al Metodo instances.get.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la VM individuarlo.

  • ZONE: la zona in cui si trova la VM.

  • VM_NAME: il nome di una VM esistente che specifica un criterio di posizionamento.

L'output è simile al seguente:

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

Il valore del campo physicalHost è composto da tre parti. Questi ciascuna delle parti rappresenta il cluster, il rack e l'host in cui si trova la VM.

Quando confronti la posizione di due VM che specificano lo stesso di posizionamento, più parti nel campo physicalHost condividono le VM più sono vicine tra loro. Ad esempio, se due VM specifica uno dei seguenti valori di esempio per il campo physicalHost:

  • /CCCCCCC/xxxxxx/xxxx: le due VM sono posizionate stesso cluster, che equivale a un valore di distanza massima di 2. VM posizionate nello stesso cluster hanno una bassa latenza di rete.

  • /CCCCCCC/BBBBBB/xxxx: le due VM sono posizionate stesso rack, il che equivale a un valore di distanza massima di 1. VM posizionate in la stessa esperienza in un rack con latenza di rete più bassa rispetto alle VM nello stesso cluster.

  • /CCCCCCC/BBBBBB/AAAA: le due VM condividono la stessa . Le VM posizionate nello stesso host riducono al minimo la latenza di rete tanto quanto possibile.

Passaggi successivi