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 (MIG) specificando un limite di tempo per le VM. Inoltre, descrive il funzionamento del limite di tempo per le VM in un gruppo di istanze gestite.

Puoi ottimizzare i workload temporanei specificando un limite di tempo per le VM in un MIG. Quando una VM raggiunge il limite di tempo, il gruppo di istanze gestite la termina automaticamente (la elimina). Limitare il tempo di esecuzione delle VM in un gruppo di istanze gestite con un limite di tempo consente di minimizzare i costi e liberare la quota.

Per informazioni su 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 ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per saperne di più, consulta Eseguire l'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 le VM in base al modello, il limite di tempo viene applicato a ogni VM.

Puoi specificare uno dei due tipi di limiti di tempo:

  • Limite di tempo come durata dell'esecuzione
  • Limite di tempo come ora di fine

Per specificare un limite di tempo per le VM in un MIG:

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

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

Limitazioni

  • Devi rispettare le limitazioni per limitare il tempo di esecuzione delle VM autonome.

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

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 in esecuzione per una determinata durata, imposta una durata massima di esecuzione (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 Regionale.

  4. Se hai scelto Regionale, seleziona la Regione in cui creare il modello di istanza.

  5. Nella sezione Criteri di disponibilità, espandi le 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 Al termine della VM, seleziona Elimina.

  9. Per gli altri campi, accetta i valori predefiniti o modificali in base alle necessità.

  10. Fai clic su Crea.

gcloud

Utilizza il comando instance-templates create. Per eliminare automaticamente le VM dopo una durata specifica, includi il flag --max-run-duration e imposta il flag --instance-termination-action su DELETE come segue:

  gcloud 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 per cui vuoi che le VM vengano eseguite. Il gruppo di istanze MIG elimina automaticamente la VM dopo la durata specificata.

    Formatta la durata come numero di giorni, ore, minuti e secondi seguito 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 quella massima di 120 giorni (120d).

Terraform

Per creare un modello di istanza utilizzando Terraform, utilizza la risorsagoogle_compute_instance_template. Per creare un modello di istanza che elimini automaticamente le VM dopo un periodo di tempo specifico, devi includere l' argomento max_run_duration e impostare l' argomento instance_termination_action su DELETE.

Per saperne di più, consulta la documentazione di Terraform per la risorsa google_compute_instance_template.

REST

Utilizza il metodo instanceTemplates.insert. Per eliminare automaticamente le VM dopo una durata specifica, includi il campomaxRunDuration e imposta il campoinstanceTerminationAction suDELETE come segue:

POST https://compute.googleapis.com/compute/v1/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: il 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 predefinito o personalizzato per le VM del 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. Viene specificata l'immagine del sistema operativo più recente e non ritirata. Ad esempio, se specifichi family/debian-10, viene utilizzata la versione più recente della famiglia di immagini Debian 10.

  • DURATION: la durata per cui vuoi che le VM vengano eseguite. Il gruppo di istanze gestite elimina automaticamente la VM dopo la durata specificata.

    Formatta la durata come numero di giorni, ore, minuti e secondi seguito 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 quella massima di 120 giorni (120d).

Crea un modello di istanza con una data e un'ora di interruzione 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 termini 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 Regionale.

  4. Se hai scelto Regionale, seleziona la Regione in cui creare il modello di istanza.

  5. Nella sezione Criteri di disponibilità, espandi le 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 data e ora. Nel campo successivo, fai clic su Seleziona data e ora e seleziona la data, l'ora e il fuso orario per l'interruzione automatica.

  7. Nell'elenco Al termine della VM, seleziona Elimina.

  8. Per gli altri campi, accetta i valori predefiniti o modificali in base alle necessità.

  9. Fai clic su Crea.

gcloud

Utilizza il comando instance-templates create. 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 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 la VM venga terminata automaticamente. L'ora specificata deve essere almeno 30 secondi nel futuro e al 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 a 4 cifre, mese a 2 cifre e giorno del mese a 2 cifre separati da trattini.
    • HH:MM:SS: un'ora formattata come ora a due cifre con il formato 24 ore, minuto a due cifre e secondo a due cifre separati da due punti.
    • OFFSET: il fuso orario formattato come offset del Tempo Coordinato Universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), che è 8 ore in anticipo rispetto al fuso orario UTC, specifica -08:00. In alternativa, per non utilizzare alcun offset (UTC+0), specifica Z.

REST

Utilizza il metodo instanceTemplates.insert. Per eliminare automaticamente le VM a un'ora specifica, includi il campoterminationTime e imposta il campoinstanceTerminationAction suDELETE come segue:

POST https://compute.googleapis.com/compute/v1/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: il 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 predefinito o personalizzato per le VM del 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 ritirata. Ad esempio, se specifichi family/debian-10, viene utilizzata la versione più recente della famiglia di immagini Debian 10.

  • TIME: l'ora in cui vuoi che la VM venga terminata automaticamente. L'ora specificata deve essere almeno 30 secondi nel futuro e al 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 a 4 cifre, mese a 2 cifre e giorno del mese a 2 cifre separati da trattini.
    • HH:MM:SS: un'ora formattata come ora a due cifre con il formato 24 ore, minuto a due cifre e secondo a due cifre separati da due punti.
    • OFFSET: il fuso orario formattato come offset del Tempo Coordinato Universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), che è 8 ore in anticipo rispetto al fuso orario UTC, specifica -08:00. In alternativa, per non utilizzare alcun 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, l'ora in cui un gruppo di istanze gestite termina una VM viene impostata 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 creazione o di avvio più recente della VM + maxRunDuration

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

  • Limite di tempo come ora di interruzione (terminationTime):

    terminationTimestamp di una VM = terminationTime

    Quando specifichi un'ora, il timestamp di terminazione viene impostato su quell'ora, a condizione che l'ora sia nel futuro. Se il tempo di interruzione è scaduto, qualsiasi azione MIG che tenta di creare, riavviare o sostituire una VM non va a buon fine con un errore. Per risolvere questo errore, devi creare un nuovo modello di istanza con una data di terminazione futura e applicarlo al gruppo di istanze gestite. Se vuoi utilizzare le proprietà del modello esistente nel nuovo modello, crea un modello di istanza basato sul modello esistente.

Durante l'aggiornamento di una 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 mantenuto ogni volta che il gruppo di istanze gestite aggiorna la VM.

Quando sospendi o interrompi 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 agli aumenti o alle diminuzioni del carico. Quando un gruppo di istanze gestite elimina le VM che hanno raggiunto i timestamp di interruzione, crea nuove VM per mantenere le dimensioni consigliate dall'agente di scalabilità automatica. Le nuove VM vengono eseguite per il limite di tempo specificato. Se il consiglio dell'autoscalabilità è di ridurre il numero di VM, il gruppo di istanze gestite le elimina anche prima che raggiungano i limiti di tempo.

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

Passaggi successivi