Pianifica l'avvio e l'arresto di un'istanza VM

Le pianificazioni delle istanze ti consentono di avviare e arrestare automaticamente le istanze di macchine virtuali (VM). Per utilizzare le pianificazioni delle istanze, crea una policy delle risorse che descriva il comportamento di avvio e arresto, quindi associala a una o più istanze VM.

L'utilizzo delle pianificazioni delle istanze per automatizzare il deployment delle istanze VM può aiutarti a ottimizzare i costi e a gestire le istanze VM in modo più efficiente. Puoi utilizzare le pianificazioni delle istanze sia per i workload ricorrenti sia per quelli una tantum. Ad esempio, utilizza le pianificazioni delle istanze per eseguire le istanze VM solo durante l'orario di lavoro o per fornire la capacità per un evento una tantum.

Per scoprire altre opzioni per la pianificazione automatica delle VM, consulta le seguenti pagine:

• Scala in base alle pianificazioni: se esegui il tuo workload su un gruppo di istanze gestite (MIG), puoi utilizzare le pianificazioni di scalabilità per pianificare il numero richiesto di istanze di macchine virtuali (VM) per eventi ricorrenti o una tantum.

• Limita il tempo di esecuzione di una VM: se non vuoi creare policy delle risorse, puoi configurare direttamente una VM in modo che venga arrestata o eliminata automaticamente quando raggiunge una data e ora o una durata specificata.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

  Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI by running the following command:

  gcloud init

  Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Ruoli obbligatori

Per utilizzare le pianificazioni delle istanze, devi concedere i ruoli IAM (Identity and Access Management) obbligatori alle seguenti entità:

• L'agente di servizio Compute Engine per il tuo progetto. Questo è necessario per l'esecuzione della pianificazione delle istanze su una VM.

  Se revochi queste autorizzazioni dopo aver creato le pianificazioni delle istanze, le pianificazioni potrebbero smettere di funzionare senza fornire notifiche. Per verificare se le pianificazioni delle istanze vengono eseguite correttamente, devi verificare regolarmente gli audit log.

• L'account utente o il service account che crea, gestisce o utilizza la pianificazione delle istanze.

Ruoli obbligatori per l'agente di servizio Compute Engine

Per assicurarti che l'agente di servizio Compute Engine disponga delle autorizzazioni necessarie per eseguire la pianificazione delle istanze, chiedi all'amministratore di concedere all'agente di servizio Compute Engine il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) sul progetto.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eseguire la pianificazione delle istanze. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

L'amministratore potrebbe anche essere in grado di concedere all'agente di servizio Compute Engine queste autorizzazioni tramite ruoli personalizzati o altri ruoli predefiniti.

Ruoli obbligatori per l'account utente o il service account

Per assicurarti che tu o il tuo service account disponiate delle autorizzazioni necessarie per creare e gestire le pianificazioni delle istanze, chiedi all'amministratore di concedere a te o al tuo service account il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) sul tuo progetto o sulla tua organizzazione.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire le pianificazioni delle istanze. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

L'amministratore potrebbe anche essere in grado di concedere a te o al tuo service account queste autorizzazioni tramite ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

• Puoi collegare una pianificazione delle istanze solo alle istanze VM che si trovano nella stessa regione della pianificazione.
• Non puoi utilizzare le pianificazioni delle istanze per arrestare un'istanza con dischi SSD locali.
• Ogni istanza VM può seguire una sola pianificazione, ma puoi associare ogni pianificazione a un massimo di 1000 istanze VM.
• Le pianificazioni delle istanze non forniscono garanzie di capacità, pertanto se le risorse richieste per un'istanza VM pianificata non sono disponibili al momento pianificato, l'istanza VM potrebbe non avviarsi quando pianificato. Sebbene sia possibile prenotare istanze VM prima di avviarle per ottenere un elevato livello di garanzia che la capacità sia disponibile quando richiesta, le prenotazioni non possono essere pianificate automaticamente.
• Le pianificazioni delle istanze si limitano ad avviare e arrestare le istanze VM alla data e ora specificata, ma puoi avviare e arrestare manualmente le istanze VM in qualsiasi momento. Ad esempio, immaginiamo che tu abbia una pianificazione che inizia ogni giorno alle 08:00 e termina ogni giorno alle 17:00. Se alle 16:00 colleghi questa pianificazione a un'istanza VM arrestata, l'istanza VM non verrà avviata prima delle 08:00 del giorno successivo, a meno che non la avvii manualmente prima.
• Le istanze VM pianificate potrebbero richiedere fino a 15 minuti oltre l'orario pianificato per iniziare un'operazione di avvio o arresto. Se devi avviare o arrestare le istanze VM in un momento specifico, pianifica l'operazione 15 minuti prima del necessario e pianifica ogni operazione con un intervallo di almeno 15 minuti.
• Lo scheduler potrebbe non riuscire se esiste un intervallo di meno di 15 minuti tra le operazioni di avvio e arresto. Questo perché l'operazione di arresto potrebbe verificarsi prima dell'operazione di avvio, impedendone l'esecuzione.
• Ogni pianificazione delle istanze consente fino a un'operazione di avvio e un'operazione di arresto all'ora.
• Per modificare la pianificazione di un'istanza, utilizza un'operazione di patch sulla policy di pianificazione delle istanze.

Gestione delle pianificazioni delle istanze

Crea, elenca, descrivi ed elimina le pianificazioni delle istanze utilizzando la consoleTrusted Cloud , Google Cloud CLI o l'API Compute Engine.

Creazione di una pianificazione delle istanze

Crea una pianificazione delle istanze che descriva quando devono essere avviate o arrestate automaticamente le istanze VM. La pianificazione delle istanze che crei è una policy delle risorse che puoi utilizzare collegandola o rimuovendola dalle istanze VM.

gcloud compute resource-policies create instance-schedule SCHEDULE_NAME \
    --region=REGION \
    [--vm-start-schedule='START-OPERATION_SCHEDULE'] \
    [--vm-stop-schedule='STOP-OPERATION_SCHEDULE'] \
    [--timezone=TIME_ZONE] \
    [--initiation-date=INITIATION_DATE] \
    [--end-date=END_DATE]

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
  "name": "SCHEDULE_NAME",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "START-OPERATION_SCHEDULE"
    },
    "vmStopSchedule": {
      "schedule": "STOP-OPERATION_SCHEDULE"
    },
    "timeZone": "TIME_ZONE",
    "startTime":"INITIATION_DATE",
    "expirationTime":"END_DATE"
  }
}

Ogni pianificazione delle istanze ha le seguenti impostazioni:

pianificazione dell'operazione di avvio, pianificazione dell'operazione di arresto

Pianificazioni che descrivono quando la pianificazione delle istanze avvia e arresta le eventuali istanze VM collegate. Una pianificazione delle istanze può avere una di queste pianificazioni o entrambe.

Quando crei le pianificazioni delle istanze utilizzando la console Trusted Cloud , puoi selezionare un'Ora di inizio, un'Ora di fine e una Frequenza oppure formattare ogni pianificazione come espressione cron. Quando crei le pianificazioni delle istanze utilizzando gcloud CLI o l'API Compute Engine, devi formattare ogni pianificazione come espressione cron.

La tabella seguente definisce i campi di un'espressione cron e i valori supportati per ciascun campo.

Minuto	Ora	Giorno del mese	Mese	Giorno della settimana
0-59	0-23	1-31 dove 29-31 sono validi solo per i mesi pertinenti	1-12	0-6 o SUN-SAT (domenica-sabato) dove 0=SUN, 1=MON, … 6=SAT

Oltre a questi valori, ogni campo di un'espressione cron può anche utilizzare i seguenti caratteri speciali.

Carattere speciale	Significato	Esempio
*	qualsiasi	Se i campi giorno del mese, mese e giorno della settimana sono tutti impostati su *, la pianificazione si ripete ogni giorno.
-	intervallo	Se il campo giorno della settimana è impostato su MON-FRI (o 1-5), la pianificazione si ripete ogni settimana dal lunedì al venerdì.
,	elenco	Se il campo mese è impostato su 1-6,8-12, la pianificazione si ripete ogni mese tranne a luglio.

Quando scrivi un'espressione cron, tieni presente quanto segue:

• I campi di un'espressione cron sono separati da spazi vuoti. Ricorda di non inserire spazi vuoti aggiuntivi in un campo che utilizza caratteri speciali.
• Quando specifichi sia un giorno della settimana sia un giorno del mese (quando nessuno dei due campi è impostato su *), la pianificazione utilizza l'unione di questi valori, non l'intersezione. Ad esempio, la pianificazione0 8 1 * MON inizia alle 08:00 ogni lunedì e il primo giorno di ogni mese. Questa pianificazione non inizia alle 08:00 solo i lunedì che sono anche il primo giorno del mese.

fuso orario

Il fuso orario IANA basato sulla località per le pianificazioni delle operazioni di avvio e di arresto. Il database dei fusi orari IANA definisce un elenco di valori disponibili. Questo fuso orario viene utilizzato come riferimento solo per le pianificazioni delle operazioni di avvio e arresto, non per la data di avvio e la data di fine. Il fuso orario è facoltativo quando utilizzi gcloud CLI o l'API Compute Engine. Se omesso, viene utilizzato il valore predefinito UTC.

Alcuni fusi orari IANA osservano l'ora legale (DST), che può influire sulle pianificazioni delle istanze. I dettagli dell'ora legale, ad esempio quando inizia e termina, nonché l'entità dello spostamento dell'orario in avanti o indietro, variano in base al singolo fuso orario.

data di avvio, data di fine

Il periodo di tempo in cui la pianificazione delle istanze è valida. Entrambi i valori sono facoltativi. Le operazioni si ripetono ogni anno, a meno che non specifichi questi valori per limitare la pianificazione a un solo anno.

Quando crei le pianificazioni delle istanze utilizzando la console Trusted Cloud , seleziona una data, un'ora e un fuso orario utilizzando i campi Data di avvio e Data di fine.

Quando crei le pianificazioni delle istanze utilizzando gcloud CLI o l'API Compute Engine, questi valori sono formattati 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 2 cifre con il formato 24 ore, minuto a 2 cifre e secondo a 2 cifre, separati da due punti.
• OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, il fuso orario standard della costa del Pacifico (PST), che è 8 ore in anticipo rispetto al fuso orario UTC, viene scritto come -08:00. In alternativa, per non utilizzare alcun offset (il fuso orario UTC), scrivi Z.

Elenco delle pianificazioni delle istanze

Elenca le pianificazioni delle istanze per visualizzare tutte le pianificazioni delle istanze esistenti per il tuo progetto.

gcloud compute resource-policies list \
    [--filter="region:(REGION)"]

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies

Descrizione di una pianificazione delle istanze

Descrivi una pianificazione delle istanze per visualizzarne la descrizione, la tempistica, le operazioni e un elenco di tutte le istanze VM a cui è collegata.

gcloud compute resource-policies describe SCHEDULE_NAME \
    --region=REGION

...
description: Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.
...
instanceSchedulePolicy:
 expirationTime: '2022-12-31T23:59:59Z'
 startTime: '2022-01-01T00:00:00Z'
 timeZone: UTC
 vmStartSchedule:
   schedule: 0 8 * * MON-FRI
 vmStopSchedule:
   schedule: 0 17 * * MON-FRI
...
name: example-instance-schedule
region: https://www.s3nsapis.fr/compute/v1/projects/example-project/regions/us-west1
resourceStatus:
 instanceSchedulePolicy:
   nextRunStartTime: '2022-01-03T08:00:00Z'
...
status: READY

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME

{
  ...
  "description": "Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.",
  "name": "example-instance-schedule",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "0 8 * * MON-FRI"
    },
    "vmStopSchedule": {
      "schedule": "0 17 * * MON-FRI"
    },
    "timeZone": "UTC",
    "startTime": "2022-01-01T00:00:00Z",
    "expirationTime": "2022-12-31T23:59:59Z"
  },
  "status": "READY",
  "resourceStatus": {
    "instanceSchedulePolicy": {
      "nextRunStartTime": "2022-01-03T08:00:00Z"
    }
  },
  ...
}

Eliminazione di una pianificazione delle istanze

Elimina una pianificazione delle istanze quando non ti serve più rimuovendo le eventuali istanze VM collegate ed eliminando la policy delle risorse.

Utilizzo delle pianificazioni delle istanze con le istanze VM

Per utilizzare una pianificazione delle istanze, collegala a una o più istanze VM che dovranno seguirla. Puoi collegare una pianificazione delle istanze a un'istanza VM esistente o durante la creazione di una nuova istanza VM. Per impedire a un'istanza VM di seguire una pianificazione delle istanze collegata, rimuovi la pianificazione dall'istanza VM.

Collegamento di una pianificazione delle istanze durante la creazione di una nuova istanza VM

Per collegare una pianificazione delle istanze a una nuova istanza VM, devi creare l'istanza VM nella stessa regione della pianificazione delle istanze utilizzata. Scopri di più sulla creazione di un'istanza VM.

gcloud compute instances create VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    [--image-project IMAGE_PROJECT]

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ],
  "resourcePolicies": [
    "https://compute.s3nsapis.fr/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
  ]
}

Puoi verificare se la pianificazione delle istanze viene eseguita correttamente controllando gli audit log per la policy delle risorse della pianificazione delle istanze e per l'istanza VM collegata. Potresti dover attendere fino a 15 minuti dopo l'ora pianificata per ogni operazione.

Collegamento di una pianificazione delle istanze a un'istanza VM esistente

Puoi collegare una pianificazione delle istanze a qualsiasi istanza VM esistente che si trova nella stessa regione della pianificazione.

gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/addResourcePolicies
{
  "resourcePolicies": "projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

Puoi verificare se la pianificazione delle istanze viene eseguita correttamente controllando gli audit log per la policy delle risorse della pianificazione delle istanze e per l'istanza VM collegata. Potresti dover attendere fino a 15 minuti dopo l'ora pianificata per ogni operazione.

Rimozione di una pianificazione delle istanze da un'istanza VM

Per impedire a un'istanza VM di seguire una pianificazione delle istanze, rimuovi la pianificazione dall'istanza VM.

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    --zone=ZONE

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/removeResourcePolicies
{
  "resourcePolicies": "projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

Passaggi successivi

• Scopri altre funzionalità di Compute Engine per la pianificazione delle VM:
  • Limita il tempo di esecuzione di una VM
  • Scala i MIG in base alle pianificazioni