Utilizzare le istanze gestite

Un gruppo di istanze gestite (MIG) crea ciascuna delle sue istanze gestite in base ai componenti di configurazione che utilizzi: modello di istanza, configurazione facoltativa per tutte le istanze e configurazione stateful facoltativa.

Ogni istanza gestita è un'entità di dati che rappresenta lo stato previsto per un'istanza di macchina virtuale (VM) effettiva in un gruppo di istanze gestite.

Leggi questo documento per scoprire come utilizzare in modo affidabile le istanze gestite in un gruppo MIG. Ad esempio, potresti dover aggiungere, rimuovere, aggiornare o visualizzare informazioni su un'istanza specifica.

Per assicurarti che le modifiche alla configurazione non vengano annullate dal MIG, è importante utilizzare i metodi descritti in questo documento. Se lavori al di fuori dei metodi del gruppo per modificare le VM di un gruppo di istanze gestite, il gruppo potrebbe o meno rilevare che queste VM non utilizzano più la configurazione prevista del gruppo e potresti riscontrare risultati imprevisti. Ad esempio, se elimini o aggiorni una VM in un gruppo di istanze gestite utilizzando l'API di istanze anziché l'API Instance Group Manager richiesta, il gruppo di istanze gestite non sarà a conoscenza della tua intenzione e, in qualsiasi momento in futuro, potrebbe tentare automaticamente di ricreare o ripristinare la VM in base alla configurazione del gruppo di istanze gestite.

Prima di iniziare

  • Esamina le limitazioni, quindi crea un gruppo.
  • Se non l'hai ancora 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 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. 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 dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

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

        gcloud init

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

Che cos'è un'istanza gestita?

Un'istanza gestita è un'entità di dati all'interno di un gruppo di istanze gestite che contiene lo stato corrente e lo stato previsto di un'istanza VM effettiva.

Lo stato corrente di un'istanza gestita include i seguenti campi:

  • Stato del ciclo di vita dell'istanza, ad esempio RUNNING, STOPPING.
  • Azione corrente svolta dal gruppo di istanze gestite su un'istanza, ad esempio: RESTARTING, VERIFYING, NONE.
  • Stato di salute dell'istanza, ad esempio HEALTHY, UNHEALTHY.

Lo stato previsto di un'istanza gestita per un'istanza VM effettiva include quanto segue:

  • Versione prevista, ovvero il nome della versione e il modello di istanza da utilizzare per l'istanza.
  • Stato conservato degli elementi (ad esempio dischi o metadati) da conservare.

Come mostrato nella figura 1, per ogni istanza gestita in un gruppo di istanze gestite, il gruppo di istanze gestite mantiene in esecuzione una VM effettiva in base alle specifiche dell'istanza gestita.

In base alla configurazione, il gruppo di istanze gestite genera automaticamente istanze gestite, che corrispondono alle istanze VM effettive gestite per tuo conto da un gruppo di istanze gestite.

Figura 1. Relazione tra le istanze gestite e le VM corrispondenti.

Per visualizzare le specifiche di un'istanza gestita, consulta Visualizzare le informazioni sulle istanze gestite in un'istanza MIG.

Aggiunta di istanze a un gruppo di istanze gestite

Per aggiungere altre istanze a un gruppo MIG, puoi:

Per verificare che le istanze appena aggiunte siano attive e in esecuzione, verifica lo stato del gruppo o verifica lo stato delle istanze gestite.

Ridimensionamento manuale

Se un gruppo di istanze gestite non è già impostato per la scalabilità automatica, puoi impostare manualmente le dimensioni del gruppo per modificare il numero di istanze al suo interno. Vedi Ridimensionare manualmente un gruppo di istanze gestite.

Scalabilità automatica

Puoi configurare i gruppi di istanze gestite in modo da aggiungere o rimuovere automaticamente le istanze in base ai relativi carichi di lavoro. Le tue applicazioni possono gestire agevolmente gli aumenti del traffico e puoi ridurre i costi quando il fabbisogno di risorse di calcolo è inferiore. Per ulteriori informazioni sulla scalabilità automatica del gruppo di istanze gestite, consulta Gruppi di istanze a scalabilità automatica.

Aggiunta di istanze con nomi specifici

Se hai un sistema che dipende da nomi specifici, puoi aggiungere VM con questi nomi a un MIG esistente. I nomi assegnati a queste istanze gestite rimangono invariati se il gruppo di istanze gestite ricrea la VM. Per ulteriori informazioni, consulta la sezione Creare istanze con nomi specifici nei gruppi di istanze gestite.

Per ulteriori informazioni su come preservare lo stato delle istanze MIG, consulta Gruppi di istanze gestite stateful.

Eliminazione di istanze da un gruppo di istanze gestite

Quando elimini le istanze gestite, il gruppo di istanze gestite riduce il targetSize del gruppo ed elimina le istanze VM corrispondente.

Se configuri un gruppo di istanze gestite stateful, il gruppo di istanze gestite elimina le configurazioni dello stato preservato delle istanze. Il gruppo MIG rimuove inoltre le istanze da eventuali pool di destinazione di cui fanno parte.

Se il gruppo fa parte di un servizio di backend che ha attivato lo svuotamento della connessione, possono essere necessari fino a 60 secondi in più dopo la durata dello svuotamento della connessione prima che l'istanza VM venga rimossa o eliminata.

Per eliminare un'istanza gestita, puoi:

Aggiornamento della configurazione delle VM in un gruppo di istanze gestite

Se devi modificare la configurazione delle VM in un gruppo di istanze gestite, ad esempio per modificare il disco di avvio o il tipo di macchina, aggiungere dischi o modificare altre proprietà della VM, consulta Aggiornare la configurazione delle VM in un gruppo di istanze gestite.

Ricreazione di istanze in un gruppo di istanze gestite

Utilizza questo metodo per aggiornare le VM selezionate in modo che utilizzino i componenti di configurazione delle VM più recenti del gruppo. Se devi ricreare tutte le VM in un gruppo di istanze gestite, avvia un aggiornamento progressivo.

Se il gruppo fa parte di un servizio di backend che ha attivato lo svuotamento della connessione, possono essere necessari fino a 60 secondi in più dopo la durata dello svuotamento della connessione prima che l'istanza VM venga rimossa o eliminata.

Ricrea le istanze VM selezionate nel gruppo di istanze gestite utilizzando l'interfaccia a riga di comando gcloud o il protocollo REST.

gcloud

Utilizza il comando instance-groups managed recreate-instances.

gcloud compute instance-groups managed recreate-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

Nell'API, esegui una richiesta POST al metodo regionInstanceGroupManagers.recreateInstances. Per un gruppo di istanze gestite zonale, utilizza il metodo instanceGroupManagers.recreateInstances.

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

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Dopo aver inviato una richiesta per ricreare le istanze VM in un gruppo di istanze gestite, le nuove VM vengono avviate non appena il sistema può eseguirne il provisioning. Questa procedura può richiedere molto tempo a seconda del numero di istanze che ricrei. Verifica lo stato del gruppo o lo stato delle istanze gestite.

L'operazione di ricreazione conserva il nome dell'istanza VM, ma il timestamp della creazione dell'istanza potrebbe non cambiare. Per verificare che l'operazione di ricreazione abbia creato una nuova istanza quando il timestamp di creazione dell'istanza non è cambiato, controlla il timestamp di creazione del disco di avvio collegato all'istanza.

Visualizzazione delle informazioni sulle istanze in un MIG

Consulta Visualizzare le informazioni sulle istanze gestite in un gruppo di istanze gestite.

Configurazione di istanze stateful in un gruppo di istanze gestite (MIG)

Consulta Configurare i gruppi di istanze gestite stateful.

Passaggi successivi