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

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 las clasificaciones 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 no se modificarán. Cuando realices cambios en una selección de instancias, debes especificar su configuración completa durante la edición. Si no especificas la configuración completa, el MIG reemplazará las partes no especificadas de la selección de instancias. Por ejemplo, si quieres cambiar solo una clasificación, especifica la nueva clasificación 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áquinas quitados siguen 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 Cómo actualizar 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 Selección de instancias, haz clic en Editar selección de instancias.

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

    Cuando edites 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 Rango.
    • Agrega un nuevo tipo de máquina a la selección. Para ello, haz clic en Agregar tipo de máquina.
    • Quita los 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 Selección de instancias, haz clic en Listo.

  8. Haz clic en Guardar para aplicar los cambios.

gcloud

Para editar una configuración de flexibilidad de instancias, 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 instancia en la que deseas realizar los cambios. Debes especificar tanto MACHINE_TYPE como RANK. Si no vas a cambiar ninguno de estos, debes proporcionar los valores existentes para retenerlos.

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 instancia en la que deseas realizar los cambios. Debes especificar tanto MACHINE_TYPE como RANK. Si no vas a cambiar ninguno de estos, debes proporcionar los valores existentes para retenerlos.

Quita la configuración de flexibilidad de instancias

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

  • Para quitar todas las selecciones de instancias de 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. De esta manera, se quitan solo las selecciones de instancias específicas, y el MIG retiene las demás.

Después de quitar las selecciones de instancias, las VMs existentes que usan los tipos de máquinas de las selecciones de instancias quitadas siguen usando el mismo tipo de máquina. Para que se apliquen los cambios, debes actualizar o volver a crear esas VMs. Para obtener más información, consulta Cómo actualizar 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, 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 Selección de instancias, haz clic en Editar selección de instancias.

  5. En la ventana Selección 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.

Quita selecciones de instancias específicas

Para quitar selecciones de instancias específicas, 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 Selección de instancias, haz clic en Editar selección de instancias.

  5. En la ventana Selección 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 de nombres separados por comas.

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 la instancia, 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?