Modifica o rimuovi la flessibilità dell'istanza

Questo documento descrive come apportare modifiche o rimuovere la flessibilità delle istanze in un gruppo di istanze gestite (MIG) modificando il criterio di flessibilità delle istanze. Descrive inoltre come aggiornare il tipo di macchina di una VM quando viene rimosso dalla configurazione della flessibilità dell'istanza.

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 ai Google Cloud servizi e alle API. 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. After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      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.

          After installing the Google Cloud CLI, initialize it by running the following command: 

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Modifica la configurazione della flessibilità dell'istanza

Puoi apportare le seguenti modifiche modificando la configurazione della flessibilità dell'istanza in un MIG:

  • Aggiungi un tipo di macchina a una selezione di istanze
  • Rimuovi un tipo di macchina da una selezione di istanze
  • Modificare i ranking delle selezioni dell'istanza
  • Aggiungere una selezione dell'istanza

Il MIG applica le modifiche in base ai nomi di selezione delle istanze che specifichi. Le selezioni delle istanze che non specifichi rimangono invariate. Quando apporti modifiche a una selezione di istanze, devi specificarne la configurazione completa durante la modifica. Se non specifichi la configurazione completa, il MIG sovrascriverà le parti non specificate della selezione delle istanze. Ad esempio, se vuoi modificare solo un grado, specifica il nuovo grado insieme ai tipi di macchina impostati in quella selezione. Per visualizzare la configurazione esistente, consulta Visualizza la flessibilità dell'istanza.

Dopo aver rimosso un tipo di macchina dalla configurazione, le VM esistenti con i tipi di macchina rimossi continuano a utilizzarli. Se vuoi modificare i tipi di macchina di queste VM, devi aggiornare o ricreare le VM specifiche. Per saperne di più, consulta Aggiorna il tipo di macchina di una VM per utilizzare la configurazione più recente.

Per modificare la configurazione della flessibilità dell'istanza in un MIG, seleziona una delle seguenti opzioni:

Console

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

    Vai a Gruppi di istanze

  2. Fai clic sul nome del MIG in cui vuoi modificare la flessibilità dell'istanza.

  3. Fai clic su Modifica.

  4. Nella sezione Selezioni istanza, fai clic su Modifica selezioni istanza.

  5. Nella finestra Selezioni istanza, fai clic sull'icona Attiva/Disattiva di una selezione istanza per aprire la visualizzazione Modifica selezione istanza.

    Quando modifichi una selezione di istanze, puoi apportare le seguenti modifiche:

    • Modifica il nome e il ranking della selezione istanza. Per farlo, modifica i valori nei campi Nome e Ranking.
    • Aggiungi un nuovo tipo di macchina alla selezione. Per farlo, fai clic su Aggiungi tipo di macchina.
    • Rimuovi i tipi di macchine. Per farlo, seleziona i tipi di macchina e poi fai clic su Rimuovi.

  6. Modifica la selezione in base alle esigenze e fai clic su Fine.

  7. Dopo aver completato le modifiche nella finestra Selezioni istanza, fai clic su Fine.

  8. Fai clic su Salva per applicare le modifiche.

gcloud

Per modificare una configurazione della flessibilità dell'istanza, utilizza il comando instance-groups managed update.

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --instance-selection "name=INSTANCE_SELECTION_1,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2,rank=RANK_1" \
      --instance-selection "name=INSTANCE_SELECTION_2,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4,rank=RANK_2"

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG in cui vuoi controllare la configurazione della flessibilità dell'istanza.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_SELECTION: il nome della selezione di istanze in cui vuoi apportare le modifiche. Devi specificare sia MACHINE_TYPE che RANK. Se non modifichi nessuno di questi valori, devi fornire quelli esistenti per mantenerli.

REST

Per modificare una configurazione di flessibilità dell'istanza, invia una richiesta PATCH al metodo regionInstanceGroupManagers.patch.

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

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION": {
          "machineTypes": [
            "MACHINE_TYPE_1",
            "MACHINE_TYPE_2"
          ],
          "rank": RANK
        }
      }
    }
  }

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_GROUP_NAME: il nome del MIG in cui vuoi controllare la configurazione della flessibilità dell'istanza.
  • INSTANCE_SELECTION: il nome della selezione di istanze in cui vuoi apportare le modifiche. Devi specificare sia MACHINE_TYPE che RANK. Se non modifichi nessuno di questi valori, devi fornire quelli esistenti per mantenerli.

Rimuovi la configurazione della flessibilità dell'istanza

Puoi rimuovere tutte le selezioni di istanze o solo quelle specifiche in un gruppo MIG.

  • Per rimuovere tutte le selezioni di istanze in un gruppo di istanze gestite, consulta Rimuovere tutte le selezioni di istanze. Quando rimuovi tutte le selezioni di istanze, il MIG utilizza il tipo di macchina specificato nel modello di istanza per creare nuove VM nel gruppo.

  • Per rimuovere le singole selezioni di istanze per nome, vedi Rimuovere selezioni di istanze specifiche. In questo modo vengono rimosse solo le selezioni di istanze specifiche e il gruppo MIG mantiene le altre.

Dopo aver rimosso le selezioni di istanze, le VM esistenti che utilizzano i tipi di macchina delle selezioni di istanze rimosse continuano a utilizzare lo stesso tipo di macchina. Affinché le modifiche vengano applicate, devi aggiornare o ricreare queste VM. Per saperne di più, consulta Aggiorna il tipo di macchina di una VM per utilizzare la configurazione più recente.

Rimuovi tutte le selezioni di istanze

Per rimuovere tutte le selezioni delle istanze, seleziona una delle seguenti opzioni:

Console

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

    Vai a Gruppi di istanze

  2. Fai clic sul nome del MIG in cui vuoi modificare la flessibilità dell'istanza.

  3. Fai clic su Modifica.

  4. Nella sezione Selezioni istanza, fai clic su Modifica selezioni istanza.

  5. Nella finestra Selezioni istanza, fai clic sull'icona Elimina accanto a ogni selezione istanza.

  6. Fai clic su Fine.

  7. Fai clic su Salva.

gcloud

Per rimuovere tutte le selezioni di istanze in un MIG, utilizza il comando instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections-all

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG da cui vuoi rimuovere tutte le selezioni delle istanze.
  • REGION: la regione in cui si trova il MIG.

REST

Per rimuovere tutte le selezioni di istanze in un MIG, invia una richiesta PATCH al metodo regionInstanceGroupManagers.patch.

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

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": null
    }
  }

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_GROUP_NAME: il nome del MIG da cui vuoi rimuovere una selezione di istanze.

Rimuovere selezioni di istanze specifiche

Per rimuovere selezioni di istanze specifiche, seleziona una delle seguenti opzioni:

Console

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

    Vai a Gruppi di istanze

  2. Fai clic sul nome del MIG in cui vuoi modificare la flessibilità dell'istanza.

  3. Fai clic su Modifica.

  4. Nella sezione Selezioni istanza, fai clic su Modifica selezioni istanza.

  5. Nella finestra Selezioni istanza, fai clic sull'icona Elimina accanto alla selezione istanza che vuoi rimuovere.

  6. Fai clic su Fine.

  7. Fai clic su Salva.

gcloud

Per rimuovere selezioni di istanze specifiche in un MIG, utilizza il comando instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections INSTANCE_SELECTION

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG da cui vuoi rimuovere una selezione di istanze.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_SELECTION: il nome della selezione dell'istanza che vuoi rimuovere. Se sono presenti più selezioni di istanze, fornisci un elenco dei nomi separati da virgole.

REST

Per rimuovere selezioni di istanze specifiche in un MIG, utilizza il metodo regionInstanceGroupManagers.patch.

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

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION": null
      }
    }
  }

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_GROUP_NAME: il nome del MIG da cui vuoi rimuovere una selezione di istanze.
  • INSTANCE_SELECTION: il nome della selezione dell'istanza che vuoi rimuovere. Se sono presenti più selezioni di istanze, specificarle tutte. Ad esempio, "selection-1": null,"selection-2": null.

Aggiorna il tipo di macchina di una VM per utilizzare la configurazione più recente

Se una VM in un MIG utilizza un tipo di macchina rimosso dalla configurazione di flessibilità dell'istanza, devi aggiornare o ricreare la VM per aggiornare il relativo tipo di macchina.

Per aggiornare o ricreare una VM, utilizza una delle seguenti opzioni:

  • Aggiorna le VM utilizzando il metodo regionInstanceGroupManagers.applyUpdatesToInstances. Quando utilizzi il metodo applyUpdatesToInstances, il campo mostDisruptiveAllowedAction deve essere RESTART O REPLACE.

  • Ricrea le VM utilizzando il metodo regionInstanceGroupManagers.recreateInstances.

  • Ricrea le VM eliminandole prima e poi ridimensionando il MIG in modo che contenga il numero di VM richiesto.

Passaggi successivi