Modifica o rimuovi la flessibilità delle istanze

Questo documento descrive come apportare modifiche o rimuovere la flessibilità delle istanze in un gruppo di istanze gestite (MIG) modificando la policy di flessibilità delle istanze. Inoltre, descrive come aggiornare il tipo di macchina di una VM quando questo viene rimosso dalla configurazione della flessibilità delle istanze.

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 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. After installation, initialize the Google Cloud CLI 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.

    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. After installation, initialize the Google Cloud CLI 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 Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Modifica la configurazione della flessibilità delle istanze

Puoi apportare le seguenti modifiche modificando la configurazione della flessibilità delle istanze in un MIG:

  • Aggiungere un tipo di macchina a una selezione di istanze
  • Rimuovere un tipo di macchina da una selezione di istanze
  • Modificare il ranking delle selezioni di istanze
  • Aggiungere una selezione di istanze

Il MIG applica le modifiche in base ai nomi della selezione di istanze specificata. Le eventuali selezioni di istanze non specificate 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 di istanze. Ad esempio, se vuoi modificare solo un ranking, specifica il nuovo ranking insieme ai tipi di macchine impostati in quella selezione. Per visualizzare la configurazione esistente, consulta Visualizza la flessibilità delle istanze.

Dopo aver rimosso un tipo di macchina dalla configurazione, le VM esistenti con i tipi di macchine rimossi continuano a utilizzarli. Se vuoi modificare i tipi di macchine 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à delle istanze 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à delle istanze.

  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 di attivazione/disattivazione di una selezione di istanze per aprire la visualizzazione Modifica selezioni istanza.

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

    • Modifica il nome e il ranking della selezione di istanze. A tale scopo, 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 macchine e poi fai clic su Rimuovi.

  6. Modifica la selezione secondo necessità e fai clic su Fine.

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

  8. Fai clic su Salva per applicare le modifiche.

gcloud

Per modificare una configurazione di flessibilità delle istanze, 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à delle istanze.
  • 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 vuoi modificare questi valori, devi fornire i valori esistenti per conservarli.

REST

Per modificare una configurazione di flessibilità delle istanze, 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à delle istanze.
  • INSTANCE_SELECTION: il nome della selezione di istanze in cui vuoi apportare le modifiche. Devi specificare sia MACHINE_TYPE che RANK. Se non vuoi modificare questi valori, devi fornire i valori esistenti per conservarli.

Rimuovi la configurazione della flessibilità delle istanze

Puoi rimuovere tutte o alcune delle selezioni di istanze in un MIG.

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

  • Per rimuovere le singole selezioni di istanze per nome, consulta Rimuovi selezioni di istanze specifiche. In questo modo vengono rimosse solo le selezioni di istanze specifiche, mentre il MIG conserva le altre.

Dopo aver rimosso le selezioni di istanze, le VM esistenti che utilizzano i tipi di macchine 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 di 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à delle istanze.

  3. Fai clic su Modifica.

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

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

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

Rimuovi 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à delle istanze.

  3. Fai clic su Modifica.

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

  5. Nella finestra Selezioni di istanze, fai clic sull'icona Elimina accanto alla selezione di istanze da 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 di istanze che vuoi rimuovere. Se sono presenti più selezioni di istanze, fornisci un elenco di nomi separato 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 di istanze che vuoi rimuovere. Se sono presenti più selezioni di istanze, specificale tutte. Ad esempio, "selection-1": null,"selection-2": null.

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

Se le VM in un MIG utilizzano un tipo di macchina rimosso dalla configurazione della flessibilità delle istanze, devi aggiornare o ricreare la VM per aggiornarne il 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 OPPURE REPLACE.

  • Ricrea le VM utilizzando il metodo regionInstanceGroupManagers.recreateInstances.

  • Ricrea le VM eliminandole e poi ridimensionando il MIG in base al numero di VM richiesto.

Passaggi successivi