Il controllo di manutenzione avanzato per single-tenancy consente di controllare gli eventi di manutenzione pianificati per i gruppi di nodi single-tenant e ridurre al minimo le interruzioni dovute 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 spostare le VM in gruppi di nodi single-tenant in cui è abilitato il controllo avanzato della manutenzione.
Il controllo di manutenzione avanzato per la funzionalità single-tenancy ti consente di:
- Controlla la presenza di 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, questa verrà eseguita entro 24 ore dal momento in cui attivi la richiesta.
Di seguito è riportato il processo per creare un gruppo di nodi single-tenant con controllo di manutenzione avanzato:
Attiva il controllo di manutenzione avanzato per i gruppi di nodi single-tenancy compatibili. Questa funzionalità è 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 avanzato della manutenzione abilitato.
Controlla se è prevista la manutenzione 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 del periodo di manutenzione di 24 ore in cui è pianificata la manutenzione per il nodo.
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 viene eseguita entro 24 ore dal momento in cui attivi la richiesta. Tieni presente che la data e l'ora pianificate che hai scelto 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 verrà eseguita entro il tempo specificato nel periodo di manutenzione iniziale.
Puoi scegliere di scalare automaticamente gruppi di nodi single-tenant con il controllo di manutenzione avanzato abilitato. Gli audit log vengono generati in tutti i casi.
Limitazioni
Di seguito sono riportate le limitazioni del controllo di manutenzione avanzato per la funzionalità single-tenancy nella fase Anteprima:
- Famiglie di macchine: questa funzionalità è supportata solo per le famiglie di VM M1, M2, M3, C2 e N2. Non è supportato per le famiglie di VM N1 e N2D.
- SSD e GPU locali: le SSD locali e le GPU non sono supportate da questa funzionalità.
- Criteri di manutenzione: questa funzionalità supporta il criterio di manutenzione predefinito (migrazione live) nella fase di anteprima. Altri criteri di manutenzione, come 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 di manutenzione avanzato per i gruppi di nodi single-tenant esistenti: nella fase di anteprima, 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 in cui è abilitato il controllo avanzato della manutenzione, devi prima creare un nuovo gruppo di nodi in cui sia abilitato il controllo avanzato di manutenzione, 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 cui non è abilitato il controllo di manutenzione avanzato.
- Impatto sui criteri di manutenzione attuali: se attivi questa funzionalità, questa funzionalità sostituisce tutti i 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 quota. A seconda del numero e della dimensione di nodi che prenoti, potrebbe essere necessario richiedere una quota aggiuntiva.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:
Console
Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.
gcloud
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Imposta una regione e una zona predefinite.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
-
Abilita il controllo di manutenzione avanzato su un nodo single-tenant
Il controllo di manutenzione avanzato per single-tenancy è una funzionalità attivabile durante la fase di anteprima. Questa funzionalità è 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 avanzato della manutenzione 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 le impostazioni di manutenzione. Per maggiori informazioni, consulta Creare un gruppo di nodi single-tenant.
gcloud
Per creare una VM su un gruppo di nodi single-tenant, 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 utilizzando il gruppo di nodi.
REST
Per creare un gruppo di nodi single-tenant basato su un modello di nodo creato in precedenza, 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/beta/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 si trova 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 VM assegnato in precedenza. Di conseguenza, l'attivazione del controllo di manutenzione avanzato sostituisce qualsiasi flag di manutenzione precedente.
Controlla l'imminente manutenzione
La manutenzione di un nodo single-tenant viene eseguita al massimo ogni 28 giorni. Potrai controllare l'evento di manutenzione per un nodo 28 giorni prima dell'inizio del periodo di manutenzione di 24 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 i prossimi eventi di manutenzione nel seguente modo:
Nella console Google Cloud, vai alla pagina Nodi single-tenant.
Fai clic su Gruppi di nodi per visualizzare un elenco dei gruppi di nodi single-tenant.
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 rappresentano la manutenzione successiva pianificata per qualsiasi nodo all'interno del gruppo di nodi.
Per visualizzare informazioni sulla manutenzione per ciascun nodo di un gruppo di nodi single-tenant, 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 Tempo di manutenzione nella tabella mostrano le informazioni sulla manutenzione futura.
gcloud
Per elencare i nodi di un gruppo di nodi single-tenant insieme alle relative informazioni di manutenzione, utilizza il comando gcloud beta 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 insieme alle relative informazioni di manutenzione, utilizza il metodo nodeGroups.listNodes.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes
Sostituisci quanto segue:
PROJECT_ID: il nome del progetto in cui si trova 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 o 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 pianificati: la manutenzione rappresenta gli aggiornamenti critici per i quali viene dato molto meno preavviso. |
canReschedule |
Se la manutenzione può essere ripianificata. |
maintenanceStatus |
Lo 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 alcun evento 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 stabilito quali nodi in un gruppo di nodi single-tenant 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 24 ore dall'attivazione della richiesta.
Programma la manutenzione per un secondo momento in base alle tue esigenze.
Se non attivi immediatamente la manutenzione o la pianifichi per una data e un'ora successive, la manutenzione verrà eseguita all'interno del 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:
Nella console Google Cloud, vai alla pagina Nodi single-tenant.
Fai clic su Gruppi di nodi.
Fai clic sul nome del gruppo di nodi per aprire la pagina dei dettagli.
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 24 ore dall'attivazione della richiesta.
Per pianificare la manutenzione per un nodo:
Nella console Google Cloud, vai alla pagina Nodi single-tenant.
Fai clic su Gruppi di nodi per visualizzare un elenco dei gruppi di nodi single-tenant.
Fai clic sul nome del gruppo di nodi per aprire la pagina dei dettagli.
Seleziona il nodo per il quale vuoi pianificare la manutenzione e fai clic su Pianifica manutenzione.
Nel riquadro Pianifica manutenzione visualizzato, seleziona una data e un'ora che preferisci 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 24 ore dall'attivazione della richiesta.
gcloud
Utilizza il comando gcloud beta compute sole-tenancy node-groups perform-maintenance per avviare o pianificare
la manutenzione di un nodo single-tenant:
gcloud beta 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 inizi il prima possibile, ometti questo flag.
REST
Utilizza il metodo nodeGroups.performMaintenance per avviare o pianificare la manutenzione per un nodo single-tenant:
POST
https://compute.googleapis.com/compute/beta/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 si trova 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 inizi 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 è stata ancora avviata, 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, utilizza il comando gcloud beta compute sole-tenancy node-groups list-nodes o il metodo nodeGroups.listNodes. Per ulteriori informazioni, consulta la sezione Controllare lo stato della manutenzione.
- La manutenzione ha esito positivo: 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
upcomingMaintenancenon è più presente per il nodo. Puoi visualizzare un log eventi di sistema in Cloud Logging. - Manutenzione non riuscita: se la manutenzione non viene completata entro un periodo di 24 ore, l'evento di manutenzione rimane In corso fino al completamento della manutenzione per il nodo. Una volta completato, la notifica di manutenzione viene rimossa.
A volte, la richiesta di trigger di manutenzione per la data e l'ora scelta potrebbe essere rifiutata se i limiti interni di Google Cloud sul 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 di 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 di manutenzione pianificate per un nodo single-tenancy utilizzando la stessa procedura utilizzata per attivare o pianificare la manutenzione di un nodo.