Ver información sobre MIG e instancias administradas

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Utilice los métodos de esta página para ver información sobre sus grupos de instancias administrados (MIG) y para ver información sobre las instancias de máquinas virtuales (VM) dentro de cada MIG.

Antes de comenzar

• Revise las limitaciones y luego cree un grupo.
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
  

  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

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

  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.

  Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Ver información sobre MIG

Puede recuperar información sobre los propios grupos, por ejemplo, para inspeccionar las políticas adjuntas al grupo y comprobar si el grupo es estable o está experimentando cambios. Para obtener información sobre las instancias de VM dentro de un MIG, consulte Ver información sobre instancias administradas .

Listar MIG

Para obtener una lista de tus grupos de instancias administrados, usa la consola , la CLI de 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

Ver las propiedades de un MIG

Para ver información sobre un MIG específico, incluidas sus políticas (por ejemplo, las políticas de actualización y reparación automática del grupo), usa la consola , la CLI de gcloud o REST .

Para ver el valor id del grupo, debes usar la CLI de gcloud o la API de 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

Comprobar si un MIG es estable

Varios comandos y solicitudes crean, eliminan y modifican instancias en un grupo de instancias administrado. Esas operaciones se devuelven como DONE después de que el grupo haya programado acciones para crear, eliminar o actualizar esas instancias. Sin embargo, esto no significa que las instancias del grupo se hayan creado, eliminado o actualizado hasta que se completen esas acciones subyacentes. Debe verificar el estado del grupo o, alternativamente , verificar el estado de esas instancias .

Un grupo de instancias administrado es estable cuando todas las instancias del grupo de instancias administrado no sufren ningún cambio, no se programan cambios futuros para las instancias y el grupo en sí no se modifica.

Es posible que necesite saber si el grupo es estable cuando tiene dependencias que dependen de que todas las instancias del grupo estén en buen estado y en servicio. Por ejemplo, es posible que desee comenzar a programar trabajos, enviar tráfico o asignar rangos de claves después de confirmar que todas las máquinas virtuales se están ejecutando y en buen estado.

Verifique que todas las instancias de un grupo de instancias administrado se estén ejecutando y en buen estado verificando el valor del campo status.isStable del grupo.

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 establecido en false indica que los cambios están activos, pendientes o que el propio MIG se está modificando.

status.isStable establecido en true indica lo siguiente:

• Ninguna de las instancias en el MIG está sufriendo ningún tipo de cambio y la currentAction para todas las instancias es NONE .
• No hay cambios pendientes para instancias en el MIG.
• El MIG en sí no se modifica.

Recuerde que la estabilidad de un MIG depende de numerosos factores porque un MIG se puede modificar de numerosas maneras. Por ejemplo:

• Realiza una solicitud para implementar una nueva plantilla de instancia.
• Realiza una solicitud para crear, eliminar, cambiar el tamaño o actualizar instancias en el MIG.
• Un escalador automático solicita cambiar el tamaño del MIG.
• Un recurso de reparación automática está reemplazando una o más instancias en mal estado en el MIG.
• En un MIG regional, algunas de las instancias se están redistribuyendo .

Tan pronto como finalicen todas las acciones, status.isStable vuelve a establecerse en true para ese MIG.

Para instancias de VM individuales, consulte Comprobación del estado de instancias administradas .

Compruebe si las reparaciones de VM están desactivadas en un MIG

Para comprobar si las reparaciones de VM están desactivadas en un MIG, usa la consola , la CLI de 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"
}

Si no desea que un MIG repare una máquina virtual fallida o en mal estado en el grupo, puede desactivar las reparaciones en el MIG .

Ver operaciones históricas de reparación automática

Si ha configurado la reparación automática, puede ver eventos de reparación automática anteriores .

Supervisar las actualizaciones continuas

Si inició una actualización continua y desea saber cuándo se completa la actualización, consulte Monitoreo de actualizaciones .

Ver configuración con estado

Si configuró un MIG con estado y desea revisar su configuración, consulte Visualización de la configuración con estado .

Ver información sobre las instancias de VM administradas dentro de un MIG

Listar las instancias administradas de un MIG

Para obtener una lista de las instancias administradas en un grupo, incluidos sus estados y plantillas, usa la consola , la CLI de gcloud 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

Verificar el estado de las instancias administradas

Varios comandos y solicitudes crean, eliminan y modifican instancias en un grupo de instancias administrado. Esas operaciones se devuelven como DONE después de que el grupo haya programado acciones para crear, eliminar o actualizar esas instancias. Sin embargo, esto no significa que las instancias del grupo se hayan creado, eliminado o actualizado hasta que se completen esas acciones subyacentes. Debe verificar el estado de esas instancias o, alternativamente, verificar el estado del grupo mismo.

Utilice la CLI o REST de Google Cloud para ver detalles sobre las instancias en un grupo de instancias administrado. Los detalles incluyen el estado de la instancia y las acciones actuales que el grupo está realizando en sus instancias.

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"
  }
 ]
}

Para ver una lista de valores de campo de instanceStatus válidos, consulte Ciclo de vida de instancia de VM .

Si una instancia está experimentando algún tipo de cambio, el grupo de instancias administrado establece el campo currentAction de la instancia en una de las siguientes acciones para ayudarlo a realizar un seguimiento del progreso del cambio. De lo contrario, el campo currentAction se establece en NONE .

Los posibles valores currentAction son:

• ABANDONING . La instancia se está eliminando del MIG.
• CREATING . La instancia está en proceso de creación.
• CREATING_WITHOUT_RETRIES . La instancia se está creando sin reintentos; Si la instancia no se crea en el primer intento, el MIG no intenta reemplazar la instancia nuevamente.
• DELETING . La instancia está en proceso de eliminación.
• RECREATING . La instancia está siendo reemplazada.
• REFRESHING . La instancia se elimina de sus grupos de destino actuales y se vuelve a agregar a la lista de grupos de destino actuales (esta lista puede ser la misma o diferente de los grupos de destino existentes).
• RESTARTING . La instancia está en proceso de reiniciarse utilizando los métodos stop e start .
• RESUMING . La instancia se encuentra en proceso de reanudación luego de haber sido suspendida.
• STARTING . La instancia está en proceso de iniciarse después de haber sido detenida.
• STOPPING . La instancia está siendo detenida.
• SUSPENDING . La instancia queda suspendida.
• VERIFYING . La instancia ha sido creada y está en proceso de verificación.
• NONE . No se están realizando acciones en la instancia.

Para comprobar si el grupo en su conjunto es estable o está experimentando cambios, consulte Comprobación del estado del grupo .

Consultar estados de salud

Si configuró la reparación automática para su grupo de instancias administrado, puede revisar el estado de salud de cada VM. Consulte Comprobación del estado de salud .

Listar errores de instancia

Si sus instancias administradas encontraron errores, puede verlos para diagnosticar y mitigar la causa.

Utilice la consola de Google Cloud, la CLI de gcloud o REST para enumerar los errores.

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=="
}

La lista de posibles errores incluye, entre otros, los siguientes ejemplos:

• No se puede crear una nueva instancia debido a:
  • Indisponibilidad de capacidad preferente.
  • Falta de cuota, por ejemplo, para CPU en una región determinada.
  • Se alcanzó el límite en la cantidad de instancias de VM para la red asociada con el grupo.
  • La imagen de disco especificada en el campo properties.disks[].initializeParams.sourceImage de la plantilla de instancia se eliminó o sus permisos cambiaron.
  • La tarjeta de crédito de la cuenta de facturación asociada al proyecto rechazó un pago.
• Una instancia existente no se puede eliminar porque:
  • La cuenta de servicio que usa el grupo no tiene el permiso compute.instances.delete .
  • Se solicitaron demasiadas eliminaciones simultáneas, lo que superó los límites de velocidad.
• No se puede agregar una instancia a un grupo de destino porque el grupo de destino se eliminó.

Después de inspeccionar dichos errores, podrá mitigarlos. Por ejemplo:

• Mueva su carga de trabajo a una zona diferente que tenga capacidad preferente.
• Solicitar un aumento de cuota en una región determinada.
• Agregue el permiso compute.instances.delete a la cuenta de servicio utilizada por el grupo.

Si falla una acción desencadenada por un grupo de instancias administrado (por ejemplo, si un escalador automático encuentra un error al intentar aumentar el tamaño del grupo), el grupo podría volver a intentar esa acción inmediatamente. Si el último intento de reintento inmediato falla, el MIG registra el error y usted puede verlo enumerando los errores de instancia . Después de un tiempo de espera, el grupo vuelve a intentar la acción fallida. Si el error persiste, es posible que se registre varias veces.

Compute Engine conserva los errores 500 más recientes de los últimos 8 días, incluso si las instancias subyacentes ya no existen o no se pudieron crear.

Comprobar si una instancia de VM es parte de un MIG

Para comprobar si una VM específica es miembro de un grupo, puede usar la consola o REST.

Como alternativa, para identificar si una VM es o fue miembro de un grupo de instancias administrado, busque estas dos claves de metadatos en los metadatos de la instancia:

• instance-template indica la plantilla desde la que se creó la VM.
• created-by indica el grupo de instancias administrado que creó la VM.

Incluso si abandona la instancia, la VM seguirá teniendo estas entradas de metadatos, a menos que las elimine manualmente.

Por ejemplo, si hay una VM llamada random-instance-biy y quieres saber si la VM fue creada por un grupo de instancias administrado, puedes describir la instancia y buscar las claves de metadatos. Por ejemplo:

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

La CLI de gcloud devuelve una respuesta similar a:

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

Ver el estado conservado de una instancia administrada

Si configuró un MIG con estado y desea ver el estado preservado de cada instancia administrada, consulte Visualización de la configuración con estado y el estado preservado .

¿Qué sigue?

• Obtenga más información sobre los grupos de instancias administrados .
• Crea una plantilla de instancias que puedas usar para crear un grupo de instancias administrado .