Agregar y eliminar máquinas virtuales de un MIG

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

Después de haber creado un grupo de instancias administrado (MIG) , es posible que desees agregar o eliminar máquinas virtuales de ese grupo para satisfacer las necesidades de tu carga de trabajo. Si alcanzó el límite predeterminado para la cantidad máxima de máquinas virtuales que puede agregar a un MIG y necesita más máquinas virtuales, puede aumentar el límite de tamaño del MIG.

Para agregar o eliminar máquinas virtuales en un MIG, puede hacer lo siguiente:

• Agregue o elimine máquinas virtuales automáticamente configurando el tamaño objetivo del MIG:
  • Utilice el ajuste de escala automático para aplicaciones sin estado
  • Establecer manualmente el tamaño del MIG
• Agregue, elimine o abandone manualmente instancias específicas:
  • Crear instancias con nombres específicos
  • Eliminar instancias específicas
  • Abandonar instancias específicas

Antes de comenzar

• 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.

  Terraform

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

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command:

     gcloud init

  4. 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, confirm that you have configured the gcloud CLI to use Workforce Identity Federation.

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

  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 .

Establecer el tamaño objetivo del grupo

Puede configurar el tamaño objetivo de un MIG automáticamente utilizando un escalador automático o configurar el tamaño manualmente.

Agregar y eliminar máquinas virtuales automáticamente en un MIG

Puede configurar grupos de instancias administrados para agregar o eliminar máquinas virtuales automáticamente según sus cargas de trabajo. Sus aplicaciones pueden manejar con elegancia los aumentos de tráfico y usted puede reducir sus costos cuando la necesidad de recursos informáticos es menor. Para comenzar a escalar sus grupos de instancias administrados, consulte Crear un MIG con ajuste de escala automático .

Para obtener más información, consulte Grupos de instancias con ajuste de escala automático .

Configurar manualmente el tamaño de un MIG

Si un grupo de instancias administrado aún no está configurado para escalar automáticamente , puedes cambiar el tamaño del grupo manualmente para cambiar la cantidad de instancias. Si aumenta el tamaño, el grupo de instancias administrado usa la plantilla de instancia actual para agregar nuevas instancias. Si reduce el tamaño, el grupo de instancias administrado elimina las máquinas virtuales del grupo. El grupo elimina instancias con una currentAction de DELETING , CREATING y RECREATING antes de eliminar instancias que se están ejecutando sin acciones programadas.

Si el grupo forma parte de un servicio backend que ha habilitado el drenaje de la conexión , pueden pasar hasta 60 segundos adicionales después de que haya transcurrido la duración del drenaje de la conexión antes de que se elimine o 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 realizar una solicitud para cambiar el tamaño de un grupo de instancias administrado, las VM se inician o se detienen tan pronto como el sistema puede aprovisionarlas o eliminarlas. Este proceso puede llevar una cantidad significativa de tiempo dependiendo de la cantidad de instancias del grupo. Verifica el estado de las instancias en tu grupo de instancias administrado.

Deshabilitar 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 administrado vuelve a intentar crear la VM continuamente hasta que se crea correctamente. Sin embargo, si no desea reintentos de creación automáticos, puede deshabilitar el modo de reintentos de creación cuando cambia el tamaño del grupo de instancias. En este modo, el grupo de instancias administrado intenta crear todas las instancias solo una vez. Si hay un error durante la creación de la instancia, el grupo de instancias administrado renuncia a esta instancia, la elimina de la lista de instancias administradas del grupo y reduce el tamaño objetivo del grupo de instancias administrado.

Este modo se aplica solo durante el primer intento de creación de una VM. Si una máquina virtual se crea correctamente mientras este modo está habilitado, la máquina virtual se comporta de la misma manera que todas las demás máquinas virtuales creadas con una solicitud de cambio de tamaño normal. En particular, si una máquina virtual en ejecución muere inesperadamente más adelante y es necesario recrearla, este modo no afecta el comportamiento de recreación en ese escenario.

Deshabilitar el modo de reintentos de creación es especialmente útil en escenarios en los que los sistemas crean automáticamente grupos de máquinas virtuales donde no se requiere una cantidad exacta de máquinas virtuales. Es posible que prefiera estabilizar rápidamente el tamaño del grupo de instancias administrado y ser flexible en la cantidad de VM en el 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 puede deshabilitar los reintentos de creación para un MIG regional con una forma de distribución de destino EVEN .
• Para MIG regionales con una forma de distribución de destino BALANCED o ANY_SINGLE_ZONE , debe deshabilitar la redistribución proactiva de instancias antes de poder deshabilitar el modo de reintentos de creación.
• No puede deshabilitar los reintentos de creación para MIG con escala automática .

Para cambiar el tamaño de un grupo de instancias administrado cuando el modo de reintentos de creación está deshabilitado, use la CLI 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
}

Agregar, eliminar o abandonar instancias específicas

Crear instancias con nombres específicos en MIG

Si tiene un sistema que depende de nombres específicos, puede agregar máquinas virtuales con nombres específicos a un MIG existente.

Los nombres que asigna a estas instancias administradas persisten si el MIG vuelve a crear la VM. Para obtener más información sobre cómo preservar el estado de las instancias MIG, consulte MIG con estado .

Limitaciones

Si crea instancias con nombres específicos:

• Debe desactivar el ajuste de escala automático durante el proceso de creación de la instancia.
• Debe configurar la política de actualización del MIG para que sea oportunista .
• Si está actualizando un MIG regional:
  • Debe deshabilitar la redistribución proactiva de instancias .
  • No puede seleccionar en qué zona crear la VM.
• No puedes usar nombres de instancias de VM duplicados dentro de un proyecto.

Puedes usar la CLI de gcloud o REST para agregar máquinas virtuales con nombres específicos a un MIG existente.

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 específicas de un grupo

Puedes eliminar instancias de VM individuales en un grupo de instancias administrado. La eliminación de instancias reduce el targetSize especificado del grupo de instancias y elimina las máquinas virtuales de cualquier grupo de destino del que sean miembros.

Eliminar instancias específicas de un grupo de instancias administrado no cambia ninguna configuración del escalador automático especificada. Si elimina instancias de un grupo de instancias administrado, el escalador automático podría detectar un aumento en la carga de trabajo en las otras instancias del grupo y aumentar el tamaño del grupo a su nivel anterior. Para evitar esto, detenga el escalador automático antes de intentar eliminar las instancias.

Si el grupo forma parte de un servicio backend que ha habilitado el drenaje de la conexión , pueden pasar hasta 60 segundos adicionales después de que haya transcurrido la duración del drenaje de la conexión antes de que se elimine o 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 realizar una solicitud para eliminar instancias en un grupo de instancias administrado, las instancias se detienen tan pronto como el sistema puede eliminarlas. Este proceso puede llevar una cantidad significativa de tiempo dependiendo de la cantidad de instancias que elimine del grupo. Verificar el estado del grupo o verificar el estado de las instancias administradas .

Abandonar instancias de un MIG

Puedes separar una instancia de VM de un grupo de instancias administrado para depurar problemas más fácilmente con instancias individuales sin afectar al grupo en su conjunto. Abandonar una instancia de un grupo también elimina la instancia de los balanceadores de carga que se asignaron al grupo de instancias administrado. Los grupos de destino que se asignaron manualmente a instancias individuales específicas no se eliminan.

No puede volver a agregar una instancia de VM abandonada al grupo. Abandonar instancias reduce el targetSize especificado del grupo de instancias, pero no cambia ninguna configuración del escalador automático especificada. Los grupos de instancias administrados con un escalador automático continúan agregando o eliminando instancias automáticamente según sea necesario. Para un MIG regional con escalado automático configurado en el modo ONLY_SCALE_OUT , si abandona una instancia de VM para reducir el tamaño objetivo de MIG al tamaño recomendado por el escalador automático , entonces el escalador automático podría crear una nueva instancia de VM en la misma zona de la VM abandonada. En tales casos, para evitar la creación de una nueva instancia de VM, intente abandonar la instancia de VM de una zona diferente.

Si el grupo forma parte de un servicio backend que ha habilitado el drenaje de la conexión , pueden pasar hasta 60 segundos adicionales después de que haya transcurrido la duración del drenaje de la conexión antes de que se elimine o 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 realizar una solicitud para abandonar instancias de un grupo de instancias administrado, el grupo elimina las instancias lo antes posible. Verificar el estado del grupo o verificar el estado de las instancias administradas .

Aumentar el límite de tamaño del grupo.

De forma predeterminada, el límite de tamaño para un MIG zonal es de 1000 VM y el límite de tamaño para un MIG regional es de 2000 VM. Puede aumentar aún más estos límites a 2000 VM para un MIG zonal y 4000 VM para un MIG regional.

Para aumentar los límites, establezca el campo listManagedInstancesResults del grupo en PAGINATED . Si aún necesita más máquinas virtuales en el grupo, cree varios MIG o comuníquese con el soporte .

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/region/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

Si desea volver a los resultados de la lista sin páginas, también debe volver al límite de tamaño predeterminado del grupo. Para volver atrás, primero asegúrese de que el grupo no exceda su límite de tamaño predeterminado y luego establezca el campo listManagedInstancesResults en PAGELESS .

¿Qué sigue?

• Obtenga información sobre cómo trabajar con instancias administradas , por ejemplo, para eliminar, abandonar y volver a crear instancias administradas.
• Vea información sobre grupos de instancias administrados e instancias administradas.
• Solucionar problemas de grupos de instancias administrados .