Crea richieste di ridimensionamento in un MIG

Questo documento spiega come creare richieste di ridimensionamento in un gruppo di istanze gestite (MIG) di macchine virtuali (VM). Per saperne di più sulle richieste di ridimensionamento del gruppo di istanze gestite, consulta la pagina Informazioni sulle richieste di ridimensionamento in un MIG.

La creazione di una richiesta di ridimensionamento del MIG ti consente di ottenere risorse molto richieste, come le GPU, e di ottimizzare i costi creando in una volta il numero esatto di VM. Per creare una richiesta di ridimensionamento del MIG che possa utilizzare le funzionalità e i servizi disponibili in AI Hypercomputer, consulta invece Crea un gruppo di istanze gestite e una richiesta di ridimensionamento nella documentazione di AI Hypercomputer.

Prima di iniziare

  • Per utilizzare le richieste di ridimensionamento del gruppo di istanze gestite per creare VM con inizio flessibile per i carichi di lavoro che vengono eseguiti per un massimo di sette giorni, verifica di disporre di una quota sufficiente per le risorse richieste. In caso contrario, la richiesta di ridimensionamento rimane in sospeso finché non avrai una quota sufficiente.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    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. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    REST

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

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare richieste di ridimensionamento del gruppo di istanze gestite, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare richieste di ridimensionamento del gruppo di istanze gestite. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare richieste di ridimensionamento del gruppo di istanze gestite sono necessarie le seguenti autorizzazioni:

  • Per creare un template di istanza: compute.instanceTemplates.create sul progetto
  • Per creare un gruppo di istanze gestite a livello di zona: compute.instanceGroupManagers.create sul progetto
  • Per creare una richiesta di ridimensionamento del gruppo di istanze gestite: compute.instanceGroupManagers.update sul progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Prepara un gruppo di istanze gestite per le richieste di ridimensionamento

Per creare richieste di ridimensionamento di un gruppo di istanze gestite, devi configurare un template di istanza e il gruppo di istanze gestite come descritto nelle sezioni seguenti.

Crea un modello di istanza

In base al caso d'uso per le richieste di ridimensionamento del gruppo di istanze gestite, crea un template di istanza utilizzando uno dei seguenti metodi:

Utilizza il modello di provisioning con avvio flessibile

Per creare un template di istanza configurato per la creazione di richieste di ridimensionamento del gruppo di istanze gestite e VM Flex-start, devi specificare le seguenti impostazioni nel template:

Nota: se vuoi eseguire workload di data science o machine learning, valuta la possibilità di utilizzare una Deep Learning VM Image quando crei un template di istanza. La VM di Deep Learning è un insieme di immagini VM preconfezionate che include framework di machine learning e strumenti essenziali. Per ulteriori informazioni su queste immagini, vedi Scegliere un'immagine nella documentazione di Deep Learning VM.

Per creare un template di istanza, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Template di istanza.

    Vai a Template di istanza

  2. Fai clic su Crea modello istanza. Viene visualizzata la pagina Crea un template di istanza.

  3. Nel campo Nome, inserisci un nome per il template di istanza.

  4. Nella sezione Località, seleziona una delle seguenti opzioni:

    • Per creare un template di istanza regionale, seleziona Regionale (consigliato), quindi seleziona la regione in cui creare il template.

    • Per creare un template di istanza globale, seleziona Globale.

  5. Nella sezione Configurazione macchina, specifica un tipo di macchina GPU o un tipo di macchina H4D.

  6. Nella sezione Modello di provisioning, completa i seguenti passaggi:

    1. Nel campo Modello di provisioning delle VM, seleziona Avvio flessibile.

    2. Espandi Impostazioni avanzate del modello di provisioning delle VM.

    3. Seleziona la casella di controllo Imposta un limite di tempo per la VM.

    4. Per impostare una durata di esecuzione per le VM create tramite il template di istanza, inserisci il numero di ore nel campo Inserisci il numero di ore. Il valore deve essere compreso tra 36 secondi (0.01) e sette giorni (168).

  7. (Facoltativo) Per modificare il tipo o l'immagine del disco di avvio predefinito, fai clic su Modifica nella sezione Disco di avvio. Dopodiché, segui le istruzioni per modificare il disco di avvio.

  8. Fai clic su Crea.

gcloud

Per creare un template di istanza, utilizza il comando instance-templates create con i seguenti flag:

  • Il flag --instance-termination-action impostato su DELETE.

  • Il flag --maintenance-policy impostato su TERMINATE.

  • Il flag --max-run-duration.

  • Il flag --provisioning-model impostato su FLEX_START.

  • Il flag --reservation-affinity impostato su none.

Ad esempio, per creare un template di istanza regionale, esegui il seguente comando. Se vuoi creare un template di istanza globale, utilizza lo stesso comando senza il flag --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-template-region=REGION \
    --instance-termination-action=DELETE \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --max-run-duration=RUN_DURATION \
    --provisioning-model=FLEX_START \
    --reservation-affinity=none

Sostituisci quanto segue:

  • INSTANCE_TEMPLATE_NAME: il nome del template di istanza da creare

  • IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

  • IMAGE_FAMILY: una famiglia di immagini. In questo modo, viene specificata l'immagine del sistema operativo più recente e non deprecata. Ad esempio, se specifichi debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per ulteriori informazioni sull'utilizzo delle famiglie di immagini, consulta le rispettive best practice.

  • REGION: la regione in cui creare il template di istanza.

  • MACHINE_TYPE: il tipo di macchina GPU o H4D da utilizzare per le VM Flex-start. Se specifichi un tipo di macchina N1, devi includere il flag --accelerator per definire il numero e il tipo di GPU da collegare alle VM.

  • RUN_DURATION: la durata per cui vuoi eseguire le VM richieste. Devi formattare il valore come numero di giorni, ore, minuti o secondi seguito rispettivamente da d, h, m e s. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per un giorno, due ore, tre minuti e quattro secondi. Il valore deve essere compreso tra 10 minuti e sette giorni.

REST

Per creare un template di istanza, invia una richiesta POST a uno dei seguenti metodi:

Nel corpo della richiesta, includi i seguenti campi:

  • Il campo reservationAffinity.consumeReservationType impostato su NO_RESERVATION.

  • Il campo scheduling.instanceTerminationAction impostato su DELETE.

  • Il campo scheduling.maxRunDuration.

  • Il campo scheduling.onHostMaintenance impostato su TERMINATE.

  • Il campo scheduling.provisioningModel impostato su FLEX_START.

Ad esempio, per creare un modello di istanza regionale, effettua una richiesta come segue:

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

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui creare il template di istanza.

  • REGION: la regione in cui creare il template di istanza

  • INSTANCE_TEMPLATE_NAME: il nome del template di istanza da creare

  • IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

  • IMAGE: specifica una delle seguenti opzioni:

    • Una versione specifica dell'immagine sistema operativo, ad esempio debian-12-bookworm-v20240617.

    • Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. In questo modo, viene specificata l'immagine sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per saperne di più sull'utilizzo delle famiglie di immagini, consulta le best practice per le famiglie di immagini.

  • MACHINE_TYPE: il tipo di macchina GPU da utilizzare per le VM. Se specifichi un tipo di macchina N1, devi includere il campo guestAccelerators per definire il numero e il tipo di GPU da collegare alle VM.

  • RUN_DURATION: la durata, in secondi, per cui vuoi eseguire le VM richieste. Il valore deve essere compreso tra 600, ovvero 600 secondi (10 minuti), e 604800, ovvero 604.800 secondi (sette giorni).

Per saperne di più sulla creazione di un template di istanza, consulta Crea template di istanza.

Utilizzare il modello di provisioning con prenotazione

Per creare un template di istanza configurato per le richieste di ridimensionamento del gruppo di istanze gestite e per utilizzare una prenotazione, devi specificare quanto segue nel template:

Nota: se vuoi eseguire workload di data science o machine learning, valuta la possibilità di utilizzare una Deep Learning VM Image quando crei un template di istanza. La VM di Deep Learning è un insieme di immagini VM preconfezionate che include framework di machine learning e strumenti essenziali. Per ulteriori informazioni su queste immagini, vedi Scegliere un'immagine nella documentazione di Deep Learning VM.

Per creare un template di istanza, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Template di istanza.

    Vai a Template di istanza

  2. Fai clic su Crea modello istanza. Viene visualizzata la pagina Crea un template di istanza.

  3. Nel campo Nome, inserisci un nome per il template di istanza.

  4. Nella sezione Località, seleziona una delle seguenti opzioni:

    • Per creare un template di istanza regionale, seleziona Regionale (consigliato), quindi seleziona la regione in cui creare il template.

    • Per creare un template di istanza globale, seleziona Globale.

  5. Nella sezione Configurazione macchina, specifica un tipo di macchina A4, A3 Ultra o H4D.

  6. Nella sezione Modello di provisioning, completa i seguenti passaggi:

    1. Espandi Impostazioni avanzate del modello di provisioning delle VM.

    2. Nell'elenco Alla terminazione della VM, seleziona Elimina.

  7. (Facoltativo) Per modificare il tipo o l'immagine del disco di avvio predefinito, fai clic su Modifica nella sezione Disco di avvio. Dopodiché, segui le istruzioni per modificare il disco di avvio.

  8. Espandi la sezione Opzioni avanzate e segui questi passaggi:

    1. Espandi la sezione Gestione.

    2. Nella sezione Prenotazioni, seleziona Scegli una prenotazione, quindi fai clic su Scegli prenotazione. Nel riquadro visualizzato, segui le istruzioni per selezionare la prenotazione che vuoi utilizzare.

  9. Fai clic su Crea.

gcloud

Per creare un template di istanza, utilizza il comando instance-templates create con i seguenti flag:

  • Il flag --instance-termination-action impostato su DELETE.

  • Il flag --maintenance-policy impostato su TERMINATE.

  • Il flag --provisioning-model impostato su RESERVATION_BOUND.

  • Il flag --reservation-affinity impostato su specific.

  • Il flag --reservation.

Ad esempio, per creare un template di istanza regionale, esegui il seguente comando. Se vuoi creare un template di istanza globale, utilizza lo stesso comando senza il flag --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --image-project=IMAGE_PROJECT \
    --image-family=IMAGE_FAMILY \
    --instance-termination-action=DELETE \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --provisioning-model=RESERVATION_BOUND \
    --reservation-affinity=specific \
    --reservation=RESERVATION_URL

Sostituisci quanto segue:

  • INSTANCE_TEMPLATE_NAME: il nome del template di istanza da creare

  • IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

  • IMAGE_FAMILY: una famiglia di immagini. In questo modo, viene specificata l'immagine del sistema operativo più recente e non deprecata. Ad esempio, se specifichi debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per ulteriori informazioni sull'utilizzo delle famiglie di immagini, consulta le rispettive best practice.

  • REGION: la regione in cui creare il template di istanza.

  • MACHINE_TYPE: il tipo di macchina A4 o A3 Ultra specificato nella prenotazione che vuoi utilizzare.

  • RESERVATION_URL: l'URL della prenotazione creata automaticamente per una prenotazione futura in modalità calendario che vuoi utilizzare. Specifica uno dei seguenti valori:

    • Se la prenotazione creata automaticamente esiste nel tuo progetto: RESERVATION_NAME.

    • Se la prenotazione creata automaticamente esiste in un progetto diverso: projects/PROJECT_ID/reservations/RESERVATION_NAME.

REST

Per creare un template di istanza, invia una richiesta POST a uno dei seguenti metodi:

Nel corpo della richiesta, includi i seguenti campi:

  • Il campo reservationAffinity.consumeReservationType impostato su SPECIFIC_RESERVATION.

  • Il campo reservationAffinity.key impostato su compute.googleapis.com/reservation-name.

  • Il campo reservationAffinity.values impostato sull'URL della prenotazione creata automaticamente.

  • Il campo scheduling.instanceTerminationAction impostato su DELETE.

  • Il campo scheduling.onHostMaintenance impostato su TERMINATE.

  • Il campo scheduling.provisioningModel impostato su RESERVATION_BOUND.

Ad esempio, per creare un modello di istanza regionale, effettua una richiesta come segue:

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "reservationAffinity": {
      "consumeReservationType": "SPECIFIC_RESERVATION",
      "key": "compute.googleapis.com/reservation-name",
      "values": [
        "RESERVATION_URL"
      ]
    },
    "scheduling": {
      "instanceTerminationAction": "DELETE",
      "onHostMaintenance": "TERMINATE",
      "provisioningModel": "RESERVATION_BOUND"
    }
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui creare il template di istanza.

  • REGION: la regione in cui creare il template di istanza

  • INSTANCE_TEMPLATE_NAME: il nome del template di istanza da creare

  • IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud. Per saperne di più sui progetti di immagini supportati, vedi Immagini pubbliche.

  • IMAGE: specifica una delle seguenti opzioni:

    • Una versione specifica dell'immagine sistema operativo, ad esempio debian-12-bookworm-v20240617.

    • Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. In questo modo, viene specificata l'immagine sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-12, viene utilizzata l'ultima versione della famiglia di immagini Debian 12. Per saperne di più sull'utilizzo delle famiglie di immagini, consulta le best practice per le famiglie di immagini.

  • MACHINE_TYPE: il tipo di macchina A4 o A3 Ultra specificato nella prenotazione che vuoi utilizzare.

  • RESERVATION_URL: l'URL della prenotazione creata automaticamente per una prenotazione futura in modalità calendario che vuoi utilizzare. Specifica uno dei seguenti valori:

    • Se la prenotazione creata automaticamente esiste nel tuo progetto: RESERVATION_NAME

    • Se la prenotazione creata automaticamente si trova in un progetto diverso: projects/PROJECT_ID/reservations/RESERVATION_NAME

Per saperne di più sulla creazione di un template di istanza, consulta Crea template di istanza.

Crea o aggiorna un gruppo di istanze gestite

Dopo aver creato il template di istanza come descritto nella sezione precedente, utilizzalo per generare un gruppo di istanze gestite o per aggiornarlo. Inoltre, per preparare il gruppo di istanze gestite per le richieste di ridimensionamento, devi eseguire queste operazioni:

Per creare un gruppo di istanze gestite compatibile con le richieste di ridimensionamento, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud , vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Fai clic su Crea gruppo di istanze. Viene visualizzata la pagina Crea gruppo di istanze.

  3. Nel campo Nome, inserisci un nome per il gruppo di istanze gestite.

  4. Prima di selezionare un modello di istanza, devi eliminare la configurazione della scalabilità automatica e disattivare le riparazioni nel seguente modo:

    1. Per eliminare la configurazione della scalabilità automatica:

      1. Nella sezione Scalabilità automatica, fai clic sull'elenco Modalità di scalabilità automatica, quindi su Elimina configurazione di scalabilità automatica.

      2. Nella finestra di dialogo di conferma, fai clic su Elimina.

    2. Per disattivare le riparazioni, nella sezione Ciclo di vita di un'istanza VM, fai clic sull'elenco Azione predefinita in caso di errore e seleziona Nessuna azione.

  5. Torna al campo Template di istanza. Nell'elenco Modello di istanza, seleziona il modello di istanza creato nella sezione precedente. Se selezioni un template di istanza regionale, l'elenco Regione viene impostato sulla regione del template.

  6. Esegui una di queste operazioni:

    • Per creare una richiesta di ridimensionamento quando crei il MIG:

      1. Nel campo Numero di istanze, inserisci il numero di VM che vuoi creare in una volta.

      2. Seleziona la casella di controllo Utilizza la richiesta di ridimensionamento per creare tutte le VM in una volta.

      3. (Facoltativo) Se il modello di istanza del MIG specifica una durata di esecuzione, puoi specificarne una diversa. Per farlo, specifica una durata di esecuzione nei campi Durata esecuzione richiesta e negli elenchi Unità. Devi specificare una durata compresa tra un'ora e sette giorni.

    • Per creare una richiesta di ridimensionamento dopo aver creato il gruppo di istanze gestite, inserisci 0 nel campo Numero di istanze.

  7. Nella sezione Località, specifica se vuoi creare un gruppo di istanze gestite a livello di zona o di regione come segue:

    1. Per creare un gruppo di istanze gestite a livello di zona, seleziona Zona singola. In alternativa, per creare un gruppo di istanze gestite a livello di regione, seleziona Più zone.

    2. Seleziona la regione e le zone del gruppo di istanze gestite.

    3. Se stai creando un gruppo di istanze gestite a livello di regione, procedi nel seguente modo:

      1. Nel campo Forma di distribuzione target, seleziona Qualsiasi zona singola.

      2. Nella finestra di dialogo visualizzata, fai clic su Disabilita ridistribuzione istanze.

  8. Fai clic su Crea.

gcloud

Utilizza il comando instance-groups managed create con il flag --default-action-on-vm-failure impostato su do_nothing. Se stai creando un gruppo di istanze gestite a livello di regione, devi includere anche il flag --target-distribution-shape impostato su any-single-zone e il flag --instance-redistribution-type impostato su none.

  • Per creare un gruppo di istanze gestite a livello di zona, esegui questo comando:

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

  • Per creare un gruppo di istanze gestite a livello di regione, esegui questo comando:

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

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite da creare

  • INSTANCE_TEMPLATE_URL: l'URL parziale del template di istanza che hai creato nella sezione precedente. Se vuoi utilizzare un template di istanza a livello regionale per creare il gruppo di istanze gestite, puoi farlo solo all'interno della regione del template. Specifica uno tra i seguenti valori:

    • Per un template di istanza regionale: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

    • Per un template di istanza globale: INSTANCE_TEMPLATE_NAME

  • ZONE: la zona in cui creare il gruppo di istanze gestite

  • REGION: la regione in cui creare il gruppo di istanze gestite

REST

  • Per creare un gruppo di istanze gestite a livello di zona, invia una richiesta POST utilizzando il metodo instanceGroupManagers.insert come segue:

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

{
  "versions": [
    {
      "instanceTemplate": "INSTANCE_TEMPLATE_URL"
    }
  ],
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": 0,
  "instanceLifecyclePolicy": {
    "defaultActionOnFailure": "DO_NOTHING"
  }
}

  • Per creare un gruppo di istanze gestite a livello di regione, invia una richiesta POST utilizzando il metodo regionInstanceGroupManagers.insert come segue:

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

{
  "versions": [
    {
      "instanceTemplate": "INSTANCE_TEMPLATE_URL"
    }
  ],
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": 0,
  "distributionPolicy": {
    "targetShape": "ANY_SINGLE_ZONE"
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  },
  "instanceLifecyclePolicy": {
    "defaultActionOnFailure": "DO_NOTHING"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste il template di istanza che hai creato nella sezione precedente.

  • INSTANCE_TEMPLATE_URL: l'URL parziale del template di istanza che hai creato nella sezione precedente. Se vuoi utilizzare un template di istanza a livello regionale per creare il gruppo di istanze gestite, puoi farlo solo all'interno della regione del template. Specifica uno tra i seguenti valori:

    • Per un template di istanza regionale: regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME

    • Per un template di istanza globale: global/instanceTemplates/INSTANCE_TEMPLATE_NAME

  • ZONE: la zona in cui creare il gruppo di istanze gestite

  • REGION: la regione in cui creare il gruppo di istanze gestite

  • INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite da creare

Crea una richiesta di ridimensionamento in un gruppo di istanze gestite

Prima di creare richieste di ridimensionamento del gruppo di istanze gestite, assicurati di aver preparato il gruppo di istanze gestite come descritto nella sezione precedente.

Dopo la creazione di una richiesta di ridimensionamento e quando tutte le risorse richieste diventano disponibili, il gruppo di istanze gestite crea in una volta il numero richiesto di VM. Le VM vengono eseguite fino a quando il gruppo di istanze gestite non le elimina al termine della durata di esecuzione specificata o fino a quando non le elimini tu manualmente.

Per creare una richiesta di ridimensionamento in un gruppo di istanze gestite, seleziona una delle seguenti opzioni. Per aggiungere VM con nomi specifici al gruppo di istanze gestite tramite una richiesta di ridimensionamento, utilizza gcloud CLI o l'API REST.

Console

  1. Nella console Google Cloud , vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Nella colonna Nome, fai clic sul nome del gruppo di istanze gestite in cui creare la richiesta di ridimensionamento.

    Si apre la pagina di riepilogo del gruppo di istanze gestite.

  3. Nella riga Richieste di ridimensionamento, fai clic su Modifica richieste di ridimensionamento.

  4. Fai clic su Nuova richiesta di ridimensionamento.

    Viene visualizzato il riquadro Nuove richieste di ridimensionamento.

  5. Nel campo Nome, inserisci il nome della richiesta di ridimensionamento.

  6. Nel campo Numero di istanze aggiuntive necessarie, inserisci il numero di VM da aggiungere al gruppo di istanze gestite contemporaneamente.

  7. (Facoltativo) Se il template di istanza del MIG specifica una durata di esecuzione, puoi specificarne una diversa. A tale scopo, nei campi Durata esecuzione richiesta e negli elenchi Unità, specifica una durata di esecuzione. Devi specificare una durata compresa tra un'ora e sette giorni.

  8. Fai clic su Crea.

gcloud

  • Per creare una richiesta di ridimensionamento in un gruppo di istanze gestite a livello di zona, utilizza il comando instance-groups managed resize-requests create.

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

  • Per creare una richiesta di ridimensionamento in un gruppo di istanze gestite a livello di regione, utilizza il comando beta instance-groups managed resize-requests create.

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

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite configurato per la creazione di richieste di ridimensionamento

  • RESIZE_REQUEST_NAME: il nome della richiesta di ridimensionamento, che deve essere univoco, all'interno del gruppo di istanze gestite specificato. Se così non fosse, la creazione della richiesta di ridimensionamento non va a buon fine.

  • COUNT: il numero di VM da aggiungere al gruppo di istanze gestite contemporaneamente

  • ZONE: la zona in cui esiste il gruppo di istanze gestite

  • REGION: la regione in cui esiste il gruppo di istanze gestite

In via facoltativa, puoi procedere come segue:

REST

  • Per creare una richiesta di ridimensionamento in un gruppo di istanze gestite a livello di zona, invia una richiesta POST utilizzando il metodo instanceGroupManagerResizeRequests.insert.

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

  • Per creare una richiesta di ridimensionamento in un gruppo di istanze gestite a livello di regione, invia una richiesta POST utilizzando il metodo beta.regionInstanceGroupManagerResizeRequests.insert.

Nel corpo della richiesta, includi quanto segue:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste il gruppo di istanze gestite specificato

  • ZONE: la zona in cui esiste il gruppo di istanze gestite

  • REGION: la regione in cui esiste il gruppo di istanze gestite

  • INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite configurato per la creazione di richieste di ridimensionamento

  • RESIZE_REQUEST_NAME: il nome della richiesta di ridimensionamento, che deve essere univoco, all'interno del gruppo di istanze gestite specificato. Se così non fosse, la creazione della richiesta di ridimensionamento non va a buon fine.

  • COUNT: il numero di VM da aggiungere contemporaneamente al gruppo di istanze gestite

In via facoltativa, puoi procedere come segue:

Passaggi successivi