Avviare manualmente un evento di manutenzione dell'host

Questa pagina spiega come avviare manualmente un evento di manutenzione dell'host sulle istanze Compute Engine supportate. Questa funzionalità ti consente di avviare un evento di manutenzione per controllare le tempistiche della manutenzione dell'istanza. Questo è utile per i carichi di lavoro che potrebbero essere interessati da prestazioni ridotte o tempi di inattività, per i quali è necessario che il periodo di manutenzione inizi a un'ora specifica.

Quando avvii manualmente un evento di manutenzione, la manutenzione dell'host inizia immediatamente. Non puoi specificare una data o un'ora di inizio per l'evento di manutenzione. Se non utilizzi questa funzionalità, l'evento di manutenzione avviene all'ora indicata nella notifica relativa alla manutenzione imminente.

Se vuoi prima testare il modo in cui le tue applicazioni gestiranno un evento di manutenzione, puoi simulare un evento di manutenzione.

Limitazioni

Puoi avviare manualmente un evento di manutenzione dell'host per le istanze che utilizzano i seguenti tipi di macchine:

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:

    gcloud

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

      gcloud init
    2. Set a default region and zone.

      3. 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 saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire la manutenzione delle VM. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per gestire la manutenzione delle VM sono necessarie le seguenti autorizzazioni:

  • Per ottenere informazioni su un'istanza di calcolo: compute.instances.get
  • Per avviare la manutenzione dell'host per un'istanza: compute.instances.performMaintenance

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Avviare manualmente un evento di manutenzione dell'host

Compute Engine invia notifiche per gli eventi di manutenzione imminenti con diversi metodi. Utilizzando le informazioni contenute nelle notifiche, puoi determinare il periodo di tempo in cui puoi avviare manualmente un evento di manutenzione.

Controllare le informazioni di notifica

Per trovare le notifiche relative agli eventi di manutenzione:

Se la notifica relativa a un evento di manutenzione dell'host contiene canReschedule=True e maintenanceStatus=Pending, puoi avviare la manutenzione al momento che preferisci o attendere che l'evento di manutenzione si verifichi al momento specificato da windowStartTime.

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

There is no reschedulable upcoming maintenance.

Ciò indica che non è stato pianificato alcun evento di manutenzione e che non è richiesta alcuna azione.

Avvia l'evento di manutenzione

Puoi avviare la manutenzione dell'host in un momento a tua scelta, anziché attendere l'ora programmata. Utilizza Google Cloud CLI o REST per attivare l'evento di manutenzione, che si avvia immediatamente.

gcloud

Per avviare un evento di manutenzione, utilizza il comando compute instances perform-maintenance. La manutenzione dell'host inizia immediatamente dopo l'inserimento del comando.

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza di calcolo.
  • ZONE: la zona in cui risiede l'istanza.

La risposta è 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, canReschedule è impostato su false e maintenanceStatus su ONGOING, il che indica che l'operazione di manutenzione dell'host è in corso.

REST

Per avviare un evento di manutenzione, crea una richiesta POST utilizzando il metodo instances.performMaintenance.

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

Sostituisci quanto segue:

  • PROJECT_NAME: il nome del progetto
  • ZONE: la zona in cui risiede l'istanza di calcolo
  • INSTANCE_NAME: il nome dell'istanza

La risposta è 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, canReschedule è impostato su false e maintenanceStatus su ONGOING, il che indica che l'operazione di manutenzione dell'host è in corso.

Passaggi successivi