Visualizza le informazioni su MIG e istanze gestite

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

Prima di iniziare

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

  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 .

Visualizza le informazioni relative ai MIG

Puoi recuperare le informazioni sui gruppi stessi, ad esempio per ispezionare le policy associate al gruppo e verificare se il gruppo è stabile o è in fase di modifica. Per le informazioni sulle istanze VM all'interno di un MIG, vedi Visualizza le informazioni sulle istanze gestite.

Elenca i MIG

Per vedere un elenco dei tuoi gruppi di istanze gestite, puoi utilizzare la console, gcloud CLI 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

Visualizza le proprietà di un MIG

Per visualizzare le informazioni su un MIG specifico, incluse le relative policy (ad esempio le policy di riparazione automatica e di aggiornamento del gruppo), usa la console, gcloud CLI o REST.

Per visualizzare il valore id del gruppo, è necessario usare gcloud CLI 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

Controlla se un MIG è stabile

Numerosi comandi e richieste possono creare, eliminare e modificare le istanze di un gruppo di istanze gestite. Queste operazioni vengono restituite come DONE dopo che il gruppo ha pianificato le azioni per creare, eliminare o aggiornare le istanze. Tuttavia, le istanze del gruppo non sono di fatto create, eliminate o aggiornate, fin quando non sono state completate le relative azioni sottostanti. È necessario verificare lo stato del gruppo oppure verificare lo stato delle istanze interessate.

Un gruppo di istanze gestite è stabile quando nessuna delle istanze del gruppo è in fase di modifica, non sono state pianificate modifiche future delle istanze e il gruppo stesso non è in fase di modifica.

Sapere se il gruppo è stabile può essere necessario se hai dipendenze che si basano sull'integrità e il funzionamento di tutte le istanze del gruppo. Ad esempio, dopo aver ricevuto la conferma che tutte le VM sono in esecuzione e sono integre, potresti iniziare a programmare job, inviare traffico o assegnare intervalli di chiavi

Per verificare che tutte le istanze di un gruppo di istanze gestite siano in esecuzione e integre, controlla 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 le seguenti condizioni:

• Nessuna delle istanze del MIG è in fase di modifica di alcun tipo e il valore currentAction di tutte le istanze è NONE.
• Non sono previste modifiche imminenti per le istanze del MIG.
• Il MIG stesso non è in fase di modifica.

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

• Invio di una richiesta di implementazione di un nuovo template di istanza
• Invio di una richiesta di creazione, eliminazione, ridimensionamento o aggiornamento delle istanze nel MIG
• Richiesta di ridimensionamento del MIG da parte di un gestore della scalabilità automatica
• È in corso la sostituzione di una o più istanze non integre nel MIG da parte di una risorsa di riparazione automatica
• È in corso la redistribuzione di alcune istanze di un MIG a livello di regione

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

Per le singole istanze VM, vedi Controlla lo stato delle istanze gestite.

Controlla se le riparazioni delle VM di un MIG sono disattivate

Per verificare se le riparazioni delle VM di un MIG sono disattivate, puoi usare la console, gcloud CLI o l'API.

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

  instanceLifecyclePolicy:
    defaultActionOnFailure: DO_NOTHING
    forceUpdateOnRepair: NO
    onFailedHealthCheck: DEFAULT_ACTION

GET https://compute.googleapis.com/compute/beta/projects/project_ID/zones/zone/instanceGroupManagers/instance_group

...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "DO_NOTHING",
  "onFailedHealthCheck": "DEFAULT_ACTION"
}
...

Se le riparazioni sono disattivate e vuoi riattivarle, vedi Attiva le riparazioni o la riparazione automatica.

Visualizza la cronologia delle operazioni di riparazione automatica

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

Monitora gli aggiornamenti in sequenza

Se hai avviato un aggiornamento in sequenza e vuoi sapere quando è arrivato al termine, vedi Monitora gli aggiornamenti.

Visualizza la configurazione stateful

Se hai eseguito la configurazione di MIG stateful e vuoi riesaminarla, vedi Visualizza la configurazione stateful.

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

Elenca le istanze gestite di un MIG

Per visualizzare un elenco delle istanze gestite in un gruppo, inclusi i relativi stati e modelli, puoi usare 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

Controlla lo stato delle istanze gestite

Numerosi comandi e richieste possono creare, eliminare e modificare le istanze di un gruppo di istanze gestite. Queste operazioni vengono restituite come DONE dopo che il gruppo ha pianificato le azioni per creare, eliminare o aggiornare le istanze. Tuttavia, le istanze del gruppo non sono di fatto create, eliminate o aggiornate, fin quando non sono state completate le relative azioni sottostanti. È necessario verificare lo stato delle istanze o, in alternativa, verificare lo stato del gruppo stesso.

Utilizza Google Cloud CLI o REST per visualizzare i dettagli relativi alle istanze di un gruppo di istanze gestite. I dettagli comprendono lo stato delle istanze e le azioni che il gruppo sta eseguendo sulle proprie 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, vedi Ciclo di vita di un'istanza 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 agevolare il monitoraggio dello stato di avanzamento della modifica. Altrimenti il campo currentAction è impostato su NONE.

I valori currentAction possibili sono:

• ABANDONING. L'istanza è in fase di rimozione dal MIG.
• CREATING. L'istanza è in fase di creazione.
• CREATING_WITHOUT_RETRIES. L'istanza è in fase di creazione senza tentativi di ripetizione. Se l'istanza non viene creata al primo tentativo, il MIG non tenta nuovamente di sostituirla.
• DELETING. L'istanza è in fase di eliminazione.
• RECREATING. L'istanza è in fase di sostituzione.
• REFRESHING. L'istanza viene rimossa dai propri pool di destinazione correnti e aggiunta nuovamente all'elenco dei pool di destinazione correnti (l'elenco potrebbe essere uguale o diverso rispetto ai pool di destinazione esistenti).
• RESTARTING. L'istanza è in fase di riavvio per mezzo dei 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 arrestata.
• 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. Sull'istanza non risulta alcuna azione in fase di esecuzione.

Per verificare se il gruppo nel suo insieme è stabile o se sono in corso modifiche, vedi Controlla se un MIG è stabile.

Controlla gli stati di integrità

Se hai configurato la riparazione automatica per il gruppo di istanze gestite, puoi visualizzare lo stato di integrità di ciascuna VM. Vedi Stati di integrità.

Elenca gli errori delle istanze

Se le istanze gestite hanno riscontrato errori, puoi visualizzarli per diagnosticarne la causa e limitarla.

Per visualizzare un elenco degli errori puoi usare la console Google Cloud , gcloud CLI o REST.

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 la nuova istanza per i seguenti motivi:
  • Non è disponibile capacità preemptible.
  • Quota insufficiente, 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 template di istanza è stata eliminata o le relative autorizzazioni sono cambiate.
  • La carta di credito collegata all'account di fatturazione associato al progetto ha rifiutato un pagamento.
• Non è possibile eliminare un'istanza esistente per i seguenti motivi:
  • Il service account utilizzato dal gruppo non dispone dell'autorizzazione compute.instances.delete.
  • Sono state effettuate troppe richieste di eliminazione simultanee, causando il superamento dei limiti di frequenza.
• Non è possibile aggiungere l'istanza a un pool di destinazione perché quest'ultimo è stato eliminato.

Dopo aver esaminato gli errori, puoi limitarli. Ad esempio:

• Sposta il workload in una zona diversa con capacità preemptible.
• Richiedi un aumento di quota per una determinata regione.
• Aggiungi l'autorizzazione compute.instances.delete al service account utilizzato dal gruppo.

Se un'azione attivata da un gruppo di istanze gestite non va a buon fine (ad esempio, se un gestore della scalabilità automatica rileva un errore mentre tenta di aumentare le dimensioni del gruppo), il gruppo può riprovare immediatamente a eseguire l'azione. Se l'ultimo tentativo immediato di ripetizione non va a buon fine, il MIG registra l'errore, che puoi visualizzare elencando gli errori delle istanze. Dopo il tempo di backoff, il gruppo tenta di nuovo di eseguire l'azione non riuscita. Se l'errore persiste, potrebbe essere registrato più volte.

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

Verifica se un'istanza VM fa parte di un MIG

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

In alternativa, per scoprire se una VM fa parte di un gruppo di istanze gestite o ne ha fatto parte in passato, cerca queste due chiavi di metadati nei metadati dell'istanza:

• instance-template indica il template in base al quale è stata creata la VM.
• created-by indica il gruppo di istanze gestite che ha creato la VM.

Anche se abbandoni l'istanza, la VM contiene comunque questi metadati, a meno che non li 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

Visualizza lo stato conservato di un'istanza gestita

Se hai configurato un MIG stateful e vuoi visualizzare lo stato conservato di ciascuna istanza gestita, vedi Visualizza la configurazione stateful e lo stato conservato.

Passaggi successivi

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