Attiva un evento di manutenzione dell'host

In questa pagina viene spiegato come attivare un evento di manutenzione dell'host attivo di istanze VM specifiche della tua famiglia. Questa funzionalità ti consente di avvii manualmente un evento di manutenzione per controllare la tempistica manutenzione. Questo è utile per i carichi di lavoro che potrebbero essere interessati da una periodo di manutenzione.

Puoi attivare manualmente un evento di manutenzione in modo che venga avviato immediatamente. Non è attivare un evento in una data o un'ora specifica. Se non utilizzi questa funzionalità, l'evento di manutenzione si verifica come pianificato.

Limitazioni

L'attivazione di un evento di manutenzione dell'host VM è limitato alla seguente macchina VM tipi:

• Intero host: macchine standard C4, con memoria elevata e con CPU elevata (Anteprima) con 192 vCPU
• Macchine C3 standard, con memoria elevata e con CPU elevata dell'intero host con 176 vCPU
• VM C3 con SSD locale
• Macchine C3D standard, con memoria elevata e con CPU elevata dell'intero host con 360 vCPU
• VM C3D con SSD locale
• Macchine con memoria elevata Z3 con 176 vCPU

• Le seguenti macchine M1, M2, M3 ottimizzate per la memoria:

  • M3-Ulramem-128
  • m3-megamem-128
  • m2-ultramem-416
  • m2-megamem-416
  • ipermea-m2-416
  • m1-ultramem-160
  • m1-megamem-96

• Se utilizzi VM di altre famiglie di macchine, esamina il Imposta il criterio di manutenzione dell'host documento.

Prima di iniziare

• Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.
  

  Select the tab for how you plan to use the samples on this page:

  gcloud

  1. Install the Google Cloud CLI, then initialize it 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, utilizzi le credenziali che fornisci a gcloud CLI.

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

  gcloud init

  Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare le VM e gestire la manutenzione delle VM, chiedi all'amministratore di concederti Ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare VM e gestire la manutenzione delle VM. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.

Attiva evento di manutenzione dell'host

Google invia notifiche per la manutenzione imminente delle VM con vari metodi. Puoi trovare le notifiche eseguendo una query sulle VM, sul server metadati o su Cloud Logging.

Dopo aver ricevuto una notifica relativa a un evento di manutenzione dell'host, devi per attivare immediatamente la manutenzione o attendere l'evento di manutenzione che si svolgerà come programmato.

Avvia l'evento di manutenzione

Puoi avviare immediatamente la manutenzione delle VM, anziché attendere l'esecuzione all'ora programmata. Utilizza il metodo Google Cloud CLI o REST di attivare immediatamente la manutenzione della VM.

Se non viene visualizzata alcuna notifica e provi ad attivare un evento di manutenzione, viene visualizzato il seguente messaggio:

There is no reschedulable upcoming maintenance.

Questo indica che non è stato pianificato alcun evento di manutenzione e che non è stata pianificata alcuna azione da utilizzare.

gcloud compute instances perform-maintenance VM_NAME \
--zone=ZONE

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME/performMaintenance

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

Definizioni degli stati di manutenzione

Le seguenti definizioni di stato spiegano le risposte alla manutenzione di una VM query. Forniscono informazioni relative alla manutenzione delle VM. Google Cloud CLI, REST e il server di metadati usano gli stessi risposte:

• windowStartTime: l'inizio della finestra temporale in cui viene effettuata la manutenzione
• windowEndTime: la fine dell'intervallo di tempo in cui viene eseguita la manutenzione
• latestWindowStartTime: il primo momento in cui la finestra può essere spostata
• maintenanceType: il tipo di manutenzione da eseguire
  • NONE: non è pianificata alcuna manutenzione per questa VM
  • IN PROGRAMMA: per la manutenzione saranno previsti 7 giorni notifica
  • NON PROGRAMMATO: la manutenzione rappresenta aggiornamenti critici per i quali molto meno viene dato un avviso

• canReschedule: indica se la manutenzione può essere attivata durante il periodo periodo di notifica per questa VM
  • TRUE: la manutenzione attivata dal cliente può essere eseguita durante periodo di notifica
  • FALSE: la manutenzione attivata dal cliente non può essere eseguita su questa VM Questo si verifica spesso durante il periodo in cui la VM è in fase di manutenzione

• maintenanceStatus: lo stato dell'operazione di manutenzione attuale
  • ONGOING: è in corso l'operazione di manutenzione.
  • IN ATTESA: l'operazione di manutenzione è pianificata, ma non è ancora iniziata.

Comportamenti dello stato di manutenzione

Mentre gestisci la pianificazione della manutenzione, controlla lo stato di canReschedule= e maintenanceStatus= di queste combinazioni di risposte descrivono il comportamento previsto della funzionalità e verrà visualizzato uno dei seguenti stati combinazioni:

• Se canReschedule=Yes e maintenanceStatus=Pending puoi attivare la manutenzione sulla VM.
• Se canReschedule=No e maintenanceStatus=Ongoing la manutenzione è già in corso.
• Se canReschedule=No e maintenanceStatus=Pending la VM non supporta la manutenzione attivata manualmente.

Passaggi successivi

• Scopri come simulare un evento di manutenzione dell'host.
• Scopri come ricevere notifiche sulla migrazione live.
• Scopri come creare un avviso basato su log in Cloud Logging.