Questo documento fornisce una panoramica delle policy di estensione VM globali in Gestore di estensioni VM. Le policy di estensione globali consentono di eseguire il deployment e gestire le estensioni in tutte le zone e regioni di un progetto, una cartella o un'organizzazione per mantenere configurazioni del parco risorse coerenti senza gestire le policy per zona.
Per saperne di più sui livelli di gerarchia per le policy di estensione, consulta Ambiti della gerarchia delle risorse.
Il seguente diagramma illustra in che modo le policy di estensione globali applicano le estensioni alle VM in zone e regioni diverse a livello di organizzazione, cartella e progetto:
Come mostrato nel diagramma precedente, puoi definire policy di estensione globali a livello di organizzazione, cartella o progetto. Gestore di estensioni VM applica ogni policy alle VM corrispondenti in tutte le zone all'interno di quell'ambito della gerarchia.
Piani di rilascio per le policy globali
Le policy globali utilizzano i piani di rilascio per eseguire il deployment delle estensioni in zone e regioni. Un piano di rilascio consente di definire l'ordine e la tempistica degli aggiornamenti per garantire un rilascio graduale e controllato e ridurre al minimo il rischio di problemi diffusi.
Quando crei o aggiorni una policy globale, puoi specificare uno dei seguenti piani di rilascio:
- Implementazione lenta. Esegue il deployment delle estensioni gradualmente nelle zone in un periodo predefinito di cinque giorni. Utilizza questo piano di rilascio per identificare e risolvere i problemi nelle prime ondate di deployment prima che interessino l'intero parco risorse.
- Implementazione rapida. Esegue immediatamente il deployment delle estensioni in tutte le VM target in tutte le zone e regioni. Utilizza questo piano di implementazione quando devi eseguire rapidamente il deployment di un'estensione o di una patch in ambienti non di produzione.
Puoi anche definire piani di rilascio personalizzati per specificare le ondate di deployment per zona o regione e il tempo di attesa tra le ondate. Per saperne di più, consulta il metodo rolloutPlans.insert.
Comportamento in caso di conflitto di implementazione
Quando crei o aggiorni una policy di estensione globale, può verificarsi un conflitto con una policy di zona esistente nelle seguenti situazioni:
- Quando crei una policy globale. Se esiste già una policy di zona con lo stesso nome in una zona, si verifica un conflitto di nomi.
- Quando aggiorni una policy globale. Se modifichi una policy a livello di zona esistente in modo indipendente, ad esempio utilizzando una chiamata API a livello di zona, e un'implementazione successiva della policy globale tenta di aggiornare la policy a livello di zona, si verifica un conflitto di contenuti.
Per risolvere i conflitti di implementazione, puoi specificare un comportamento in caso di conflitto per l'implementazione. Questa impostazione determina se la policy globale sovrascrive le policy di zona in conflitto durante un'implementazione. Puoi specificare uno dei seguenti comportamenti:
- Non sovrascrivere (predefinito). Se non specifichi un comportamento in caso di conflitto, l'implementazione della policy globale non sovrascrive le policy di zona in conflitto. La configurazione della policy a livello di zona ha la precedenza in quella zona.
- Sovrascrivi. Se imposti il comportamento in caso di conflitto su
overwrite, la policy globale sovrascrive le policy di zona in conflitto e il gestore di estensioni VM applica la configurazione della policy globale in quella zona.
I conflitti di implementazione e la priorità delle policy sono funzionalità distinte che funzionano in modo indipendente. Per saperne di più sulla priorità delle policy, consulta Priorità delle policy e risoluzione dei conflitti.
Per saperne di più sulle impostazioni dei conflitti di implementazione, consulta il parametro conflictBehavior nel metodo globalVmExtensionPolicies.insert.
Riprova un'implementazione
Quando aggiorni o elimini una policy di estensione globale, il gestore di estensioni VM avvia un nuovo rilascio per applicare le modifiche in base al piano di rilascio. Se un'implementazione non va a buon fine o se diventano disponibili nuove zone, puoi riprovare l'operazione avviando una nuova implementazione per la stessa policy.
Quando riprovi un'operazione di aggiornamento o eliminazione di un'implementazione, devi fornire un identificatore univoco universale (UUID) in formato esadecimale di 32 caratteri (ad esempio, a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8) per identificare la richiesta di nuovo tentativo. Puoi utilizzare qualsiasi generatore di UUID standard per creare questo valore.
Riprova l'implementazione di una policy di aggiornamento
Il seguente elenco descrive gli scenari in cui potrebbe essere necessario riprovare l'implementazione di una policy di aggiornamento:
- Nuove zone aggiunte. Se dopo l'implementazione di una policy globale diventano disponibili nuove zone Google Cloud , il gestore di estensioni VM non applica automaticamente le policy esistenti alle VM nelle nuove zone. Puoi riprovare l'implementazione dell'aggiornamento per applicare la policy di estensione alle VM in queste zone.
- Ripristina le modifiche alle policy di zona. Se modifichi una policy a livello di zona in modo indipendente, ad esempio utilizzando una chiamata API a livello di zona, puoi riprovare a implementare un aggiornamento con
conflictBehaviorimpostato suoverwrite. Questa impostazione applica nuovamente la configurazione della policy globale e sovrascrive le modifiche alla policy di zona. - Implementazione interrotta. Se un'implementazione precedente non riesce prima del completamento, puoi avviarne una nuova per riprovare l'aggiornamento.
- Accelerare un'implementazione. Se un'implementazione in corso procede troppo lentamente, puoi avviarne una nuova utilizzando un piano
FAST_ROLLOUTo un piano di implementazione personalizzato per accelerare il processo di aggiornamento.
Per saperne di più, consulta il parametro retryUuid nel metodo globalVmExtensionPolicies.update.
Riprova l'implementazione di una politica di cancellazione
L'elenco seguente descrive gli scenari in cui potrebbe essere necessario riprovare l'implementazione di una policy di eliminazione:
- Implementazione interrotta. Se un'implementazione di eliminazione precedente non viene completata, puoi avviarne una nuova per riprovare l'eliminazione.
- Accelerare un'implementazione. Se un'implementazione di eliminazione in corso procede troppo lentamente, puoi avviarne una nuova utilizzando un piano
FAST_ROLLOUTo un piano di implementazione personalizzato per accelerare il processo di eliminazione.
Per saperne di più, consulta il parametro retryUuid nel metodo globalVmExtensionPolicies.delete.
Passaggi successivi
- Per eseguire il deployment degli agenti supportati nel tuo parco risorse a livello di organizzazione, cartella o progetto, consulta Installa le estensioni VM creando policy di estensione.
- Per modificare le impostazioni di configurazione, cambiare le versioni bloccate o rimuovere gli agenti di cui è stato eseguito il deployment, consulta Gestisci le estensioni VM utilizzando le policy delle estensioni.
- Per esaminare l'avanzamento dell'implementazione e lo stato di integrità delle estensioni, consulta Visualizza i dettagli e lo stato delle estensioni VM.
- Per creare dashboard di Cloud Monitoring e configurare avvisi per l'integrità dell'agente, l'utilizzo della CPU e della memoria utilizzata, consulta Monitora le estensioni VM.