Aggiungi e rimuovi VM da un MIG

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

Per aggiungere o rimuovere VM in un MIG, puoi:

• Aggiungere o rimuovere automaticamente le VM impostando le dimensioni di destinazione del MIG:
  • Utilizza la scalabilità automatica per le applicazioni stateless
  • Imposta manualmente le dimensioni del MIG
• Aggiungere, rimuovere o abbandonare manualmente istanze specifiche:
  • Crea istanze con nomi specifici
  • Elimina istanze specifiche
  • Abbandona istanze specifiche

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity. After signing in, initialize the Google Cloud CLI 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 leCredenziali predefinite dell'applicazionee con le tue credenziali utente.

  1. Install the Google Cloud CLI.

  2. Configure the gcloud CLI to use your federated identity.

     For more information, see Sign in to the gcloud CLI with your federated identity.

  3. Create local authentication credentials for your user account:

     gcloud auth application-default login

     If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

  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.

  Install the Google Cloud CLI, and then sign in to the gcloud CLI with your federated identity.

  Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .

Imposta le dimensioni di destinazione del gruppo

Puoi impostare automaticamente le dimensioni di destinazione di un MIG utilizzando un gestore della scalabilità automatica o puoi impostarle manualmente.

Aggiunta e rimozione automatiche di VM in un MIG

Puoi configurare i gruppi di istanze gestite in modo da aggiungere o rimuovere automaticamente le VM in base ai relativi workload. 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 scalare i gruppi di istanze gestite, consulta Crea un MIG con la scalabilità automatica.

Per ulteriori informazioni, consulta Scalabilità automatica dei gruppi di istanze.

Impostazione manuale delle dimensioni di un MIG

Se la scalabilità automatica non è già stata impostata per un gruppo di istanze gestite, puoi ridimensionare il gruppo manualmente per modificare il numero di istanze. Se aumenti le dimensioni, il gruppo di istanze gestite utilizza il template di istanza corrente per aggiungere nuove istanze. Se diminuisci le dimensioni, il gruppo di istanze gestite elimina 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ù dal termine 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 effettuato 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 della 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 ripetutamente di creare la VM finché non ci riesce. Tuttavia, se non vuoi i tentativi automatici di creazione, puoi disattivare la modalità di ripetizione della creazione quando ridimensioni il 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 le dimensioni di destinazione 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 ripetizione della creazione 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 quando 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 per un tempo indeterminato 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 ripetuti di creazione per un MIG a livello di regione con una forma di distribuzione target EVEN.
• Per i MIG a livello di regione con una forma di distribuzione target BALANCED o ANY_SINGLE_ZONE, devi disattivare la ridistribuzione proattiva delle istanze prima di poter disattivare la modalità di ripetizione della creazione.
• Non puoi disattivare i tentativi ripetuti di creazione per i MIG con scalabilità automatica.

Per ridimensionare un gruppo di istanze gestite quando la modalità di ripetizione della 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
}

Aggiungi, rimuovi o abbandona istanze specifiche

Creazione di istanze con nomi specifici nei MIG

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

I nomi assegnati alle istanze gestite rimangono invariati se il MIG ricrea la VM. Per ulteriori informazioni su come conservare lo stato delle istanze dei MIG, consulta MIG stateful.

Limitazioni

Se crei istanze con nomi specifici:

• Devi disattivare la scalabilità automatica durante il processo di creazione dell'istanza.
• Devi impostare la policy di aggiornamento del MIG su opportunistico.
• Se stai aggiornando un MIG 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 gcloud CLI o REST per aggiungere VM con nomi specifici a un MIG 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 target 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 workload sulle altre istanze del gruppo e aumentare nuovamente le dimensioni del gruppo al livello precedente. Per evitare che ciò accada, arresta il gestore della scalabilità automatica 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ù dal termine 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 effettuato 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 verifica lo stato delle istanze gestite.

Abbandono di istanze da un MIG

Puoi separare un'istanza VM da un gruppo di istanze gestite per eseguire più facilmente il debug di 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 target 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 MIG a livello di regione con la scalabilità automatica impostata sulla modalità ONLY_SCALE_OUT, se abbandoni un'istanza VM per ridurre le dimensioni di destinazione del MIG 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ù dal termine 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 verifica lo stato delle istanze gestite.

Aumenta il limite di dimensioni del gruppo

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

Per aumentare i limiti, imposta il campo listManagedInstancesResults del gruppo su PAGINATED. Se hai bisogno di altre VM nel gruppo, crea più MIG 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 dimensioni 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 eliminare, abbandonare e ricreare istanze gestite.
• Visualizza le informazioni su gruppi di istanze gestite e istanze gestite.
• Risolvi i problemi relativi ai gruppi di istanze gestite.