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

Il controllo avanzato della manutenzione per la modalità single-tenancy consente di controllare gli eventi di manutenzione pianificata per i gruppi di nodi single-tenant e ridurre al minimo le interruzioni legate alla manutenzione. Questa funzionalità è disponibile solo per i gruppi di nodi single-tenant. Per utilizzare questa funzionalità con le macchine virtuali esistenti, devi prima spostare le VM in gruppi di nodi single-tenant in cui è abilitato il controllo di manutenzione avanzato.

Il controllo di manutenzione avanzato per la funzionalità single-tenancy ti consente di:

  • Controlla gli eventi di manutenzione pianificati per un nodo single-tenant con 28 giorni di anticipo.
  • Attiva immediatamente la manutenzione o pianificala per un secondo momento. Tieni presente che, se attivi la manutenzione immediatamente, la manutenzione avviene entro 6 ore dal momento in cui viene attivata la richiesta.

Di seguito è riportato il processo per la creazione di un gruppo di nodi single-tenant con controllo di manutenzione avanzato:

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

  2. Verifica la manutenzione imminente dei nodi single-tenant. La manutenzione di un nodo single-tenant viene eseguita al massimo ogni 28 giorni. Puoi controllare l'evento di manutenzione per un nodo 28 giorni prima dell'inizio del 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 immediatamente la manutenzione o pianificala per un secondo momento. Se scegli di attivare immediatamente la manutenzione, questa verrà eseguita entro 6 ore dall'attivazione della richiesta. Tieni presente che la data e l'ora pianificate che scegli devono essere precedenti all'ora di inizio del periodo di manutenzione iniziale.

    • Se non attivi la manutenzione immediatamente o non la pianifichi per un secondo momento, la manutenzione avviene entro il tempo specificato nel periodo di manutenzione iniziale.

Puoi scegliere di scalare automaticamente i gruppi di nodi single-tenant in cui è abilitato il controllo di manutenzione avanzato. Gli audit log vengono generati in tutti i casi.

Famiglie di macchine supportate

Il controllo di manutenzione avanzato per i nodi single-tenant è supportato per le seguenti famiglie di macchine:

Limitazioni

Di seguito sono riportati i limiti del controllo di manutenzione avanzato per la funzionalità single-tenancy:

  • SSD e GPU locali: questa funzionalità non supporta gli SSD locali e le GPU.
  • Criteri di manutenzione: questa funzionalità supporta il criterio di manutenzione predefinito (migrazione live). Altri criteri di manutenzione, ad esempio il riavvio in loco (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 per zona.
  • Controllo avanzato della manutenzione per gruppi di nodi single-tenant esistenti: non puoi attivare i gruppi di nodi single-tenant esistenti per il controllo avanzato della manutenzione. Per eseguire i carichi di lavoro esistenti su gruppi di nodi single-tenant con il controllo di manutenzione avanzato abilitato, devi prima creare un nuovo gruppo di nodi con il controllo di manutenzione avanzato abilitato, quindi 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 per i quali non è abilitato il controllo di manutenzione avanzato.
  • Impatto sui criteri di manutenzione attuali: se attivi questa funzionalità, verrà eseguita l'override di eventuali periodi di manutenzione esistenti associati ai nodi single-tenant.

Costi

Non sono previsti costi aggiuntivi per l'utilizzo del controllo di manutenzione avanzato sui nodi single-tenant.

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 che prenoti, potrebbe essere necessario richiedere una quota aggiuntiva.
  • Se non l'hai già fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in 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

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

      gcloud init
    2. Set a default region and zone.
    3. 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.

        Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

        gcloud init

      Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

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

Il controllo di manutenzione avanzato per la modalità single-tenancy è una funzionalità attivabile ed è disponibile solo per i gruppi di nodi single-tenant. Per utilizzare questa funzionalità con le VM o i carichi di lavoro single-tenant esistenti, devi prima spostare le VM in gruppi di nodi single-tenant con il controllo di manutenzione avanzato abilitato.

Console

Puoi attivare il controllo di manutenzione avanzato quando crei un gruppo di nodi selezionando l'opzione Attiva la manutenzione avanzata single-tenancy nella sezione Configura impostazioni di manutenzione. Per ulteriori informazioni, consulta Creare un gruppo di nodi single-tenant.

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 comando seguente specifica che il nodo single-tenant è attivato per il controllo di manutenzione avanzato.

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 stai basando il gruppo di nodi.

REST

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

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

Il parametro maintenanceInterval nel comando seguente 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 qualsiasi flag della VM assegnato in precedenza. Pertanto, l'attivazione del controllo di manutenzione avanzato sostituisce qualsiasi flag di manutenzione precedente.

Verificare la manutenzione imminente

La manutenzione di un nodo single-tenant viene eseguita al massimo ogni 28 giorni. Puoi controllare l'evento di manutenzione per un nodo 28 giorni prima dell'inizio del 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 single-tenant.

    Vai ai nodi single-tenant

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

  3. Per qualsiasi gruppo di nodi single-tenant, puoi visualizzare le colonne Stato manutenzione e Tempo manutenzione nella tabella per la manutenzione futura. Poiché la manutenzione è impostata a livello di nodo, le informazioni di manutenzione che vedi qui sono la prossima manutenzione pianificata per uno qualsiasi dei nodi all'interno del gruppo di nodi.

  4. Per visualizzare le informazioni sulla manutenzione per ciascun nodo in un gruppo di nodi single-tenant, fai clic sul nome del gruppo di nodi per aprire la pagina dei dettagli. Per ogni nodo del gruppo di nodi, le colonne Stato manutenzione e Tempo manutenzione nella tabella mostrano le informazioni sulla manutenzione futura.

gcloud

Per elencare i nodi di un gruppo di nodi single-tenant M2 insieme alle relative informazioni di 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 immediatamente la manutenzione oppure pianificarla per una data e un'ora successive solo prima del giorno latestWindowStartTime.
maintenanceType Il tipo di manutenzione che verrà eseguito:
- Pianificata: la manutenzione è pianificata per questo nodo.
- Non pianificata: la manutenzione rappresenta aggiornamenti critici per i quali viene fornito molto meno preavviso.
canReschedule Indica se la manutenzione può essere ripianificata.
maintenanceStatus Stato dell'operazione di manutenzione attuale:
- In attesa: l'operazione di manutenzione non è ancora iniziata, ma è pianificata.
- In corso: il periodo di manutenzione è iniziato.

Se non vedi eventi di manutenzione, significa che non è prevista alcuna manutenzione imminente per i nodi nel gruppo di nodi.

Attiva immediatamente la manutenzione o pianifica la manutenzione per un nodo

Dopo aver determinato quali nodi di un gruppo di nodi single-tenant sono pianificati per la manutenzione, puoi procedere in uno dei seguenti modi:

  • Attiva immediatamente la manutenzione. Se scegli di attivare immediatamente la manutenzione, questa viene eseguita entro 6 ore dal momento in cui viene attivata la richiesta.

  • Pianifica la manutenzione per un secondo momento in base alle tue esigenze.

Se non attivi la manutenzione immediatamente o non la pianifichi per una data e un'ora successive, la manutenzione avviene entro il periodo di manutenzione iniziale. Una volta iniziata la manutenzione di un nodo, non puoi metterlo in pausa o ripianificarlo.

Console

Per attivare immediatamente la manutenzione per un nodo:

  1. Nella console Google Cloud, vai alla pagina Nodi single-tenant.

    Vai ai 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 il quale 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 dall'attivazione della richiesta.

Per pianificare la manutenzione di un nodo, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Nodi single-tenant.

    Vai ai nodi single-tenant

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

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

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

  5. Nel riquadro Pianifica manutenzione visualizzato, seleziona la data e l'ora desiderate per la manutenzione. Tieni presente che puoi pianificare la manutenzione di 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 dall'attivazione della richiesta.

gcloud

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

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 manutenzione. Se vuoi che la manutenzione venga avviata il prima possibile, ometti questo flag.

REST

Utilizza il metodo nodeGroups.performMaintenance per avviare o pianificare la manutenzione per un nodo single-tenant M2.

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 manutenzione. Ometti questo campo se vuoi che la manutenzione venga avviata il prima possibile.

Il campo Stato manutenzione di un nodo mostra il seguente stato durante il processo di manutenzione:

  • In attesa: l'operazione di manutenzione non è ancora iniziata, ma è pianificata.
  • In corso: il periodo di manutenzione è iniziato. L'evento di manutenzione rimane In corso fino al completamento della manutenzione per il nodo.

Controllare se la manutenzione è stata completata

Per eseguire una query sullo stato di 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 la sezione Controllare lo stato della manutenzione.

  • Manutenzione riuscita: se la manutenzione di un nodo single-tenant è andata a buon fine, la notifica di 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 entro 6 ore, l'evento di manutenzione rimane In corso fino al completamento della manutenzione per il nodo. Al termine, la notifica di manutenzione viene rimossa.

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

Modifica data e ora della manutenzione pianificata

Puoi modificare la data e l'ora della manutenzione pianificata per un nodo single-tenancy utilizzando la stessa procedura che utilizzi per attivare o pianificare la manutenzione per un nodo.