Limitare il tempo di esecuzione delle VM in un gruppo di istanze gestite

Questo documento descrive come terminare automaticamente le macchine virtuali (VM) in un gruppo di istanze gestite specificando un limite di tempo per le VM. Descrive inoltre il funzionamento del limite di tempo per le VM in un gruppo di istanze gestite.

Puoi ottimizzare i carichi di lavoro temporanei specificando un limite di tempo per le VM in un gruppo di istanze gestite. Quando una VM raggiunge il limite di tempo, il gruppo di istanze gestite termina automaticamente (elimina) la VM. La limitazione del tempo di esecuzione delle VM in un gruppo di istanze gestite in base a un limite di tempo consente di ridurre al minimo i costi e liberare la quota.

Per scoprire come specificare un limite di tempo per una VM autonoma, consulta Limitare il tempo di esecuzione di una VM. Se vuoi che un gruppo di istanze gestite aggiunga o elimini automaticamente le VM in base ai tuoi carichi di lavoro, consulta Gruppi di istanze con scalabilità automatica.

Prima di iniziare

  • Se non l'hai già fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in Compute Engine come segue.

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

Limitare il tempo di esecuzione delle VM in un gruppo di istanze gestite

Puoi limitare il tempo di esecuzione delle VM in un gruppo di istanze gestite specificando un limite di tempo nel modello di istanza utilizzato per il gruppo di istanze gestite. Quando il gruppo di istanze gestite crea VM in base al modello, viene applicato un limite di tempo a ogni VM.

Puoi specificare uno di due tipi di limiti di tempo:

  • Limite di tempo come durata dell'esecuzione
  • Limite di tempo come tempo di risoluzione

Per specificare un limite di tempo per le VM in un gruppo di istanze gestite:

  1. Crea un modello di istanza con una durata di esecuzione per le VM o con un'ora di terminazione per le VM.

  2. Utilizza il modello di istanza per creare un gruppo di istanze gestite o aggiornare un gruppo di istanze gestite esistente.

Limitazioni

  • Quando crei un modello di istanza per specificare un limite di tempo per le VM in un gruppo di istanze gestite, si applicano le seguenti limitazioni:

    • Non puoi impostare l'azione di chiusura su STOP. I gruppi di istanze gestite supportano solo DELETE.
    • Non puoi utilizzare le VM spot.

  • Non puoi creare una richiesta di ridimensionamento in un gruppo di istanze gestite che utilizza un modello di istanza che limita il tempo di esecuzione della VM.

  • Non puoi limitare il tempo di esecuzione delle VM in un gruppo di istanze gestite a livello di regione con la forma di distribuzione di destinazione EVEN e la ridistribuzione proattiva delle istanze abilitate.

Crea un modello di istanza con una durata di esecuzione per le VM

Per terminare automaticamente le VM in un gruppo di istanze gestite dopo che sono state eseguite per una determinata durata, imposta una durata massima (maxRunDuration) nel modello di istanza.

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. Seleziona la Località come descritto di seguito:

    • Se vuoi utilizzare il modello di istanza in più regioni, scegli Globale.
    • Se vuoi ridurre la dipendenza tra regioni, scegli A livello di regione.

  4. Se hai scelto l'area geografica, seleziona la Regione in cui vuoi creare il modello di istanza.

  5. Nella sezione Criteri di disponibilità, espandi Impostazioni avanzate del modello di provisioning delle VM.

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

  7. Nel campo Tipo di limite di tempo, seleziona Per ore (impostazione predefinita) per specificare il limite di tempo come durata. Nel campo successivo inserisci la durata in ore.

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

  9. Per gli altri campi, accetta i valori predefiniti o modificali come richiesto.

  10. Fai clic su Crea.

gcloud

Utilizza il comando instance-templates create beta. Per eliminare automaticamente le VM dopo un determinato periodo di tempo, includi il flag --max-run-duration e imposta il flag --instance-termination-action su DELETE in questo modo:

  gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
      --max-run-duration=DURATION \
      --instance-termination-action=DELETE

Sostituisci quanto segue:

  • INSTANCE_TEMPLATE_NAME: il nome del modello di istanza.

  • DURATION: la durata di esecuzione delle VM. Il gruppo di istanze gestite elimina automaticamente la VM dopo la durata specificata.

    Formatta la durata come il numero di giorni, ore, minuti e secondi seguiti rispettivamente da d, h, m e s. Ad esempio, specifica 30m per una durata di 30 minuti o 1d2h3m4s per una durata di 1 giorno, 2 ore, 3 minuti e 4 secondi. La durata minima è di 30 secondi (30s) e la durata massima è di 120 giorni (120d).

REST

Utilizza il metodo instanceTemplates.insert beta. Per eliminare automaticamente le VM dopo un determinato periodo di tempo, includi il campo maxRunDuration e imposta il campo instanceTerminationAction su DELETE come segue:

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default",
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ]
      }
    ],
    "disks": [
      {
        "type": "PERSISTENT",
        "boot": true,
        "mode": "READ_WRITE",
        "initializeParams":
        {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ]
    "scheduling": {
      "maxRunDuration":
      {
        "seconds": DURATION
      },
      "instanceTerminationAction": "DELETE"
    }
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi creare il modello di istanza.
  • INSTANCE_TEMPLATE_NAME: il nome del modello di istanza.
  • MACHINE_TYPE: il tipo di macchina predefinita o personalizzata per le VM nel gruppo.
  • IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud.

  • IMAGE o IMAGE_FAMILY: specifica una delle seguenti opzioni:

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

    • IMAGE_FAMILY: una famiglia di immagini. Specifica l'immagine del sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-10, viene utilizzata l'ultima versione della famiglia di immagini Debian 10.

  • DURATION: la durata di esecuzione delle VM. Il gruppo di istanze gestite elimina automaticamente la VM dopo la durata specificata.

    Formatta la durata come il numero di giorni, ore, minuti e secondi seguiti rispettivamente da d, h, m e s. Ad esempio, specifica 30m per una durata di 30 minuti o 1d2h3m4s per una durata di 1 giorno, 2 ore, 3 minuti e 4 secondi. La durata minima è di 30 secondi (30s) e la durata massima è di 120 giorni (120d).

Crea un modello di istanza con un'ora di terminazione per le VM

Per terminare automaticamente le VM in un gruppo di istanze gestite in un momento specifico, imposta un'ora di terminazione (terminationTime) nel modello di istanza. Puoi impostare una data e un'ora in cui vuoi che un gruppo di istanze gestite arresti le VM.

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. Seleziona la Località come descritto di seguito:

    • Se vuoi utilizzare il modello di istanza in più regioni, scegli Globale.
    • Se vuoi ridurre la dipendenza tra regioni, scegli A livello di regione.

  4. Se hai scelto l'area geografica, seleziona la Regione in cui vuoi creare il modello di istanza.

  5. Nella sezione Criteri di disponibilità, espandi Impostazioni avanzate del modello di provisioning delle VM.

  6. Nel campo Tipo di limite di tempo, seleziona Per data per specificare il limite di tempo come ora e data. Nel campo successivo, fai clic su Seleziona data e ora e seleziona la data, l'ora e il fuso orario per la risoluzione automatica.

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

  8. Per gli altri campi, accetta i valori predefiniti o modificali come richiesto.

  9. Fai clic su Crea.

gcloud

Utilizza il comando instance-templates create beta. Per eliminare automaticamente le VM in un momento specifico, includi il flag --termination-time e imposta il flag --instance-termination-action su DELETE come segue:

  gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
      --termination-time=TIME \
      --instance-termination-action=DELETE

Sostituisci quanto segue:

  • INSTANCE_TEMPLATE_NAME: il nome del modello di istanza.

  • TIME: l'ora in cui vuoi che questa VM venga terminata automaticamente. L'ora specificata deve essere di almeno 30 secondi nel futuro e di massimo 120 giorni nel futuro. Formatta l'ora come timestamp RFC 3339:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Sostituisci quanto segue:

    • YYYY-MM-DD: una data formattata come anno di quattro cifre, mese di due cifre e giorno del mese di due cifre separate da trattini.
    • HH:MM:SS: un'ora nel formato a due cifre che utilizza il formato 24 ore, i minuti a due cifre e le due cifre dei secondi, separati da due punti.
    • OFFSET: il fuso orario formattato come offset del fuso orario UTC (Coordinated Universal Time). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time, 8 ore prima del fuso orario UTC), specifica -08:00. In alternativa, per non utilizzare offset (UTC+0), specifica Z.

REST

Utilizza il metodo instanceTemplates.insert beta. Per eliminare automaticamente le VM in un momento specifico, includi il campo terminationTime e imposta il campo instanceTerminationAction su DELETE come segue:

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

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default",
        "accessConfigs": [
          {
            "name": "external-IP",
            "type": "ONE_TO_ONE_NAT"
          }
        ]
      }
    ],
    "disks": [
      {
        "type": "PERSISTENT",
        "boot": true,
        "mode": "READ_WRITE",
        "initializeParams":
        {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ]
    "scheduling": {
      "terminationTime": TIME,
      "instanceTerminationAction": "DELETE"
    }
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi creare il modello di istanza.
  • INSTANCE_TEMPLATE_NAME: il nome del modello di istanza.
  • MACHINE_TYPE: il tipo di macchina predefinita o personalizzata per le VM nel gruppo.
  • IMAGE_PROJECT: il progetto immagine che contiene l'immagine, ad esempio debian-cloud.

  • IMAGE o IMAGE_FAMILY: specifica una delle seguenti opzioni:

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

    • IMAGE_FAMILY: una famiglia di immagini. Specifica l'immagine del sistema operativo più recente e non deprecata. Ad esempio, se specifichi family/debian-10, viene utilizzata l'ultima versione della famiglia di immagini Debian 10.

  • TIME: l'ora in cui vuoi che questa VM venga terminata automaticamente. L'ora specificata deve essere di almeno 30 secondi nel futuro e di massimo 120 giorni nel futuro. Formatta l'ora come timestamp RFC 3339:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Sostituisci quanto segue:

    • YYYY-MM-DD: una data formattata come anno di quattro cifre, mese di due cifre e giorno del mese di due cifre separate da trattini.
    • HH:MM:SS: un'ora nel formato a due cifre che utilizza il formato 24 ore, i minuti a due cifre e le due cifre dei secondi, separati da due punti.
    • OFFSET: il fuso orario formattato come offset del fuso orario UTC (Coordinated Universal Time). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time, 8 ore prima del fuso orario UTC), specifica -08:00. In alternativa, per non utilizzare offset (UTC+0), specifica Z.

Come funziona il limite di tempo per le VM in un gruppo di istanze gestite

Quando specifichi un limite di tempo per le VM in un gruppo di istanze gestite, il momento in cui un gruppo di istanze gestite termina automaticamente una VM viene impostato automaticamente nel campo del timestamp di terminazione (terminationTimestamp) della VM.

In base al tipo di limite di tempo specificato, il timestamp di terminazione di una VM viene impostato come segue:

  • Limite di tempo come durata dell'esecuzione (maxRunDuration):

    terminationTimestamp di una VM = ora di inizio o creazione più recente della VM + maxRunDuration

    Quando specifichi una durata, il timestamp di terminazione viene impostato in base all'ultima ora di creazione o di inizio della VM. Se la VM viene ricreata, riavviata, ripresa o sostituita, il timestamp di terminazione viene ricalcolato. Il timestamp di terminazione può variare tra le VM in un gruppo di istanze gestite in base all'ora in cui ciascuna VM è stata creata o avviata l'ultima volta. Ad esempio, se una VM viene riparata, il relativo timestamp di terminazione viene ricalcolato aggiungendo la durata al momento in cui la VM è stata ricreata durante la riparazione.

  • Limite di tempo per la risoluzione (terminationTime):

    terminationTimestamp di una VM = terminationTime

    Quando specifichi un orario, il timestamp di terminazione è impostato su quell'ora, a condizione che sia nel futuro. Se il tempo di terminazione è trascorso, qualsiasi azione del gruppo di istanze gestite che tenti di creare, riavviare o sostituire una VM non riesce e restituisce un errore. Per risolvere un errore di questo tipo, devi creare un nuovo modello di istanza con un'ora di fine futura e applicare il modello al gruppo di istanze gestite. Se vuoi utilizzare le proprietà del modello esistente nel nuovo modello, crea un modello di istanza basato su quello esistente.

Durante un aggiornamento della VM, il timestamp di terminazione non cambia. Ad esempio, se imposti il livello di interruzione per gli aggiornamenti su REFRESH, il timestamp di terminazione viene conservato ogni volta che il gruppo di istanze gestite aggiorna la VM.

Quando sospendi o arresti una VM in un gruppo di istanze gestite, il timestamp di terminazione viene cancellato automaticamente indipendentemente dal tipo di limite di tempo. Quando riprendi o avvii una VM, il timestamp di terminazione viene impostato di nuovo in base al tipo di limite di tempo, come spiegato in precedenza in questa sezione.

Come funziona la scalabilità automatica quando è impostato un limite di tempo

La scalabilità automatica consente al gruppo di istanze gestite di aggiungere o rimuovere automaticamente le VM in base all'aumento o alla diminuzione del carico. Quando un gruppo di istanze gestite elimina le VM che hanno raggiunto i timestamp di terminazione, crea nuove VM per mantenere le dimensioni consigliate dal gestore della scalabilità automatica. Le nuove VM vengono eseguite per il limite di tempo specificato. Se il consiglio del gestore della scalabilità automatica prevede di ridurre il numero di VM, il gruppo di istanze gestite elimina le VM anche prima che raggiungano i limiti di tempo.

Se hai configurato le pianificazioni di scalabilità, le VM vengono eseguite solo fino alla fine di una pianificazione o fino a quando una VM raggiunge il timestamp di terminazione, a seconda dell'evento che si verifica per primo.

Passaggi successivi