Reducir la latencia usando políticas de colocación compacta

En este documento, se describe cómo reducir la latencia de red entre tus instancias de Compute Engine a través de la creación y aplicación de políticas de posición compacta. Para obtener más información sobre las políticas de posición, incluidas las series de máquinas compatibles, las restricciones y los precios, consulta la Descripción general de las políticas de posición.

Una política de posición de compactación especifica que tus instancias deben colocarse físicamente más cerca entre sí. Esto puede ayudar a mejorar el rendimiento y reducir la latencia de red entre tus instancias cuando, por ejemplo, ejecutas cargas de trabajo de computación de alto rendimiento (HPC), aprendizaje automático (AA) o servidor de base de datos.

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 Trusted Cloud 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:

    Select the tab for how you plan to use the samples on this page:

    gcloud

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

      gcloud init
    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 y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando: 

      gcloud init

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

Roles requeridos

Para obtener los permisos que necesitas para crear y aplicar una política de posición de compacta a las instancias de procesamiento, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear y aplicar una política de posición compacta a las instancias de procesamiento. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear y aplicar una política de posición compacta a las instancias de procesamiento:

  • Para crear políticas de posición: compute.resourcePolicies.create en el proyecto
  • Para aplicar una política de posición a las instancias existentes: compute.instances.addResourcePolicies en el proyecto
  • Para crear instancias, haz lo siguiente:
    • compute.instances.create en el proyecto
    • Para usar una imagen personalizada con el fin de crear la VM, sigue estos pasos: compute.images.useReadOnly en la imagen
    • Si deseas usar una instantánea para crear la VM, sigue estos pasos: compute.snapshots.useReadOnly en la instantánea
    • Para usar una plantilla de instancias a fin de crear la VM, haz lo siguiente: compute.instanceTemplates.useReadOnly en la plantilla de instancias
    • Para asignar una red heredada a la VM: compute.networks.use en el proyecto
    • Si deseas especificar una dirección IP estática para la VM; compute.addresses.use en el proyecto
    • Para asignar una dirección IP externa a la VM cuando se usa una red y punto heredado; compute.networks.useExternalIp en el proyecto
    • A fin de especificar una subred para la VM: compute.subnetworks.use en el proyecto o en la subred elegida
    • Para asignar una dirección IP externa a la VM cuando se usa una red de VPC, compute.subnetworks.useExternalIp en el proyecto o en la subred elegida
    • A fin de configurar los metadatos de la instancia de VM para la VM y los puntos, sigue estos pasos: compute.instances.setMetadata en el proyecto
    • A fin de configurar etiquetas para la VM y los puntos; compute.instances.setTags en la VM
    • Si deseas configurar etiquetas para la VM, haz lo siguiente: compute.instances.setLabels en la VM
    • A fin de configurar una cuenta de servicio para que la VM la usecompute.instances.setServiceAccount en la VM
    • Si deseas crear un disco nuevo para la VM: compute.disks.create en el proyecto
    • Para conectar un disco existente en modo de solo lectura o de lectura y escritura, haz lo siguiente: compute.disks.use en el disco
    • Para conectar un disco existente en modo de solo lectura y dos puntos, sigue estos pasos: compute.disks.useReadOnly en el disco
  • Para crear una reserva: compute.reservations.create en el proyecto
  • Para crear una plantilla de instancias: compute.instanceTemplates.create en el proyecto
  • Para crear un grupo de instancias administrado (MIG): compute.instanceGroupManagers.create en el proyecto
  • Para ver los detalles de una instancia, haz clic en compute.instances.get en el proyecto.

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Crea una política de posición de compactación

Antes de crear una política de posición de compactación, ten en cuenta lo siguiente:

  • Si deseas aplicar una política de posición compacta a una instancia de procesamiento que no sea N2 o N2D, te recomendamos que especifiques un valor de distancia máxima.

  • Solo puedes aplicar políticas de posición compacta a instancias A4 o A3 Ultra que se implementen con las funciones que proporciona Cluster Director. Para obtener más información, consulta Cluster Director en la documentación de AI Hypercomputer.

  • De forma predeterminada, no puedes aplicar políticas de posición compacta con un valor de distancia máxima a las instancias A3 Mega, A3 High o A3 Edge. Para solicitar acceso a esta función, comunícate con tu administrador técnico de cuentas (TAM) asignado o con el equipo de Ventas.

Para crear una política de posición compacta, selecciona una de las siguientes opciones:

gcloud

  • Para aplicar la política de posición compacta a las instancias N2 o N2D, crea la política con el comando gcloud compute resource-policies create group-placement con la marca --collocation=collocated.

    gcloud compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --region=REGION

    Reemplaza lo siguiente:

    • POLICY_NAME: el nombre de la política de posición compacta.

    • REGION: la región en la que se creará la política de posición.

  • Para aplicar la política de posición compacta a cualquier otra instancia compatible, crea la política con el comando gcloud beta compute resource-policies create group-placement con las marcas --collocation=collocated y --max-distance.

    gcloud beta compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --max-distance=MAX_DISTANCE \
    --region=REGION

    Reemplaza lo siguiente:

    • POLICY_NAME: el nombre de la política de posición compacta.

    • MAX_DISTANCE: Es la configuración de distancia máxima para tus instancias. El valor debe estar entre 1, que especifica que tus instancias se deben colocar en el mismo bastidor para obtener la latencia de red más baja posible, y 3, que especifica que se deben colocar las instancias en los clústeres adyacentes. Si deseas aplicar la política de posición compacta a una reserva o a una instancia A4 o A3 Ultra, no puedes especificar un valor de 1.

    • REGION: la región en la que se creará la política de posición.

REST

  • Para aplicar la política de posición compacta a las instancias N2 o N2D, crea la política realizando una solicitud POST al método resourcePolicies.insert. En el cuerpo de la solicitud, incluye el campo collocation y configúralo como COLLOCATED.

    POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  }
}

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto en el que deseas crear la política de posición.

    • REGION: la región en la que se creará la política de posición.

    • POLICY_NAME: el nombre de la política de posición compacta.

  • Para aplicar la política de posición compacta a cualquier otra instancia compatible, crea la política realizando una solicitud POST al método beta.resourcePolicies.insert. En el cuerpo de la solicitud, incluye lo siguiente:

    • El campo collocation configurado como COLLOCATED.

    • El campo maxDistance

    POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies

{
  "name": "POLICY_NAME",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED",
    "maxDistance": MAX_DISTANCE
  }
}

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto en el que deseas crear la política de posición.

    • REGION: la región en la que se creará la política de posición.

    • POLICY_NAME: el nombre de la política de posición compacta.

    • MAX_DISTANCE: Es la configuración de distancia máxima para tus instancias. El valor debe estar entre 1, que especifica que tus instancias se deben colocar en el mismo bastidor para obtener la latencia de red más baja posible, y 3, que especifica que se deben colocar las instancias en los clústeres adyacentes. Si deseas aplicar la política de posición compacta a una reserva o a una instancia A4 o A3 Ultra, no puedes especificar un valor de 1.

Aplica una política de posición compacta

Puedes aplicar una política de posición de compactación a una instancia de procesamiento o a un grupo de instancias administrado (MIG) existente, o cuando creas instancias, plantillas de instancias, MIG o reservas de instancias.

Para aplicar una política de posición compacta a un recurso de Compute Engine, selecciona uno de los siguientes métodos:

Después de aplicar una política de posición compacta a una instancia, puedes verificar la ubicación física de la instancia en relación con otras instancias que especifiquen la misma política de posición.

Aplica la política a una instancia existente

Antes de aplicar una política de posición de compactación a una instancia de procesamiento existente, asegúrate de lo siguiente:

De lo contrario, la aplicación de la política de posición compacta a la instancia fallará. Si la instancia ya especifica una política de posición y quieres reemplazarla, consulta Reemplaza una política de posición en una instancia.

Para aplicar una política de posición compacta a una instancia existente, selecciona una de las siguientes opciones:

gcloud

  1. Detén la instancia.

  2. Para aplicar una política de posición de compactación a una instancia existente, usa el comando gcloud compute instances add-resource-policies.

    gcloud compute instances add-resource-policies INSTANCE_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

    Reemplaza lo siguiente:

    • INSTANCE_NAME: Es el nombre de una instancia existente.

    • POLICY_NAME: el nombre de una política de posición de compactación existente.

    • ZONE: Es la zona en la que se encuentra la instancia.

  3. Reinicia la instancia.

REST

  1. Detén la instancia.

  2. Para aplicar una política de posición compacta a una instancia existente, realiza una solicitud POST al método instances.addResourcePolicies.

    POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que se encuentran la política de posición compacta y la instancia.

    • ZONE: Es la zona en la que se encuentra la instancia.

    • INSTANCE_NAME: Es el nombre de una instancia existente.

    • REGION: la región en la que se encuentra la política de posición compacta.

    • POLICY_NAME: el nombre de una política de posición de compactación existente.

  3. Reinicia la instancia.

Aplica la política mientras creas una instancia

Solo puedes crear una instancia de procesamiento que especifique una política de posición compacta en la misma región que la política de posición.

Para crear una instancia que especifique una política de posición compacta, selecciona una de las siguientes opciones:

gcloud

Para crear una instancia que especifique una política de posición compacta, usa el comando gcloud compute instances create con las marcas --maintenance-policy y --resource-policies.

gcloud compute instances create INSTANCE_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de la instancia que se creará.

  • MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.

  • MAINTENANCE_POLICY: Es la política de mantenimiento del host de la instancia. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, o si el tipo de máquina que elegiste no admite la migración en vivo, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.

  • POLICY_NAME: el nombre de una política de posición de compactación existente.

  • ZONE: Es la zona en la que se creará la instancia.

REST

Para crear una instancia que especifique una política de posición compacta, realiza una solicitud POST al método instances.insert. En el cuerpo de la solicitud, incluye los campos onHostMaintenance y resourcePolicies.

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  "scheduling": {
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentra la política de posición compacta.

  • ZONE: Es la zona en la que se creará la instancia y en la que se encuentra el tipo de máquina. Solo puedes especificar una zona en la región de la política de posición compacta.

  • INSTANCE_NAME: Es el nombre de la instancia que se creará.

  • MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.

  • IMAGE_PROJECT: el proyecto de imagen que contiene la imagen; por ejemplo, debian-cloud. Para obtener más información sobre los proyectos de imágenes compatibles, consulta Imágenes públicas.

  • IMAGE: especifica una de las siguientes opciones:

    • una versión específica de la imagen de SO; por ejemplo, debian-12-bookworm-v20240617.

    • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto especifica la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/debian-12, se usa la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.

  • REGION: la región en la que se encuentra la política de posición de compactación.

  • POLICY_NAME: el nombre de una política de posición de compactación existente.

  • MAINTENANCE_POLICY: Es la política de mantenimiento del host de la instancia. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, o si el tipo de máquina que elegiste no admite la migración en vivo, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.

Si deseas obtener más información sobre las opciones de configuración para crear una instancia, consulta Crea y, luego, inicia una instancia.

Aplica la política mientras creas una reserva

Si deseas crear una reserva según demanda de un solo proyecto que especifique una política de posición compacta, debes crear una reserva orientada específicamente. Cuando crees instancias para consumir la reserva, asegúrate de lo siguiente:

  • Las instancias deben especificar la misma política de posición compacta aplicada a la reserva.

  • Las instancias deben orientarse específicamente a la reserva para consumirla. Para obtener más información, consulta Consume instancias de una reserva específica.

Para crear una reserva de un solo proyecto con una política de posición compacta, selecciona uno de los siguientes métodos:

Para crear una reserva de un solo proyecto con una política de posición compacta a través de la especificación directa de las propiedades, selecciona una de las siguientes opciones:

gcloud

Para crear una reserva de un solo proyecto con una política de posición compacta a través de la especificación directa de las propiedades, usa el comando gcloud compute reservations create con las marcas --require-specific-reservation y --resource-policies=policy.

gcloud compute reservations create RESERVATION_NAME \
    --machine-type=MACHINE_TYPE \
    --require-specific-reservation \
    --resource-policies=policy=POLICY_NAME \
    --vm-count=NUMBER_OF_INSTANCES \
    --zone=ZONE

Reemplaza lo siguiente:

  • RESERVATION_NAME por el nombre de la reserva.

  • MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.

  • POLICY_NAME: el nombre de una política de posición de compactación existente.

  • NUMBER_OF_INSTANCES: Es la cantidad de instancias que se reservarán, que no puede ser mayor que la cantidad máxima de instancias admitida para la política de posición compacta especificada.

  • ZONE: Es la zona en la que se reservarán las instancias. Solo puedes reservar instancias en una zona de la región de la política de posición compacta especificada.

REST

Para crear una reserva de un solo proyecto con una política de posición compacta a través de la especificación directa de las propiedades, realiza una solicitud POST al método reservations.insert. En el cuerpo de la solicitud, incluye el campo resourcePolicies y el campo specificReservationRequired configurado como true.

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

{
  "name": "RESERVATION_NAME",
  "resourcePolicies": {
    "policy" : "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  },
  "specificReservation": {
    "count": "NUMBER_OF_INSTANCES",
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
    }
  },
  "specificReservationRequired": true
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentra la política de posición compacta.

  • ZONE: Es la zona en la que se reservarán las instancias. Solo puedes reservar instancias en una zona de la región de la política de posición compacta especificada.

  • RESERVATION_NAME por el nombre de la reserva.

  • REGION: la región en la que se encuentra la política de posición compacta.

  • POLICY_NAME: el nombre de una política de posición de compactación existente.

  • NUMBER_OF_INSTANCES: Es la cantidad de instancias que se reservarán, que no puede ser mayor que la cantidad máxima de instancias admitida para la política de posición compacta especificada.

  • MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.

Para obtener más información sobre las opciones de configuración para crear reservas de un solo proyecto, consulta Crea una reserva para un solo proyecto.

Aplica la política cuando crees una plantilla de instancias

Si deseas crear una plantilla de instancias regional, debes crear la plantilla en la misma región de la política de posición compacta. De lo contrario, la creación de la plantilla de instancias fallará.

Después de crear una plantilla de instancias que especifique una política de posición compacta, puedes usar la plantilla para hacer lo siguiente:

Para crear una plantilla de instancias que especifique una política de posición compacta, selecciona una de las siguientes opciones:

gcloud

Para crear una plantilla de instancias que especifique una política de posición compacta, usa el comando gcloud compute instance-templates create con las marcas --maintenance-policy y --resource-policies.

Por ejemplo, para crear una plantilla de instancias global que especifique una política de posición compacta, ejecuta el siguiente comando:

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME

Reemplaza lo siguiente:

  • INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.

  • MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.

  • MAINTENANCE_POLICY: Es la política de mantenimiento del host de la instancia. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, o si el tipo de máquina que elegiste no admite la migración en vivo, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.

  • POLICY_NAME: el nombre de una política de posición de compactación existente.

REST

Para crear una plantilla de instancias que especifique una política de posición compacta, realiza una solicitud POST a uno de los siguientes métodos:

En el cuerpo de la solicitud, incluye los campos onHostMaintenance y resourcePolicies.

Por ejemplo, para crear una plantilla de instancias global que especifique una política de posición de compactación, realiza una solicitud POST de la siguiente manera:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/global/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "resourcePolicies": [
      "POLICY_NAME"
    ],
    "scheduling": {
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentra la política de posición compacta.

  • INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.

  • IMAGE_PROJECT: el proyecto de imagen que contiene la imagen; por ejemplo, debian-cloud. Para obtener más información sobre los proyectos de imágenes compatibles, consulta Imágenes públicas.

  • IMAGE: especifica una de las siguientes opciones:

    • una versión específica de la imagen de SO; por ejemplo, debian-12-bookworm-v20240617.

    • Una familia de imágenes, que debe tener el formato family/IMAGE_FAMILY. Esto especifica la imagen de SO no obsoleta más reciente. Por ejemplo, si especificas family/debian-12, se usa la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de las familias de imágenes, consulta Prácticas recomendadas para las familias de imágenes.

  • MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.

  • POLICY_NAME: el nombre de una política de posición de compactación existente.

  • MAINTENANCE_POLICY: Es la política de mantenimiento del host de la instancia. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, o si el tipo de máquina que elegiste no admite la migración en vivo, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.

Si quieres obtener más información sobre las opciones de configuración para crear una plantilla de instancias, consulta Crea plantillas de instancias.

Aplica la política a las instancias en un MIG

Después de crear una plantilla de instancias que especifique una política de posición de compactación, puedes usar la plantilla para hacer lo siguiente:

Aplica la política mientras creas un MIG

Solo puedes crear instancias de procesamiento que especifiquen una política de posición compacta si las instancias se encuentran en la misma región que la política de posición.

Para crear un MIG con una plantilla de instancias que especifique una política de posición compacta, selecciona una de las siguientes opciones:

gcloud

Para crear un MIG con una plantilla de instancias que especifique una política de posición compacta, usa el comando gcloud compute instance-groups managed create.

Por ejemplo, para crear un MIG zonal con una plantilla de instancias global que especifique una política de posición compacta, ejecuta el siguiente comando:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • INSTANCE_GROUP_NAME: el nombre del MIG que se creará.

  • SIZE: el tamaño del MIG.

  • INSTANCE_TEMPLATE_NAME: el nombre de una plantilla de instancias existente que especifica una política de posición compacta.

  • ZONE: la zona en la que se crea el MIG, que debe estar en la región en la que se encuentra la política de posición compacta.

REST

Para crear un MIG con una plantilla de instancias que especifique una política de posición compacta, realiza una solicitud POST a uno de los siguientes métodos:

Por ejemplo, para crear un MIG zonal con una plantilla de instancias global que especifique una política de posición compacta, realiza una solicitud POST de la siguiente manera:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers

{
  "name": "INSTANCE_GROUP_NAME",
  "targetSize": SIZE,
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
    }
  ]
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentran la política de posición compacta y la plantilla de instancias que especifica la política de posición.

  • ZONE: la zona en la que se crea el MIG, que debe estar en la región en la que se encuentra la política de posición compacta.

  • INSTANCE_GROUP_NAME: el nombre del MIG que se creará.

  • INSTANCE_TEMPLATE_NAME: el nombre de una plantilla de instancias existente que especifica una política de posición compacta.

  • SIZE: el tamaño del MIG.

Para obtener más información acerca de las opciones de configuración para crear MIG, consulta Situaciones básicas para crear MIG.

Aplica la política a un MIG existente

Solo puedes aplicar una política de posición compacta a un MIG existente si el MIG se encuentra en la misma región que la política de posición o, para los MIG zonales, en una zona en la misma región que la política de posición.

Para actualizar un MIG para usar una plantilla de instancias que especifique una política de posición compacta, elige una de las siguientes opciones:

gcloud

Para actualizar un MIG para usar una plantilla de instancias que especifique una política de posición compacta, usa el comando gcloud compute instance-groups managed rolling-action start-update.

Por ejemplo, para actualizar un MIG zonal para usar una plantilla de instancias que especifique una política de posición compacta y reemplazar las instancias existentes del MIG por instancias nuevas que especifiquen las propiedades de la plantilla, ejecuta el siguiente comando:

gcloud compute instance-groups managed rolling-action start-update MIG_NAME \
    --version=template=INSTANCE_TEMPLATE_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

  • MIG_NAME: el nombre de un MIG existente.

  • INSTANCE_TEMPLATE_NAME: el nombre de una plantilla de instancias existente que especifica una política de posición compacta.

  • ZONE: La zona en la que se encuentra el MIG. Solo puedes aplicar la política de posición compacta a un MIG ubicado en la misma región que la política de posición.

REST

Para actualizar un MIG para usar una plantilla de instancias que especifique una política de posición compacta y aplicar automáticamente las propiedades de la plantilla y la política de posición a las instancias existentes en el MIG, realiza una solicitud PATCH a uno de los siguientes métodos:

Por ejemplo, para actualizar un MIG zonal para usar una plantilla de instancias global que especifique una política de posición compacta y reemplazar las instancias existentes del MIG por instancias nuevas que especifiquen las propiedades de la plantilla, realiza la siguiente solicitud PATCH:

PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE_NAME"
}

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que se encuentran el MIG, la política de posición compacta y la plantilla de instancias que especifica la política de posición.

  • ZONE: La zona en la que se encuentra el MIG. Solo puedes aplicar la política de posición compacta a un MIG ubicado en la misma región que la política de posición.

  • MIG_NAME: el nombre de un MIG existente.

  • INSTANCE_TEMPLATE_NAME: el nombre de una plantilla de instancias existente que especifica una política de posición compacta.

Si deseas obtener más información sobre las opciones de configuración para actualizar las instancias en un MIG, consulta Actualiza y aplica configuraciones nuevas a las instancias en un MIG.

Verifica la ubicación física de una instancia

Después de aplicar una política de posición compacta a una instancia de procesamiento, puedes ver la ubicación física de la instancia en relación con otras instancias. Esta comparación se limita a las instancias ubicadas en tu proyecto y que especifican la misma política de posición compacta. Ver la ubicación física de una instancia te ayuda a hacer lo siguiente:

  • Confirma que la política se haya aplicado correctamente.

  • Identifica qué instancias están más cerca entre sí.

Para ver la ubicación física de una instancia en relación con otras instancias que especifican la misma política de posición compacta, selecciona una de las siguientes opciones:

gcloud

Para ver la ubicación física de una instancia que especifica una política de posición de compactación, usa el comando gcloud compute instances describe con la marca --format.

gcloud compute instances describe INSTANCE_NAME \
    --format="table[box,title=VM-Position](resourcePolicies.scope():sort=1,resourceStatus.physicalHost:label=location)" \
    --zone=ZONE

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de una instancia existente que especifica una política de posición compacta.

  • ZONE: Es la zona en la que se encuentra la instancia.

El resultado es similar a este:

VM-Position

RESOURCE_POLICIES: us-central1/resourcePolicies/example-policy']
PHYSICAL_HOST: /CCCCCCC/BBBBBB/AAAA

El valor del campo PHYSICAL_HOST se compone de tres partes. Estas partes representan el clúster, el rack y el host en el que se encuentra la instancia.

Cuando se compara la posición de dos instancias que usan la misma política de posición de compactación en tu proyecto, cuantas más partes del campo PHYSICAL_HOST compartan las instancias, más cerca estarán físicamente entre sí. Por ejemplo, supongamos que dos instancias especifican uno de los siguientes valores de muestra para el campo PHYSICAL_HOST:

  • /CCCCCCC/xxxxxx/xxxx: Las dos instancias se colocan en el mismo clúster, lo que equivale a un valor de distancia máxima de 2. Las instancias ubicadas en el mismo clúster experimentan una latencia de red baja.

  • /CCCCCCC/BBBBBB/xxxx: Las dos instancias se colocan en el mismo rack, lo que equivale a un valor de distancia máxima de 1. Las instancias ubicadas en el mismo rack experimentan una latencia de red más baja que las instancias ubicadas en el mismo clúster.

  • /CCCCCCC/BBBBBB/AAAA: Las dos instancias comparten el mismo host. Las instancias ubicadas en el mismo host minimizan la latencia de red tanto como sea posible.

REST

Para ver la ubicación física de una instancia que especifica una política de posición de compactación, realiza una solicitud GET al método instances.get.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que se encuentra la instancia.

  • ZONE: Es la zona en la que se encuentra la instancia.

  • INSTANCE_NAME: el nombre de una instancia existente que especifica una política de posición compacta.

El resultado es similar a este:

{
  ...
  "resourcePolicies": [
    "https://www.s3nsapis.fr/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy"
  ],
  "resourceStatus": {
    "physicalHost": "/xxxxxxxx/xxxxxx/xxxxx"
  },
  ...
}

El valor del campo physicalHost se compone de tres partes. Estas partes representan el clúster, el rack y el host en el que se encuentra la instancia.

Cuando se compara la posición de dos instancias que usan la misma política de posición de compactación en tu proyecto, cuantas más partes del campo physicalHost compartan las instancias, más cerca estarán físicamente entre sí. Por ejemplo, supongamos que dos instancias especifican uno de los siguientes valores de muestra para el campo physicalHost:

  • /CCCCCCC/xxxxxx/xxxx: Las dos instancias se colocan en el mismo clúster, lo que equivale a un valor de distancia máxima de 2. Las instancias ubicadas en el mismo clúster experimentan una latencia de red baja.

  • /CCCCCCC/BBBBBB/xxxx: Las dos instancias se colocan en el mismo rack, lo que equivale a un valor de distancia máxima de 1. Las instancias ubicadas en el mismo bastidor experimentan una latencia de red más baja que las instancias ubicadas en el mismo clúster.

  • /CCCCCCC/BBBBBB/AAAA: Las dos instancias comparten el mismo host. Las instancias ubicadas en el mismo host minimizan la latencia de red tanto como sea posible.

Próximos pasos