Agregar flexibilidad de instancias

En este documento, se describe cómo agregar flexibilidad de instancias que te permita configurar varios tipos de máquinas en un MIG.

Puedes agregar flexibilidad de instancias cuando creas un MIG o editas uno existente. Para agregar la flexibilidad, configura una política de flexibilidad de instancias en el MIG. La política anula el tipo de máquina especificado en la plantilla de instancias. Cada vez que el MIG crea una instancia de máquina virtual (VM), selecciona de forma automática uno de los tipos de máquinas que indicaste en la política según la disponibilidad de recursos. También puedes asignar clasificaciones a las listas de tipos de máquinas para indicar tu preferencia.

Para saber cómo funciona la flexibilidad de instancias en un MIG, consulta Acerca de la flexibilidad de instancias.

Antes de comenzar

  • Cuando configures la flexibilidad de instancias, debes asegurarte de lo siguiente:
    • Los tipos de máquinas se admiten en la región en la que se encuentra tu MIG. Para obtener una lista de los tipos de máquinas disponibles para cada región, consulta Regiones y zonas disponibles.
    • Los tipos de máquinas son compatibles con las propiedades de instancia que se especifican en la plantilla de instancias del MIG. Si un tipo de máquina seleccionado no es compatible con los discos o la plataforma de CPU de la plantilla de instancias, configura las anulaciones para que coincidan con los requisitos del tipo de máquina. Para verificar las propiedades de la plantilla de instancias, consulta Obtén información sobre una plantilla de instancias.

    Si agregas un tipo de máquina no compatible o incompatible, el MIG no podrá usarlo. Cualquier intento de crear VMs con ese tipo de máquina falla.

  • Si deseas crear VMs Spot en un MIG, consulta la disponibilidad de los recursos antes de agregar VMs al MIG. Verificar la disponibilidad de los recursos ayuda a reducir las probabilidades de que se produzcan errores de disponibilidad de recursos. Para obtener instrucciones, consulta Visualiza la disponibilidad de recursos de las VMs Spot.
  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Cloud de Confiance by S3NS . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña según cómo planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Cloud de Confiance para acceder a los servicios y las APIs de Cloud de Confiance by S3NS , no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando:

      gcloud init
  • Configura una región y una zona predeterminadas.
  • 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. Instala Google Cloud CLI.

    2. Configura gcloud CLI para usar tu identidad federada.

      Para obtener más información, consulta Accede a gcloud CLI con tu identidad federada.

    3. Crea credenciales de autenticación locales para tu cuenta de usuario:

      gcloud auth application-default login

      Si se devuelve un error de autenticación, confirma que accediste a gcloud CLI con tu identidad federada.

    Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

    REST

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

      Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Cloud de Confiance .

Crea un MIG con flexibilidad de instancias

Antes de crear un MIG, primero debes crear una plantilla de instancias, si aún no tienes una. Luego, puedes crear un MIG con flexibilidad de instancias para anular el tipo de máquina especificado en la plantilla de instancias.

Crea un MIG con flexibilidad de instancias de una de las siguientes maneras:

Crea un MIG con varios tipos de máquinas

Si tus tipos de máquinas comparten las configuraciones de disco y plataforma de CPU de la plantilla de instancias, y no necesitas clasificarlos por preferencia, usa una de las siguientes opciones:

Console

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

    Ir a Grupos de instancias

  2. Haz clic en Crear grupo de instancias.

  3. En el campo Nombre, ingresa un nombre para el MIG.

  4. En la lista Plantilla de instancias, selecciona la plantilla de instancias que deseas usar para el MIG.

  5. En el campo Cantidad de instancias, especifica la cantidad de VMs que deseas en el grupo.

  6. En la sección Selecciones de instancias, haz clic en Agregar selecciones.

    Se abrirá la ventana Selecciones de instancias.

    1. En la sección Selección de instancia nueva, haz lo siguiente:

      1. En el campo Nombre, ingresa un nombre para la selección de instancias. Como en este ejemplo crearás una selección de instancia única, puedes mantener el valor predeterminado para el campo Rango.

      2. Repite los siguientes pasos para cada tipo de máquina que quieras agregar a la selección de instancias.

        1. Haz clic en Agregar tipo de máquina.

        2. En el panel Agregar tipo de máquina, selecciona la Serie del tipo de máquina que deseas agregar.

        3. En la lista Tipo de máquina, selecciona el tipo de máquina.

        4. Haz clic en Listo.

          Si un tipo de máquina seleccionado no es compatible con la configuración del disco o de la plataforma de CPU en la plantilla de instancias, la consola muestra un mensaje de validación, como un mensaje que indica que el tipo de disco no se puede usar como disco de arranque con el tipo de máquina seleccionado. Para resolver este problema, configura las anulaciones en los siguientes pasos.

      3. Para anular la plataforma de CPU mínima especificada en la plantilla de instancias, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular la plataforma de CPU para esta selección.

        2. En la lista Plataforma de CPU, selecciona la plataforma que deseas usar para la selección de instancias. Como alternativa, para seleccionar automáticamente cualquier plataforma de CPU compatible con los tipos de máquinas elegidos, selecciona Automático.

      4. Para anular la configuración de disco especificada en la plantilla de instancias o para conectar almacenamiento, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular discos.

        2. Para anular el disco de arranque, en la sección Disco de arranque, haz clic en Cambiar y sigue las indicaciones.

        3. Para conectar el almacenamiento, haz clic en Agregar disco nuevo o Conectar disco existente y sigue las indicaciones.

      5. En la sección Selección de instancias nuevas, después de agregar los tipos de máquinas y las anulaciones, haz clic en Listo.

    2. En la ventana Selecciones de instancias, haz clic en Listo.

  7. Deja los demás campos con la configuración predeterminada o modifícalos según sea necesario.

  8. Haz clic en Crear.

gcloud

Para crear un MIG regional con varios tipos de máquinas, usa el comando instance-groups managed create de la siguiente manera:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --instance-selection-machine-types MACHINE_TYPE,MACHINE_TYPE,...

Los MIG zonales no admiten la flexibilidad de instancias. Sin embargo, si deseas crear un MIG en una sola zona, configura la forma de distribución objetivo como any-single-zone. Además, si deseas una zona específica, usa la forma de distribución any-single-zone y, también, incluye la marca --zones ZONE.

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • REGION: Es la región en la que deseas crear el MIG.
  • TARGET_SIZE: la cantidad de VMs que deseas que el MIG cree y mantenga.
  • INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:
    • Para una plantilla de instancias regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para una plantilla de instancias global: INSTANCE_TEMPLATE_ID
  • SHAPE: Es la forma de distribución objetivo. El valor puede ser balanced, any o any-single-zone.
  • MACHINE_TYPE: los tipos de máquinas que deseas configurar en el MIG, por ejemplo, n1-standard-16,n2-standard-16,e2-standard-16.

Terraform

Si aún no creaste una plantilla de instancias, en la que se especifican las propiedades de VM que quieres para cada VM en tu MIG, crea una plantilla de instancias.

Para crear un MIG regional con varios tipos de máquinas, usa el recurso google_compute_region_instance_group_manager.

resource "google_compute_region_instance_group_manager" "default" {
  name               = "flex-igm"
  base_instance_name = "tf-test-flex-igm"
  region             = "us-central1"

  target_size                      = 3
  distribution_policy_target_shape = "ANY_SINGLE_ZONE"

  version {
    instance_template = google_compute_instance_template.default.id
  }

  instance_flexibility_policy {
    instance_selections {
      name          = "default-instance-selection"
      machine_types = ["n1-standard-16", "n2-standard-16", "e2-standard-16"]
    }
  }

  update_policy {
    instance_redistribution_type = "NONE"
    type                         = "OPPORTUNISTIC"
    minimal_action               = "REPLACE"
    max_surge_fixed              = 0
    max_unavailable_fixed        = 6
  }
}

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

REST

Para crear un MIG regional con varios tipos de máquinas, realiza una solicitud POST al método regionInstanceGroupManagers.insert.

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

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": TARGET_SIZE,
  "instanceTemplate": "INSTANCE_TEMPLATE_URL",
  "distributionPolicy": {
    "targetShape": "SHAPE"
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2",
          ...
        ]
      }
    }
  }
}

Los MIG zonales no admiten la flexibilidad de instancias. Sin embargo, si deseas crear un MIG en una sola zona, configura la forma de distribución objetivo como ANY_SINGLE_ZONE. Además, si deseas una zona específica, usa la forma de distribución ANY_SINGLE_ZONE y, luego, incluye el campo distributionPolicy.zones[].zone en la solicitud.

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • REGION: Es la región en la que deseas crear el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • TARGET_SIZE: la cantidad de VMs que deseas que el MIG cree y mantenga.
  • INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:
    • Para una plantilla de instancias regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para una plantilla de instancias global: INSTANCE_TEMPLATE_ID
  • SHAPE: Es la forma de distribución objetivo. El valor puede ser BALANCED, ANY o ANY_SINGLE_ZONE.
  • INSTANCE_SELECTION: Es el nombre de la lista de tipos de máquinas.
  • MACHINE_TYPE: los tipos de máquinas que deseas configurar en el MIG, por ejemplo, "n1-standard-16","n2-standard-16","e2-standard-16".

Crea un MIG con varios tipos de máquinas, preferencias y anulaciones adicionales

Cuando creas un MIG con varios tipos de máquinas, puedes establecer preferencias (clasificaciones) para los tipos de máquinas y anular las definiciones de la plataforma de CPU mínima y del disco para cada selección de instancias. Por ejemplo, si la plantilla de instancias especifica un Persistent Disk y seleccionas una serie de máquinas N4, debes anular el disco de arranque con un tipo de Google Cloud Hyperdisk compatible. Para conocer los tipos de discos compatibles con las series de máquinas, consulta Compatibilidad de las series de máquinas con discos persistentes y Compatibilidad de las series de máquinas con Hyperdisk.

Para crear un MIG con varios tipos de máquinas, preferencias y anulaciones, selecciona una de las siguientes opciones:

Console

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

    Ir a Grupos de instancias

  2. Haz clic en Crear grupo de instancias.

  3. En el campo Nombre, ingresa un nombre para el MIG.

  4. En la lista Plantilla de instancias, selecciona la plantilla de instancias que deseas usar para el MIG.

  5. En el campo Cantidad de instancias, especifica la cantidad de VMs que deseas en el grupo.

  6. En la sección Selecciones de instancias, haz clic en Agregar selecciones.

    Se abrirá la ventana Selecciones de instancias.

    1. En la sección Selección de instancia nueva, haz lo siguiente:

      1. En el campo Nombre, ingresa un nombre para la selección de instancias. Como en este ejemplo crearás una selección de instancia única, puedes mantener el valor predeterminado para el campo Rango.

      2. En el campo Rango, ingresa el orden de preferencia entre las selecciones de instancias que agregues para el MIG.

      3. Repite los siguientes pasos para cada tipo de máquina que quieras agregar a la selección de instancias.

        1. Haz clic en Agregar tipo de máquina.

        2. En el panel Agregar tipo de máquina, selecciona la Serie del tipo de máquina que deseas agregar.

        3. En la lista Tipo de máquina, selecciona el tipo de máquina.

        4. Haz clic en Listo.

          Si un tipo de máquina seleccionado no es compatible con la configuración del disco o de la plataforma de CPU en la plantilla de instancias, la consola muestra un mensaje de validación, como un mensaje que indica que el tipo de disco no se puede usar como disco de arranque con el tipo de máquina seleccionado. Para resolver este problema, configura las anulaciones en los siguientes pasos.

      4. Para anular la plataforma de CPU mínima especificada en la plantilla de instancias, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular la plataforma de CPU para esta selección.

        2. En la lista Plataforma de CPU, selecciona la plataforma que deseas usar para la selección de instancias. Como alternativa, para seleccionar automáticamente cualquier plataforma de CPU compatible con los tipos de máquinas elegidos, selecciona Automático.

      5. Para anular la configuración de disco especificada en la plantilla de instancias o para conectar almacenamiento, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular discos.

        2. Para anular el disco de arranque, en la sección Disco de arranque, haz clic en Cambiar y sigue las indicaciones.

        3. Para conectar el almacenamiento, haz clic en Agregar disco nuevo o Conectar disco existente y sigue las indicaciones.

      6. En la sección Selección de instancias nuevas, después de agregar los tipos de máquinas y las anulaciones, haz clic en Listo.

    2. Para agregar la siguiente selección de instancias, haz clic en Agregar selección de instancias y repite los pasos para cada selección de instancias que desees agregar en el MIG.

    3. En la ventana Selecciones de instancias, después de completar la adición de las selecciones de instancias, haz clic en Listo.

  7. Deja los demás campos con la configuración predeterminada o modifícalos según sea necesario.

  8. Haz clic en Crear.

gcloud

Para crear un MIG regional con varios tipos de máquinas, preferencias y anulaciones, usa el comando instance-groups managed create.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --force-update-on-repair \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --instance-flexibility-policy='{"instanceSelections": \
        {"INSTANCE_SELECTION_1":{"rank":RANK_1,"machineTypes":["MACHINE_TYPE_1","MACHINE_TYPE_2"],"minCpuPlatform":"MIN_CPU_PLATFORM_1","disks":[{"deviceName":"BOOT_DISK_DEVICE_NAME_1","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}, \
        "INSTANCE_SELECTION_2":{"rank":RANK_2,"machineTypes":["MACHINE_TYPE_3","MACHINE_TYPE_4"],"minCpuPlatform":"MIN_CPU_PLATFORM_2","disks":[{"deviceName":"BOOT_DISK_DEVICE_NAME_2","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}}}'

Si solo necesitas establecer preferencias (clasificaciones) y no requieres anulaciones de la plataforma de CPU o del disco, puedes usar la marca --instance-selection repetida para cada selección. Por ejemplo:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --instance-selection "name=INSTANCE_SELECTION_1,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2,rank=RANK_1" \
    --instance-selection "name=INSTANCE_SELECTION_2,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4,rank=RANK_2"

También puedes usar un archivo YAML o JSON para configurar la política de flexibilidad de instancias. Para hacerlo, usa la marca --flags-file en lugar de la marca --instance-flexibility-policy y especifica el nombre del archivo. Por ejemplo, usa --flags-file=FILE_NAME.yaml.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --region REGION \
    --size TARGET_SIZE \
    --template INSTANCE_TEMPLATE_URL \
    --force-update-on-repair \
    --target-distribution-shape SHAPE \
    --instance-redistribution-type none \
    --flags-file=FILE_NAME.yaml

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • REGION: Es la región en la que deseas crear el MIG.
  • TARGET_SIZE: Es la cantidad de VMs que deseas que el MIG cree y mantenga.
  • INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:
    • Para una plantilla de instancias regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para una plantilla de instancias global: INSTANCE_TEMPLATE_ID
  • SHAPE: Es la forma de distribución objetivo. El valor puede ser balanced, any o any-single-zone. No se admiten las otras formas de distribución objetivo.
  • INSTANCE_SELECTION: es el nombre de la lista de tipos de máquinas.
  • MACHINE_TYPE: los tipos de máquina que deseas configurar en el MIG.
  • MIN_CPU_PLATFORM: Es la plataforma de CPU mínima para las instancias.
  • BOOT_DISK_DEVICE_NAME: Es el nombre del dispositivo para el disco de arranque.
  • IMAGE_PROJECT: Es el ID del proyecto de la imagen de origen.
  • IMAGE_NAME: Es el nombre de la imagen de origen.
  • RANK: Es un número que representa tu orden de preferencia para la selección de instancias. Un valor más bajo significa una preferencia más alta.

Terraform

Si aún no creaste una plantilla de instancias, en la que se especifican las propiedades de VM que quieres para cada VM en tu MIG, crea una plantilla de instancias.

Para crear un MIG regional con varios tipos de máquinas, preferencias y anulaciones, usa el recurso google_compute_region_instance_group_manager.

resource "google_compute_region_instance_group_manager" "default" {
  provider           = google-beta
  name               = "flex-igm"
  base_instance_name = "flex-igm-instance"
  region             = "us-central1"

  target_size                      = 2
  distribution_policy_target_shape = "ANY"

  version {
    instance_template = google_compute_instance_template.default.id
  }

  instance_flexibility_policy {
    instance_selections {
      name          = "first-preference"
      rank          = 1
      machine_types = ["n4-standard-4"]
      disks {
        auto_delete  = true
        device_name  = "boot"
        boot         = true
        source_image = "projects/debian-cloud/global/images/family/debian-12"
        disk_size_gb = 10
        disk_type    = "hyperdisk-balanced"
      }
    }

    instance_selections {
      name             = "second-preference"
      rank             = 2
      machine_types    = ["n2-standard-4"]
      min_cpu_platform = "Intel Ice Lake"
      disks {
        auto_delete  = true
        device_name  = "boot"
        boot         = true
        source_image = "projects/debian-cloud/global/images/family/debian-12"
        disk_size_gb = 10
        disk_type    = "pd-ssd"
      }
    }
  }

  instance_lifecycle_policy {
    force_update_on_repair = "YES"
  }

  update_policy {
    instance_redistribution_type = "NONE"
    type                         = "OPPORTUNISTIC"
    minimal_action               = "REPLACE"
    max_surge_fixed              = 0
    max_unavailable_fixed        = 6
  }
}

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

REST

Para crear un MIG regional con varios tipos de máquinas, preferencias y anulaciones, realiza una solicitud POST al método regionInstanceGroupManagers.insert.

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

{
"name": "INSTANCE_GROUP_NAME",
"targetSize": "TARGET_SIZE",
"instanceTemplate": "INSTANCE_TEMPLATE_URL",
"distributionPolicy": {
  "targetShape": "SHAPE"
},
"updatePolicy": {
  "instanceRedistributionType": "NONE"
},
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES",
},
"instanceFlexibilityPolicy": {
  "instanceSelections": {
    "INSTANCE_SELECTION_1": {
      "machineTypes": ["MACHINE_TYPE_1", "MACHINE_TYPE_2", …],
      "minCpuPlatform": "MIN_CPU_PLATFORM_1",
      "disks": [
        {
          "deviceName": "BOOT_DISK_DEVICE_NAME_1",
          "initializeParams": {
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
          },
          "boot": true
        }
      ],
      "rank": RANK_1
    },
    "INSTANCE_SELECTION_2": {
      "machineTypes": ["MACHINE_TYPE_3", "MACHINE_TYPE_4", …],
      "minCpuPlatform": "MIN_CPU_PLATFORM_2",
      "disks": [
        {
          "deviceName": "BOOT_DISK_DEVICE_NAME_2",
          "initializeParams": {
            "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
          },
          "boot": true
        }
      ],
      "rank": RANK_2
    }
  }
}
}

Si solo necesitas establecer preferencias (clasificaciones) y no requieres anulaciones de la plataforma de CPU o disco, puedes omitir minCpuPlatform y disks del cuerpo de la solicitud. Por ejemplo:

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

{
"name": "INSTANCE_GROUP_NAME",
"targetSize": "TARGET_SIZE",
"instanceTemplate": "INSTANCE_TEMPLATE_URL",
"distributionPolicy": {
  "targetShape": "SHAPE"
},
"updatePolicy": {
  "instanceRedistributionType": "NONE"
},
"instanceFlexibilityPolicy": {
  "instanceSelections": {
    "INSTANCE_SELECTION_1": {
      "machineTypes": [
        "MACHINE_TYPE_1",
        "MACHINE_TYPE_2"
      ],
      "rank": RANK_1
    },
    "INSTANCE_SELECTION_2": {
      "machineTypes": [
        "MACHINE_TYPE_3",
        "MACHINE_TYPE_4"
      ],
      "rank": RANK_2
    }
  }
}
}

Los MIG zonales no admiten la flexibilidad de instancias. Sin embargo, si deseas crear un MIG en una sola zona, configura la forma de distribución objetivo como ANY_SINGLE_ZONE. Además, si deseas una zona específica, usa la forma de distribución ANY_SINGLE_ZONE y, luego, incluye el campo distributionPolicy.zones[].zone en la solicitud.

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región en la que deseas crear el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • TARGET_SIZE: Es la cantidad de VMs que deseas que el MIG cree y mantenga.
  • INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:
    • Para una plantilla de instancias regional: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Para una plantilla de instancias global: INSTANCE_TEMPLATE_ID
  • SHAPE: Es la forma de distribución objetivo. El valor puede ser BALANCED, ANY o ANY_SINGLE_ZONE. No se admiten las otras formas de distribución objetivo.
  • INSTANCE_SELECTION: es el nombre de la lista de tipos de máquinas.
  • MACHINE_TYPE: los tipos de máquina que deseas configurar en el MIG.
  • MIN_CPU_PLATFORM: Es la plataforma de CPU mínima para las instancias.
  • BOOT_DISK_DEVICE_NAME: Es el nombre del dispositivo para el disco de arranque.
  • IMAGE_PROJECT: Es el ID del proyecto de la imagen de origen.
  • IMAGE_NAME: Es el nombre de la imagen de origen.
  • RANK: Es un número que representa tu orden de preferencia para la selección de instancias. Un valor más bajo significa una preferencia más alta.

Agrega flexibilidad de instancias a un MIG existente

Puedes agregar flexibilidad de instancias a un MIG existente. Puedes establecer varios tipos de máquinas y también establecer preferencias para ciertos tipos de máquinas.

Si tu MIG ya tiene VMs, estas seguirán usando el tipo de máquina especificado en la plantilla de instancias. Si deseas que las VMs existentes en el MIG usen los tipos de máquinas de la política de flexibilidad de instancias, después de agregar la política, borra las VMs existentes y, luego, cambia el tamaño del MIG a la cantidad de VMs requerida. Cuando se cambie el tamaño, las VMs nuevas usarán los tipos de máquina de la política.

Para modificar una política de flexibilidad de instancias existente, consulta Cambia la configuración de flexibilidad de instancias.

Agrega flexibilidad de instancias a un MIG de una de las siguientes maneras:

Agrega varios tipos de máquinas

Si tus tipos de máquinas comparten las configuraciones de disco y plataforma de CPU de la plantilla de instancias, y no necesitas clasificarlos por preferencia, usa una de las siguientes opciones:

Console

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

    Ir a Grupos de instancias

  2. Haz clic en el nombre del MIG en el que deseas establecer varios tipos de máquinas.

  3. Haz clic en Editar.

  4. Haz clic en Flexibilidad de instancias para expandir la sección.

  5. En la sección Selecciones de instancias, haz clic en Agregar selecciones.

    Se abrirá la ventana Selecciones de instancias.

    1. En la sección Selección de instancia nueva, haz lo siguiente:

      1. En el campo Nombre, ingresa un nombre para la selección de instancias. Como en este ejemplo crearás una selección de instancia única, puedes mantener el valor predeterminado para el campo Rango.

      2. Repite los siguientes pasos para cada tipo de máquina que quieras agregar a la selección de instancias.

        1. Haz clic en Agregar tipo de máquina.

        2. En el panel Agregar tipo de máquina, selecciona la Serie del tipo de máquina que deseas agregar.

        3. En la lista Tipo de máquina, selecciona el tipo de máquina.

        4. Haz clic en Listo.

          Si un tipo de máquina seleccionado no es compatible con la configuración del disco o de la plataforma de CPU en la plantilla de instancias, la consola muestra un mensaje de validación, como un mensaje que indica que el tipo de disco no se puede usar como disco de arranque con el tipo de máquina seleccionado. Para resolver este problema, configura las anulaciones en los siguientes pasos.

      3. Para anular la plataforma de CPU mínima especificada en la plantilla de instancias, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular la plataforma de CPU para esta selección.

        2. En la lista Plataforma de CPU, selecciona la plataforma que deseas usar para la selección de instancias. Como alternativa, para seleccionar automáticamente cualquier plataforma de CPU compatible con los tipos de máquinas elegidos, selecciona Automático.

      4. Para anular la configuración de disco especificada en la plantilla de instancias o para conectar almacenamiento, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular discos.

        2. Para anular el disco de arranque, en la sección Disco de arranque, haz clic en Cambiar y sigue las indicaciones.

        3. Para conectar el almacenamiento, haz clic en Agregar disco nuevo o Conectar disco existente y sigue las indicaciones.

      5. En la sección Selección de instancias nuevas, después de agregar los tipos de máquinas y las anulaciones, haz clic en Listo.

    2. En la ventana Selecciones de instancias, haz clic en Listo.

  6. Haz clic en Guardar.

gcloud

Para agregar varios tipos de máquinas a un MIG existente, usa el comando instance-groups managed update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --instance-selection-machine-types MACHINE_TYPE,MACHINE_TYPE,...

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • REGION: Es la región en la que se encuentra el MIG.
  • MACHINE_TYPE: los tipos de máquina que deseas configurar en el MIG.

REST

Para agregar varios tipos de máquinas a un MIG existente, realiza una solicitud PATCH al método regionInstanceGroupManagers.patch.

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

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
    "INSTANCE_SELECTION": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
          ...
        ]
      }
    }
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • INSTANCE_SELECTION: es el nombre de la lista de tipos de máquinas.
  • MACHINE_TYPE: los tipos de máquina que deseas configurar en el MIG.
  • RANK: Es un número que representa tu orden de preferencia para la selección de instancias. Un valor más bajo significa una preferencia más alta.

Agrega varios tipos de máquinas, preferencias y anulaciones adicionales

Cuando agregas varios tipos de máquinas en un MIG, puedes establecer preferencias (clasificaciones) para los tipos de máquinas y anular las definiciones de plataforma de CPU mínima y disco para cada selección de instancia. Por ejemplo, si la plantilla de instancias especifica un Persistent Disk y seleccionas una serie de máquinas N4, debes anular el disco de arranque con un tipo de Google Cloud Hyperdisk compatible. Para conocer los tipos de discos compatibles con las series de máquinas, consulta Compatibilidad de las series de máquinas con discos persistentes y Compatibilidad de las series de máquinas con Hyperdisk.

Cuando agregues o actualices las anulaciones de configuración de la plataforma de CPU y del disco en un MIG existente, debes asegurarte de lo siguiente:

  • Cada tipo de máquina de la selección de instancias admite las configuraciones de plataforma de CPU y disco efectivas.

  • La actualización en la reparación está habilitada.

Para agregar varios tipos de máquinas, preferencias y anulaciones a un MIG existente, selecciona una de las siguientes opciones:

Console

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

    Ir a Grupos de instancias

  2. Haz clic en el nombre del MIG en el que deseas establecer varios tipos de máquinas.

  3. Haz clic en Editar.

  4. Haz clic en Flexibilidad de instancias para expandir la sección.

  5. En la sección Selecciones de instancias, haz clic en Agregar selecciones.

    Se abrirá la ventana Selecciones de instancias.

    1. En la sección Selección de instancia nueva, haz lo siguiente:

      1. En el campo Nombre, ingresa un nombre para la selección de instancias. Como en este ejemplo crearás una selección de instancia única, puedes mantener el valor predeterminado para el campo Rango.

      2. En el campo Rango, ingresa el orden de preferencia entre las selecciones de instancias que agregues para el MIG.

      3. Repite los siguientes pasos para cada tipo de máquina que quieras agregar a la selección de instancias.

        1. Haz clic en Agregar tipo de máquina.

        2. En el panel Agregar tipo de máquina, selecciona la Serie del tipo de máquina que deseas agregar.

        3. En la lista Tipo de máquina, selecciona el tipo de máquina.

        4. Haz clic en Listo.

          Si un tipo de máquina seleccionado no es compatible con la configuración del disco o de la plataforma de CPU en la plantilla de instancias, la consola muestra un mensaje de validación, como un mensaje que indica que el tipo de disco no se puede usar como disco de arranque con el tipo de máquina seleccionado. Para resolver este problema, configura las anulaciones en los siguientes pasos.

      4. Para anular la plataforma de CPU mínima especificada en la plantilla de instancias, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular la plataforma de CPU para esta selección.

        2. En la lista Plataforma de CPU, selecciona la plataforma que deseas usar para la selección de instancias. Como alternativa, para seleccionar automáticamente cualquier plataforma de CPU compatible con los tipos de máquinas elegidos, selecciona Automático.

      5. Para anular la configuración de disco especificada en la plantilla de instancias o para conectar almacenamiento, haz lo siguiente:

        1. Selecciona la casilla de verificación Anular discos.

        2. Para anular el disco de arranque, en la sección Disco de arranque, haz clic en Cambiar y sigue las indicaciones.

        3. Para conectar el almacenamiento, haz clic en Agregar disco nuevo o Conectar disco existente y sigue las indicaciones.

      6. En la sección Selección de instancias nuevas, después de agregar los tipos de máquinas y las anulaciones, haz clic en Listo.

    2. Para agregar la siguiente selección de instancias, haz clic en Agregar selección de instancias y repite los pasos para cada selección de instancias que desees agregar en el MIG.

    3. En la ventana Selecciones de instancias, después de completar la adición de las selecciones de instancias, haz clic en Listo.

  6. Haz clic en Guardar.

gcloud

Para agregar varios tipos de máquinas, preferencias y anulaciones de propiedades de instancias a un MIG existente, usa el comando instance-groups managed update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --force-update-on-repair \
    --instance-flexibility-policy='{"instanceSelections": \
        {"INSTANCE_SELECTION_1":{"rank":RANK_1,"machineTypes":["MACHINE_TYPE_1","MACHINE_TYPE_2"],"minCpuPlatform":"MIN_CPU_PLATFORM_1","disks":[{"deviceName":"BOOT_DISK_DEVICE_NAME_1","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}, \
        "INSTANCE_SELECTION_2":{"rank":RANK_2,"machineTypes":["MACHINE_TYPE_3","MACHINE_TYPE_4"],"minCpuPlatform":"MIN_CPU_PLATFORM_2","disks":[{"deviceName":"BOOT_DISK_DEVICE_NAME_2","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}}}'

Si solo necesitas establecer preferencias (clasificaciones) y no requieres anulaciones de la plataforma de CPU o del disco, puedes usar la marca --instance-selection repetida para cada selección. Por ejemplo:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --instance-selection "name=INSTANCE_SELECTION_1,machine-type=MACHINE_TYPE_1,machine-type=MACHINE_TYPE_2,rank=RANK_1" \
    --instance-selection "name=INSTANCE_SELECTION_2,machine-type=MACHINE_TYPE_3,machine-type=MACHINE_TYPE_4,rank=RANK_2"

También puedes usar un archivo YAML o JSON para configurar la política de flexibilidad de instancias. Para hacerlo, usa la marca --flags-file en lugar de la marca --instance-flexibility-policy y especifica el nombre del archivo. Por ejemplo, usa --flags-file=FILE_NAME.yaml.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --region REGION \
    --force-update-on-repair \
    --flags-file=FILE_NAME.yaml

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • REGION: Es la región en la que se encuentra el MIG.
  • INSTANCE_SELECTION: es el nombre de la lista de tipos de máquinas.
  • MACHINE_TYPE: los tipos de máquina que deseas configurar en el MIG.
  • MIN_CPU_PLATFORM: Es la plataforma de CPU mínima para las instancias.
  • BOOT_DISK_DEVICE_NAME: Es el nombre del dispositivo para el disco de arranque.
  • IMAGE_PROJECT: Es el ID del proyecto de la imagen de origen.
  • IMAGE_NAME: Es el nombre de la imagen de origen.
  • RANK: Es un número que representa tu orden de preferencia para la selección de instancias. Un valor más bajo significa una preferencia más alta.

REST

Para agregar varios tipos de máquinas, preferencias y anulaciones de propiedades de instancias a un MIG existente, realiza una solicitud PATCH al método regionInstanceGroupManagers.patch.

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

{
  "instanceLifecyclePolicy": {
    "forceUpdateOnRepair": "YES",
  },
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ],
        "minCpuPlatform": "MIN_CPU_PLATFORM_1",
        "disks": [
          {
            "deviceName": "BOOT_DISK_DEVICE_NAME_1",
            "initializeParams": {
              "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
            },
            "boot": true
          }
        ],
        "rank": RANK_1
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3",
          "MACHINE_TYPE_4"
        ],
        "minCpuPlatform": "MIN_CPU_PLATFORM_2",
        "disks": [
          {
            "deviceName": "BOOT_DISK_DEVICE_NAME_2",
            "initializeParams": {
              "sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"
            },
            "boot": true
          }
        ],
        "rank": RANK_2
      }
    }
  }
}

Si solo necesitas establecer preferencias (clasificaciones) y no requieres anulaciones de la plataforma de CPU o del disco, puedes omitir minCpuPlatform y disks del cuerpo de la solicitud. Por ejemplo:

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

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "INSTANCE_SELECTION_1": {
        "machineTypes": [
          "MACHINE_TYPE_1",
          "MACHINE_TYPE_2"
        ],
        "rank": RANK_1
      },
      "INSTANCE_SELECTION_2": {
        "machineTypes": [
          "MACHINE_TYPE_3",
          "MACHINE_TYPE_4"
        ],
        "rank": RANK_2
      }
    }
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG.
  • INSTANCE_SELECTION: es el nombre de la lista de tipos de máquinas.
  • MACHINE_TYPE: los tipos de máquina que deseas configurar en el MIG.
  • MIN_CPU_PLATFORM: Es la plataforma de CPU mínima para las instancias.
  • BOOT_DISK_DEVICE_NAME: Es el nombre del dispositivo para el disco de arranque.
  • IMAGE_PROJECT: Es el ID del proyecto de la imagen de origen.
  • IMAGE_NAME: Es el nombre de la imagen de origen.
  • RANK: Es un número que representa tu orden de preferencia para la selección de instancias. Un valor más bajo significa una preferencia más alta.

Ejemplo de archivo YAML para configurar la flexibilidad de instancias

Puedes usar un archivo YAML o JSON para configurar la política de flexibilidad de instancias. Para hacerlo, usa la marca --flags-file en el comando de gcloud CLI y especifica el nombre del archivo. Por ejemplo, usa --flags-file=FILE_NAME.yaml.

A continuación, se muestra un ejemplo de un archivo YAML:

--instance-flexibility-policy:
  instanceSelections:
    first-preference:
      rank: 1
      machineTypes:
        - n2-standard-8
      minCpuPlatform: "Intel Ice Lake"
      disks:
        - deviceName: data-disk
          boot: false
          initializeParams:
            sourceImage: projects/debian-cloud/global/images/debian-12
            diskType: pd-ssd

¿Qué sigue?