Attivare il controllo di manutenzione avanzato per i nodi single-tenant


Il controllo di manutenzione avanzato per il single-tenancy ti consente di controllare gli eventi di manutenzione pianificati per i gruppi di nodi single-tenant e di ridurre al minimo le interruzioni correlate alla manutenzione. Questa funzionalità è disponibile solo per i gruppi di nodi di proprietà esclusiva. Per utilizzare questa funzionalità con le tue macchine virtuali esistenti, devi prima spostarle in gruppi di nodi di proprietà esclusiva in cui è attivato il controllo avanzato della manutenzione.

La funzionalità di controllo di manutenzione avanzata per single-tenancy ti consente di:

  • Controlla se sono presenti eventi di manutenzione pianificati per un nodo di proprietà esclusiva con 28 giorni di anticipo.
  • Attiva la manutenzione immediatamente o programmala per un momento successivo. Tieni presente che se attivi immediatamente la manutenzione, questa viene eseguita entro 6 ore dal momento in cui attivi la richiesta.

Di seguito è riportata la procedura per creare un gruppo di nodi single-tenant con controllo avanzato della manutenzione:

  1. Attiva il controllo di manutenzione avanzato sui gruppi di nodi single-tenant compatibili. Questa funzionalità è disponibile solo per i gruppi di nodi di proprietà esclusiva. Per utilizzare questa funzionalità con le VM o i carichi di lavoro sole-tenant esistenti, devi prima spostare le VM in gruppi di nodi sole-tenant con il controllo della manutenzione avanzata attivo.

  2. Controlla la manutenzione in programma per i tuoi nodi di proprietà singola. La manutenzione di un nodo monoproprietario viene eseguita al massimo ogni 28 giorni. Puoi controllare l'evento di manutenzione per un nodo 28 giorni prima dell'inizio della periodo di manutenzione di 6 ore in cui è pianificata la manutenzione per quel nodo.

  3. Se la manutenzione è pianificata per un nodo single-tenant e prima dell'inizio della periodo di manutenzione pianificata, puoi:

    • Attiva la manutenzione immediatamente o programmala per un momento successivo. Se scegli di attivare immediatamente la manutenzione, questa viene eseguita entro 6 ore dal momento in cui attivi la richiesta. Tieni presente che la data e l'ora programmate che scegli devono precedere l'ora di inizio del periodo di manutenzione iniziale.

    • Se non attivi la manutenzione immediatamente o non la programmi per un momento successivo, la manutenzione viene eseguita nel periodo di tempo specificato nella finestra di manutenzione iniziale.

Puoi scegliere di eseguire la scalabilità automatica dei gruppi di nodi single-tenant con il controllo di manutenzione avanzato attivo. I log di controllo vengono generati in tutti i casi.

Famiglie di macchine supportate

Il controllo di manutenzione avanzato per i nodi monoproprietario è supportato per le seguenti famiglie di macchine:

Limitazioni

Di seguito sono riportate le limitazioni del controllo di manutenzione avanzato per la funzionalità di single-tenancy:

  • GPU e SSD locali:le GPU e le SSD locali non sono supportate da questa funzionalità.
  • Criteri di manutenzione: questa funzionalità supporta il criterio di manutenzione predefinito (migrazione live). Altri criteri di manutenzione, come il riavvio in situ (BYOLv1) e la migrazione all'interno del gruppo di nodi (BYOLv2), non sono supportati.
  • Nodi:questa funzionalità può supportare un massimo di 20 nodi per progetto e per zona.
  • Controllo di manutenzione avanzato per i gruppi di nodi single-tenant esistenti: non puoi attivare il controllo di manutenzione avanzato per i gruppi di nodi single-tenant esistenti. Se vuoi eseguire i carichi di lavoro esistenti su gruppi di nodi di proprietà esclusiva con il controllo avanzato della manutenzione abilitato, devi prima creare un nuovo gruppo di nodi con il controllo avanzato della manutenzione abilitato e poi eseguire la migrazione del carico di lavoro in questo gruppo. Analogamente, per disattivare il controllo di manutenzione avanzato, devi eseguire la migrazione dei nodi single-tenant in gruppi di nodi single-tenant in cui non è attivo il controllo di manutenzione avanzato.
  • Impatto sui criteri di manutenzione attuali: quando attivi questa funzionalità, viene sostituita qualsiasi finestra di manutenzione esistente associata ai nodi single-tenant.

Costi

Non sono previsti costi aggiuntivi per l'utilizzo del controllo di manutenzione avanzato sui nodi di proprietà singola.

Prima di iniziare

  • Prima di eseguire il provisioning delle VM su un nodo single-tenant, controlla la tua quota. A seconda del numero e delle dimensioni dei nodi riservati, potresti dover richiedere una quota aggiuntiva.
  • 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:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    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.

Attivare il controllo di manutenzione avanzato su un nodo single-tenant

Il controllo di manutenzione avanzato per single-tenancy è una funzionalità che deve essere attivata ed è disponibile solo per i gruppi di nodi single-tenant. Per utilizzare questa funzionalità con le VM o i workload single-tenant esistenti, devi prima spostare le VM in gruppi di nodi single-tenant con il controllo avanzato della manutenzione abilitato.

Console

Puoi attivare il controllo di manutenzione avanzato quando crei un gruppo di nodi selezionato Attiva il controllo di manutenzione avanzato per la single-tenancy nella sezione Configura le impostazioni di manutenzione. Per ulteriori informazioni, consulta Creare un gruppo di nodi di proprietà esclusiva.

gcloud

Per creare un gruppo di nodi single-tenant M2, utilizza il comando gcloud compute sole-tenancy node-groups create.

Per creare un gruppo di nodi single-tenant di qualsiasi altra famiglia di macchine supportata, utilizza il comando gcloud beta compute sole-tenancy node-groups create.

Il flag --maintenance-interval=RECURRENT nel seguente comando specifica che il controllo di manutenzione avanzato è attivo per il nodo single-tenant.

gcloud compute sole-tenancy node-groups create NODE_GROUP_NAME \
--node-template=NODE_TEMPLATE_NAME \
--zone=NODE_GROUP_ZONE \
--target-size=NODE_GROUP_SIZE \
--maintenance-interval=RECURRENT

Sostituisci quanto segue:

  • NODE_GROUP_NAME: il nome del gruppo di nodi.

  • NODE_TEMPLATE_NAME: il nome del modello di nodo da utilizzare per creare questo gruppo.

  • NODE_GROUP_SIZE: il numero di nodi da creare nel gruppo.

  • NODE_GROUP_ZONE: la zona in cui creare il gruppo di nodi. Deve essere la stessa regione del modello di nodo su cui baso il gruppo di nodi.

REST

Per creare un gruppo di nodi single-tenant M2 in base a un modello di nodo creato in precedenza, utilizza il metodo nodeGroups.insert.

Per creare un gruppo di nodi single-tenant in base a un modello di nodo creato in precedenza per tutti gli altri nodi, utilizza il metodo nodeGroups.insert.

Il parametro maintenanceInterval nel seguente comando specifica che il nodo single-tenant è attivato per il controllo di manutenzione avanzato.

POST https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups
{
"name": "NODE_GROUP_NAME",
"nodeTemplate": "NODE_TEMPLATE_URL",
"zone": "NODE_GROUP_ZONE",
"size": "NODE_GROUP_SIZE",
"maintenanceInterval": "RECURRENT"
}

Sostituisci quanto segue:

  • PROJECT_ID: il nome del progetto in cui esiste il gruppo di nodi.

  • NODE_GROUP_ZONE: la zona del gruppo di nodi.

  • NODE_GROUP_NAME: il nome del gruppo di nodi.

  • NODE_TEMPLATE_URL: l'URL del modello di nodo da utilizzare per creare questo gruppo.

  • NODE_GROUP_SIZE: il numero di nodi da creare nel gruppo.

Il flag a livello di nodo sostituisce eventuali flag VM assegnati in precedenza. Pertanto, l'attivazione del controllo di manutenzione avanzato ha la precedenza su eventuali flag di manutenzione precedenti.

Controllare la manutenzione prevista

La manutenzione di un nodo monoproprietario viene eseguita al massimo ogni 28 giorni. Puoi controllare l'evento di manutenzione per un nodo 28 giorni prima dell'inizio della periodo di manutenzione di 6 ore, in cui è pianificata la manutenzione per quel nodo.

Console

Dopo aver attivato un gruppo di nodi single-tenant per il controllo di manutenzione avanzato, vedrai gli eventi di manutenzione imminenti nel seguente modo:

  1. Nella console Google Cloud, vai alla pagina Nodi di proprietà esclusiva.

    Vai a Nodi single-tenant

  2. Fai clic su Gruppi di nodi per visualizzare un elenco di gruppi di nodi single-tenancy.

  3. Per qualsiasi gruppo di nodi di proprietà esclusiva, puoi vedere le colonne Stato manutenzione e Ora manutenzione nella tabella relativa alla manutenzione imminente. Poiché la manutenzione è impostata a livello di nodo, le informazioni sulla manutenzione visualizzate qui si riferiscono alla manutenzione successiva pianificata per uno dei nodi del gruppo di nodi.

  4. Per visualizzare le informazioni sulla manutenzione di ogni nodo in un gruppo di nodi di proprietà esclusiva, fai clic sul nome del gruppo di nodi per aprire la pagina dei dettagli. Per ogni nodo nel gruppo di nodi, le colonne Stato manutenzione e Ora manutenzione nella tabella mostrano le informazioni sulla manutenzione imminente.

gcloud

Per elencare i nodi di un gruppo di nodi single-tenant M2 insieme alle relative informazioni sulla manutenzione, utilizza il comando gcloud compute sole-tenancy node-groups list-nodes.

gcloud compute sole-tenancy node-groups list-nodes NODE_GROUP_NAME \
--format "table(name, status, node_type, instances, server_id, upcoming_maintenance)"

Sostituisci NODE_GROUP_NAME con il nome del gruppo di nodi.

REST

Per elencare i nodi di un gruppo di nodi single-tenant M2 insieme alle relative informazioni di manutenzione, utilizza il metodo nodeGroups.listNodes.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes

Sostituisci quanto segue:

  • PROJECT_ID: il nome del progetto in cui esiste il gruppo di nodi.

  • NODE_GROUP_ZONE: la zona del gruppo di nodi.

  • NODE_GROUP_ID: l'ID del gruppo di nodi.

Di seguito è riportata la risposta del metodo nodeGroups.listNodes:

{
  …
  "items": [
    …
    {
      "name": string,
      "status": string,
      …
      "upcomingMaintenance": {
        "canReschedule": boolean,
        "maintenanceType": enum, // SCHEDULED | UNSCHEDULED
        "windowStartTime": string, // RFC 3339 timestamp string
        "windowEndTime": string, // RFC 3339 timestamp string
        "latestWindowStartTime": string, // RFC 3339 timestamp string
        "maintenanceStatus": enum // PENDING | ONGOING
      },
      …
    },
    …
  ],
  …
}

Di seguito sono riportati i dettagli dell'evento di manutenzione per il gruppo di nodi:

Nome parametro Descrizione
windowStartTime Ora di inizio del periodo di manutenzione.
windowEndTime Ora di fine del periodo di manutenzione.
latestWindowStartTime Ora di inizio del periodo di manutenzione iniziale. Puoi scegliere di attivare la manutenzione immediatamente o di programmarla per una data e un'ora successive solo prima del giorno latestWindowStartTime.
maintenanceType Il tipo di manutenzione che verrà eseguita:
- Pianificata: la manutenzione è pianificata per questo nodo.
- Non pianificata: la manutenzione rappresenta aggiornamenti critici per i quali viene fornita una notifica molto più breve.
canReschedule Indica se è possibile riprogrammare la manutenzione.
maintenanceStatus Lo stato dell'operazione di manutenzione in corso:
- In attesa: l'operazione di manutenzione non è ancora iniziata, ma è stata pianificata.
- In corso: il periodo di manutenzione è iniziato.

Se non vedi alcun evento di manutenzione, significa che non è prevista alcuna manutenzione per i nodi del gruppo di nodi.

Attivare immediatamente la manutenzione o pianificarla per un nodo

Dopo aver stabilito quali nodi di un gruppo di nodi monoproprietario sono pianificati per la manutenzione, puoi eseguire una delle seguenti operazioni:

  • Attiva immediatamente la manutenzione. Se scegli di attivare immediatamente la manutenzione, questa viene eseguita entro 6 ore dall'attivazione della richiesta.

  • Pianifica la manutenzione per un momento successivo in base ai tuoi requisiti.

Se non attivi immediatamente la manutenzione o la programmi per una data e un'ora successive, la manutenzione viene eseguita nel periodo di manutenzione iniziale. Una volta avviata la manutenzione per un nodo, non puoi metterla in pausa o riprogrammarla.

Console

Per attivare immediatamente la manutenzione di un nodo:

  1. Nella console Google Cloud, vai alla pagina Nodi di proprietà esclusiva.

    Vai a Nodi single-tenant

  2. Fai clic su Gruppi di nodi.

  3. Fai clic sul nome del gruppo di nodi per aprire la pagina dei dettagli.

  4. Seleziona il nodo per cui vuoi attivare immediatamente la manutenzione e fai clic su Inizia ora.

Verrà visualizzato un messaggio di conferma e la manutenzione verrà eseguita entro 6 ore dal momento in cui attivi la richiesta.

Per pianificare la manutenzione di un nodo:

  1. Nella console Google Cloud, vai alla pagina Nodi di proprietà esclusiva.

    Vai a Nodi single-tenant

  2. Fai clic su Gruppi di nodi per visualizzare un elenco di gruppi di nodi single-tenancy.

  3. Fai clic sul nome del gruppo di nodi per aprire la pagina dei dettagli.

  4. Seleziona il nodo per cui vuoi pianificare la manutenzione e fai clic su Pianifica manutenzione.

  5. Nel riquadro Pianifica manutenzione visualizzato, seleziona una data e un'ora per la manutenzione. Tieni presente che puoi pianificare la manutenzione per un nodo in qualsiasi momento prima dell'ora di inizio del periodo di manutenzione iniziale.

Verrà visualizzato un messaggio di conferma e la manutenzione verrà eseguita entro 6 ore dal momento dell'attivazione della richiesta.

gcloud

Utilizza il comando gcloud compute sole-tenancy node-groups perform-maintenance per avviare o pianificare la manutenzione di un nodo M2 single-tenant.

gcloud compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \
--zone=NODE_GROUP_ZONE \
--nodes=NODE_NAMES \
--window-start-time=WINDOW_START_TIME

Sostituisci quanto segue:

  • NODE_GROUP_NAME: il nome del gruppo di nodi.

  • NODE_GROUP_ZONE: la zona del gruppo di nodi.

  • NODE_NAMES: il nome del nodo per cui vuoi eseguire la manutenzione.

  • WINDOW_START_TIME: data e ora di inizio della manutenzi. Se vuoi che la manutenzione inizi il prima possibile, ometti questo flag.

REST

Utilizza il metodo nodeGroups.performMaintenance per avviare o pianificare la manutenzione di un nodo M2 di proprietà esclusiva.

POST
https://compute.googleapis.com/compute/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/performMaintenance
{
"nodes": "NODE_NAMES" // [Required] The user needs to list at least 1 node
"windowStartTime":  "WINDOW_START_TIME" // [Optional] RFC 3339 timestamp string
}

Sostituisci quanto segue:

  • PROJECT_ID: il nome del progetto in cui esiste il gruppo di nodi.

  • NODE_GROUP_ZONE: la zona del gruppo di nodi.

  • NODE_GROUP_ID: l'ID del gruppo di nodi.

  • NODE_NAMES: il nome del nodo per cui vuoi eseguire la manutenzione.

  • WINDOW_START_TIME: data e ora di inizio della manutenzi. Ometti questo campo se vuoi che la manutenzione inizi il prima possibile.

Il campo Stato della manutenzione di un nodo mostra il seguente stato durante la procedura di manutenzione:

  • In attesa: l'operazione di manutenzione non è ancora iniziata, ma è programmata.
  • In corso: il periodo di manutenzione è iniziato. L'evento di manutenzione rimane in stato In corso finché la manutenzione non viene completata correttamente per il nodo.

Controlla se la manutenzione è stata completata

Per eseguire query sullo stato della manutenzione di un nodo M2, utilizza il comando gcloud compute sole-tenancy node-groups list-nodes o il metodo nodeGroups.listNodes.

Per ulteriori informazioni, consulta Controllare lo stato della manutenzione.

  • Manutenzione riuscita: se la manutenzione di un nodo monoproprietario è riuscita, la notifica relativa alla manutenzione viene rimossa. Quando esegui una query sul nome del gruppo di nodi, la sezione upcomingMaintenance non sarà più presente per il nodo.
  • Manutenzione non riuscita: se la manutenzione non viene completata nel periodo di tempo di 6 ore, l'evento di manutenzione rimane In corso finché la manutenzione non viene completata correttamente per il nodo. Al termine dell'operazione, la notifica relativa alla manutenzione viene rimossa.

A volte, la richiesta di attivazione della manutenzione per la data e l'ora che preferisci potrebbe essere rifiutata se i limiti interni di Google Cloud per il controllo avanzato della manutenzione per i nodi di proprietà esclusiva sono stati superati per la data e l'ora specificate. In questo caso, devi selezionare un'altra data e un'altra ora per la manutenzione del nodo. Lo stato della manutenzione per questo nodo è In corso e rimane tale fino al completamento della manutenzione.

Modificare la data e l'ora della manutenzione pianificata

Puoi modificare la data e l'ora della manutenzione pianificata per un nodo di proprietà esclusiva utilizzando la stessa procedura utilizzata per attivare o pianificare la manutenzione di un nodo.