Visualizzare o annullare la creazione collettiva di istanze in un gruppo di istanze gestite

Questo documento descrive come visualizzare lo stato della creazione collettiva di istanze di macchine virtuali (VM) in un gruppo di istanze gestite (MIG). Spiega anche come annullare una creazione collettiva in corso.

Per scoprire come funziona la creazione collettiva di istanze in un MIG, consulta Informazioni sulla creazione collettiva di istanze in un MIG

Visualizzare lo stato della creazione collettiva di istanze

Puoi visualizzare lo stato di un'operazione di creazione collettiva in un MIG. Lo stato ti consente di verificare se la creazione collettiva è ancora in corso e, se le istanze non sono ancora state create, di comprenderne i motivi.

I dettagli del MIG contengono i seguenti campi per aiutarti a monitorare lo stato della creazione collettiva:

  • status.bulkInstanceOperation.inProgress: questo campo indica se è in corso una creazione collettiva di istanze (true) o meno (false).

  • lastProgressCheck: questo campo fornisce dettagli sul motivo per cui le istanze potrebbero non essere ancora state create. I possibili motivi sono i seguenti:

    • Mancanza di capacità: quando il MIG è in attesa che la capacità richiesta diventi disponibile, viene visualizzato il codice di errore ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS.

    • Quota insufficiente: quando la quota non è sufficiente per soddisfare la richiesta, viene visualizzato l'errore QUOTA_EXCEEDED. Per aumentare la quota del tuo progetto, consulta Richiedi un aggiustamento delle quote.

gcloud

Per visualizzare lo stato della creazione collettiva di istanze in un MIG, utilizza il gcloud compute instance-groups managed describe comando.

  • Per un MIG a livello di zona, esegui il seguente comando:

    gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --zone=ZONE

  • Per un MIG a livello di regione, esegui il seguente comando:

    gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --region=REGION

    Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG.

  • ZONE: la zona in cui esiste il gruppo di istanze gestite

  • REGION: la regione in cui esiste il gruppo di istanze gestite

L'esempio seguente mostra una risposta per un MIG in cui è in corso una creazione collettiva e il campo lastProgressCheck indica che la creazione collettiva è in attesa di risorse a causa di un errore ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS e presenta anche un errore QUOTA_EXCEEDED.

{
  "status": {
    "bulkInstanceOperation": {
      "inProgress": true,
      "lastProgressCheck": {
        "timestamp": "2024-01-01T12:00:00.712-08:00",
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  }
}

REST

Per visualizzare lo stato della creazione collettiva di istanze in un MIG, invia una richiesta GET come segue:

  • Per un MIG a livello di zona, utilizza il instanceGroupManagers.get metodo.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME

  • Per un MIG a livello di regione, utilizza il regionInstanceGroupManagers.get metodo.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • ZONE: la zona in cui esiste il gruppo di istanze gestite
  • REGION: la regione in cui esiste il gruppo di istanze gestite
  • INSTANCE_GROUP_NAME: il nome del MIG.

L'esempio seguente mostra una risposta per un MIG in cui è in corso una creazione collettiva e il campo lastProgressCheck indica che la creazione collettiva è in attesa di risorse a causa di un errore ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS e presenta anche un errore QUOTA_EXCEEDED.

{
  "status": {
    "bulkInstanceOperation": {
      "inProgress": true,
      "lastProgressCheck": {
        "timestamp": "2024-01-01T12:00:00.712-08:00",
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "Waiting for resources. Currently there are not enough resources available to fulfill the request."
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  }
}

Visualizzare lo stato delle istanze gestite

Puoi monitorare lo stato delle singole istanze gestite controllando l'azione corrente e lo stato dell'istanza.

  • Mentre l'operazione di istanza collettiva è in corso, le istanze gestite mostrano i seguenti stati:

    • currentAction: CREATING
    • instanceStatus: PENDING

  • Al termine dell'operazione di istanza collettiva, gli stati delle istanze gestite cambiano come segue:

    • currentAction: NONE
    • instanceStatus: RUNNING

Per visualizzare queste informazioni sulle istanze gestite, consulta Controllare lo stato delle istanze gestite.

Annullare l'operazione di creazione collettiva

Per annullare un'operazione di creazione collettiva, ridimensiona il MIG a zero o eliminalo.

Ridimensionare il MIG a zero

Console

  1. Vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Fai clic sul nome del MIG che vuoi ridimensionare.

  3. Fai clic su Modifica.

  4. Fai clic su Dimensioni gruppo e scalabilità automatica per espandere la sezione.

  5. Imposta Numero di istanze su 0.

  6. Fai clic su Salva.

gcloud

Per ridimensionare un MIG a zero, utilizza il gcloud compute instance-groups managed resize comando e imposta il --size flag su 0.

  • Per un MIG a livello di zona, esegui il seguente comando:

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

  • Per un MIG a livello di regione, esegui il seguente comando:

    gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size=0 \
    --region=REGION

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG.
  • ZONE: la zona in cui esiste il gruppo di istanze gestite
  • REGION: la regione in cui esiste il gruppo di istanze gestite

  • REST

    Per ridimensionare un MIG a zero, invia una richiesta PATCH utilizzando uno dei seguenti metodi. Nel corpo della richiesta, imposta targetSize su 0.

    • Per un MIG a livello di zona, utilizza il instanceGroupManagers.patch metodo.

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "targetSize": 0
}

    • Per un MIG a livello di regione, utilizza il regionInstanceGroupManagers.patch metodo.

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

{
  "targetSize": 0
}

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto
    • ZONE: la zona in cui esiste il gruppo di istanze gestite
    • REGION: la regione in cui esiste il gruppo di istanze gestite
    • INSTANCE_GROUP_NAME: il nome del MIG.

Eliminare un MIG

Console

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

    Vai a Gruppi di istanze

  2. Seleziona la casella di controllo del MIG che vuoi eliminare.

  3. Fai clic su Elimina per eliminare il MIG e tutte le istanze al suo interno.

gcloud

Per eliminare un MIG, utilizza il delete comando.

  • Per un MIG a livello di zona, esegui il seguente comando:

    gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \
    --zone ZONE

  • Per un MIG a livello di regione, esegui il seguente comando:

    gcloud compute instance-groups managed delete INSTANCE_GROUP_NAME \
    --region REGION

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG.
  • ZONE: la zona in cui esiste il gruppo di istanze gestite
  • REGION: la regione in cui esiste il gruppo di istanze gestite

REST

Per eliminare un MIG, invia una richiesta PATCH utilizzando uno dei seguenti metodi:

  • Per un MIG a livello di zona, utilizza il instanceGroupManagers.delete metodo.

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME

  • Per un MIG a livello di regione, utilizza il regionInstanceGroupManagers.delete metodo

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • ZONE: la zona in cui esiste il gruppo di istanze gestite
  • REGION: la regione in cui esiste il gruppo di istanze gestite
  • INSTANCE_GROUP_NAME: il nome del MIG.

Passaggi successivi