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 scoprire di più sulle richieste di ridimensionamento dei MIG, consulta Informazioni sulle richieste di ridimensionamento in un MIG.

La creazione di una richiesta di ridimensionamento di un 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 di un MIG che può utilizzare le funzionalità e i servizi disponibili in AI Hypercomputer, consulta invece Crea un MIG e una richiesta di ridimensionamento nella documentazione di AI Hypercomputer.

Puoi anche utilizzare la modalità in blocco nei MIG per creare istanze tutte insieme in modo da raggiungere le dimensioni target impostate. Per scoprire di più su questa opzione, consulta Informazioni sulla modalità in blocco.

Prima di iniziare

  • Per utilizzare le richieste di ridimensionamento dei MIG per creare VM con avvio flessibile per i workload 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 attesa finché non disponi di una quota sufficiente.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init
  • Imposta una regione e una zona predefinite.

    • 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 accedi a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare richieste di ridimensionamento dei MIG, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) sul 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 dei MIG. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare richieste di ridimensionamento dei MIG 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 MIG: 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 una richiesta di ridimensionamento del MIG, devi configurare un template di istanza e il MIG come descritto nelle sezioni seguenti.

Crea un template di istanza

In base al tuo caso d'uso per le richieste di ridimensionamento dei MIG, 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 MIG e di VM con avvio flessibile, 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 Seleziona un'immagine nella documentazione relativa alla VM di Deep Learning.

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 template di 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 una regione che supporti i tipi di macchine GPU o H4D.

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

  5. Nella sezione Configurazione macchina, specifica un tipo di macchina.

  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 un periodo di esecuzione per le VM create utilizzando 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 le seguenti impostazioni dei 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 seguente comando di esempio crea un template di istanza regionale. 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

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. Specifica una famiglia di immagini per utilizzare l'immagine 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. Specifica una regione che supporti i tipi di macchine GPU o H4D.

  • MACHINE_TYPE: il tipo di macchina da utilizzare per le VM con avvio flessibile. 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, effettua una richiesta POST a uno dei seguenti metodi:

Nel corpo della richiesta, includi i seguenti campi:

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

La seguente richiesta di esempio crea un template di istanza regionale:

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"
      }
    ],
    "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. Specifica una regione che supporti i tipi di macchine GPU o H4D.

  • 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. Specifica una famiglia di immagini per utilizzare 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 ulteriori informazioni sull'utilizzo delle famiglie di immagini, consulta le rispettive best practice.

  • MACHINE_TYPE: il tipo di macchina da utilizzare per le VM con avvio flessibile. 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.

Utilizza il modello di provisioning con prenotazione

Per creare un template di istanza configurato per le richieste di ridimensionamento del MIG e per l'utilizzo di una prenotazione, devi specificare quanto segue nel template:

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 template di 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 una regione che supporti i tipi di macchine GPU o H4D.

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

  5. Nella sezione Configurazione macchina, specifica un tipo di macchina.

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

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

    2. Nell'elenco Informazioni sulla terminazione delle 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 e poi 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 le seguenti impostazioni dei 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.

Il seguente comando di esempio crea un template di istanza regionale. 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. Specifica una famiglia di immagini per utilizzare l'immagine 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. Specifica una regione che supporti i tipi di macchine GPU o H4D.

  • MACHINE_TYPE: il tipo di macchina 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, effettua 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 template 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. Specifica una regione che supporti i tipi di macchine GPU o H4D.

  • 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. Specifica una famiglia di immagini per utilizzare 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 ulteriori informazioni sull'utilizzo delle famiglie di immagini, consulta le rispettive best practice.

  • MACHINE_TYPE: il tipo di macchina 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

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 il MIG, seleziona una delle seguenti opzioni. Se vuoi specificare una policy del workload per ridurre al minimo la latenza di rete tra le VM, devi utilizzare gcloud CLI o l'API REST.

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 template di istanza, devi disattivare le riparazioni come segue:

    1. Nella sezione Ciclo di vita di un'istanza VM, deseleziona la casella di controllo Consenti la riparazione delle VM in una zona alternativa.

    2. Nell'elenco Azione predefinita in caso di errore, seleziona Nessuna azione.

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

  6. Nel campo Numero di istanze, inserisci 0.

  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 MIG_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 MIG_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:

  • MIG_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

Se vuoi applicare una policy di workload al MIG, includi il flag --workload-policy nel comando. Devi specificare una policy di workload che si trovi nella stessa regione del MIG.

REST

  • Per creare un MIG 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": "MIG_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": "MIG_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 si trova il template di istanza 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

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

Se vuoi applicare una policy di workload al MIG, includi il campo workloadPolicy nel corpo della richiesta. Devi specificare una policy di workload che si trovi nella stessa regione del MIG.

Crea una richiesta di ridimensionamento in un gruppo di istanze gestite

Prima di creare richieste di ridimensionamento del MIG, assicurati di aver preparato il MIG 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, seleziona una delle seguenti opzioni:

Specifica il numero di VM

Per creare una richiesta di ridimensionamento che specifica il numero di VM da aggiungere al MIG in una sola operazione, seleziona una delle seguenti opzioni.

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 un periodo di esecuzione, puoi specificarne uno diverso. Per farlo, specifica una durata di esecuzione nel campo Durata esecuzione richiesta e negli elenchi Unità. 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 MIG_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 instance-groups managed resize-requests create.

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

Sostituisci quanto segue:

  • MIG_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

Facoltativamente, puoi eseguire una o entrambe le seguenti operazioni:

  • Se il template di istanza del MIG specifica una durata di esecuzione, puoi specificare una durata di esecuzione diversa. Per farlo, includi il flag --requested-run-duration nel comando. Devi specificare una durata compresa tra 10 minuti e sette giorni.

REST

  • Per creare una richiesta di ridimensionamento in un MIG 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/MIG_NAME/resizeRequests
{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT
}

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

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests
{
  "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

  • MIG_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

Facoltativamente, puoi eseguire una o entrambe le seguenti operazioni:

  • Se il template di istanza del MIG specifica una durata di esecuzione, puoi specificare una durata di esecuzione diversa. Per farlo, includi il campo requestedRunDuration nel corpo della richiesta. Devi specificare una durata, in secondi, compresa tra 10 minuti e sette giorni.

Specifica un elenco di nomi VM

Se il tuo workload richiede determinati nomi VM, specifica un elenco di nomi per creare le VM. Il numero di nomi specificati determina il numero di VM che il MIG crea contemporaneamente.

Per creare una richiesta di ridimensionamento in un MIG specificando un elenco di nomi di VM, utilizza gcloud CLI o l'API REST.

gcloud

Per creare una richiesta di ridimensionamento con nomi di VM specifici in un MIG, utilizza il comando beta gcloud compute instance-groups managed resize-requests create con il flag --instances:

  • In un MIG a livello di zona, esegui il seguente comando:

    gcloud beta compute instance-groups managed resize-requests create MIG_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --instances=INSTANCE_NAMES \
    --zone=ZONE

  • In un MIG a livello di regione, esegui il seguente comando:

    gcloud beta compute instance-groups managed resize-requests create MIG_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --instances=INSTANCE_NAMES \
    --region=REGION

Sostituisci quanto segue:

  • MIG_NAME: il nome del MIG.
  • RESIZE_REQUEST_NAME: il nome della richiesta di ridimensionamento, che deve essere univoco, all'interno del MIG specificato. Se così non fosse, la creazione della richiesta di ridimensionamento non va a buon fine.
  • INSTANCE_NAMES: un elenco separato da virgole di nomi per le VM che vuoi creare. Ad esempio, instance-1,instance-2,instance-3.
  • ZONE: la zona in cui esiste il gruppo di istanze gestite
  • REGION: la regione in cui esiste il gruppo di istanze gestite

REST

Per creare una richiesta di ridimensionamento con nomi di VM specifici in un MIG, utilizza uno dei seguenti metodi:

Ad esempio, per specificare due nomi di VM, includi quanto segue nel corpo della richiesta:

{
  "name": "RESIZE_REQUEST_NAME",
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste il MIG specificato
  • MIG_NAME: il nome del MIG.
  • RESIZE_REQUEST_NAME: il nome della richiesta di ridimensionamento, che deve essere univoco, all'interno del MIG specificato. Se così non fosse, la creazione della richiesta di ridimensionamento non va a buon fine.
  • INSTANCE_NAME_1, INSTANCE_NAME_2: i nomi delle VM che vuoi creare.
  • ZONE: la zona in cui esiste il gruppo di istanze gestite
  • REGION: la regione in cui esiste il gruppo di istanze gestite

Passaggi successivi