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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Limite di tempo come durata dell'esecuzione
- Limite di tempo come ora di fine
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.
Utilizza il modello di istanza per creare un gruppo di istanze gestite o aggiornarne uno esistente.
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 soloDELETE
. - Non puoi utilizzare le VM spot.
- Non puoi impostare l'azione di interruzione su
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.Nella console Google Cloud, vai alla pagina Modelli di istanza.
Fai clic su Crea modello istanza.
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.
Se hai scelto Regionale, seleziona la Regione in cui creare il modello di istanza.
Nella sezione Criteri di disponibilità, espandi le impostazioni avanzate del modello di provisioning delle VM.
Seleziona la casella di controllo Imposta un limite di tempo per la VM.
Nel campo Tipo di limite di tempo, seleziona Per ore (valore predefinito) per specificare il limite di tempo come durata. Nel campo successivo, inserisci la durata in ore.
Nell'elenco Al termine della VM, seleziona Elimina.
Per gli altri campi, accetta i valori predefiniti o modificali in base alle necessità.
Fai clic su Crea.
INSTANCE_TEMPLATE_NAME
: il nome del modello di istanza.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
es
. Ad esempio, specifica30m
per una durata di 30 minuti o1d2h3m4s
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
).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 esempiodebian-cloud
.IMAGE
oIMAGE_FAMILY
: specifica una delle seguenti opzioni:IMAGE
: una versione specifica dell'immagine del sistema operativo, ad esempiodebian-10-buster-v20200309
.IMAGE_FAMILY
: una famiglia di immagini. Specifica l'immagine del sistema operativo più recente e non ritirata. Ad esempio, se specifichifamily/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
es
. Ad esempio, specifica30m
per una durata di 30 minuti o1d2h3m4s
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
).Nella console Google Cloud, vai alla pagina Modelli di istanza.
Fai clic su Crea modello istanza.
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.
Se hai scelto Regionale, seleziona la Regione in cui creare il modello di istanza.
Nella sezione Criteri di disponibilità, espandi le impostazioni avanzate del modello di provisioning delle VM.
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 il termine automatico.Nell'elenco Al termine della VM, seleziona Elimina.
Per gli altri campi, accetta i valori predefiniti o modificali in base alle necessità.
Fai clic su Crea.
INSTANCE_TEMPLATE_NAME
: il nome del modello di istanza.TIME
: l'ora in cui vuoi che questa VM si arresti 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), specificaZ
.
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 esempiodebian-cloud
.IMAGE
oIMAGE_FAMILY
: specifica una delle seguenti opzioni:IMAGE
: una versione specifica dell'immagine del sistema operativo, ad esempiodebian-10-buster-v20200309
.IMAGE_FAMILY
: una famiglia di immagini. Specifica l'immagine del sistema operativo più recente e non ritirata. Ad esempio, se specifichifamily/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), specificaZ
.
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 riesce 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.
- Scopri gli scenari di base per la creazione di gruppi di istanze gestite.
- Scopri come applicare un nuovo modello di istanza a un gruppo di istanze gestite esistente.
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 ulteriori informazioni, 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:
Per specificare un limite di tempo per le VM in un MIG:
Limitazioni
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
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
suDELETE
come segue:gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --max-run-duration=DURATION \ --instance-termination-action=DELETE
Sostituisci quanto segue:
Terraform
Per creare un modello di istanza utilizzando Terraform, utilizza la risorsa
google_compute_instance_template
. Per creare un modello di istanza che elimini automaticamente le VM dopo un periodo di tempo specifico, devi includere l' argomentomax_run_duration
e impostare l' argomentoinstance_termination_action
suDELETE
.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:
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
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
suDELETE
come segue:gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --termination-time=TIME \ --instance-termination-action=DELETE
Sostituisci quanto segue:
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:
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:
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 MIG 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
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-12-19 UTC.
-