Obtén información sobre los MIG y las instancias administradas

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

Antes de comenzar

Obtén información sobre los MIG

Puedes recuperar información sobre los grupos en sí, por ejemplo, para inspeccionar las políticas adjuntas al grupo y verificar 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 obtener información sobre las instancias administradas.

Genera una lista de MIG

Para obtener una lista de tus grupos de instancias administrados, usa Console, la herramienta de gcloud o la API.

Console

  1. En Google Cloud Platform Console, ve a la página Grupos de instancias.

    Ir a la página Grupos de instancias.

    Si tienes grupos de instancias existentes, la página genera una lista de esos grupos, incluidos los grupos de instancias administrados y los grupos de instancias no administrados.

    Los grupos de instancias administrados tienen un valor en la columna Plantilla.

gcloud

Genera una lista de todos los grupos de instancias administrados dentro de un proyecto:

gcloud compute instance-groups managed list

API

Para generar una lista de todos los grupos de instancias administrados dentro de una zona, crea una solicitud GET para el método instanceGroupManagers.list:

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

Para los grupos de instancias administrados regionales (de varias zonas), usa el recurso regionInstanceGroupManagers en su lugar: regionInstanceGroupManagers.list.

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

Obtén las propiedades de un MIG

Para obtener información sobre un MIG específico, incluidas las políticas adjuntas (por ejemplo, políticas de reparación automática), usa Console, la herramienta de gcloud o la API.

Para obtener el id del grupo, debes usar la herramienta de gcloud o la API.

Console

  1. En Google Cloud Platform Console, ve a la página Grupos de instancias.

    Ir a la página Grupos de instancias.

    En la página, se detallan los grupos de instancias que tengas. También se muestra una lista de los grupos de instancias no administrados.

  2. En la columna Nombre de la lista, haz clic en el nombre del grupo de instancias que quieres examinar. Se abrirá una página con las propiedades del grupo de instancias y una lista de las instancias incluidas en el grupo.

gcloud

Para obtener información sobre un grupo específico, ejecuta el siguiente comando:

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

El comando muestra detalles sobre el grupo, incluidas las políticas adjuntas.

API

A fin de obtener información sobre un grupo específico, crea una solicitud GET para el método instanceGroupManagers.get, en la que debes incluir el nombre de un grupo de instancias administrado específico:

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

Para los grupos de instancias administrados regionales (de varias zonas), usa el recurso regionInstanceGroupManagers en su lugar: regionInstanceGroupManagers.list y regionInstanceGroupManagers.get.

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

La respuesta muestra detalles sobre el grupo, incluidas las políticas adjuntas, pero no muestra las políticas de ajuste de escala automático.

A fin de obtener información sobre los escaladores automáticos, crea una solicitud GET para el método autoscalers.get y especifica el nombre de un grupo de instancias administrado específico:

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

Para grupos de instancias administrados regionales (de varias zonas), usa el recurso regionAutoscalers en su lugar: regionAutoscalers.get.

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

Verifica el estado del grupo

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.

A nivel de grupo, Compute Engine propaga un campo de solo lectura llamado status que contiene una marca isStable, al que puedes acceder con la herramienta de línea de comandos de gcloud o con la API.

gcloud

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

La herramienta de gcloud muestra información detallada sobre el grupo de instancias, incluido el campo status.isStable.

Para pausar una secuencia de comandos hasta que el grupo se encuentre estable, usa el comando wait-until con la marca --stable. Por ejemplo:

gcloud beta 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

El comando vuelve después de que status.isStable se establezca en true para el grupo.

API

Para un MIG zonal, realiza una solicitud POST al método instanceGroupManagers.get:

POST https://compute.googleapis.com/compute/beta/projects/project-id/zones/zone/instanceGroupManagers/[INSTANCE_GROUP_NAME]/get

Si el grupo de instancias es un grupo de instancias administrado regional, reemplaza zones/zone por regions/region:

POST https://compute.googleapis.com/compute/beta/projects/project-id/regions/region/instanceGroupManagers/[INSTANCE_GROUP_NAME]/get

La API muestra información detallada sobre el grupo de instancias, incluido el campo status.isStable.

Puedes verificar que un grupo de instancias administrado esté en ejecución y en buen estado si verificas el valor del campo status.isStable del recurso asociado instanceGroupManagers o regionInstanceGroupManagers.

También puedes usar el comando wait-until de la herramienta de línea de comandos de gcloud con la marca --stable a fin de esperar hasta que status.isStable esté configurado en true para el grupo:

gcloud beta compute instance-groups managed wait-until INSTANCE_GROUP_NAME \
    --stable \
    [--zone [ZONE] | --region [REGION]]

status.isStable establecido en false indica que los cambios están activos, pendientes o que el grupo de instancias administrado en sí se está modificando.

status.isStable establecido en true indica lo siguiente:

  • Ninguna de las instancias del grupo de instancias administrado se somete a ningún tipo de cambio y currentAction para todas las instancias es NONE.
  • No hay cambios pendientes para las instancias en el grupo de instancias administrado.
  • El grupo de instancias administrado en sí no se está modificando.

Los grupos de instancias administrados se pueden 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 grupo.
  • Un escalador automático solicita cambiar el tamaño del grupo.
  • Un recurso de reparación automática reemplaza una o más instancias en mal estado en el grupo de instancias administrado.
  • En un grupo de instancias administrado 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 grupo de instancias administrado.

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

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.

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

Genera una lista de las instancias administradas de un MIG

Para obtener una lista de las instancias administradas en un grupo, incluidos sus estados y plantillas, usa Console, la herramienta de gcloud o la API.

Console

  1. En Google Cloud Platform Console, ve a la página Grupos de instancias.

    Ir a la página Grupos de instancias.

    En la página, se detallan los grupos de instancias que tengas. También se muestra una lista de los grupos de instancias no administrados.

  2. En la columna Nombre de la lista, haz clic en el nombre del grupo de instancias que quieres examinar. Se abrirá una página con las propiedades del grupo de instancias y una lista de las instancias incluidas en el grupo.

gcloud

Usa el subcomando list-instances de la herramienta de gcloud.

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

El comando muestra una lista de instancias con sus detalles, incluidos su estado actual, plantilla de instancias y último error.

API

Para un MIG zonal, haz una solicitud POST al método instanceGroupManagers.listManagedInstances y especifica el nombre de un grupo de instancias administrado específico:

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

Para los grupos de instancias administrados regionales (de varias zonas), usa el recurso regionInstanceGroupManagers en su lugar: regionInstanceGroupManagers.list.

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

La respuesta muestra una lista de instancias con sus detalles, incluidos su estado actual y la plantilla de instancias.

Comprueba 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, de forma alternativa, verificar el estado del grupo con la herramienta de gcloud o la API.

Para ver la currentAction que se realiza y el status de cada instancia en un grupo de instancias administrado, puedes usar la herramienta de línea de comandos de gcloud o la API.

gcloud

gcloud compute instance-groups managed list-instances [INSTANCE_GROUP_NAME] [--filter="zone:([ZONE])" | --filter="region:([REGION])"]

gcloud muestra una lista de instancias en el grupo de instancias y sus respectivos estados y acciones actuales. Por ejemplo:

NAME               ZONE           STATUS    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

API

En la API, realiza una solicitud POST al método regionInstanceGroupManagers.listManagedInstances. Para un grupo de instancias administrado zonal, usa el método instanceGroupManagers.listManagedInstances.

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

La API muestra una lista de instancias dentro del grupo, incluido el instanceStatus y la currentAction de cada instancia.

{
 "managedInstances": [
  {
   "instance": "https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/instanceTemplates/[INSTANCE_TEMPLATE_NAME]",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://compute.googleapis.com/compute/v1/projects/[PROJECT_ID]/global/instanceTemplates/[INSTANCE_TEMPLATE_NAME]",
   "currentAction": "REFRESHING"
  }
 ]
}

Para cada instancia en un grupo de instancias administrado, el estado de la instancia se describe mediante su campo instanceStatus. Para ver una lista de los valores del campo instanceStatus válidos, consulta Verifica el estado de una instancia.

Si la instancia experimenta algún tipo de cambio, el campo currentAction se propaga con una de las siguientes acciones para ayudarte a realizar un seguimiento del progreso del cambio. De lo contrario, el campo currentAction es NONE.

Los valores posibles de currentAction son los siguientes:

  • ABANDONING: la instancia se está quitando del grupo de instancias administrado.
  • 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 grupo de instancias administrado no intenta volver a reemplazar la instancia.
  • DELETING: la instancia está en proceso de borrado.
  • RECREATING: la instancia se borró y se la 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.
  • 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 verificar 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 tu grupo de instancias administrado, puedes revisar el estado de cada instancia. Consulta la página sobre la verificación de estado.

Verifica si una instancia de VM es parte de un MIG

Para verificar si una instancia específica forma parte de un grupo en este momento, puedes usar Console o la API.

Console

  1. En Google Cloud Platform Console, ve a la página Instancias de VM.

    Ir a la página Instancias de VM

  2. Haz clic en una instancia para acceder a los detalles de la instancia de VM.
  3. Si la instancia de VM pertenece a un grupo de instancias administrado, el nombre de ese grupo de instancias administrado aparece bajo el encabezado En uso por. Si la instancia de VM no pertenece a un grupo, el encabezado En uso por no aparece en la página de detalles de la instancia.

API

Consulta la documentación sobre cómo ver referencias de instancias de VM.

Además, para identificar si una instancia formó parte de un grupo de instancias administrado, o aún lo hace, busca estas dos claves de metadatos en los metadatos de la instancia:

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

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

Por ejemplo, si existiera una instancia llamada random-instance-biy y quisieras saber si la instancia fue creada por un grupo de instancias administrado, podrías describir la instancia y buscar las claves de metadatos. Por ejemplo:

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

La herramienta de gcloud muestra una respuesta similar a la que se incluye a continuación:

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

Próximos pasos

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Compute Engine