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

En este documento, se explica cómo reducir la latencia de red entre las instancias de máquina virtual (VM) a través de la creación y aplicación de políticas de posición compacta.

Una política de posición compacta especifica que tus VMs deben colocarse físicamente más cerca entre sí. Esto puede ayudar a mejorar el rendimiento y reducir la latencia de red entre las VMs 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

Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Roles obligatorios

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

Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1)
Para crear una reserva: Administrador de Compute (roles/compute.admin)

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 VMs. 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 de compactación a las VMs:

Para crear políticas de posición: compute.resourcePolicies.create en el proyecto
Para aplicar una política de posición a las VMs existentes: compute.instances.addResourcePolicies en el proyecto
Para crear VMs, sigue estos pasos:
- 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&colon; 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&colon; 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&colon; 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 VM: 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 compacta

A menos que quieras aplicar una política de posición compacta a las VMs N2 o N2D, Google Cloud recomienda especificar un valor de distancia máxima cuando crees la política. Para obtener más información, consulta Cómo funcionan las políticas de posición compacta.

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 VMs 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: Es 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 VM compatible, crea la política con el comando gcloud beta compute resource-policies create group-placement con las marcas --collocation=collocated y --max-distance.

Vista previa — The --max-distance flag

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.
```
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: la configuración de distancia máxima para tus VMs. El valor debe estar entre 1, que especifica que tus VMs 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 VMs en los clústeres adyacentes. Si deseas aplicar la política de posición compacta a una reserva, no puedes especificar un valor de 1.
- REGION: Es 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 VMs 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.googleapis.com/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: Es 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 VM 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
Vista previa — The maxDistance field

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.
```
POST https://compute.googleapis.com/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: Es 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: la configuración de distancia máxima para tus VMs. El valor debe estar entre 1, que especifica que tus VMs 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 VMs en los clústeres adyacentes. Si deseas aplicar la política de posición compacta a una reserva, no puedes especificar un valor de 1.

Aplica una política de posición compacta

Puedes aplicar una política de posición compacta a una VM o un MIG existente, o cuando creas VMs, plantillas de instancias, MIG o reservas de VMs.

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

Aplica la política a una VM existente.
Aplica la política mientras creas una VM.
Aplica la política mientras creas VMs de forma masiva.
Aplica la política mientras creas una reserva.
Aplica la política cuando crees una plantilla de instancias.
Aplica la política a las VMs en un MIG.

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

Aplica la política a una VM existente

Antes de aplicar una política de posición compacta a una VM existente, asegúrate de lo siguiente:

La VM y la política de posición compacta deben estar ubicadas en la misma región. Por ejemplo, si la política de posición se encuentra en la región us-central1, la VM debe estar ubicada en una zona en us-central1. Si necesitas migrar una VM a otra región, consulta Traslada una VM entre zonas o regiones.
La VM debe usar una serie de máquinas y una política de mantenimiento del host compatibles. Si necesitas realizar cambios en la VM, realiza una de las siguientes acciones o ambas:
- Cambiar el tipo de máquina de la VM.
- Actualizar la política de mantenimiento del host de la VM.

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

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

gcloud

Detén la VM.
Para aplicar una política de posición compacta a una VM existente, usa el comando gcloud compute instances add-resource-policies.
```
gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE
```
Reemplaza lo siguiente:
- VM_NAME: el nombre de una VM existente.
- POLICY_NAME: el nombre de una política de posición compacta existente.
- ZONE: la zona donde se ubica la VM.
Reinicia la VM.

REST

Detén la VM.
Para aplicar una política de posición compacta a una VM existente, realiza una solicitud POST al método instances.addResourcePolicies.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/addResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}
```
Reemplaza lo siguiente:
- PROJECT_ID: el ID del proyecto en el que se encuentran la política de posición compacta y la VM.
- ZONE: la zona donde se ubica la VM.
- VM_NAME: el nombre de una VM 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 compacta existente.
Reinicia la VM.

Aplica la política mientras creas una VM

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

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

gcloud

Para crear una VM 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 VM_NAME \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

VM_NAME: El nombre de la VM que se creará.
MACHINE_TYPE: un tipo de máquina compatible para las políticas de posición compacta.
MAINTENANCE_POLICY: la política de mantenimiento del host de la VM. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.
POLICY_NAME: el nombre de una política de posición compacta existente.
ZONE: la zona en la que se creará la VM.

REST

Para crear una VM 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.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_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: la zona en la que se creará la VM y en la que se encuentra el tipo de máquina. Solo puedes especificar una zona dentro de la región de la política de posición compacta.
VM_NAME: El nombre de la VM 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 compacta.
POLICY_NAME: el nombre de una política de posición compacta existente.
MAINTENANCE_POLICY: la política de mantenimiento del host de la VM. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.

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

Aplica la política mientras creas VMs de forma masiva

Solo puedes crear VMs de forma masiva con una política de posición compacta en la misma región que la política de posición.

Para crear VMs de forma masiva que especifiquen una política de posición compacta, selecciona una de las siguientes opciones:

gcloud

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

Por ejemplo, para crear VMs de forma masiva en una sola zona y especificar un patrón del nombre para las VMs, ejecuta el siguiente comando:

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Reemplaza lo siguiente:

COUNT: la cantidad de VMs que se crearán, que no puede ser mayor que la cantidad máxima de VMs 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.
MAINTENANCE_POLICY: la política de mantenimiento del host de la VM. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.
NAME_PATTERN: Es el patrón del nombre de las VM. Para reemplazar una secuencia de números en el nombre de una VM, usa una secuencia de caracteres hash (#). Por ejemplo, si usas vm-# para el patrón de nombre, se generan VMs con nombres que comienzan con vm-1, vm-2 y continúan hasta la cantidad de VMs especificadas por COUNT.
POLICY_NAME: el nombre de una política de posición compacta existente.
ZONE: La zona en la que se crearán las VMs de forma masiva.

REST

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

Por ejemplo, si deseas crear VMs de forma masiva en una sola zona y especificar un patrón de nombre para las VMs, realiza una solicitud POST de la siguiente manera:

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": "COUNT",
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "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: La zona en la que se crearán las VMs de forma masiva.
COUNT: la cantidad de VMs que se crearán, que no puede ser mayor que la cantidad máxima de VMs admitida para la política de posición compacta especificada.
NAME_PATTERN: Es el patrón del nombre de las VM. Para reemplazar una secuencia de números en el nombre de una VM, usa una secuencia de caracteres hash (#). Por ejemplo, si usas vm-# para el patrón de nombre, se generan VMs con nombres que comienzan con vm-1, vm-2 y continúan hasta la cantidad de VMs especificadas por COUNT.
```
    with names starting with `vm-1`, `vm-2`, and continuing up to the number
```
de VMs especificadas por COUNT.
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 compacta.
POLICY_NAME: el nombre de una política de posición compacta existente.
MAINTENANCE_POLICY: la política de mantenimiento del host de la VM. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.

Para obtener más información acerca de las opciones de configuración para crear VMs de forma masiva, consulta Crea VMs de forma masiva.

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 VMs para consumir la reserva, asegúrate de lo siguiente:

Las VMs deben especificar la misma política de posición compacta aplicada a la reserva.
Las VMs deben orientarse específicamente a la reserva para consumirla. Para obtener más información, consulta Consume las VMs 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 la reserva, especifica las propiedades directamente como se describe en esta sección.
Aplica la política cuando crees una plantilla de instancias como se describe en este documento y, luego, crea una reserva de un solo proyecto; para ello, especifica la plantilla de instancias recién creada.

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_VMS \
    --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 compacta existente.
NUMBER_OF_VMS: la cantidad de VMs que se reservarán, que no puede ser mayor que la cantidad máxima de VMs admitida para la política de posición compacta especificada.
ZONE: Es la zona en la que se reservarán las VM. Solo puedes reservar VMs en una zona dentro 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.googleapis.com/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_VMS",
    "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 VM. Solo puedes reservar VMs en una zona dentro 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 compacta existente.
NUMBER_OF_VMS: la cantidad de VMs que se reservarán, que no puede ser mayor que la cantidad máxima de VMs 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: la política de mantenimiento del host de la VM. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, solo puedes especificar TERMINATE. De lo contrario, puedes especificar MIGRATE o TERMINATE.
POLICY_NAME: el nombre de una política de posición compacta 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:

Para crear una plantilla de instancias global: método instanceTemplates.insert.
Para crear una plantilla de instancias regional: método regionInstanceTemplates.insert.

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 compacta, realiza una solicitud POST de la siguiente manera:

POST https://compute.googleapis.com/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 compacta existente.
MAINTENANCE_POLICY: la política de mantenimiento del host de la VM. Si la política de posición compacta que especificas usa un valor de distancia máxima de 1 o 2, 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 VMs en un MIG

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:

Aplica la política cuando crees un MIG.
Aplica la política a un MIG existente.

Aplica la política mientras creas un MIG

Solo puedes crear VMs que especifiquen una política de posición compacta si las VMs 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 dentro de 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:

Para crear un MIG zonal, usa el método instanceGroupManagers.insert.
Para crear un MIG regional, usa el método regionInstanceGroupManagers.insert.

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.googleapis.com/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 dentro de 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 dentro de 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 VMs existentes del MIG por VMs 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 dentro de 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 VMs existentes en el MIG, realiza una solicitud PATCH a uno de los siguientes métodos:

Para actualizar un MIG zonal, usa el método instanceGroupManagers.insert.
Para actualizar un MIG regional, usa el método regionInstanceGroupManagers.insert.

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 VMs existentes del MIG por VMs nuevas que especifiquen las propiedades de la plantilla, realiza la siguiente solicitud PATCH:

PATCH https://compute.googleapis.com/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 dentro de 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 acerca de las opciones de configuración para actualizar las VMs en un MIG, consulta Actualiza y aplica configuraciones nuevas a las VM en un MIG.

Verifica la ubicación física de una VM

Después de aplicar una política de posición de compactación a una VM, puedes ver cómo la política de posición de compactación afectó su ubicación física en relación con otras VMs que especifican la misma política. Esto te ayuda a determinar si la política de posición de compactación se aplicó de forma correcta a una VM y a asignar las VMs más cercanas entre sí.

Para verificar la ubicación física de una VM que especifica una política de posición en relación con otras VMs, selecciona una de las siguientes opciones:

gcloud

Para ver la ubicación física de una VM 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 VM_NAME \
    --format="table[box,title=VM-Position](resourcePolicies.scope():sort=1,resourceStatus.physicalHost:label=location)" \
    --zone=ZONE

Reemplaza lo siguiente:

VM_NAME: el nombre de una VM existente.
ZONE: la zona donde se ubica la VM.

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 bastidor y el host en el que se encuentra la VM.

Cuando se compara la posición de dos VMs que especifican la misma política de posición de compactación, cuantas más partes en el campo PHYSICAL_HOST comparten las VMs, más cerca están entre sí. Por ejemplo, si dos VMs especifican uno de los siguientes valores de muestra para el campo PHYSICAL_HOST:

/CCCCCCC/xxxxxx/xxxx: las dos VMs se colocan en la mismo clúster, que equivale a un valor de distancia máxima de 2. Las VMs ubicadas en el mismo clúster experimentan una latencia de red baja.
/CCCCCCC/BBBBBB/xxxx: las dos VMs se colocan en el mismo bastidor, que equivale a un valor de distancia máxima de 1. Las VM ubicadas en el mismo bastidor experimentan una latencia de red más baja que las VMs ubicadas en el mismo clúster.
/CCCCCCC/BBBBBB/AAAA: las dos VMs comparten el mismo host. Las VMs ubicadas en el mismo host minimizan la latencia de red tanto como sea posible.

REST

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

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto en el que se encuentra la VM.
ZONE: la zona donde se ubica la VM.
VM_NAME: el nombre de una VM existente que especifica una política de posición.

El resultado es similar a este:

{
  ...
  "resourcePolicies": [
    "https://www.googleapis.com/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 bastidor y el host en el que se encuentra la VM.

Cuando se compara la posición de dos VMs que especifican la misma política de posición de compactación, cuantas más partes en el campo physicalHost comparten las VMs, más cerca están entre sí. Por ejemplo, si dos VMs especifican uno de los siguientes valores de muestra para el campo physicalHost:

/CCCCCCC/xxxxxx/xxxx: las dos VMs se colocan en la mismo clúster, que equivale a un valor de distancia máxima de 2. Las VMs ubicadas en el mismo clúster experimentan una latencia de red baja.
/CCCCCCC/BBBBBB/xxxx: las dos VMs se colocan en el mismo bastidor, que equivale a un valor de distancia máxima de 1. Las VM ubicadas en el mismo bastidor experimentan una latencia de red más baja que las VMs ubicadas en el mismo clúster.
/CCCCCCC/BBBBBB/AAAA: las dos VMs comparten el mismo host. Las VMs ubicadas en el mismo host minimizan la latencia de red tanto como sea posible.

Próximos pasos

Obtén más información para ver las políticas de posición.
Obtén más información para reemplazar, quitar o borrar políticas de posición.
Obtén información sobre cómo hacer lo siguiente con una VM que especifica una política de posición:
- Consulta el estado de la VM.
- Conéctate a la VM.