Attivare un evento di manutenzione dell'host

Questa pagina spiega come attivare un evento di manutenzione dell'host su istanze di VM specifiche della famiglia. Questa funzionalità consente di avviare manualmente un evento di manutenzione per controllare i tempi di manutenzione della VM. Questo è utile per i carichi di lavoro che potrebbero essere interessati da un periodo di manutenzione specifico.

Puoi attivare manualmente un evento di manutenzione in modo che venga avviato immediatamente. Non è possibile 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 ai seguenti tipi di macchine VM:

Prima di iniziare

  • L'avvio manuale della manutenzione delle VM è disponibile solo sulle VM C3, C3D e Z3. Se utilizzi VM di altre famiglie di macchine, consulta il documento Impostare i criteri di manutenzione dell'host.

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

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

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Set a default region and zone.

      3. 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.

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

        gcloud init

      Per maggiori informazioni, consulta Autenticazione per REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare le VM e gestire la relativa manutenzione, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) per il 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 loro manutenzione. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare VM e gestire la loro manutenzione, sono necessarie le seguenti autorizzazioni:

  • Per ottenere informazioni su una VM: compute.instances.get
  • Per creare una VM: compute.instances.create

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Attiva evento di manutenzione host

Google invia notifiche per la manutenzione imminente delle VM in diversi modi. Puoi trovare le notifiche eseguendo query sulle VM, sul server di metadati o su Cloud Logging.

Dopo aver ricevuto una notifica relativa a un evento di manutenzione dell'host, puoi scegliere di attivare subito la manutenzione o attendere che l'evento di manutenzione avvenga come pianificato.

Avvia l'evento di manutenzione

Puoi avviare la manutenzione della VM immediatamente, anziché attendere il tempo pianificato. Utilizza Google Cloud CLI o il metodo REST per attivare immediatamente la manutenzione delle 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 è necessario intraprendere alcuna azione.

gcloud

Per avviare immediatamente la manutenzione, utilizza il comando gcloud compute instances perform-maintenance. Devi includere l'--zone=[ZONE_NAME].

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

Sostituisci quanto segue:

  • VM_NAME: il nome della VM.
  • ZONE: la zona in cui si trova la VM.

La risposta sarà simile alla seguente:

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"
}

Nella risposta, maintenanceStatus è impostato su ONGOING. La manutenzione è in corso.

REST

Per attivare la manutenzione delle VM, esegui il comando instances.performMaintenance:

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

Sostituisci quanto segue:

  • PROJECT_NAME: il nome del progetto.
  • ZONE: la zona in cui si trova la VM.
  • VM_NAME: il nome della VM.

La risposta sarà simile alla seguente:

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"
}

Nella risposta, maintenanceStatus è impostato su ONGOING. La manutenzione è in corso.

Definizioni degli stati di manutenzione

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

  • windowStartTime: l'inizio della finestra temporale in cui si verifica la manutenzione
  • windowEndTime: la fine della finestra temporale in cui si verifica la manutenzione
  • latestWindowStartTime: la prima volta in cui è possibile spostare la finestra
  • maintenanceType: il tipo di manutenzione da eseguire.
    • NESSUNA: non è pianificata alcuna manutenzione per questa VM.
    • PROGRAMMATA: la manutenzione riceverà un preavviso di 7 giorni
    • NON PROGRAMMATO: la manutenzione rappresenta gli aggiornamenti critici per i quali viene dato molto meno preavviso
  • canReschedule: indica se la manutenzione può essere attivata durante il periodo di notifica per questa VM.
    • TRUE: la manutenzione attivata dal cliente può essere eseguita durante il periodo di notifica
    • FALSE: la manutenzione attivata dal cliente non può essere eseguita su questa VM Questo spesso si verifica durante il periodo in cui la VM è sottoposta a manutenzione
  • maintenanceStatus: lo stato dell'operazione di manutenzione attuale
    • ONGOING: l'operazione di manutenzione è in corso
    • IN ATTESA: l'operazione di manutenzione è pianificata, ma non è ancora iniziata

Comportamenti degli stati di manutenzione

Mentre gestisci la pianificazione della manutenzione, controlla lo stato di canReschedule= e maintenanceStatus=. Queste combinazioni di risposte descrivono il comportamento previsto delle funzionalità e mostrano una delle seguenti combinazioni di stato:

  • 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 tua VM non supporta la manutenzione attivata manualmente.

Passaggi successivi