Applicare nuove configurazioni delle VM in un gruppo di istanze gestite

Questa pagina spiega come configurare le istanze di macchine virtuali (VM) in un gruppo di istanze gestite (MIG) e i metodi che puoi utilizzare per applicare la configurazione alle VM esistenti nel gruppo.

Specifica la configurazione prevista per le VM in un gruppo di istanze gestite utilizzando i seguenti componenti di configurazione delle VM:

  • Obbligatorio: modello di istanza
  • (Facoltativo) Configurazione di tutte le istanze
  • Facoltativo: configurazione stateful

Ogni volta che aggiorni la configurazione prevista utilizzando questi componenti, Compute Engine applica automaticamente la configurazione aggiornata alle nuove VM aggiunte al gruppo.

Per applicare una configurazione aggiornata alle VM esistenti, utilizza i metodi descritti in questa pagina:

  • Implementazioni automatiche con un budget per l'interruzione e aggiornamenti canary facoltativi nuovi modelli
  • Aggiornamenti manuali selettivi solo per VM specifiche, per ridurre al minimo le interruzioni
  • Ricostruzione di VM specifiche

Puoi anche configurare il gruppo di istanze gestite in modo che applichi la configurazione più recente disponibile alle VM durante le riparazioni. Per ulteriori informazioni, consulta Applicare gli aggiornamenti di configurazione durante le riparazioni.

Se devi solo ridimensionare un gruppo di istanze gestite, consulta la documentazione su come aggiungere o rimuovere VM in un gruppo di istanze gestite. Per scoprire di più sulla configurazione delle funzionalità dei gruppi di istanze gestite, consulta la documentazione relativa alla scalabilità automatica, alla riparazione automatica, al bilanciamento del carico e ai carichi di lavoro stateful.

Prima di iniziare

  • Se non l'hai già 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 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. 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 di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Componenti di configurazione per le VM in un gruppo di istanze gestite

Le VM in un MIG vengono configurate tramite i seguenti componenti:

ComponenteProprietàCaso d'uso
Modello di istanza Tipo di macchina, immagine del disco di avvio, etichette, script di avvio e altre proprietà della VM Obbligatorio: utilizza un modello di istanza per definire gli attributi obbligatori e per tutte le VM nel gruppo.

(Facoltativo) Se vuoi eseguire il test canary di una seconda VM puoi aggiungere al gruppo un secondo modello di istanza e applicarlo a un sottoinsieme delle VM nel gruppo.
Configurazione di tutte le istanze Etichette e metadati (Facoltativo) Utilizza una configurazione di tutte le istanze per eseguire rapidamente l'override del modello di istanza per tutte le VM nel gruppo.
Configurazione stateful Dischi con stato, indirizzi IP e metadati (Facoltativo) Se devi supportare una carico di lavoro stateful, la configurazione stateful alle VM nel gruppo.

Se aggiorni una configurazione per il gruppo tramite questi componenti, devi applicarla alle VM esistenti nel gruppo per renderla effettiva.

Metodi per applicare una nuova configurazione alle VM esistenti

Dopo aver aggiornato la configurazione delle VM di un gruppo di istanze gestite, puoi applicare la nuova configurazione alle VM esistenti nel gruppo utilizzando i seguenti metodi:

  • Automatico (proattivo): utilizza questo metodo se vuoi che il gruppo di istanze gestite applichi automaticamente nuove configurazioni a tutte o a un sottoinsieme di VM esistenti nel gruppo. Il livello di interruzione delle VM in esecuzione dipende dal criterio di aggiornamento configurato. Puoi utilizzare questo metodo per eseguire l'aggiornamento canary di nuovi modelli di istanze. Per utilizzare questo metodo, imposta il tipo di aggiornamento del gruppo di istanze gestite su "proattiva".
  • Selettivo (opportunistico): utilizza questo metodo se vuoi applicare la aggiornare manualmente o se vuoi aggiornare tutte le VM esistenti nel gruppo una volta sola. Scegli come target una o tutte le VM da aggiornare all'ultima configurazione. A Se usi questo metodo, imposta il tipo di aggiornamento del gruppo di istanze gestite su "opportunistico".
  • Ricreazione di VM: applica nuove configurazioni ricreando VM specifiche.

Per saperne di più su come impostare il tipo di aggiornamento di un gruppo di istanze gestite, consulta Configurare un aggiornamento proattivo o opportunistico.

Automatica (proattiva)

Un tipo di aggiornamento automatico è noto anche come tipo di aggiornamento proattivo. Quando Se il tipo di aggiornamento del gruppo di istanze gestite viene impostato su proattivo, il gruppo di istanze gestite applica automaticamente configurazioni alle VM in base alle esigenze.

L'impostazione del tipo di aggiornamento del gruppo di istanze gestite su proattivo offre due vantaggi principali:

  • L'implementazione di un aggiornamento avviene automaticamente in base alle tue specifiche, senza bisogno di ulteriori input dopo la richiesta iniziale. Puoi specificare la velocità di deployment, il livello di interruzione del servizio e l'ambito l'aggiornamento.
  • Puoi automatizzare le implementazioni parziali, consentendo i test canary.

Per scoprire come impostare il tipo di aggiornamento del gruppo di istanze gestite, consulta Configura un aggiornamento proattivo o opportunistico.

Per saperne di più sulle implementazioni automatiche, Applica automaticamente gli aggiornamenti della configurazione delle VM in un gruppo di istanze gestite.

Selettiva (opportunistica)

Un tipo di aggiornamento selettivo è noto anche come tipo di aggiornamento opportunistico. Quando impostate il tipo di aggiornamento del gruppo di istanze gestite su opportunistico, il gruppo di istanze gestite applica le nuove configurazioni alle VM esistenti solo quando scegliete come target VM specifiche da aggiornare.

L'impostazione del tipo di aggiornamento del gruppo di istanze gestite su opportunistico offre i seguenti vantaggi:

  • Puoi selezionare le VM da aggiornare.
  • Puoi controllare la tempistica e la sequenza degli aggiornamenti.
  • Puoi utilizzare l'interfaccia a riga di comando gcloud o REST per aggiornare immediatamente tutte le istanze.

In alcuni scenari, un tipo di aggiornamento selettivo è utile perché non vuoi causare instabilità al sistema se può essere evitato. Ad esempio, considera le seguenti:

  • Una delle VM nel gruppo di istanze gestite smette di funzionare e deve essere riparata, ma non che deve cambiare la sua configurazione. Se imposti il tipo di aggiornamento del gruppo di istanze gestite su opportunistico e non applichi forzatamente gli aggiornamenti durante le riparazioni, Compute Engine ripara la VM utilizzando la stessa configurazione utilizzata per crearla, anche se il modello di istanza originale non esiste più.

  • Hai un gruppo di istanze gestite con scalabilità automatica e vuoi applicare un aggiornamento non critico senza alcuna urgenza. Per assicurarti che Compute Engine non distruggi alle VM esistenti per applicare l'aggiornamento, imposta il tipo di aggiornamento del gruppo di istanze gestite su opportunistico. Al momento dello scale in, il gestore della scalabilità automatica termina preferibilmente le VM con configurazione. Quando il gruppo esegue lo scale out, vengono create VM con la configurazione più recente.

Per scoprire come impostare il tipo di aggiornamento del gruppo di istanze gestite, consulta Configurare un aggiornamento proattivo o opportunistico.

Per ulteriori informazioni sull'aggiornamento selettivo delle VM, consulta Applica in modo selettivo gli aggiornamenti della configurazione delle VM in un gruppo di istanze gestite.

Ricostruzione delle VM

Puoi ricreare qualsiasi VM in un gruppo di istanze gestite. In questo caso, il gruppo di istanze gestite applica qualsiasi configurazione aggiornata che non è ancora stata applicata alla VM. Per maggiori informazioni le informazioni, vedi Ricreare VM in un gruppo di istanze gestite.

Configurare un aggiornamento proattivo o opportunistico

Per applicare automaticamente nuove configurazioni alle VM esistenti, imposta il tipo di aggiornamento del gruppo di istanze gestite su "proattivo". Per applicare nuove configurazioni alle VM esistenti solo quando selezioni una VM da aggiornare, imposta il tipo di aggiornamento del gruppo di istanze gestite su "opportunistico".

Utilizza la console Google Cloud, Google Cloud CLI o REST.

Console

  1. Nella console Google Cloud, vai alla pagina Gruppi di istanze.

    Vai alla pagina Gruppi di istanze

  2. Seleziona il gruppo MIG che vuoi aggiornare.

  3. Nella parte superiore della pagina, fai clic su Aggiorna VM.

  4. Per impostare un modello diverso per il gruppo, in Nuovo modello, seleziona il modello di istanza che vuoi utilizzare.

  5. In Aggiorna configurazione, scegli l'aggiornamento automatico o selettivo.

gcloud

Utilizza il comando rolling-action start-update e imposta il flag --type su opportunistic o proactive.

gcloud compute instance-groups managed rolling-action start-update INSTANCE_GROUP_NAME \
    --version=template=NEW_TEMPLATE \
    --type=TYPE

Puoi utilizzare anche comando beta update e includi il flag --update-policy-type.

gcloud beta compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=TYPE

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del gruppo
  • NEW_TEMPLATE: il nome del nuovo modello per gruppo
  • TYPE: il tipo di aggiornamento, opportunistic o proactive

REST

Chiama il metodo patch su una risorsa MIG di zona o regionale.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "TYPE" # Choose an opportunistic or proactive update
  },
  "versions": [{
    "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
    }]
}

Sostituisci quanto segue:

  • PROJECT_ID: il progetto in cui esiste il gruppo di istanze gestite.
  • REGION: la regione in cui si trova il gruppo di istanze gestite. Per un gruppo di istanze gestite a livello di zona, sostituisci regions/REGION con zones/ZONE.
  • INSTANCE_GROUP_NAME: il nome del gruppo.
  • NEW_TEMPLATE: il nome del nuovo modello per gruppo.
  • TYPE: il tipo di aggiornamento, OPPORTUNISTIC o PROACTIVE.

Per scoprire di più su come impostare un nuovo modello e applicarlo alle VM nuove ed esistenti in un gruppo di istanze gestite, consulta le seguenti pagine:

Controllare il tipo di criterio di aggiornamento del gruppo

Puoi visualizzare il tipo di criterio di aggiornamento attualmente configurato per il tuo gruppo di istanze gestite ("opportunistico" o "proattivo") e altre aggiornare le impostazioni dei criteri mediante gcloud CLI o REST.

gcloud

Utilizza la Comando describe e includi il flag --format per elencare solo le impostazioni di updatePolicy.

gcloud beta compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(updatePolicy)"

REST

Invia una richiesta GET a un gruppo di istanze gestite a livello di zona o regionale e controlla il campo updatePolicy.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

Per modificare il tipo di criterio, consulta Configurare un aggiornamento proattivo o opportunistico.

Aggiornamenti per le VM sospese e arrestate

Se hai sospeso e arrestato i pool di VM in un gruppo di istanze gestite, puoi aggiornamento (opportunistico) di VM sospese o arrestate come faresti con le altre delle VM in esecuzione. Se configuri gli aggiornamenti automatici (proattivi), il gruppo di istanze gestite aggiorna le VM nel seguente ordine:

  1. VM in esecuzione, sospese e arrestate
  2. VM con stato SUSPENDING o STOPPING

Per un aggiornamento automatico, il gruppo di istanze gestite calcola incremento massimo e numero massimo non disponibili in base al numero target di VM in esecuzione e non considera le VM in il pool in standby.

Se l'aggiornamento automatico richiede la sostituzione delle VM nel gruppo, il gruppo di istanze gestite:

  1. Elimina le VM sospese e arrestate.
  2. Crea nuove VM con il nuovo modello di istanza.
  3. Esegue il processo di inizializzazione.
  4. Sospende o arresta le VM.

Se l'aggiornamento automatico richiede solo l'aggiornamento o il riavvio delle VM in il gruppo, il gruppo di istanze gestite esegue le seguenti operazioni:

  1. Riprende o avvia le VM.
  2. Esegue l'aggiornamento sulle VM quando sono in esecuzione.
  3. Esegue la procedura di inizializzazione.
  4. Sospende o arresta le VM.

Aggiornamenti canary

Se vuoi avviare gli aggiornamenti canary in un gruppo di istanze gestite con VM sospese o arrestate, si applica quanto segue:

  • Nella modalità di criterio di standby manual, il gruppo di istanze gestite aggiorna solo le VM in esecuzione in base al numero o alla percentuale di VM a cui vuoi applicare l'aggiornamento. Le VM sospese e arrestate rimangono nelle versioni precedenti.
  • Nella modalità di criterio di standby scale-out-pool, non puoi avviare un aggiornamento canary nel gruppo di istanze gestite.

Relazione tra i campi versions e instanceTemplate

Se utilizzi REST, ti consigliamo di utilizzare i campi instanceGroupManagers.versions e regionInstanceGroupManagers.versions per configurare i modelli di istanze per i MIG zonali e regionali.

Il campo precedente instanceTemplate si sovrappone per funzionalità al campo versions perché entrambi i campi ti consentono di specificare il modello di istanza utilizzato dal gruppo di istanze gestite per creare le VM. Tuttavia, solo il campo versions consente di specificare una configurazione avanzata con due modelli (canary).

Per la compatibilità con le versioni precedenti, le MIG continuano a supportare l'impostazione del campo instanceTemplate di primo livello, anche se ti consigliamo di passare all'utilizzo solo del campo versions. Utilizzando sia l'architettura di primo livello campo instanceTemplate e versions campo può generare ambiguità e confusione.

Se specifichi sia il campo instanceTemplate sia il campo versions quando chiamai il metodo update() o patch(), sono possibili tre risultati:

  • Imposti entrambi i campi sullo stesso valore.

    Questa è una richiesta valida. In questo caso, non viene creata alcuna ambiguità e il nuovo modello di istanza viene applicato al gruppo di istanze gestite.

    Ad esempio, nella richiesta seguente, i valori instanceTemplate di primo livello e Il campo versions specifica lo stesso modello di istanza, che è diverso dal modello attuale esistente, in modo che il gruppo di istanze gestite venga aggiornato al nuovo modello di istanza:

    {
 "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
 "versions": [
  {
   "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE"
  }
 ],
 "updatePolicy": {
   "type": "PROACTIVE"
 }
}

  • Hai impostato entrambi i campi su valori che non corrispondono, ma solo un valore differisce dal modello di istanza corrente nel MIG.

    Questa è una richiesta valida. Il campo diverso dall'impostazione corrente viene considerato il valore previsto. Ad esempio, chiami il metodo update() e fornisci entrambi i campi, ma ne viene aggiornato uno solo:

    {
 "instanceTemplate": "global/instanceTemplates/CURRENT_TEMPLATE",
 "versions": [
  {
   "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE"
  }
 ],
 "updatePolicy": {
   "type": "PROACTIVE"
 }
}

  • Imposti entrambi i campi su valori che non corrispondono rispetto all'attuale modello di istanza nel gruppo di istanze gestite.

    Questa impostazione non è valida e restituisce un errore perché non esiste un'intenzione chiara.

    {
 "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
 "versions": [
  {
   "instanceTemplate": "global/instanceTemplates/A_DIFFERENT_NEW_TEMPLATE"
  }
 ],
 "updatePolicy": {
   "type": "PROACTIVE"
 }
}

Il campo versions, il campo instanceTemplate e il metodo get()

Se specifichi un solo modello di istanza, tramite il campo instanceTemplate di primo livello o tramite il campo versions o tramite entrambi, il metodo get() restituisce entrambi i campi nella risposta. Questo rende il nuovo Campo versions compatibile con le versioni precedenti. Purché specifichi una singola istanza in uno di questi campi, le modifiche apportate a get() viene restituito nel campo instanceTemplate.

Se per il campo versions sono specificati due modelli di istanza, il metodo get() restituisce un campo instanceTemplate di primo livello vuoto. Non è possibile esprimere in modo inequivocabile una configurazione di modello di canary con due istanze nel campo di primo livello instanceTemplate, pertanto il campo non viene utilizzato durante un aggiornamento del canary.

Il campo versions e il metodo setInstanceTemplate()

Per la compatibilità con le versioni precedenti, il metodo setInstanceTemplate() si comporta come in precedenza, consentendoti di modificare il modello utilizzato dal gruppo di istanze gestite per creare le VM. Quando chiami questo metodo, il campo versions viene sostituito con il modello di istanza specificato dal metodo setInstanceTemplate().

Il metodo setInstanceTemplate() imposta anche updatePolicy su OPPORTUNISTIC. Questo impedisce al gruppo di istanze gestite di eseguire attivamente il deployment di un modello di istanza non specificato esplicitamente nel campo versions.

Passaggi successivi