Añadir y quitar VMs de un MIG

Una vez que hayas creado un grupo de instancias gestionadas (MIG), puede que quieras añadir o quitar VMs de ese grupo para satisfacer las necesidades de tu carga de trabajo. Si has alcanzado el límite predeterminado del número máximo de VMs que puedes añadir a un MIG y necesitas más VMs, puedes aumentar el límite de tamaño del MIG.

Para añadir o quitar VMs de un MIG, puedes hacer lo siguiente:

• Para añadir o quitar VMs automáticamente, define el tamaño objetivo del MIG:
  • Usa el autoescalado en aplicaciones sin reconocimiento del estado
  • Crear una solicitud de cambio de tamaño en la MIG
  • Definir manualmente el tamaño del MIG
• Añadir, quitar o abandonar manualmente instancias específicas:
  • Crear instancias con nombres específicos
  • Eliminar instancias específicas
  • Abandonar instancias específicas

Antes de empezar

• Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:

     gcloud init

     Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  2. Set a default region and zone.

  Terraform

  Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  Instala Google Cloud CLI.

  Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  If you're using a local shell, then create local authentication credentials for your user account:

  gcloud auth application-default login

  You don't need to do this if you're using Cloud Shell.

  If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

  Para obtener más información, consulta Set up authentication for a local development environment.

  REST

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

  Instala Google Cloud CLI.

  Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Definir el tamaño objetivo del grupo

Puede definir el tamaño objetivo de un MIG automáticamente mediante un autoescalador o definir el tamaño manualmente.

Añadir y quitar VMs automáticamente en un MIG

Puedes configurar grupos de instancias gestionadas para que añadan o quiten automáticamente máquinas virtuales en función de sus cargas de trabajo. Tus aplicaciones pueden gestionar fácilmente los incrementos de tráfico y puedes reducir los costes cuando la demanda de recursos de computación disminuye. Para empezar a escalar tus grupos de instancias gestionados, consulta el artículo Crear un MIG con autoescalado.

Para obtener más información, consulta Grupos de instancias con autoescalado.

Crear una solicitud de cambio de tamaño

Puedes usar solicitudes de cambio de tamaño para añadir VMs con GPU a un MIG a la vez. Esta función te ayuda a evitar que se te cobren cargos por capacidad parcial mientras Compute Engine aprovisiona todos los recursos. Las solicitudes de cambio de tamaño de MIG usan los modelos de aprovisionamiento flex-start o reservation-bound. Estos modelos te permiten obtener vCPUs y GPUs a un precio con descuento.

Para obtener más información, consulta Acerca de las solicitudes de cambio de tamaño en un MIG.

Definir manualmente el tamaño de un MIG

Si un grupo de instancias gestionado no está configurado para escalarse automáticamente, puedes cambiar el tamaño del grupo manualmente para modificar el número de instancias. Si aumentas el tamaño, el grupo de instancias gestionadas usará la plantilla de instancia actual para añadir instancias. Si reduces el tamaño, el grupo de instancias gestionadas eliminará las VMs del grupo. El grupo elimina las instancias con una currentAction de DELETING, CREATING y RECREATING antes de eliminar las instancias que se estén ejecutando sin acciones programadas.

Si el grupo forma parte de un servicio backend que tiene habilitado el drenaje de conexiones, pueden pasar hasta 60 segundos adicionales después de que haya transcurrido la duración del drenaje de conexiones antes de que se elimine la instancia de VM.

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

Después de enviar una solicitud para cambiar el tamaño de un grupo de instancias gestionadas, las VMs se inician o se detienen en cuanto el sistema puede aprovisionarlas o eliminarlas. Este proceso puede tardar bastante en función del número de instancias del grupo. Verifica el estado de las instancias de tu grupo de instancias gestionado.

Inhabilitar el modo de reintentos de creación durante el cambio de tamaño

De forma predeterminada, si falla la creación inicial de una instancia de VM, el grupo de instancias gestionado intentará crear la VM continuamente hasta que se cree correctamente. Sin embargo, si no quieres que se vuelva a intentar la creación automáticamente, puedes inhabilitar el modo de reintentos de creación cuando cambies el tamaño del grupo de instancias. En este modo, el grupo de instancias gestionado intenta crear todas las instancias solo una vez. Si se produce un error durante la creación de la instancia, el grupo de instancias gestionadas abandona esta instancia, la quita de la lista de instancias gestionadas del grupo y reduce el tamaño objetivo del grupo de instancias gestionadas.

Este modo solo se aplica durante el primer intento de creación de una VM. Si se crea una VM correctamente mientras este modo está habilitado, la VM se comportará igual que todas las demás VMs creadas con una solicitud de cambio de tamaño normal. En concreto, si una VM en ejecución falla inesperadamente más adelante y es necesario volver a crearla, este modo no afecta al comportamiento de recreación en ese caso.

Inhabilitar el modo de reintentos de creación es especialmente útil en situaciones en las que los sistemas crean automáticamente grupos de VMs en los que no se requiere un número exacto de VMs. Puede que prefieras estabilizar rápidamente el tamaño del grupo de instancias gestionado y ser flexible en cuanto al número de VMs del grupo, en lugar de esperar indefinidamente hasta que se creen todas las instancias solicitadas, lo que podría retrasarse temporal o permanentemente debido a errores de cuota u otros problemas no relacionados.

Limitaciones

• No puedes inhabilitar los reintentos de creación de un MIG regional con una forma de distribución de destino EVEN.
• En el caso de los MIGs regionales con una forma de distribución de destino BALANCED o ANY_SINGLE_ZONE, debes inhabilitar la redistribución proactiva de instancias antes de poder inhabilitar el modo de reintentos de creación.
• No puedes inhabilitar los reintentos de creación de MIGs con ajuste automático de escala.

Para cambiar el tamaño de un grupo de instancias gestionado cuando el modo de reintentos de creación está inhabilitado, usa la interfaz de línea de comandos de Google Cloud o REST.

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

Añadir, quitar o abandonar instancias específicas

En las siguientes secciones se muestra cómo añadir, quitar o abandonar instancias específicas en un MIG.

Crear instancias con nombres específicos en grupos de instancias gestionados

Si tu carga de trabajo o sistema de orquestación requiere nombres de instancias específicos, puedes añadir esas instancias a un MIG. En esta sección se muestra cómo añadir instancias en función de la disponibilidad. Si los recursos no están disponibles, el MIG añade una parte de las instancias y crea las restantes cuando los recursos estén disponibles. Para añadir a una MIG instancias de GPU con nombres específicos a la vez, consulta la sección Crear una solicitud de cambio de tamaño de este documento.

Los nombres que asignes a estas instancias se conservarán si el MIG las vuelve a crear. Para obtener más información sobre cómo conservar el estado de las instancias de MIG, consulta los MIGs con reconocimiento del estado.

Limitaciones

Si creas instancias con nombres específicos:

• Debes desactivar el autoescalado durante el proceso de creación de la instancia.
• Debes definir la política de actualización de la MIG como oportunista.
• Si vas a actualizar un MIG regional, haz lo siguiente:
  • Debes inhabilitar la redistribución proactiva de instancias.
  • No puedes seleccionar la zona en la que se creará la VM.
• No puedes usar nombres de instancias de VM duplicados en un proyecto.

Puedes usar la CLI de gcloud o REST para añadir VMs con nombres específicos a un MIG.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

Eliminar instancias concretas de un grupo

Puedes eliminar instancias de VM concretas de un grupo de instancias gestionado. Al eliminar instancias, se reduce el targetSize especificado del grupo de instancias y se eliminan las VMs de los grupos de destino de los que formen parte.

Si eliminas instancias concretas de un grupo de instancias gestionado, no se modificará ninguna de las opciones de autoescalador especificadas. Si eliminas instancias de un grupo de instancias gestionado, la herramienta de escalado automático puede detectar un aumento de la carga de trabajo en las otras instancias del grupo y volver a aumentar el tamaño del grupo hasta el nivel anterior. Para evitarlo, detén el escalador automático antes de intentar eliminar las instancias.

Si el grupo forma parte de un servicio backend que tiene habilitado el drenaje de conexiones, pueden pasar hasta 60 segundos adicionales después de que haya transcurrido la duración del drenaje de conexiones antes de que se elimine la instancia de VM.

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

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

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

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

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

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

Después de enviar una solicitud para eliminar instancias de un grupo de instancias gestionado, las instancias se detienen en cuanto el sistema puede eliminarlas. Este proceso puede tardar bastante en función del número de instancias que elimines del grupo. Verifica el estado del grupo o verifica el estado de las instancias gestionadas.

Abandonar instancias de un MIG

Puedes separar una instancia de VM de un grupo de instancias gestionado para depurar problemas con instancias concretas sin que afecte al grupo en su conjunto. Si abandonas una instancia de un grupo, también se eliminará de los balanceadores de carga que se hayan asignado al grupo de instancias gestionado. Los grupos de destino que se hayan asignado manualmente a instancias concretas no se eliminarán.

No puedes volver a añadir una instancia de VM abandonada al grupo. Al abandonar instancias, se reduce el targetSize especificado del grupo de instancias, pero no se cambia ningún ajuste de autoescalador. Los grupos de instancias gestionados con un escalador automático siguen añadiendo o quitando instancias automáticamente según sea necesario. En un MIG regional con el autoescalado configurado en el modo ONLY_SCALE_OUT, si abandonas una instancia de VM para reducir el tamaño objetivo del MIG al tamaño recomendado del autoescalador, es posible que el autoescalador cree una nueva instancia de VM en la misma zona que la VM abandonada. En estos casos, para evitar la creación de una instancia de VM, prueba a abandonar la instancia de VM desde otra zona.

Si el grupo forma parte de un servicio backend que tiene habilitado el drenaje de conexiones, pueden pasar hasta 60 segundos adicionales después de que haya transcurrido la duración del drenaje de conexiones antes de que se elimine la instancia de VM.

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

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

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

Después de enviar una solicitud para abandonar instancias de un grupo de instancias gestionado, el grupo elimina las instancias lo antes posible. Verifica el estado del grupo o verifica el estado de las instancias gestionadas.

Aumentar el límite de tamaño del grupo

De forma predeterminada, el límite de tamaño de un MIG zonal es de 1000 VMs y el de un MIG regional es de 2000 VMs. Puedes aumentar estos límites a 2000 VMs en el caso de los MIGs zonales y a 4000 VMs en el de los MIGs regionales.

Para aumentar los límites, asigna el valor PAGINATED al campo listManagedInstancesResults del grupo. Si necesitas más máquinas virtuales en el grupo, crea varios MIGs o ponte en contacto con el equipo de Asistencia.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

Si quieres volver a los resultados de la lista sin paginación, también debes restaurar el límite de tamaño predeterminado del grupo. Para volver a cambiarlo, primero asegúrate de que el grupo no supere el límite de tamaño predeterminado y, a continuación, asigna el valor PAGELESS al campo listManagedInstancesResults.

Siguientes pasos

• Consulta información sobre cómo trabajar con instancias gestionadas, por ejemplo, para eliminar, abandonar y volver a crear instancias gestionadas.
• Consulta información sobre grupos de instancias gestionados e instancias gestionadas.
• Solucionar problemas de grupos de instancias gestionados