Impostare il criterio di manutenzione dell'host per un'istanza

Console

1. Nella console Google Cloud, vai alla pagina Crea un'istanza.

   Vai a Crea un'istanza

2. Specifica un nome per l'istanza.

3. Seleziona una Regione e una Zona per l'istanza.

4. Nella sezione Configurazione macchina:

   1. Specifica i dettagli del tipo di macchina per l'istanza.
   2. Espandi il menu Impostazioni avanzate del modello di provisioning delle VM.
   3. Nel menu Manutenzione sull'host, seleziona uno dei seguenti passaggi:
      1. Per eseguire la migrazione delle VM durante gli eventi di manutenzione, seleziona Esegui la migrazione dell'istanza VM.
      2. Per arrestare le istanze durante gli eventi di manutenzione, seleziona Termina istanza VM.

5. Per creare l'istanza, fai clic su Crea.

gcloud

Per impostare il criterio di manutenzione dell'host di una nuova istanza, utilizza il comando gcloud compute instances create.

Per impostare la proprietà --host-error-timeout-seconds (Anteprima), devi utilizzare il comando gcloud beta compute instances create.

Puoi impostare il criterio di manutenzione dell'host di una nuova istanza con il seguente comando. Se ometti uno dei flag, viene utilizzato il valore predefinito per il flag.

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --maintenance-policy=MAINTENANCE_BEHAVIOR \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT \
      --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza.
• ZONE: la zona in cui si trova l'istanza,
• MAINTENANCE_BEHAVIOR: il comportamento dell'evento di manutenzione di un'istanza, TERMINATE o MIGRATE. Per la maggior parte di tipi di macchine, la VM viene migrata per impostazione predefinita se ometti questa proprietà. Le istanze Z3 e Bare Metal vengono interrotte.
• RESTART_ON_FAILURE_BEHAVIOR: comportamento di riavvio per le istanze terminate o non rispondenti, impostato su restart-on-failure (predefinito) o no-restart-on-failure.
• SSD_RECOVERY_TIMEOUT: il numero di ore da impiegare per recuperare i dischi SSD locali collegati a un'istanza terminata o non rispondente. I valori validi vanno da 0 a 168 con incrementi di 1 ora.
• ERROR_DETECTION_TIMEOUT: il numero di secondi che Compute Engine attende prima di riavviare un'istanza che non risponde, da 90 a 330 secondi (5,5 minuti), con incrementi di 30 secondi.

REST

Per impostare il criterio di manutenzione dell'host di una nuova istanza utilizzando REST, utilizza il metodo instances.insert.

Puoi impostare il criterio di manutenzione dell'host di una nuova istanza con il seguente comando. Se ometti uno dei campi, viene utilizzato il valore predefinito per il campo.

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

      {
        "name": "INSTANCE_NAME",

        "scheduling": {
          "onHostMaintenance": "MAINTENANCE_BEHAVIOR",
          "automaticRestart": "RESTART_POLICY,
          "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
        }
      }

Sostituisci quanto segue:

• PROJECT_ID: il progetto per l'istanza.
• ZONE: la zona in cui vuoi creare l'istanza.
• INSTANCE_NAME: il nome dell'istanza.
• MAINTENANCE_BEHAVIOR: il comportamento dell'evento di manutenzione di un'istanza, TERMINATE o MIGRATE. Per la maggior parte di tipi di macchine, la VM viene migrata per impostazione predefinita se ometti questo campo. Le istanze Z3 e Bare Metal vengono interrotte.
• RESTART_POLICY: indica se l'istanza si riavvia automaticamente dopo un evento di manutenzione o un errore dell'host. Può essere true (valore predefinito) o false.
• SSD_RECOVERY_TIMEOUT: il numero di ore impiegate da Compute Engine per recuperare i dischi SSD locali collegati a un'istanza non rispondente o terminata. I valori validi vanno da 0 a 168, con incrementi di 1 ora. Il valore predefinito per Z3 è 6 ore e per tutte le altre VM è 1 ora.

Imposta il timeout per il rilevamento degli errori dell'host

Per impostare il tempo massimo di attesa di Compute Engine per riavviare o terminare un'istanza che non risponde, utilizza il metodo beta instances.insert, poiché questa opzione è in anteprima.

Aggiungi la proprietà hostErrorTimeoutSeconds all'oggetto scheduling del corpo della richiesta, dove HOST_ERROR_TIMEOUT è il numero di secondi che Compute Engine attende prima di riavviare o terminare un'istanza non rispondente. I valori validi vanno da 90 a 330 (5,5 minuti), con incrementi di 30 secondi.

   POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

   {
      "name": "INSTANCE_NAME",

      "scheduling": {
        "onHostMaintenance": "MAINTENANCE_BEHAVIOR",
        "automaticRestart": "RESTART_POLICY,
        "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
        "hostErrorTimeoutSeconds": HOST_ERROR_TIMEOUT,
      }
    }

Console

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Fai clic sul nome dell'istanza per cui vuoi modificare le impostazioni. Viene visualizzata la pagina dei dettagli dell'istanza.

3. Con la scheda Dettagli selezionata, completa i seguenti passaggi:

   1. Fai clic sul pulsante Modifica nella parte superiore della pagina.
   2. Vai alla sezione Gestione. Nella sezione Norme sulla disponibilità, puoi modificare le opzioni di manutenzione dell'attività.
   3. Fai clic su Salva.

gcloud

Aggiorna il criterio di manutenzione dell'host di un'istanza esistente con il comando gcloud compute instances set-scheduling. Utilizza gli stessi parametri del comando di creazione dell'istanza nella sezione precedente.

Per aggiornare il tempo massimo di attesa di Compute Engine per riavviare o terminare un'istanza non rispondente (anteprima), utilizza il comando gcloud beta compute instances set-scheduling e includi --host-error-timeout-seconds=NUMBER_OF_SECONDS.

    gcloud compute instances set-scheduling INSTANCE_NAME \
      --maintenance-policy=MAINTENANCE_BEHAVIOR \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT

Sostituisci quanto segue:

• NUMBER_OF_SECONDS: il numero di secondi che Compute Engine attende prima di riavviare o terminare una VM non rispondente, da 90 a 330 (5,5 minuti), con incrementi di 30 secondi.
  • INSTANCE_NAME: il nome dell'istanza.
  • MAINTENANCE_BEHAVIOR: il comportamento dell'evento di manutenzione di un'istanza, TERMINATE o MIGRATE. Per la maggior parte di tipi di macchine, la VM viene migrata per impostazione predefinita se ometti questa proprietà. Le istanze Z3 e Bare Metal vengono interrotte.
  • RESTART_ON_FAILURE_BEHAVIOR: comportamento di riavvio per le istanze terminate o non rispondenti, impostato su restart-on-failure (predefinito) o no-restart-on-failure.
  • SSD_RECOVERY_TIMEOUT: il numero di ore da impiegare per recuperare i dischi SSD locali collegati a un'istanza terminata o non rispondente. I valori validi vanno da 0 a 168 con incrementi di 1 ora.
  • NUMBER_OF_SECONDS: il numero di secondi che Compute Engine attende prima di riavviare un'istanza che non risponde, da 90 a 330 secondi (5,5 minuti), con incrementi di 30 secondi.

REST

Aggiorna il criterio di manutenzione dell'host di un'istanza esistente utilizzando una POST richiesta al metodo instances.setScheduling.

    POST https://compute.googleapis.com/compute/v1projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

    {
      "onHostMaintenance": "MAINTENANCE_BEHAVIOR",
      "automaticRestart": RESTART_POLICY,
      "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
    }

Sostituisci quanto segue:

• PROJECT_ID: il progetto per l'istanza.
• ZONE: la zona in cui si trova l'istanza.
• INSTANCE_NAME: il nome dell'istanza.
• MAINTENANCE_BEHAVIOR: il comportamento dell'evento di manutenzione di questa istanza, TERMINATE o MIGRATE.
• RESTART_POLICY: indica se l'istanza viene riavviata automaticamente, true o false.
  • SSD_RECOVERY_TIMEOUT: il numero di ore da impiegare per recuperare i dischi SSD locali collegati all'istanza. I valori validi vanno da 0 a 168 con incrementi di 1 ora.

Aggiorna il timeout del rilevamento degli errori dell'host

Per aggiornare il tempo massimo di attesa di Compute Engine per riavviare o terminare una VM non rispondente, devi utilizzare il metodo beta instances.setScheduling perché questa funzionalità è in anteprima.

Aggiungi la proprietà hostErrorTimeoutSeconds al corpo della richiesta, dove HOST_ERROR_TIMEOUT è il numero di secondi che Compute Engine attende prima di riavviare o terminare un'istanza non rispondente. I valori validi vanno da 90 a 330 (5,5 minuti), con incrementi di 30 secondi.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

  {
    ...
    "hostErrorTimeoutSeconds": NUMBER_OF_SECONDS
  }

Console

1. Vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Fai clic sul nome dell'istanza di cui vuoi visualizzare le impostazioni. Viene visualizzata la pagina dei dettagli dell'istanza.

3. Vai alla sezione Gestione. La sottosezione Criteri di disponibilità mostra le impostazioni correnti per quanto segue:

   • Host in manutenzione
   • Riavvio automatico
   • Timeout errore dell'host

gcloud

Visualizza le impostazioni dell'opzione di manutenzione dell'host per un'istanza con il comando gcloud compute instances describe.

Per visualizzare il valore corrente dell'impostazione hostErrorTimeoutSeconds (Anteprima), utilizza il comando gcloud beta compute instances describe.

 gcloud compute instances describe INSTANCE_NAME \
 --zone ZONE --format="yaml(scheduling)"

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza
• ZONE: la zona in cui si trova l'istanza

L'output include le impostazioni correnti per il criterio di manutenzione dell'host, ad esempio:

scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

REST

Per visualizzare le impostazioni di manutenzione dell'host per un'istanza, utilizza il metodo instances.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Sostituisci quanto segue:

• PROJECT_ID: il progetto in cui si trova l'istanza.
• ZONE: la zona in cui si trova l'istanza.
• INSTANCE_NAME: il nome dell'istanza.

Nell'output, l'oggetto scheduling contiene le impostazioni per il criterio di manutenzione dell'host dell'istanza, ad esempio:

{
...
  "scheduling": {
      "onHostMaintenance": "MIGRATE",
      "automaticRestart": true,
      "preemptible": false,
      "provisioningModel": "STANDARD",
      "localSsdRecoveryTimeout": {
        "seconds": "10800",
        "nanos": 0
      }
    },
...
}

Visualizzare le impostazioni del timeout errore dell'host

Visualizza l'impostazione hostErrorTimeoutSeconds corrente creando una richiesta GET utilizzando il metodo instances.get beta.

 GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Sostituisci quanto segue:

• PROJECT_ID: il progetto per l'istanza.
• ZONE: la zona in cui si trova l'istanza.
• INSTANCE_NAME: il nome dell'istanza.

Nell'output, l'oggetto scheduling include il timeout di rilevamento degli errori dell'host dell'istanza, ad esempio:

{
...
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "hostErrorTimeoutSeconds": 120,
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  },
...
}