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

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

La funzionalità di controllo di manutenzione avanzato per 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 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 di manutenzione avanzato:

1. Attiva il controllo di manutenzione avanzato sui gruppi di nodi single-tenant compatibili. Questa funzionalità è disponibile solo per i gruppi di nodi single-tenant. Per utilizzare questa funzionalità con le VM esistenti o i workload single-tenant, devi prima spostare le VM nei gruppi di nodi single-tenant con il controllo della manutenzione avanzata abilitato.

2. Controlla la manutenzione imminente per i tuoi 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 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 del periodo di manutenzione pianificato, puoi:

   • Attiva la manutenzione immediatamente o pianificala per un secondo momento. 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 pianificate che scegli devono essere precedenti all'ora di inizio del periodo di manutenzione iniziale.

   • Se non attivi immediatamente la manutenzione o la pianifichi per un secondo momento, la manutenzione viene eseguita entro il periodo di tempo fornito nella finestra di manutenzione iniziale.

Puoi scegliere di scalare automaticamente i gruppi di nodi single-tenant con il controllo di manutenzione avanzato abilitato. I log di controllo vengono generati in tutti i casi.

Famiglie di macchine supportate

Il controllo di manutenzione avanzato per i nodi single-tenant è supportato per le famiglie di macchine C2, C3, C3D, C4, G2, H3, M1, M2 e M3 in disponibilità generale.

Limitazioni

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

• SSD locali e GPU:le SSD locali e le GPU non sono supportate da questa funzionalità.
• Policy di manutenzione: questa funzionalità supporta la policy di manutenzione predefinita (migrazione live). Altre policy di manutenzione, ad esempio Riavvia in loco e Esegui la migrazione all'interno del gruppo di nodi, non sono supportate.
• Nodi:questa funzionalità può supportare un massimo di 20 nodi per progetto, 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 tuoi workload 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 e poi eseguire la migrazione del workload in questo gruppo. Allo stesso modo, per disattivare il controllo di manutenzione avanzato, devi eseguire la migrazione dei nodi single-tenant in gruppi di nodi single-tenant in cui il controllo di manutenzione avanzato non è attivato.
• Impatto sui criteri di manutenzione attuali: quando attivi questa funzionalità, vengono ignorate le finestre di manutenzione esistenti associate ai nodi single-tenant.

Costi

L'utilizzo del controllo di manutenzione avanzato sui nodi single-tenant non comporta costi aggiuntivi.

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 prenotati, potresti dover richiedere una quota aggiuntiva.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  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.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

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

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

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

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"
}

Controllare la manutenzione prevista

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 della periodo di manutenzione di 6 ore, in cui è pianificata la manutenzione per quel nodo.

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/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
      },
      …
    },
    …
  ],
  …
}

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

Attivare immediatamente la manutenzione o pianificarla per un nodo

Dopo aver individuato i nodi di un gruppo di nodi single-tenant 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 dal momento in cui attivi la richiesta.

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

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

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

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
}

Il campo Stato della manutenzione di un nodo mostra lo stato seguente durante la procedura 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 finché la manutenzione non viene completata correttamente per il nodo.

Controllare se la manutenzione è stata completata

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

Per ulteriori informazioni, consulta Controllare lo stato di manutenzione.

• Manutenzione riuscita:se la manutenzione di un nodo sole-tenant va 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 nella finestra di tempo di 6 ore, l'evento di manutenzione rimane In corso finché la manutenzione non viene completata correttamente per il nodo. Una volta completata l'operazione, la notifica di manutenzione viene rimossa.

A volte, la richiesta di attivazione della manutenzione per la data e l'ora che preferisci potrebbe essere rifiutata se Google Cloud i limiti interni del controllo di manutenzione avanzato 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 manutenzione di questo nodo è In corso e rimane tale finché la manutenzione non viene completata correttamente.

Modificare la data e l'ora della manutenzione pianificata

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