Ver información de los MIG y las instancias administradas

Usa los métodos de esta página para ver información sobre los grupos de instancias administrados (MIG) y las instancias de máquina virtual (VM) dentro de cada MIG.

Antes de empezar

• Revisa las limitaciones y, luego, crea un grupo.
• Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
  

  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

  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.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

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

Visualiza información sobre los MIGs

Puedes recuperar información sobre los grupos en sí, por ejemplo, para inspeccionar las políticas adjuntas al grupo y comprobar si el grupo es estable o si está experimentando cambios. Para obtener información sobre las instancias de VM dentro de un MIG, consulta la página sobre cómo ver información sobre las instancias administradas.

Enumera MIGs

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

Visualiza las propiedades de un MIG

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

Para obtener 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

Verifica si un MIG es estable

Varios comandos y solicitudes crean, borran y modifican instancias en un grupo de instancias administrado. Esas operaciones se muestran como DONE después de que el grupo programó acciones para crear, borrar o actualizar esas instancias. Sin embargo, esto no significa que se crearon, borraron o actualizaron las instancias hasta que se completen esas acciones subyacentes. Debes verificar el estado del grupo o, de forma alternativa, verificar el estado de esas instancias.

Un grupo de instancias administrado es estable cuando ninguna de las instancias que lo conforman experimenta cambios, no hay cambios programados para esas instancias en el futuro y el grupo en sí no se está modificando.

Es posible que necesites saber si el grupo es estable en caso de que tengas dependencias que requieran que todas las instancias del grupo estén en buen estado y activas. Por ejemplo, se recomienda empezar a programar trabajos, enviar tráfico o asignar rangos de claves después de recibir la confirmación de que todas las VM están en ejecución y en buen estado.

Para verificar que todas las instancias en un grupo de instancias administrado estén en ejecución y en buen estado, comprueba 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 configurado como false indica que los cambios están activos, pendientes o que el MIG se está modificando.

status.isStable establecido en true indica lo siguiente:

• Ninguna de las instancias del MIG se somete a ningún tipo de cambio, y la currentAction para todas las instancias es NONE.
• No hay cambios pendientes para las instancias en el MIG.
• No se modifica el MIG en sí.

Recuerda que la estabilidad de un MIG depende de muchos factores, puesto que un MIG se puede modificar de varias maneras. Por ejemplo:

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

Cuando todas las acciones se completan, el valor status.isStable se vuelve a configurar como true para ese MIG.

Para instancias de VM individuales, consulta la sección sobre cómo comprobar el estado de las instancias administradas.

Verifica 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 beta compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

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

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

Si no quieres que un MIG repare una VM con errores o en mal estado en el grupo, puedes desactivar las reparaciones en el MIG.

Visualiza el historial de operaciones de reparación automática

Si configuraste la reparación automática, puedes ver eventos de reparación automática anteriores.

Supervisa las actualizaciones progresivas

Si iniciaste una actualización progresiva y quieres saber cuándo se completará, consulta Supervisa las actualizaciones.

Visualiza la configuración con estado

Si configuraste un MIG con estado y deseas revisar la configuración, consulta Visualiza la configuración con estado.

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

Enumera 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

Verifica el estado de las instancias administradas

Varios comandos y solicitudes crean, borran y modifican instancias en un grupo de instancias administrado. Esas operaciones se muestran como DONE después de que el grupo programó acciones para crear, borrar o actualizar esas instancias. Sin embargo, esto no significa que se crearon, borraron o actualizaron las instancias hasta que se completen esas acciones subyacentes. Debes verificar el estado de esas instancias o, como alternativa, verificar el estado del grupo.

Usa Google Cloud CLI o REST para ver los detalles de las instancias en un grupo de instancias administrado. Los detalles incluyen el estado de la instancia y las acciones actuales que realiza el grupo 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 los valores de campo instanceStatus válidos, consulta la sección Ciclo de vida de las instancias de VM.

Si una instancia experimenta algún tipo de cambio, el grupo de instancias administrado establece el campo currentAction de la instancia como una de las siguientes acciones para ayudarte a realizar un seguimiento del progreso del cambio. De lo contrario, el campo currentAction se configura como NONE.

Los valores posibles de currentAction son los siguientes:

• ABANDONING. La instancia se está quitando 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 de nuevo.
• DELETING: La instancia está en proceso de borrado.
• RECREATING: La instancia se está reemplazando.
• REFRESHING: La instancia se está quitando de sus grupos de destino actuales y se está agregando de nuevo a la lista de grupos de destino actuales (esta lista puede ser igual o diferente a la de los grupos de destino existentes).
• RESTARTING. la instancia está en proceso de reinicio con los métodos stop y start.
• RESUMING La instancia está en proceso de reanudarse después de que se suspendió.
• STARTING La instancia está en proceso de iniciarse después de detenerse.
• STOPPING. La instancia se está deteniendo.
• SUSPENDING. La instancia se está suspendiendo.
• VERIFYING: la instancia se creó y está en proceso de verificación.
• NONE: no hay ninguna acción en ejecución en la instancia.

Para comprobar si el grupo en su totalidad es estable o si está experimentando cambios, consulta la sección sobre cómo comprobar el estado del grupo.

Verifica los estados

Si configuraste la reparación automática para el grupo de instancias administrado, puedes revisar el estado de cada VM. ConsultaVerifica el estado.

Enumera errores de instancias

Si tus instancias administradas experimentaron errores, puedes verlos para diagnosticar y mitigar la causa.

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

En la lista de errores posibles se incluyen, entre otros, los siguientes ejemplos:

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

Después de inspeccionar estos errores, puedes mitigarlos. Por ejemplo:

• Mueve la carga de trabajo a una zona diferente que tenga capacidad interrumpible.
• Solicita un aumento de cuota en una región determinada.
• Agrega el permiso compute.instances.delete a la cuenta de servicio que usa el grupo.

Si falla una acción que se activa mediante un grupo de instancias administrado (por ejemplo, si un escalador automático experimenta un error cuando intenta aumentar el tamaño del grupo), el grupo puede reintentar esa acción de forma inmediata. Si falla la última tentativa de reintento inmediato, el MIG registra el error y puedes verlo si enumeras los errores de la instancia. Después de un tiempo de retirada, el grupo reintentará la acción que falló. Si el error persiste, es posible que se registre varias veces.

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

Verifica si una instancia de VM es parte de un MIG

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

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

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

Incluso si abandonas la instancia, la VM seguirá teniendo estas entradas de metadatos, a menos que las quites de forma manual.

Por ejemplo, si hubiese una VM llamada random-instance-biy y quisieras saber si la creó 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 muestra una respuesta similar a la siguiente:

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

Visualiza el estado preservado de una instancia administrada

Si configuraste un MIG con estado y deseas visualizar el estado preservado de cada instancia administrada, consulta Visualiza la configuración con estado y el estado preservado.

¿Qué sigue?

• Obtén 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.