La manutenzione di tutte le istanze di macchine virtuali (VM) è determinata dal criterio di manutenzione dell'host selezionato durante la creazione delle VM. Alcune VM offrono l'opzione aggiuntiva la pianificazione della manutenzione della VM in anticipo.
In questa pagina viene spiegato come monitorare e pianificare una evento di manutenzione dell'host sulle VM di Compute Engine. Per visualizzare la pianificazione della manutenzione di una VM, quest'ultima deve eseguire un tipo di macchina da una delle seguenti famiglie di macchine:
- VM C4 per uso generico
- VM C3 per uso generico
- VM C3D per uso generico
- VM H3 ottimizzate per il calcolo
- VM Z3 ottimizzate per lo spazio di archiviazione
- VM M1, M2, M3 ottimizzate per la memoria
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:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Per ottenere informazioni su una VM:
compute.instances.get
-
Per creare una VM:
compute.instances.create
- Meno eventi di manutenzione: in generale, VM con intervalli di manutenzione ricorrenti dovresti vedere meno eventi di manutenzione.
- Notifica di manutenzione più lunga: ricevi notifiche per gli eventi di manutenzione pianificati con largo anticipo ai fini della pianificazione.
- Monitoraggio e pianificazione: usa Cloud Logging per monitorare la manutenzione programmazione. Utilizza incidenti e avvisi per rimanere al corrente.
Controllo manutenzione on demand: avvia la manutenzione durante la notifica per aggiornare le VM in base alla tua pianificazione.
VM_NAME
: il nome della VM.ZONE
: la zona in cui si trova la VM.PROJECT_NAME
: il nome del progetto.ZONE
: la zona in cui si trova la VM.VM_NAME
: il nome della VM.- Per le VM configurate per l'utilizzo della migrazione live per la manutenzione, viene visualizzato l'evento
con il nome del metodo
compute.instances.migrateOnHostMaintenance
. - Per le VM configurate per l'utilizzo di Termina e Riavvio automatico per la manutenzione,
viene visualizzato con il nome del metodo
compute.instances.terminateOnHostMaintenance
. - 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
- NESSUNO: non è pianificata alcuna manutenzione per questa VM
- IN PROGRAMMA: per la manutenzione saranno previsti 7 giorni notifica
- NON PIANIFICATA: la manutenzione rappresenta aggiornamenti critici per i quali viene fornita una notifica molto meno approfondita
- 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.
- Se
canReschedule=Yes
emaintenanceStatus=Pending
puoi attivare la manutenzione sulla VM. - Se
canReschedule=No
emaintenanceStatus=Ongoing
la manutenzione è già in corso. - Se
canReschedule=No
emaintenanceStatus=Pending
la VM non supporta la manutenzione attivata manualmente. - Scopri come impostare un criterio di manutenzione dell'host della VM.
- Scopri come ricevere notifiche sulla migrazione live.
- Scopri come attivare manualmente un evento di manutenzione dell'host
- Scopri come creare un avviso basato su log in Cloud Logging.
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 a progetti, cartelle e organizzazioni.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:
Autorizzazioni obbligatorie
Per creare VM e gestire la manutenzione delle VM sono necessarie le seguenti autorizzazioni:
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.
Monitora le notifiche di manutenzione
Google invia notifiche per la manutenzione imminente delle VM tramite diversi metodi. Per trovare le notifiche, puoi eseguire query sulle VM, sul server dei metadati in Cloud Logging. Quando si apre il periodo di manutenzione pianificata, Google Cloud la manutenzione della VM viene eseguita automaticamente. Monitorando le attività pianificate della VM di manutenzione, puoi preparare in modo proattivo i carichi di lavoro per manutenzione imminente con interruzioni minime.
Le VM con notifiche di eventi di manutenzione hanno le seguenti caratteristiche:
Controlla se nelle VM è presente una notifica relativa all'evento di manutenzione
Utilizza Google Cloud CLI, il metodo REST o il server di metadati per verificare se c'è un evento di manutenzione della VM imminente.
gcloud
Per vedere il periodo di manutenzione imminente di una VM, utilizza
gcloud compute instances describe
. Devi includere i--zone=[ZONE_NAME]
.gcloud compute instances describe VM_NAME \ --zone=ZONE
Sostituisci quanto segue:
La risposta è simile alla seguente:
upcomingMaintenance:{ "canReschedule":True "latestWindowStartTime": "2023-12-01T19:00:01Z" "maintenanceStatus":"PENDING" "type":"SCHEDULED" "windowEndTime": "2023-12-01T22:00:00Z" "windowStartTime": "2023-12-01T19:00:00Z" }
In questa risposta,
canReschedule
è impostato suTrue
emaintenanceStatus
è impostato suPENDING
. La manutenzione è pianificata per la data visualizzata e l'ora. Queste impostazioni indicano che puoi attivare manualmente questo evento in anticipo del tempo.REST
Per vedere se è prevista una manutenzione imminente per una VM, esegui Comando
instances.get
:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
Sostituisci quanto segue:
La risposta è simile alla seguente:
upcomingMaintenance:{ "canReschedule":True "latestWindowStartTime": "2023-12-01T19:00:01Z" "maintenanceStatus":"PENDING" "type":"SCHEDULED" "windowEndTime": "2023-12-01T22:00:00Z" "windowStartTime": "2023-12-01T19:00:00Z" }
In questa risposta,
canReschedule
è impostato suTRUE
emaintenanceStatus
è impostato suPENDING
. La manutenzione è pianificata per la data visualizzata e l'ora.server metadati
Dal sistema operativo guest, esegui una query sul server dei metadati per vedere di manutenzione.
$ curl http://metadata.google.internal/computeMetadata/v1/instance/upcoming-maintenance?alt=json -H "Metadata-Flavor: Google"
Controlla Cloud Logging per una notifica di evento di manutenzione
Google invia una notifica a Cloud Logging prima della VM manutenzione. Cloud Logging genera un evento di sistema in Esplora log. La manutenzione pianificata della VM viene visualizzata in Cloud Logging come:
compute.instances.upcomingMaintenance
.A seconda della configurazione della VM, Cloud Logging mostra l'evento nel seguente modo:
Se la VM è configurata per l'utilizzo della migrazione live, al termine della manutenzione viene visualizzata la pagina
compute.instances.upcomingMaintenance
completata, che indica che viene cancellata.Ti consigliamo di configurare gli avvisi per ricevere notifiche di manutenzione. Per saperne di più, leggi Configurare avvisi basati su log e Creare e gestire i canali di notifica.
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:
Comportamenti dello stato di manutenzione
Mentre gestisci la pianificazione della manutenzione, controlla lo stato di
canReschedule=
emaintenanceStatus=
di queste combinazioni di risposte descrivono il comportamento previsto della funzionalità e verrà visualizzato uno dei seguenti stati combinazioni:Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-09-29 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -