Visualizza informazioni su MIG e istanze gestite

Utilizza i metodi in questa pagina per visualizzare informazioni sui gruppi di istanze gestite e sulle istanze di macchine virtuali (VM) all'interno di ciascun gruppo.

Prima di iniziare

• Esamina le limitazioni, quindi create un gruppo.
• 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.

  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.

Visualizza le informazioni sui gruppi di istanze gestite

Puoi recuperare informazioni sui gruppi stessi, ad esempio per ispezionare i criteri associati al gruppo e verificare se il gruppo è stabile o sta subendo modifiche. Per informazioni sulle istanze VM all'interno di un gruppo MIG, consulta Visualizzare le informazioni sulle istanze gestite.

Elenca MIG

Per ottenere un elenco dei gruppi di istanze gestite, utilizza la console, l'interfaccia a riga di comando gcloud o REST.

gcloud compute instance-groups managed list

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

Visualizzare le proprietà di un gruppo di istanze gestite

Per visualizzare le informazioni su un gruppo MIG specifico, inclusi i relativi criteri (ad esempio i criteri di riparazione automatica e di aggiornamento del gruppo), utilizza la console, la CLI gcloud o REST.

Per visualizzare il valore id del gruppo, devi utilizzare l'interfaccia a riga di comando gcloud o l'API Compute Engine.

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

Controllare se un gruppo MIG è stabile

Diversi comandi e richieste creano, eliminano e modificano le istanze in un gruppo di istanze gestite. Queste operazioni vengono restituite come DONE dopo che il gruppo ha pianificato azioni per creare, eliminare o aggiornare queste istanze. Tuttavia, questo non significa che le istanze del gruppo siano state create, eliminate o aggiornate fino al completamento di queste azioni sottostanti. Devi verificare lo stato del gruppo oppure lo stato di queste istanze.

Un gruppo di istanze gestite è stabile quando tutte le istanze del gruppo di istanze gestite non subiscono modifiche, non sono pianificate modifiche future per le istanze e il gruppo stesso non viene modificato.

Potresti dover sapere se il gruppo è stabile quando hai dipendenze che si basano sul fatto che tutte le istanze del gruppo siano attive e funzionanti. Ad esempio, potresti voler iniziare a pianificare i job, inviare traffico o assegnare intervalli di chiavi dopo aver ricevuto la conferma che tutte le VM sono in esecuzione e sono integre.

Verifica che tutte le istanze di un gruppo di istanze gestite siano in esecuzione e in stato integro controllando il valore del campo status.isStable del gruppo.

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

status.isStable impostato su false indica che le modifiche sono attive, in attesa o che il MIG stesso è in fase di modifica.

status.isStable impostato su true indica quanto segue:

• Nessuna delle istanze nel gruppo di istanze gestite (MIG) è soggetta a alcun tipo di modifica e il valore currentAction per tutte le istanze è NONE.
• Non sono presenti modifiche in attesa per le istanze nel gruppo di istanze gestite.
• Il MIG stesso non viene modificato.

Ricorda che la stabilità di un gruppo di istanze gestite dipende da numerosi fattori, in quanto un gruppo di istanze gestite può essere modificato in diversi modi. Ad esempio:

• Invii una richiesta di implementazione di un nuovo modello di istanza.
• Invii una richiesta per creare, eliminare, ridimensionare o aggiornare le istanze nel MIG.
• Un gestore della scalabilità automatica richiede di ridimensionare il MIG.
• Una risorsa di riparazione automatica sta sostituendo una o più istanze non attive nel gruppo di istanze gestite.
• In un gruppo di istanze gestite a livello di regione, alcune istanze vengono ridistribuite.

Una volta completate tutte le azioni, status.isStable viene impostato di nuovo su true per quel MIG.

Per le singole istanze VM, consulta Verificare lo stato delle istanze gestite.

Controllare se le riparazioni delle VM sono disattivate in un gruppo di istanze gestite

Per verificare se le riparazioni delle VM sono disattivate in un gruppo di istanze gestite, utilizza la console, la CLI gcloud o la API.

gcloud compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

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

"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "REPAIR"
}

Se non vuoi che un gruppo di istanze gestite ripari una VM non funzionante o non in stato ottimale nel gruppo, puoi disattivare le riparazioni nel gruppo di istanze gestite.

Visualizzare le operazioni di riparazione automatica storiche

Se hai configurato la riparazione automatica, puoi visualizzare gli eventi di riparazione automatica passati.

Monitorare gli aggiornamenti in sequenza

Se hai avviato un aggiornamento in sequenza e vuoi sapere quando è terminato, consulta Monitorare gli aggiornamenti.

Visualizza la configurazione stateful

Se hai configurato un MIG stateful e vuoi rivedere la configurazione, consulta Visualizzazione della configurazione stateful.

Visualizza le informazioni sulle istanze VM gestite all'interno di un gruppo di istanze gestite

Elenca le istanze gestite di un gruppo di istanze gestite

Per ottenere un elenco delle istanze gestite in un gruppo, inclusi i relativi stati e modelli, utilizza la console, gcloud CLI o REST.

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

Controllare lo stato delle istanze gestite

Diversi comandi e richieste creano, eliminano e modificano le istanze in un gruppo di istanze gestite. Queste operazioni vengono restituite come DONE dopo che il gruppo ha pianificato azioni per creare, eliminare o aggiornare queste istanze. Tuttavia, questo non significa che le istanze del gruppo siano state create, eliminate o aggiornate fino al completamento di queste azioni sottostanti. Devi verificare lo stato di queste istanze oppure lo stato del gruppo stesso.

Utilizza Google Cloud CLI o REST per visualizzare i dettagli delle istanze in un gruppo di istanze gestite. I dettagli includono lo stato delle istanze e le azioni correnti svolte dal gruppo sulle sue istanze.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

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

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

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

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Per visualizzare un elenco dei valori validi del campo instanceStatus, consulta Ciclo di vita delle istanze VM.

Se un'istanza è in fase di modifica, il gruppo di istanze gestite imposta il campo currentAction dell'istanza su una delle seguenti azioni per aiutarti a monitorare l'avanzamento della modifica. In caso contrario, il campo currentAction viene impostato su NONE.

I valori possibili di currentAction sono:

• ABANDONING. L'istanza viene rimossa dal gruppo di istanze gestite.
• CREATING. L'istanza è in fase di creazione.
• CREATING_WITHOUT_RETRIES. L'istanza viene creata senza tentativi di ripetizione. Se l'istanza non viene creata al primo tentativo, il gruppo di istanze gestite non tenta di sostituirla di nuovo.
• DELETING. L'istanza è in fase di eliminazione.
• RECREATING. L'istanza verrà sostituita.
• REFRESHING. L'istanza viene rimossa dai pool di destinazione attuali e aggiunta nuovamente all'elenco dei pool di destinazione attuali (questo elenco potrebbe essere uguale o diverso dai pool di destinazione esistenti).
• RESTARTING. L'istanza è in fase di riavvio utilizzando i metodi stop e start.
• RESUMING. L'istanza è in fase di ripristino dopo essere stata sospesa.
• STARTING. L'istanza è in fase di avvio dopo essere stata bloccata.
• STOPPING. L'istanza è in fase di arresto.
• SUSPENDING. L'istanza è in fase di sospensione.
• VERIFYING. L'istanza è stata creata ed è in corso la verifica.
• NONE. Non vengono eseguite azioni sull'istanza.

Per verificare se il gruppo nel suo complesso è stabile o sta subendo modifiche, consulta Controllare lo stato del gruppo.

Controllare gli stati di integrità

Se hai configurato la riparazione automatica per il gruppo di istanze gestite, puoi esaminare lo stato di integrità di ogni VM. Consulta Controllare lo stato di integrità.

Elenca gli errori delle istanze

Se le istanze gestite hanno riscontrato errori, puoi visualizzarli per diagnosticare e mitigare la causa.

Utilizza la console Google Cloud, l'gcloud CLI o REST per elencare gli errori.

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1

INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

L'elenco dei possibili errori include, a titolo esemplificativo:

• Non è possibile creare una nuova istanza a causa di:
  • Mancanza di capacità preassegnata.
  • Mancanza di quota, ad esempio per le CPU in una determinata regione.
  • È stato raggiunto il limite di istanze VM per la rete associata al gruppo.
  • L'immagine disco specificata nel campo properties.disks[].initializeParams.sourceImage del modello di istanza è stata eliminata o le sue autorizzazioni sono cambiate.
  • La carta di credito dell'account di fatturazione associato al progetto ha rifiutato un pagamento.
• Impossibile eliminare un'istanza esistente perché:
  • L'account di servizio utilizzato dal gruppo non dispone dell'autorizzazione compute.instances.delete.
  • Sono state richieste troppe eliminazioni simultanee, superando i limiti di frequenza.
• Non è possibile aggiungere un'istanza a un pool di destinazione perché il pool di destinazione è stato eliminato.

Dopo aver esaminato questi errori, puoi mitigarli. Ad esempio:

• Sposta il carico di lavoro in un'altra zona con capacità preeminente.
• Richiedi un aumento della quota in una determinata regione.
• Aggiungi l'autorizzazione compute.instances.delete all'account di servizio utilizzato dal gruppo.

Se un'azione attivata da un gruppo di istanze gestite non va a buon fine (ad esempio, se un'autoscalabilità rileva un errore durante il tentativo di aumentare le dimensioni del gruppo), il gruppo potrebbe riprovare immediatamente l'azione. Se l'ultimo tentativo di ripetizione immediata non va a buon fine, il MIG registra l'errore e puoi visualizzarlo elencando gli errori dell'istanza. Dopo un determinato tempo di attesa, il gruppo riprova l'azione non riuscita. Se l'errore persiste, potrebbe essere registrato più volte.

Compute Engine conserva gli errori 500 più recenti degli ultimi 8 giorni anche se le istanze sottostanti non esistono più o non è stato possibile crearle.

Verificare se un'istanza VM fa parte di un gruppo di istanze gestite

Per verificare se una VM specifica è membro di un gruppo, puoi utilizzare la console o REST.

In alternativa, per identificare se una VM è o è stata membro di un gruppo di istanze gestite, cerca queste due chiavi di metadati nei metadati dell'istanza:

• instance-template indica il modello da cui è stata creata la VM.
• created-by indica il gruppo di istanze gestite che ha creato la VM.

Anche se abbandoni l'istanza, la VM avrà comunque queste voci di metadati, a meno che non le rimuovi manualmente.

Ad esempio, se esiste una VM denominata random-instance-biy e vuoi sapere se è stata creata da un gruppo di istanze gestite, puoi descrivere l'istanza e cercare le chiavi dei metadati. Ad esempio:

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

Gcloud CLI restituisce una risposta simile alla seguente:

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

Visualizzare lo stato preservato di un'istanza gestita

Se hai configurato un gruppo di istanze gestite stateful e vuoi visualizzare lo stato preservato di ogni istanza gestita, consulta Visualizzazione della configurazione stateful e dello stato preservato.

Passaggi successivi

• Scopri di più sui gruppi di istanze gestite.
• Crea un modello di istanza che puoi utilizzare per creare un gruppo di istanze gestite.