Cambia o quita la flexibilidad de las instancias

En este documento, se describe cómo realizar cambios o quitar la flexibilidad de instancias en un grupo de instancias administrado (MIG) editando la política de flexibilidad de instancias. También se describe cómo actualizar el tipo de máquina de una VM cuando se quita de la configuración de flexibilidad de instancias.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . 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. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    2. Set a default region and zone.

    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 gcloud CLI.

      Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

    Si deseas obtener más información, consulta Autentica para usar REST en la Google Cloud documentación de autenticación.

Cambia la configuración de flexibilidad de instancias

Puedes realizar los siguientes cambios editando la configuración de flexibilidad de instancias en un MIG:

  • Agrega un tipo de máquina a una selección de instancias
  • Quita un tipo de máquina de una selección de instancias
  • Cambia la clasificación de las selecciones de instancias
  • Agrega una selección de instancias

El MIG aplica los cambios según los nombres de selección de instancias que especifiques. Las selecciones de instancias que no especifiques permanecerán sin cambios. Cuando realices cambios en la selección de una instancia, deberás especificar su configuración completa durante la edición. Si no especificas la configuración completa, el MIG sobrescribirá las partes no especificadas de la selección de instancias. Por ejemplo, si solo quieres cambiar un rango, especifica el rango nuevo junto con los tipos de máquinas establecidos en esa selección. Para ver la configuración existente, consulta Cómo ver la flexibilidad de la instancia.

Después de quitar un tipo de máquina de la configuración, las VMs existentes con los tipos de máquina quitados seguirán usándolos. Si deseas cambiar los tipos de máquina de esas VMs, debes actualizar o volver a crear las VMs específicas. Para obtener más información, consulta Actualiza el tipo de máquina de una VM para usar la configuración más reciente.

Para cambiar la configuración de flexibilidad de instancias en un MIG, selecciona una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , 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 cambiar la flexibilidad de la instancia.

  3. Haz clic en Editar.

  4. En la sección Selecciones de instancias, haz clic en Editar selecciones de instancias.

  5. En la ventana Selecciones de instancias, haz clic en el ícono de Alternar de una selección de instancias para abrir la vista Editar selección de instancias.

    Cuando editas una selección de instancias, puedes realizar los siguientes cambios:

    • Cambia el nombre y la clasificación de la selección de instancias. Para ello, edita los valores en los campos Nombre y Clasificación.
    • Agrega un tipo de máquina nuevo a la selección. Para ello, haz clic en Agregar tipo de máquina.
    • Quita tipos de máquinas. Para ello, selecciona los tipos de máquinas y, luego, haz clic en Quitar.

  6. Modifica la selección según sea necesario y haz clic en Listo.

  7. Después de completar los cambios en la ventana Selecciones de instancias, haz clic en Listo.

  8. Haz clic en Guardar para aplicar los cambios.

gcloud

Para editar la configuración de flexibilidad de una instancia, usa el comando instance-groups managed update.

  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"

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG en el que deseas verificar la configuración de flexibilidad de instancias.
  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_SELECTION: Es el nombre de la selección de instancias en la que deseas realizar los cambios. Debes especificar tanto MACHINE_TYPE como RANK. Si no cambias ninguno de estos valores, debes proporcionar los valores existentes para conservarlos.

REST

Para editar la configuración de flexibilidad de una instancia, 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"
          ],
          "rank": RANK
        }
      }
    }
  }

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG en el que deseas verificar la configuración de flexibilidad de instancias.
  • INSTANCE_SELECTION: Es el nombre de la selección de instancias en la que deseas realizar los cambios. Debes especificar tanto MACHINE_TYPE como RANK. Si no cambias ninguno de estos valores, debes proporcionar los valores existentes para conservarlos.

Quita la configuración de flexibilidad de instancias

Puedes quitar todas las selecciones de instancias o selecciones específicas en un MIG.

  • Para quitar todas las selecciones de instancias en un MIG, consulta Cómo quitar todas las selecciones de instancias. Cuando quitas todas las selecciones de instancias, el MIG usa el tipo de máquina especificado en la plantilla de instancias para crear VMs nuevas en el grupo.

  • Para quitar selecciones de instancias individuales por nombre, consulta Cómo quitar selecciones de instancias específicas. Esta acción solo quita las selecciones de instancias específicas, y el MIG conserva las demás.

Después de quitar las selecciones de instancias, las VMs existentes que usan los tipos de máquina de las selecciones de instancias quitadas seguirán usando el mismo tipo de máquina. Para que los cambios se apliquen, debes actualizar o volver a crear esas VMs. Para obtener más información, consulta Actualiza el tipo de máquina de una VM para usar la configuración más reciente.

Quita todas las selecciones de instancias

Para quitar todas las selecciones de instancias, elige una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , 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 cambiar la flexibilidad de la instancia.

  3. Haz clic en Editar.

  4. En la sección Selecciones de instancias, haz clic en Editar selecciones de instancias.

  5. En la ventana Selecciones de instancias, haz clic en el ícono Borrar junto a cada selección de instancia.

  6. Haz clic en Listo.

  7. Haz clic en Guardar.

gcloud

Para quitar todas las selecciones de instancias en un MIG, usa el comando instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections-all

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG del que deseas quitar todas las selecciones de instancias.
  • REGION: la región en la que se encuentra el MIG.

REST

Para quitar todas las selecciones de instancias en un MIG, 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": null
    }
  }

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG del que deseas quitar una selección de instancias.

Cómo quitar selecciones de instancias específicas

Para quitar selecciones de instancias específicas, elige una de las siguientes opciones:

Console

  1. En la consola de Google Cloud , 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 cambiar la flexibilidad de la instancia.

  3. Haz clic en Editar.

  4. En la sección Selecciones de instancias, haz clic en Editar selecciones de instancias.

  5. En la ventana Selecciones de instancias, haz clic en el ícono Borrar junto a la selección de instancias que deseas quitar.

  6. Haz clic en Listo.

  7. Haz clic en Guardar.

gcloud

Para quitar selecciones de instancias específicas en un MIG, usa el comando instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections INSTANCE_SELECTION

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG del que deseas quitar una selección de instancias.
  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_SELECTION: Es el nombre de la selección de instancia que deseas quitar. Si hay varias selecciones de instancias, proporciona una lista separada por comas de los nombres.

REST

Para quitar selecciones de instancias específicas en un MIG, usa el método regionInstanceGroupManagers.patch.

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

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION": null
      }
    }
  }

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG del que deseas quitar una selección de instancias.
  • INSTANCE_SELECTION: Es el nombre de la selección de instancia que deseas quitar. Si hay varias selecciones de instancias, especifícalas todas. Por ejemplo, "selection-1": null,"selection-2": null

Actualiza el tipo de máquina de una VM para usar la configuración más reciente

Si alguna VM de un MIG usa un tipo de máquina que se quitó de la configuración de flexibilidad de instancias, debes actualizar o volver a crear la VM para actualizar su tipo de máquina.

Para actualizar o volver a crear una VM, usa una de las siguientes opciones:

  • Actualiza las VMs con el método regionInstanceGroupManagers.applyUpdatesToInstances. Cuando uses el método applyUpdatesToInstances, el campo mostDisruptiveAllowedAction debe ser RESTART O REPLACE.

  • Vuelve a crear las VMs con el método regionInstanceGroupManagers.recreateInstances.

  • Para volver a crear las VMs, primero bórralas y, luego, cambia el tamaño del MIG a la cantidad requerida de VMs.

¿Qué sigue?