Definir una forma de distribución de destino para las VMs de un MIG regional

Si usas un grupo de instancias gestionado (MIG) regional, puedes definir la forma de distribución de destino de ese MIG con una de las siguientes opciones:

  • EVEN (valor predeterminado): el grupo crea y elimina VMs para conseguir y mantener el mismo número de VMs en las zonas seleccionadas. En una distribución EVEN, el número de VMs no difiere en más de 1 entre dos zonas. Se recomienda para cargas de trabajo de publicación de alta disponibilidad.
  • EQUILIBRADO: el grupo prioriza la creación de VMs en zonas donde hay recursos disponibles, al tiempo que distribuye las VMs de la forma más uniforme posible entre las zonas seleccionadas para minimizar el impacto de los fallos zonales. Se recomienda para cargas de trabajo por lotes o de servicio de alta disponibilidad.
  • ANY: el grupo elige zonas para crear instancias de VM con el fin de cumplir el número de VMs solicitado dentro de las restricciones de recursos actuales y maximizar la utilización de las reservas zonales no utilizadas. Se recomienda para cargas de trabajo por lotes que no requieran alta disponibilidad.
  • CUALQUIER ZONA: el grupo crea todas las instancias de VM en una sola zona. La zona se elige en función de la compatibilidad del hardware, los recursos y la disponibilidad de cuotas actuales, así como de las reservas coincidentes. Se recomienda usarlo en combinación con una política de emplazamiento de instancias compacta para cargas de trabajo que requieran una comunicación exhaustiva entre máquinas virtuales.

Para usar VMs reservadas en un grupo de instancias gestionado regional, crea reservas idénticas con el mismo nombre en cada zona aplicable. A continuación, puedes orientar esas reservas por nombre en la plantilla de instancia del grupo.

Para ayudarte a elegir una forma, consulta la tabla comparativa, los casos prácticos y cómo funcionan las formas de distribución.

Define una forma de distribución de destino al crear tu MIG regional o actualiza la forma de destino de un MIG regional.

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 .

Limitaciones

  • Solo puedes seleccionar zonas para tu MIG al crearla.

  • Si especificas recursos en la plantilla de instancia o en la configuración con estado de tu MIG que no están disponibles en todas las zonas seleccionadas, se aplican las siguientes limitaciones:

    • Debe definir la forma de distribución del destino como BALANCED, ANY o ANY_SINGLE_ZONE.
    • Debe asegurarse de que los recursos que requiera el MIG (por ejemplo, discos, tipos de máquina o GPUs) estén disponibles en al menos una de las zonas seleccionadas.
    • Si quieres actualizar la configuración del MIG (por ejemplo, la plantilla de instancia) a una configuración que no se pueda crear en todas las zonas seleccionadas, debes eliminar las instancias gestionadas de todas las zonas no admitidas antes de definir la nueva configuración.

  • Para asignar a la forma de distribución de destino el valor BALANCED o ANY_SINGLE_ZONE, debes inhabilitar la redistribución proactiva de instancias.

  • Si quieres escalar automáticamente un MIG regional, debes definir el perfil de distribución objetivo del grupo como BALANCED o EVEN.

  • Si define la forma de distribución del destino como BALANCED, ANY o ANY_SINGLE_ZONE, se aplican las siguientes limitaciones:

    • No se admiten actualizaciones de Canary con dos versiones.
    • Si la disponibilidad de los recursos solicitados es limitada en toda la región, el grupo puede programar la creación de instancias de máquina virtual en una zona en la que los recursos ya no estén disponibles. Puedes probar a reducir y aumentar el tamaño del grupo para obtener los recursos solicitados en otras zonas.
    • Las actualizaciones continuas que usan el SUBSTITUTE método de sustitución intentarán crear las nuevas instancias actualizadas en la misma zona que las máquinas obsoletas, aunque la zona no tenga recursos para satisfacer los requisitos de la nueva versión. Para solucionar este problema, puedes eliminar las VMs obsoletas de la zona restringida y, a continuación, aumentar el tamaño del grupo en el número de VMs eliminadas. El grupo crea instancias a partir de la plantilla más reciente en las zonas en las que hay capacidad disponible.
    • Si quieres actualizar la plantilla de instancia del grupo a una plantilla que especifique recursos que no estén disponibles en todas las zonas seleccionadas, debes quitar instancias gestionadas de las zonas no admitidas antes de definir la nueva plantilla.

  • Si defines la forma de distribución de destino como ANY_SINGLE_ZONE y el grupo tiene VMs en una sola zona, solo podrás crear más VMs en esa zona. Si quieres usar otra zona, primero debes reducir el grupo a cero máquinas virtuales.

  • Si necesitas aprovisionar un grupo de máquinas virtuales de un solo inquilino, debes definir el perfil de distribución de destino del MIG como EVEN. Crea tus grupos de nodos en las mismas zonas que las del MIG y define las afinidades de nodos del MIG en la plantilla de instancia del MIG.

Crear un grupo con una forma de distribución objetivo

Para crear un grupo, selecciona sus zonas y define su forma de distribución de destino. Puedes usar la Google Cloud console, la CLI de gcloud, Terraform o REST.

Consola

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

    Ir a la página Grupos de instancias

  2. Haz clic en Crear grupo de instancias para crear un grupo de instancias.
  3. Selecciona una de las opciones de nuevo grupo de instancias gestionado: sin reconocimiento del estado (opción predeterminada) o con reconocimiento del estado.
  4. Asigna un nombre y, si quieres, una descripción al grupo de instancias.
  5. Elige una plantilla de instancia para el grupo de instancias o crea una.
  6. Especifica el número de VMs de este grupo. En el caso de las cargas de trabajo de alta disponibilidad, recuerda aprovisionar suficientes máquinas virtuales para que tu aplicación siga funcionando si se produce un fallo en una zona.
  7. En Ubicación, selecciona Varias zonas.

  8. Elige una región y selecciona las zonas que quieras usar.

    • Si quieres que tu MIG pueda usar todas las zonas de la región, selecciona todas las zonas disponibles.
    • Ten en cuenta que no puedes actualizar un MIG regional para que use zonas diferentes después de crearlo.

  9. Elige una forma de distribución del destino.

    1. Si quieres seleccionar Cualquiera o Cualquier zona, en la sección Autoescalado, haz clic en Modo de autoescalado y elige Eliminar configuración de autoescalado.
    2. Si quieres seleccionar Cualquier zona o Equilibrado, en la sección Redistribución de instancias, no selecciones Permitir redistribución de instancias.

  10. Continúa con el resto del proceso de creación de MIG.

gcloud

Usa el comando gcloud compute instance-groups managed create e incluye la marca --target-distribution-shape.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template TEMPLATE \
    --size SIZE \
    --region REGION \
    --zones ZONES \
    --target-distribution-shape SHAPE

Haz los cambios siguientes:

  • INSTANCE_GROUP_NAME: el nombre del grupo de instancias.
  • TEMPLATE: el nombre de la plantilla de instancia que se va a usar en el grupo.
  • SIZE: el tamaño objetivo del grupo de instancias.
  • REGION: la región en la que quieres que esté tu grupo.

  • ZONES (opcional): lista de zonas de la región en la que quieres desplegar instancias de VM. De forma predeterminada, Compute Engine selecciona tres zonas.

    • Si quieres que tu MIG pueda usar todas las zonas de la región, especifica todas las zonas disponibles. Puedes obtener una lista de las zonas de la región con el siguiente comando:

      gcloud compute zones list --filter=region:REGION --format='list(NAME)'

    • Ten en cuenta que no puedes actualizar un MIG regional para que use zonas diferentes después de crearlo.

  • SHAPE: la forma de distribución del destino. Puede ser uno de los siguientes valores:

    • even (opción predeterminada): el grupo crea y elimina VMs para conseguir y mantener el mismo número de VMs en las zonas seleccionadas. En una distribución EVEN, el número de VMs no difiere en más de 1 entre dos zonas. Se recomienda para cargas de trabajo de publicación de alta disponibilidad.
    • balanced: el grupo prioriza la creación de VMs en zonas donde hay recursos disponibles, al tiempo que distribuye las VMs de la forma más uniforme posible entre las zonas seleccionadas para minimizar el impacto de los fallos zonales. Se recomienda para cargas de trabajo por lotes o de servicio de alta disponibilidad.
    • any: el grupo elige zonas para crear instancias de VM con el fin de cumplir el número de VMs solicitado dentro de las restricciones de recursos actuales y maximizar la utilización de las reservas zonales no utilizadas. Se recomienda para cargas de trabajo por lotes que no requieran alta disponibilidad.
    • any-single-zone: el grupo crea todas las instancias de VM en una sola zona. La zona se elige en función de la compatibilidad del hardware, los recursos y la disponibilidad de cuotas actuales, así como de las reservas coincidentes. Se recomienda usarlo en combinación con una política de emplazamiento de instancias compacta para cargas de trabajo que requieran una comunicación exhaustiva entre máquinas virtuales.

Por ejemplo, para crear un MIG regional con una distribución de destino equilibrada, defina la marca --target-distribution-shape en balanced.

gcloud compute instance-groups managed create example-rmig \
    --template example-template \
    --size 30 \
    --zones us-east1-b,us-east1-c \
    --target-distribution-shape balanced \
    --instance-redistribution-type none

Terraform

Si aún no has creado una plantilla de instancia, que especifica el tipo de máquina, la imagen del disco de arranque, la red y otras propiedades de la VM que quieres que tengan todas las VMs de tu MIG, crea una plantilla de instancia.

Para crear un MIG regional, usa el google_compute_region_instance_group_manager recurso.

En el siguiente ejemplo se crea un MIG regional con la forma de distribución de destino BALANCED.

resource "google_compute_region_instance_group_manager" "default" {
  name                             = "example-rmig"
  region                           = "us-east1"
  distribution_policy_zones        = ["us-east1-b", "us-east1-c"]
  distribution_policy_target_shape = "BALANCED"
  update_policy {
    type                         = "PROACTIVE"
    minimal_action               = "REFRESH"
    instance_redistribution_type = "NONE"
    max_unavailable_fixed        = 3
  }
  target_size        = 30
  base_instance_name = "instance"
  version {
    instance_template = google_compute_instance_template.default.id
  }
}

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

REST

Llama al método regionInstanceGroupManagers.insert. En el cuerpo de la solicitud, incluye la propiedad distributionPolicy y asigna un valor a su campo targetShape.

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

{
    "name": INSTANCE_GROUP_NAME,
    "instanceTemplate": "global/instanceTemplates/TEMPLATE",
    "targetSize": SIZE,
    "distributionPolicy": {
        "zones": [
            {"zone": "zones/ZONE1"},
            {"zone": "zones/ZONE2"},
            {"zone": "zones/ZONE3"},
        ],
        "targetShape": "SHAPE"
    }
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID de proyecto de esta solicitud.
  • REGION: la región del grupo de instancias.
  • INSTANCE_GROUP_NAME: el nombre del grupo de instancias.
  • TEMPLATE: el nombre de la plantilla de instancia que se va a usar en el grupo de instancias.
  • SIZE: el tamaño objetivo del grupo de instancias.
  • ZONE: el nombre de una zona de la región en la que quieras desplegar instancias de VM.
    • Si quieres que tu MIG pueda usar todas las zonas de la región, especifica todas las zonas disponibles. Puedes obtener una lista de las zonas de una región llamando al método regions.get.
    • Ten en cuenta que no puedes actualizar un MIG regional para que use zonas diferentes después de crearlo.
  • SHAPE: la forma de distribución del destino. Puede ser uno de los siguientes valores:
    • EVEN (opción predeterminada): el grupo crea y elimina VMs para conseguir y mantener el mismo número de VMs en las zonas seleccionadas. En una distribución EVEN, el número de VMs no difiere en más de 1 entre dos zonas. Se recomienda para cargas de trabajo de publicación de alta disponibilidad.
    • BALANCED: el grupo prioriza la creación de VMs en zonas donde hay recursos disponibles, al tiempo que distribuye las VMs de la forma más uniforme posible entre las zonas seleccionadas para minimizar el impacto de los fallos zonales. Se recomienda para cargas de trabajo por lotes o de servicio de alta disponibilidad.
    • ANY: el grupo elige zonas para crear instancias de VM con el fin de cumplir el número de VMs solicitado dentro de las restricciones de recursos actuales y maximizar la utilización de las reservas zonales no utilizadas. Se recomienda para cargas de trabajo por lotes que no requieran alta disponibilidad.
    • ANY_SINGLE_ZONE: el grupo crea todas las instancias de VM en una sola zona. La zona se elige en función de la compatibilidad del hardware, los recursos y la disponibilidad de cuotas actuales, así como de las reservas coincidentes. Se recomienda usarlo en combinación con una política de emplazamiento de instancias compacta para cargas de trabajo que requieran una comunicación exhaustiva entre máquinas virtuales.

Cambiar la forma de distribución del destino de un grupo

Puedes cambiar la forma de distribución de destino de un MIG regional, pero con las siguientes limitaciones:

  • Si quieres cambiar la forma de distribución de destino a BALANCED o ANY_SINGLE_ZONE, primero debes inhabilitar la redistribución proactiva.
  • Si quieres cambiar la forma de distribución de destino a EVEN y la distribución actual de las instancias no es uniforme, primero debes inhabilitar la redistribución proactiva.
  • Si cambias la forma a EVEN y quieres volver a habilitar la redistribución proactiva, primero debes volver a equilibrar el grupo manualmente.
  • Si quieres cambiar la forma de distribución de destino a EVEN, pero tu plantilla de instancia especifica recursos que no se admiten en todas las zonas seleccionadas, primero debes actualizar la plantilla de instancia del grupo a una que se admita en todas las zonas seleccionadas.

Consola

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

    Ir a la página Grupos de instancias

  2. En la columna Nombre de la lista, haga clic en el nombre del grupo de instancias en el que quiera cambiar la forma de distribución de destino.
  3. Haz clic en Editar para modificar este grupo de instancias administrado.
  4. Haga clic en Ubicación para desplegar la sección.
  5. En la lista Forma de distribución de la orientación, selecciona la forma que quieras.
  6. Haz clic en Guardar para aplicar los cambios.

gcloud

Usa el comando gcloud compute instance-groups managed update e incluye la marca --target-distribution-shape.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --target-distribution-shape SHAPE

Haz los cambios siguientes:

  • INSTANCE_GROUP_NAME: el nombre del grupo de instancias.
  • SHAPE: la forma de distribución del destino. Puede ser uno de los siguientes valores:
    • even (opción predeterminada): el grupo crea y elimina VMs para conseguir y mantener el mismo número de VMs en las zonas seleccionadas. En una distribución EVEN, el número de VMs no difiere en más de 1 entre dos zonas. Se recomienda para cargas de trabajo de publicación de alta disponibilidad.
    • balanced: el grupo prioriza la creación de VMs en zonas donde hay recursos disponibles, al tiempo que distribuye las VMs de la forma más uniforme posible entre las zonas seleccionadas para minimizar el impacto de los fallos zonales. Se recomienda para cargas de trabajo por lotes o de servicio de alta disponibilidad.
    • any: el grupo elige zonas para crear instancias de VM con el fin de cumplir el número de VMs solicitado dentro de las restricciones de recursos actuales y maximizar la utilización de las reservas zonales no utilizadas. Se recomienda para cargas de trabajo por lotes que no requieran alta disponibilidad.
    • any-single-zone: el grupo crea todas las instancias de VM en una sola zona. La zona se elige en función de la compatibilidad del hardware, los recursos y la disponibilidad de cuotas actuales, así como de las reservas coincidentes. Se recomienda usarlo en combinación con una política de emplazamiento de instancias compacta para cargas de trabajo que requieran una comunicación exhaustiva entre máquinas virtuales.

REST

Llama al método regionInstanceGroupManagers.patch. En el cuerpo de la solicitud, incluye la propiedad distributionPolicy y define su campo targetShape.

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

{
    "distributionPolicy": {
        "targetShape": "SHAPE"
    }
}

Haz los cambios siguientes:

  • PROJECT_ID: el ID de proyecto de esta solicitud.
  • REGION: la región del grupo de instancias.
  • INSTANCE_GROUP_NAME: el nombre del grupo de instancias.
  • SHAPE: la forma de distribución del destino. Puede ser uno de los siguientes valores:
    • EVEN (opción predeterminada): el grupo crea y elimina VMs para conseguir y mantener el mismo número de VMs en las zonas seleccionadas. En una distribución EVEN, el número de VMs no difiere en más de 1 entre dos zonas. Se recomienda para cargas de trabajo de publicación de alta disponibilidad.
    • BALANCED: el grupo prioriza la creación de VMs en zonas donde hay recursos disponibles, al tiempo que distribuye las VMs de la forma más uniforme posible entre las zonas seleccionadas para minimizar el impacto de los fallos zonales. Se recomienda para cargas de trabajo por lotes o de servicio de alta disponibilidad.
    • ANY: el grupo elige zonas para crear instancias de VM con el fin de cumplir el número de VMs solicitado dentro de las restricciones de recursos actuales y maximizar la utilización de las reservas zonales no utilizadas. Se recomienda para cargas de trabajo por lotes que no requieran alta disponibilidad.
    • ANY_SINGLE_ZONE: el grupo crea todas las instancias de VM en una sola zona. La zona se elige en función de la compatibilidad del hardware, los recursos y la disponibilidad de cuotas actuales, así como de las reservas coincidentes. Se recomienda usarlo en combinación con una política de emplazamiento de instancias compacta para cargas de trabajo que requieran una comunicación exhaustiva entre máquinas virtuales.

Ver la política de distribución de instancias configurada

Consola

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

    Ir a la página Grupos de instancias

    Si ya tiene grupos de instancias, la página los mostrará.
  2. Haga clic en el nombre del grupo de instancias que quiera examinar. Se abrirá una página con las propiedades del grupo de instancias y una lista de las instancias que se incluyen en el grupo.
  3. Haz clic en Detalles.
  4. En la sección Ubicación, busca Forma de distribución del destino.

gcloud

Ejecuta el comando gcloud compute instance-groups managed describe.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --region REGION

El comando devuelve los detalles del grupo, incluido el campo distributionPolicy.targetShape:

...
distributionPolicy:
  targetShape: BALANCED
  zones:
  - zone: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f
  ...
name: my-group
region: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1
...

REST

Crea una solicitud GET para el método regionInstanceGroupManagers.get.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID de proyecto de esta solicitud
  • REGION: la región del grupo de instancias
  • INSTANCE_GROUP_NAME: el nombre del grupo de instancias

La forma de distribución del destino se devuelve en el campo distributionPolicy.targetShape. Por ejemplo:

{
  "name": "my-instance-group",
  "distributionPolicy": {
    "targetShape": "BALANCED",
  },
  "targetSize": 50,
  ...
}

Siguientes pasos