Trabaja con instancias administradas


Un grupo de instancias administrado (MIG) crea cada una de sus instancias administradas según los componentes de configuración que usas: plantilla de instancias , configuración de todas las instancias opcional y configuración con estado opcional.

Cada instancia administrada es una entidad de datos que representa el estado previsto de una instancia de máquina virtual (VM) real en un MIG.

Lee este documento para aprender a trabajar de manera confiable con las instancias administradas en un MIG. Por ejemplo, es posible que necesites agregar, quitar, actualizar o ver información sobre una instancia específica.

Para asegurarte de que el MIG no revierta los cambios de configuración, es importante usar los métodos que se describen en este documento. Si trabajas fuera de los métodos del grupo para modificar las VMs de un MIG, es posible que el MIG detecte o no que esas VMs ya no usan la configuración deseada del grupo, y es posible que experimentes resultados inesperados. Por ejemplo, si borras o actualizas una VM en un MIG mediante la API de instancias en lugar de la API de administrador de grupo de instancias requerida, el MIG no tendrá conocimiento de tu intent y en cualquier momento, el MIG podría intentar volver a crear o revertir esa VM de forma automática según la configuración del MIG.

Antes de comenzar

  • Revisa las limitaciones y, luego, create 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.
    3. 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.

¿Qué es una instancia administrada?

Una instancia administrada es una entidad de datos dentro de un MIG que contiene el estado actual y el estado deseado de una instancia de VM real.

El estado actual de una instancia administrada incluye los siguientes campos:

  • El estado del ciclo de vida de la instancia, por ejemplo, RUNNING, STOPPING
  • La acción actual que realiza el MIG en una instancia, por ejemplo: RESTARTING, VERIFYING, NONE
  • El estado de la instancia, por ejemplo, HEALTHY, UNHEALTHY

El estado previsto de una instancia administrada para una instancia de VM real incluye los siguientes elementos:

  • La versión deseada, es decir, el nombre de la versión y la plantilla de instancias que se usarán en la instancia
  • El estado preservado de elementos (como discos o metadatos) que se conservarán.

Como se muestra en la figura 1, para cada instancia administrada en un MIG, el MIG mantiene una VM en funcionamiento según la especificación de la instancia administrada.

Según su configuración, el MIG genera automáticamente instancias administradas, que corresponden a las instancias de VM reales que un MIG mantiene por ti.

Figura 1. Relación entre las instancias administradas y las VM correspondientes.

Para ver las especificaciones de una instancia administrada, consulta Cómo ver información sobre las instancias administradas en un MIG.

Agrega instancias a un MIG

Para agregar más instancias a un MIG, puedes seguir estos pasos:

Para verificar que las instancias agregadas recientemente estén en funcionamiento, verifica el estado del grupo o verifica el estado de las instancias administradas.

Cambio de tamaño manual

Si un grupo de instancias administrado aún no se configuró para el ajuste de escala automático, puedes establecer el tamaño del grupo manualmente a fin de cambiar la cantidad de instancias en el grupo. Consulta Cambia el tamaño de un grupo de instancias de forma manual.

Ajuste de escala automático

Puedes configurar grupos de instancias administrados para agregar o quitar automáticamente instancias en función de las cargas de trabajo. Las aplicaciones pueden manejar fácilmente los aumentos de tráfico, y puedes reducir los costos cuando se necesiten menos recursos de procesamiento. Para obtener más información sobre el ajuste de escala automático en tu MIG, consulta Grupos de instancias de ajuste de escala automático.

Agrega instancias con nombres específicos

Si tienes un sistema que depende de nombres específicos, puedes agregar VM con esos nombres a un MIG existente. Los nombres que asignes a estas instancias administradas persisten si el MIG vuelve a crear la VM. Para obtener más información, consulta Crea instancias con nombres específicos en MIG

Para obtener más información sobre cómo preservar el estado de las instancias de un MIG, consulta MIG con estado.

Borra instancias de un MIG

Cuando borras instancias administradas, el MIG reduce el targetSize del grupo y borra las instancias de VM correspondientes.

Si configuraste un MIG con estado, este borra las opciones de configuración de estado preservado de las instancias. El MIG también quita las instancias de cualquier grupo de destino al que pertenezcan.

Si el grupo forma parte de un servicio de backend en el que el vaciado de conexiones está habilitado, pueden transcurrir hasta 60 segundos más después de que se complete el vaciado de conexiones hasta que se quite o se borre la instancia de VM.

Para borrar una instancia administrada, puedes hacer lo siguiente:

Actualiza la configuración de VM en un MIG

Si necesitas cambiar la configuración de las VM en un MIG (por ejemplo, para modificar el disco de arranque o el tipo de máquina, agregar discos o cambiar otras propiedades de la VM), consulta Actualiza la configuración de VM en un MIG.

Vuelve a crear instancias en un MIG

Usa este método para actualizar las VM seleccionadas a fin de que usen los componentes de configuración de VM más recientes del grupo. Si necesitas volver a crear todas las VM de un grupo de instancias administrado, inicia una actualización progresiva.

Si el grupo forma parte de un servicio de backend en el que el vaciado de conexiones está habilitado, pueden transcurrir hasta 60 segundos más después de que se complete el vaciado de conexiones hasta que se quite o se borre la instancia de VM.

Vuelve a crear las instancias de VM seleccionadas en el grupo de instancias administrado mediante la gcloud CLI o la REST.

gcloud

Usa el comando instance-groups managed recreate-instances.

gcloud compute instance-groups managed recreate-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

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

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/recreateInstances

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

Una vez que realizas una solicitud para volver a crear instancias de VM en un grupo de instancias administrado, las VM nuevas se inician en cuanto el sistema puede aprovisionarlas. Este proceso puede tomar un tiempo significativo en función de la cantidad de instancias que vuelves a crear. Verifica el estado del grupo o verifica el estado de las instancias administradas.

La operación de recreación conserva el nombre de la instancia de VM, pero es posible que la marca de tiempo de creación de la instancia no cambie. Para confirmar que la operación de recreación creó una instancia nueva cuando la marca de tiempo de creación de la instancia no cambió, verifica la marca de tiempo de creación del disco de arranque conectado a esa instancia.

Obtén información sobre instancias en un MIG

Consulta cómo ver información sobre las instancias administradas en un MIG.

Configura instancias con estado en un MIG

Consulta Configura MIG con estado.

¿Qué sigue?