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:

• Famiglie di macchine ottimizzate per l'acceleratore:

  • Tipi di macchine A3 Mega con 8 GPU

  • Tipi di macchine A3 High con 8 GPU

  • Tipi di macchine A3 Edge con 8 GPU

  • Tipi di macchine A2 Ultra con 8 GPU

  • Tipi di macchine A2 standard con 8 o 16 GPU

  • Tipi di macchine G2 con 8 GPU

• Famiglie di macchine ottimizzate per il calcolo:

  • Tipi di macchine H3 con 88 vCPU

• Famiglie di macchine per uso generico:

  • Tipi di macchine C4 con 192 vCPU

  • Tipi di macchine C3D con 360 vCPU o con dischi SSD locali collegati

  • Tipi di macchine C3 con 176 vCPU o con dischi SSD locali collegati

  • Istanze bare metal C3 con 192 vCPU

• Famiglie di macchine ottimizzate per la memoria:

  • Tipi di macchine X4

  • Tipi di macchine M3

  • Tipi di macchine M2

  • Tipi di macchine M1

• Famiglie di macchine ottimizzate per lo spazio di archiviazione:

  • Tipi di macchine Z3 con 176 vCPU

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.

  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, 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:

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:

• Eseguire query sulle istanze di calcolo o sul server metadati
• Utilizzare Cloud Logging

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 compute instances perform-maintenance INSTANCE_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/INSTANCE_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"
}

Passaggi successivi

• Scopri come simulare un evento di manutenzione dell'host.
• Scopri come ricevere notifiche relative alla migrazione live.
• Scopri come configurare gli avvisi per le notifiche di manutenzione dell'attività.