Creare richieste di ridimensionamento in un gruppo di istanze gestite

Console

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

   Vai a Modelli di istanza

2. Fai clic su Crea modello istanza.

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

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

   • Per creare un modello di istanza globale, seleziona Globale, se non è già selezionato.

   • Per creare un modello di istanza regionale, seleziona Regionale e poi la regione in cui creare il modello di istanza.

5. Nella sezione Configurazione macchina:

   1. Fai clic sulla scheda GPU.

   2. Nell'elenco Tipo di GPU, seleziona il tipo di GPU.

   3. Nell'elenco Numero di GPU, seleziona il numero di GPU.

   4. (Facoltativo) Se il modello di GPU supporta le workstation virtuali (vWS) NVIDIA RTX per i carichi di lavoro grafici, e prevedi di eseguire carichi di lavoro ad alta intensità di grafica, seleziona Abilita workstation virtuale (NVIDIA GRID).

   5. Nella sezione Tipo di macchina, seleziona un tipo di macchina.

6. (Facoltativo) Per modificare il tipo o l'immagine del disco di avvio predefinito, fai clic su Cambia nella sezione Disco di avvio. Poi segui le istruzioni per cambiare il disco di avvio.

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

   1. Espandi la sezione Gestione.

   2. Nell'elenco Prenotazioni, seleziona Non utilizzare.

8. Fai clic su Crea.

gcloud

Per creare un modello di istanza configurato per creare richieste di ridimensionamento in un gruppo di istanze gestite, utilizza il comando instance-templates create con i seguenti flag:

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

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

Ad esempio, utilizza il seguente comando per creare un modello di istanza regionale. Se vuoi creare un modello 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 \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=TERMINATE \
    --reservation-affinity=none

Sostituisci quanto segue:

• INSTANCE_TEMPLATE_NAME: il nome del modello di istanza da creare.

• IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud. Per ulteriori informazioni sui progetti di immagini supportati, consulta Immagini pubbliche.

• IMAGE_FAMILY: una famiglia di immagini. Viene specificata l'immagine del sistema operativo più recente e non ritirata. Ad esempio, se specifichi debian-12, viene utilizzata la versione più recente 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.

  Se vuoi utilizzare una versione specifica dell'immagine del sistema operativo, ad esempio debian-12-buster-v20240701, sostituisci il flag --image-family con il flag --image.

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

• MACHINE_TYPE: un tipo di macchina che supporta le GPU. Se specifichi un tipo di macchina N1, includi il flag --accelerator per specificare il numero e il tipo di GPU da collegare alle VM.

REST

Per creare un modello di istanza configurato per creare richieste di ridimensionamento in un gruppi di istanze gestite, invia una richiesta POST a uno dei seguenti metodi:

• Per creare un modello di istanza regionale: metodo regionInstanceTemplates.insert

• Per creare un modello di istanza globale: metodo instanceTemplates.insert

Nel corpo della richiesta:

• Includi il campo scheduling.onHostMaintenance e impostalo su TERMINATE.

• Includi il campo reservationAffinity.consumeReservationType e impostalo su NO_RESERVATION.

Ad esempio, per creare un modello di istanza regionale, effettua una richiesta POST 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": {
      "onHostMaintenance": "TERMINATE"
    }
  }
}

Sostituisci quanto segue:

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

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

• INSTANCE_TEMPLATE_NAME: il nome del modello 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, consulta Immagini pubbliche.

• IMAGE: specifica una delle seguenti opzioni:

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

  • Una famiglia di immagini, che deve essere formattata come family/IMAGE_FAMILY. Questo specifica l'immagine del sistema operativo più recente e non ritirata. Ad esempio, se specifichi family/debian-12, viene utilizzata la versione più recente 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: un tipo di macchina che supporta le GPU. Se specifichi un tipo di macchina N1, includi il campo guestAccelerators nel corpo della richiesta per specificare il numero e il tipo di GPU da collegare alle VM.

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. Nell'elenco Modello di istanza, seleziona il modello di istanza creato nella sezione precedente. Se selezioni un modello di istanza regionale, l'elenco Regione viene impostato sulla regione del modello di istanza.

5. 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 regionale, 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 di destinazione, seleziona Qualsiasi zona singola. Puoi selezionare questa opzione solo dopo aver eliminato la configurazione dell'autoscaling nei passaggi successivi.

      2. Dopo aver selezionato l'opzione Qualsiasi zona singola, nella finestra di dialogo visualizzata fai clic su Disattiva la ridistribuzione delle istanze.

6. Elimina la configurazione della scalabilità automatica nel seguente modo:

   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.

7. Disattiva le riparazioni nel seguente modo:

   1. Nella sezione Ciclo di vita dell'istanza VM, fai clic sull'elenco Azione predefinita in caso di errore.

   2. Seleziona Nessuna azione.

8. Esegui una di queste operazioni:

   • A questo punto, per creare una richiesta di ridimensionamento:

     1. Nel campo Numero di istanze, inserisci il numero di VM che vuoi creare contemporaneamente.

        

     2. Seleziona la casella di controllo Utilizza la richiesta di ridimensionamento per creare tutte le VM contemporaneamente.

     3. Nel campo Durata esecuzione richiesta e nell'elenco Unità, specifica la durata di esecuzione delle VM. La durata deve essere compresa tra 1 ora e 7 giorni.

   • In caso contrario, inserisci 0 nel campo Numero di istanze. In seguito, puoi aggiungere VM al gruppo creando richieste di ridimensionamento.

9. 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 crei 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 zonale, esegui il seguente comando:

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

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

  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 modello di istanza che hai creato nella sezione precedente. Se vuoi utilizzare un modello di istanza regionale per creare il gruppo di istanze gestite, puoi creare il gruppo di istanze gestite solo all'interno della regione del modello. Specifica uno tra i seguenti valori:

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

  • Per un modello 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 si trova il modello di istanza creato nella sezione precedente.

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

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

  • Per un modello 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.

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 panoramica del gruppo di istanze gestite.

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

4. Fai clic su add 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 con scalabilità automatica contemporaneamente.

7. Nei campi Durata esecuzione richiesta e Unità, specifica la durata di esecuzione delle VM richieste. La durata deve essere compresa tra 1 ora e 7 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 \
      --requested-run-duration=RUN_DURATION \
      --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 \
      --requested-run-duration=RUN_DURATION \
      --region=REGION
  

Sostituisci quanto segue:

• INSTANCE_GROUP_NAME: il nome del MIG configurato per la creazione di richieste di ridimensionamento al suo interno.

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

• COUNT: il numero di VM da aggiungere al MIG contemporaneamente.

• RUN_DURATION: la durata per cui vuoi eseguire le VM richieste. Il valore deve essere formattato 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 1 giorno, 2 ore, 3 minuti e 4 secondi. Il valore deve essere compreso tra 10 minuti e 7 giorni.

• ZONE: la zona in cui si trova il gruppo di istanze gestite.

• REGION: la regione in cui si trova il gruppo di istanze gestite.

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.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
  

Nel corpo della richiesta, includi quanto segue:

{
  "name": "RESIZE_REQUEST_NAME",
  "resizeBy": COUNT,
  "requestedRunDuration": {
    "seconds": "RUN_DURATION"
  }
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova il MIG specificato.

• ZONE: la zona in cui si trova il gruppo di istanze gestite.

• REGION: la regione in cui si trova 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. In caso contrario, la creazione della richiesta di ridimensionamento non va a buon fine.

• COUNT: il numero di VM da aggiungere contemporaneamente al MIG.

• 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 (7 giorni).