Flexibilidad de las instancias

En este documento, se describe cómo ver la configuración de flexibilidad de instancias en un grupo de instancias administrado (MIG) y los tipos de máquinas que usa cada VM del grupo.

Después de agregar o cambiar la flexibilidad de instancias en un MIG, puedes hacer lo siguiente:

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.

Consulta la configuración de flexibilidad de instancias

Console

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

    Ir a Grupos de instancias

  2. En la columna Nombre, haz clic en el nombre del MIG cuya configuración de flexibilidad de instancias deseas ver.

    Se abrirá la página de resumen del MIG.

  3. Haz clic en la pestaña Detalles.

    En la sección Flexibilidad de instancias, la tabla Selecciones de instancias muestra el nombre, el rango y los tipos de máquinas de una selección de instancias. Si el MIG no tiene configurada la flexibilidad de instancias, no se mostrará la sección Flexibilidad de instancias.

gcloud

Para ver la configuración de flexibilidad de la instancia, usa el comando instance-groups managed describe. Incluye la marca --format para filtrar las propiedades instanceFlexibilityPolicy.instanceSelections.

  gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
      --region REGION \
      --format="json(instanceFlexibilityPolicy.instanceSelections)"

El siguiente es un resultado de muestra:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Si un MIG no tiene configurada la flexibilidad de instancias, el resultado muestra null.

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: Es el nombre del MIG cuya configuración de flexibilidad de instancias deseas ver.
  • REGION: la región en la que se encuentra el MIG.

REST

Para ver la configuración de flexibilidad de la instancia, usa el método regionInstanceGroupManagers.get. Incluye el parámetro fields en la URL de la solicitud para filtrar las propiedades instanceFlexibilityPolicy.instanceSelections.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections

El siguiente es un resultado de muestra:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Si un MIG no tiene configurada la flexibilidad de instancias, el resultado muestra null.

Reemplaza lo siguiente:

  • PROJECT_ID es el ID de tu proyecto.
  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG cuya configuración de flexibilidad de instancias deseas ver.

Consulta los tipos de máquinas que usa cada VM

Console

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

    Ir a Grupos de instancias

  2. En la columna Nombre, haz clic en el nombre del MIG en el que deseas ver los tipos de máquinas que usa cada VM.

    Se abrirá la página Descripción general del MIG, en la que se enumeran todas las VMs del grupo, sus tipos de máquinas y otros detalles.

gcloud

Para ver los tipos de máquinas que usa cada VM en un MIG, enumera las VMs con el comando instance-groups managed list-instances y, luego, incluye la marca --format para filtrar el campo propertiesFromFlexibilityPolicy.machineType. También puedes filtrar otros campos según sea necesario.

  gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      --region REGION \
      --format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'

El siguiente es un resultado de muestra:

NAME: example-mig-0md2
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

NAME: example-mig-vbgg
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

Reemplaza lo siguiente:

  • REGION: la región en la que se encuentra el MIG.
  • INSTANCE_GROUP_NAME: Es el nombre del MIG cuya configuración de flexibilidad de instancias deseas ver.

REST

Para ver los tipos de máquinas que usa cada VM en un MIG, enumera las VMs con el método listManagedInstances y verifica el campo propertiesFromFlexibilityPolicy.machineType en la respuesta.

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

A continuación, se muestra un ejemplo de resultado. Busca el campo propertiesFromFlexibilityPolicy en el que se configura el campo machineType de una VM.

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-0md2",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-vbgg",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    }
  ]
}

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 cuya configuración de flexibilidad de instancias deseas ver.

¿Qué sigue?