Avviare manualmente un evento di manutenzione dell'host

In questa pagina viene spiegato come avviare manualmente un evento di manutenzione dell'host attivo di Compute Engine supportate. Questa funzionalità ti consente di avvii un evento di manutenzione per controllare la tempistica manutenzione. Questa funzionalità è utile per i carichi di lavoro che potrebbero essere interessati da una riduzione delle prestazioni le prestazioni o i tempi di inattività, per i quali è necessario iniziare il periodo di manutenzione in un momento specifico.

Quando avvii manualmente un evento di manutenzione, viene avviata la manutenzione dell'host 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 si verifica al momento indicato imminente notifica di manutenzione.

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

Limitazioni

L'avvio manuale di un evento di manutenzione dell'host per un'istanza è limitato ai seguenti tipi di macchine:

Prima di iniziare

  • Se non l'hai già 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 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.

      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 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 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 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 riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.

Avvia manualmente un evento di manutenzione dell'host

Compute Engine invia notifiche per gli eventi di manutenzione imminenti con diversi metodi. Utilizzando le informazioni 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 all'ora specificata da windowStartTime.

Se non ricevi 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 viene avviato immediatamente.

gcloud

Per avviare un evento di manutenzione, utilizza Comando compute instances perform-maintenance. La manutenzione dell'host viene avviata 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 è impostato su ONGOING, a indicare 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 ha questo aspetto:

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