Aggiungere e rimuovere VM da un gruppo di istanze gestite

Dopo aver creato un gruppo di istanze gestite (MIG), potresti voler aggiungere o rimuovere VM dal gruppo per soddisfare le esigenze del tuo carico di lavoro. Se hai raggiunto il limite predefinito per il numero massimo di VM che puoi aggiungere a un gruppo di istanze gestite e hai bisogno di altre VM, puoi aumentare il limite di dimensioni del gruppo di istanze gestite.

Per aggiungere o rimuovere VM in un gruppo di istanze gestite, puoi:

• Aggiungi o rimuovi automaticamente le VM impostando la dimensione target del gruppo di istanze gestite:
  • Utilizzare la scalabilità automatica per le applicazioni stateless
  • Impostare manualmente le dimensioni del gruppo di istanze gestite
• Aggiungi, rimuovi o abbandona manualmente istanze specifiche:
  • Creare istanze con nomi specifici
  • Eliminare istanze specifiche
  • Abbandonare istanze specifiche

Prima di iniziare

• 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.

  Terraform

  Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command:

     gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account:

     gcloud auth application-default login

     You don't need to do this if you're using Cloud Shell.

  Per ulteriori informazioni, consulta Set up authentication for a local development environment.

  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.

Imposta la dimensione target del gruppo

Puoi impostare automaticamente le dimensioni target di un gruppo di istanze gestite utilizzando un gestore della scalabilità automatica o impostarle manualmente.

Aggiunta e rimozione automatiche di VM in un gruppo di istanze gestite

Puoi configurare i gruppi di istanze gestite in modo da aggiungere o rimuovere automaticamente le VM 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 iniziare a eseguire la scalabilità dei gruppi di istanze gestite, consulta Creare un gruppo di istanze gestite con la scalabilità automatica.

Per ulteriori informazioni, consulta Gruppi di istanze a scalabilità automatica.

Impostazione manuale delle dimensioni di un gruppo di istanze gestite

Se per un gruppo di istanze gestite non è già impostata la scalabilità automatica, puoi ridimensionare il gruppo manualmente per modificare il numero di istanze. Se aumenti la dimensione, il gruppo di istanze gestite utilizza il modello di istanza corrente per aggiungere nuove istanze. Se diminuisci le dimensioni, il gruppo di istanze gestite elimina le VM dal gruppo. Il gruppo elimina le istanze con un valore currentAction di DELETING, CREATING e RECREATING prima di eliminare le istanze in esecuzione senza azioni pianificate.

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.

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

Dopo aver inviato una richiesta di ridimensionamento di un gruppo di istanze gestite, le VM vengono avviate o arrestate non appena il sistema può eseguirne il provisioning o l'eliminazione. Questa procedura può richiedere molto tempo, a seconda del numero di istanze nel gruppo. Verifica lo stato delle istanze nel gruppo di istanze gestite.

Disattivazione della modalità di ripetizione dei tentativi di creazione durante il ridimensionamento

Per impostazione predefinita, se la creazione iniziale di un'istanza VM non va a buon fine, il gruppo di istanze gestite tenta continuamente di creare la VM finché non ci riesce. Tuttavia, se non vuoi i tentativi di creazione automatica, puoi disattivare la modalità di ripetizione dei tentativi di creazione quando modifichi le dimensioni del gruppo di istanze. In questa modalità, il gruppo di istanze gestite tenta di creare tutte le istanze solo una volta. Se si verifica un errore durante la creazione dell'istanza, il gruppo di istanze gestite rinuncia a questa istanza, la rimuove dall'elenco di istanze gestite del gruppo e riduce la dimensione target del gruppo di istanze gestite.

Questa modalità si applica solo durante il primo tentativo di creazione di una VM. Se una VM viene creata correttamente quando questa modalità è attivata, si comporta come tutte le altre VM create con una normale richiesta di ridimensionamento. In particolare, se una VM in esecuzione si arresta in modo imprevisto in un secondo momento e deve essere ricreata, questa modalità non influisce sul comportamento di ricreazione in quello scenario.

La disattivazione della modalità di ripetizione della creazione è particolarmente utile in scenari in cui hai sistemi che creano automaticamente gruppi di VM in cui non è richiesto un numero esatto di VM. Potresti preferire stabilizzarti rapidamente sulle dimensioni del gruppo di istanze gestite ed essere flessibile nel numero di VM nel gruppo, anziché attendere indefinitamente fino a quando non vengono create tutte le istanze richieste, il che potrebbe essere ritardato temporaneamente o definitivamente a causa di errori di quota o altri problemi non correlati.

Limitazioni

• Non puoi disattivare i tentativi di creazione per un gruppo di istanze gestite a livello di regione con una forma di distribuzione di destinazione EVEN.
• Per i MIG regionali con una forma di distribuzione di destinazione BALANCED o ANY_SINGLE_ZONE, devi disattivare la ridistribuzione proattiva delle istanze prima di poter disattivare la modalità di ripetizione dei tentativi di creazione.
• Non puoi disattivare i tentativi di creazione per i gruppi di istanze gestite con scalabilità automatica.

Per ridimensionare un gruppo di istanze gestite quando la modalità di ripetizione dei tentativi di creazione è disattivata, utilizza Google Cloud CLI o REST.

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

Aggiungere, rimuovere o abbandonare istanze specifiche

Creazione di istanze con nomi specifici nei MIG

Se hai un sistema che dipende da nomi specifici, puoi aggiungere VM con nomi specifici a un MIG esistente.

I nomi assegnati a queste istanze gestite rimangono invariati se il gruppo di istanze gestite riesegue la VM. Per ulteriori informazioni su come preservare lo stato delle istanze MIG, consulta gruppi di istanze gestite stateful.

Limitazioni

Se crei istanze con nomi specifici:

• Devi disattivare la scalabilità automatica durante la procedura di creazione dell'istanza.
• Devi impostare il criterio di aggiornamento del MIG su opportunistico.
• Se stai aggiornando un gruppo di istanze gestite a livello di regione:
  • Devi disattivare la ridistribuzione proattiva delle istanze.
  • Non puoi selezionare la zona in cui creare la VM.
• Non puoi utilizzare nomi di istanze VM duplicati all'interno di un progetto.

Puoi utilizzare l'interfaccia a riga di comando gcloud o REST per aggiungere VM con nomi specifici a un gruppo di istanze gestite esistente.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Eliminazione di istanze specifiche da un gruppo

Puoi eliminare singole istanze VM in un gruppo di istanze gestite. L'eliminazione delle istanze riduce il valore targetSize specificato del gruppo di istanze e rimuove le VM da eventuali pool di destinazione di cui fanno parte.

L'eliminazione di istanze specifiche da un gruppo di istanze gestite non modifica le impostazioni del gestore della scalabilità automatica specificate. Se elimini istanze da un gruppo di istanze gestite, il gestore della scalabilità automatica potrebbe rilevare un aumento del carico di lavoro sulle altre istanze del gruppo e aumentare nuovamente le dimensioni del gruppo al livello precedente. Per evitare che ciò accada, interrompi lo scalare prima di tentare di eliminare le istanze.

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.

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

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

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

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

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

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

Dopo aver inviato una richiesta di eliminazione delle istanze in un gruppo di istanze gestite, le istanze vengono arrestate non appena il sistema può eliminarle. Questa operazione può richiedere molto tempo a seconda del numero di istanze che elimini dal gruppo. Verifica lo stato del gruppo o lo stato delle istanze gestite.

Abbandono di istanze da un gruppo di istanze gestite

Puoi separare un'istanza VM da un gruppo di istanze gestite per risolvere più facilmente i problemi relativi alle singole istanze senza influire sul gruppo nel suo complesso. L'abbandono di un'istanza da un gruppo comporta anche la rimozione dell'istanza dai bilanciatori del carico assegnati al gruppo di istanze gestite. I pool di destinazione assegnati manualmente a singole istanze specifiche non vengono rimossi.

Non puoi aggiungere di nuovo un'istanza VM abbandonata al gruppo. L'abbandono delle istanze riduce il valore targetSize specificato del gruppo di istanze, ma non modifica le impostazioni del gestore della scalabilità automatica specificate. I gruppi di istanze gestite con un gestore della scalabilità automatica continuano ad aggiungere o rimuovere automaticamente le istanze in base alle necessità. Per un gruppo di istanze gestite a livello di area geografica con la scalabilità automatica impostata sulla modalità ONLY_SCALE_OUT, se abbandoni un'istanza VM per ridurre le dimensioni target del gruppo di istanze gestite alle dimensioni consigliate dal gestore della scalabilità automatica, il gestore della scalabilità automatica potrebbe creare una nuova istanza VM nella stessa zona della VM abbandonata. In questi casi, per evitare la creazione di una nuova istanza VM, prova ad abbandonare l'istanza VM da un'altra zona.

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.

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

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

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

Dopo aver inviato una richiesta di abbandono delle istanze da un gruppo di istanze gestite, il gruppo rimuove le istanze il prima possibile. Verifica lo stato del gruppo o lo stato delle istanze gestite.

Aumentare il limite di dimensioni del gruppo

Per impostazione predefinita, il limite di dimensioni per un gruppo di istanze gestite a livello di zona è 1000 VM e il limite di dimensioni per un gruppo di istanze gestite a livello di regione è 2000 VM. Puoi aumentare ulteriormente questi limiti fino a 2000 VM per un gruppo di istanze gestite di zona e 4000 VM per un gruppo di istanze gestite a livello di regione.

Per aumentare i limiti, imposta il campo listManagedInstancesResults del gruppo su PAGINATED. Se hai ancora bisogno di altre VM nel gruppo, crea più gruppi di istanze gestite o contatta l'assistenza.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/region/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

Se vuoi tornare ai risultati dell'elenco senza pagine, devi anche ripristinare il limite di dimensione predefinito del gruppo. Per tornare indietro, assicurati innanzitutto che il gruppo non superi il limite di dimensioni predefinito, quindi imposta il campo listManagedInstancesResults su PAGELESS.

Passaggi successivi

• Scopri come utilizzare le istanze gestite, ad esempio per eliminarle, abbandonarle e ricrearle.
• Visualizza le informazioni su gruppi di istanze gestite e istanze gestite.
• Risolvi i problemi relativi ai gruppi di istanze gestite.