En este documento se describe cómo crear solicitudes de cambio de tamaño en un grupo de instancias gestionado (MIG) de instancias de máquina virtual (VM) que tienen GPUs conectadas. Para obtener más información sobre las solicitudes de cambio de tamaño, consulta Información sobre las solicitudes de cambio de tamaño en un MIG.
Crear una solicitud de cambio de tamaño de MIG te ayuda a obtener recursos muy demandados, como GPUs, y a optimizar los costes creando el número exacto de VMs a la vez. Para crear una solicitud de cambio de tamaño de un MIG que pueda usar las funciones y los servicios disponibles en Cluster Director, consulta Crear un MIG y una solicitud de cambio de tamaño en la documentación de AI Hypercomputer.
Antes de empezar
- Para usar solicitudes de cambio de tamaño de MIG para crear VMs en cuanto haya recursos disponibles para cargas de trabajo que se ejecuten durante un máximo de siete días, comprueba que tienes suficiente cuota estándar o de recursos preemptivos para los recursos solicitados. Para obtener más información, consulta cómo comprobar la cuota de GPU.
-
Si aún no lo has hecho, configura la autenticación.
La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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
-
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
- Set a default region and zone.
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud init
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Roles obligatorios
Para obtener los permisos que necesitas para crear solicitudes de cambio de tamaño de MIGs, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de instancias de Compute (v. 1) (
roles/compute.instanceAdmin.v1
) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.Este rol predefinido contiene los permisos necesarios para crear solicitudes de cambio de tamaño de MIGs. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para crear solicitudes de cambio de tamaño de MIG, se necesitan los siguientes permisos:
-
Para crear una plantilla de instancia, sigue estos pasos:
compute.instanceTemplates.create
en el proyecto -
Para crear un MIG zonal, sigue estos pasos:
compute.instanceGroupManagers.create
en el proyecto -
Para crear una solicitud de cambio de tamaño de un MIG, haz lo siguiente:
compute.instanceGroupManagers.update
en el proyecto
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
Preparar un MIG para las solicitudes de cambio de tamaño
Para crear solicitudes de cambio de tamaño de un MIG, debe configurar una plantilla de instancia y el MIG, tal como se describe en las siguientes secciones.
Crear una plantilla de instancia
En función del caso práctico de las solicitudes de cambio de tamaño de MIG, cree una plantilla de instancia mediante uno de los siguientes métodos:
Si quieres crear VMs en cuanto haya recursos disponibles para cargas de trabajo que se ejecuten durante un máximo de siete días, crea una plantilla de instancia con el modelo de aprovisionamiento de inicio flexible.
Si quieres crear VMs consumiendo una reserva creada automáticamente para una reserva futura en modo calendario, crea una plantilla de instancia con el modelo de aprovisionamiento vinculado a la reserva.
Usar el modelo de aprovisionamiento flex-start
Para crear una plantilla de instancia configurada para las solicitudes de cambio de tamaño de los grupos de instancias gestionados y para crear VMs en cuanto haya recursos disponibles, debes especificar lo siguiente en la plantilla:
Usa un tipo de máquina con GPU, excepto los tipos de máquina A4X o G4.
Detener las VMs durante los eventos de mantenimiento del host.
Elimina las VMs al final de su duración de ejecución mediante los campos
maxRunDuration
yinstanceTerminationAction
.
Para crear una plantilla de instancia, selecciona una de las siguientes opciones:
Consola
En la consola, ve a la página Plantillas de instancia. Google Cloud
Haz clic en Crear plantilla de instancia. Se abrirá la página Crear una plantilla de instancia.
En el campo Nombre, introduce un nombre para la plantilla de instancia.
En la sección Ubicación, seleccione una de las siguientes opciones:
Para crear una plantilla de instancia regional, selecciona Regional (recomendado) y, a continuación, la región en la que quieras crear la plantilla.
Para crear una plantilla de instancia global, selecciona Global.
En la sección Configuración de la máquina, haga lo siguiente:
Haz clic en la pestaña GPUs.
En la lista Tipo de GPU, selecciona un tipo de GPU.
En la lista Número de GPUs, selecciona el número de GPUs.
Opcional: Si el tipo de GPU que has elegido admite estaciones de trabajo virtuales (vWS) NVIDIA RTX para cargas de trabajo de gráficos y tienes previsto ejecutar cargas de trabajo que utilizan un gran número de gráficos, selecciona Habilitar estación de trabajo virtual (NVIDIA GRID).
En la sección Tipo de máquina, selecciona un tipo de máquina.
En la sección Modelo de aprovisionamiento, sigue estos pasos:
En el campo Modelo de aprovisionamiento de la VM, selecciona Inicio flexible.
Despliega Configuración avanzada del modelo de aprovisionamiento de VMs.
Selecciona la casilla Definir un límite de tiempo para la VM.
Para definir la duración de la ejecución de las VMs creadas a partir de la plantilla de instancia, introduce el número de horas en el campo Enter number of hours (Introduce el número de horas). El valor debe estar entre 36 segundos (
0.01
) y siete días (168
).
Opcional: Para cambiar el tipo o la imagen del disco de arranque predeterminado, en la sección Disco de arranque, haz clic en Cambiar. A continuación, sigue las instrucciones para cambiar el disco de arranque.
Haz clic en Crear.
gcloud
Para crear una plantilla de instancia, usa el comando
beta instance-templates create
con las siguientes marcas:La marca
--instance-termination-action
se ha definido comoDELETE
.La marca
--maintenance-policy
se ha definido comoTERMINATE
.La bandera de
--max-run-duration
.La marca
--provisioning-model
se ha definido comoFLEX_START
.La marca
--reservation-affinity
se ha definido comonone
.
Por ejemplo, para crear una plantilla de instancia regional, ejecuta el siguiente comando. Si quieres crear una plantilla de instancia global, usa el mismo comando sin la marca
--instance-template-region
.gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --instance-template-region=REGION \ --instance-termination-action=DELETE \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --max-run-duration=RUN_DURATION \ --provisioning-model=FLEX_START \ --reservation-affinity=none
Haz los cambios siguientes:
INSTANCE_TEMPLATE_NAME
: el nombre de la plantilla de instancia que se va a crear.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 admitidos, consulta Imágenes públicas.IMAGE_FAMILY
: una familia de imágenes. Especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificasdebian-12
, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulta las prácticas recomendadas para familias de imágenes.REGION
: la región en la que se creará la plantilla de instancia.MACHINE_TYPE
: el tipo de máquina con GPU que se va a usar en las VMs. Si especificas un tipo de máquina N1, debes incluir la marca--accelerator
para definir el número y el tipo de GPUs que se van a asociar a tus VMs.RUN_DURATION
: la duración que quieres que se ejecuten las VMs solicitadas. El valor debe tener el formato de número de días, horas, minutos o segundos seguido ded
,h
,m
ys
, respectivamente. Por ejemplo, especifica30m
para 30 minutos o1d2h3m4s
para un día, dos horas, tres minutos y cuatro segundos. El valor debe estar entre 10 minutos y 7 días.
REST
Para crear una plantilla de instancia, haz una solicitud
POST
a uno de los siguientes métodos:Para crear una plantilla de instancia regional, sigue estos pasos: Método beta
regionInstanceTemplates.insert
Para crear una plantilla de instancia global, usa el método beta
instanceTemplates.insert
:
En el cuerpo de la solicitud, incluye los siguientes campos:
El campo
reservationAffinity.consumeReservationType
tiene el valorNO_RESERVATION
.El campo
scheduling.instanceTerminationAction
se ha definido comoDELETE
.El campo
scheduling.maxRunDuration
.El campo
scheduling.onHostMaintenance
se ha definido comoTERMINATE
.El campo
scheduling.provisioningModel
se ha definido comoFLEX_START
.
Por ejemplo, para crear una plantilla de instancia regional, haz una solicitud como la siguiente:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/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" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, "scheduling": { "instanceTerminationAction": "DELETE", "maxRunDuration": { "seconds": RUN_DURATION }, "onHostMaintenance": "TERMINATE", "provisioningModel": "FLEX_START" } } }
Haz los cambios siguientes:
PROJECT_ID
: ID del proyecto en el que se va a crear la plantilla de instancia.REGION
: la región en la que se creará la plantilla de instancia.INSTANCE_TEMPLATE_NAME
: el nombre de la plantilla de instancia que se va a crear.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 admitidos, consulta Imágenes públicas.IMAGE
: especifica una de las siguientes opciones:Una versión específica de la imagen del SO, por ejemplo,
debian-12-bookworm-v20240617
.Una familia de imágenes, que debe tener el formato
family/IMAGE_FAMILY
. Especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificasfamily/debian-12
, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulte las prácticas recomendadas para familias de imágenes.
MACHINE_TYPE
: el tipo de máquina con GPU que se va a usar en las VMs. Si especificas un tipo de máquina N1, debes incluir el campoguestAccelerators
para definir el número y el tipo de GPUs que se van a asociar a tus VMs.RUN_DURATION
: la duración, en segundos, que quiere que se ejecuten las VMs solicitadas. El valor debe estar entre600
(600 segundos, es decir, 10 minutos) y604800
(604.800 segundos, es decir,7 días).
Para obtener más información sobre cómo crear una plantilla de instancia, consulta el artículo Crear plantillas de instancia.
Usar el modelo de aprovisionamiento vinculado a la reserva
Para crear una plantilla de instancia configurada para las solicitudes de cambio de tamaño de grupos de instancias gestionados y para consumir una reserva, debe especificar lo siguiente en la plantilla:
Usa un tipo de máquina A4 o A3 Ultra, tal como se especifica en la reserva.
Detener las VMs durante los eventos de mantenimiento del host.
Elimina las VMs al final del periodo de reserva mediante el campo
instanceTerminationAction
.
Para crear una plantilla de instancia, selecciona una de las siguientes opciones:
Consola
En la consola, ve a la página Plantillas de instancia. Google Cloud
Haz clic en Crear plantilla de instancia. Se abrirá la página Crear una plantilla de instancia.
En el campo Nombre, introduce un nombre para la plantilla de instancia.
En la sección Ubicación, seleccione una de las siguientes opciones:
Para crear una plantilla de instancia regional, selecciona Regional (recomendado) y, a continuación, la región en la que quieras crear la plantilla.
Para crear una plantilla de instancia global, selecciona Global.
En la sección Configuración de la máquina, haga lo siguiente:
Haz clic en la pestaña GPUs.
En la lista Tipo de GPU, selecciona una de las siguientes opciones, tal como se especifica en la reserva que quieras consumir:
Para usar máquinas virtuales A4: NVIDIA B200 de 180 GB
Para usar las máquinas virtuales A3 Ultra: NVIDIA H200 de 141 GB
Esta acción define automáticamente el modelo de aprovisionamiento de la plantilla de instancia como Vinculado a reserva.
En la lista Número de GPUs, selecciona el número de GPUs.
Opcional: Si el tipo de GPU que has elegido admite estaciones de trabajo virtuales (vWS) NVIDIA RTX para cargas de trabajo de gráficos y tienes previsto ejecutar cargas de trabajo que utilizan un gran número de gráficos, selecciona Habilitar estación de trabajo virtual (NVIDIA GRID).
En la sección Tipo de máquina, selecciona un tipo de máquina.
En la sección Modelo de aprovisionamiento, sigue estos pasos:
Despliega Configuración avanzada del modelo de aprovisionamiento de VMs.
En la lista Al finalizar la VM, selecciona Eliminar.
Opcional: Para cambiar el tipo o la imagen del disco de arranque predeterminado, en la sección Disco de arranque, haz clic en Cambiar. A continuación, sigue las instrucciones para cambiar el disco de arranque.
Despliega la sección Opciones avanzadas y sigue estos pasos:
Despliega la sección Gestión.
En la sección Reservas, selecciona Elegir una reserva y, a continuación, haz clic en Elegir reserva. En el panel que aparece, sigue las indicaciones para seleccionar la reserva que quieras consumir.
Haz clic en Crear.
gcloud
Para crear una plantilla de instancia, usa el comando
instance-templates create
con las siguientes marcas:La marca
--instance-termination-action
se ha definido comoDELETE
.La marca
--maintenance-policy
se ha definido comoTERMINATE
.La marca
--provisioning-model
se ha definido comoRESERVATION_BOUND
.La marca
--reservation-affinity
se ha definido comospecific
.La bandera de
--reservation
.
Por ejemplo, para crear una plantilla de instancia regional, ejecuta el siguiente comando. Si quieres crear una plantilla de instancia global, usa el mismo comando sin la marca
--instance-template-region
.gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --instance-termination-action=DELETE \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --provisioning-model=RESERVATION_BOUND \ --reservation-affinity=specific \ --reservation=RESERVATION_URL
Haz los cambios siguientes:
INSTANCE_TEMPLATE_NAME
: el nombre de la plantilla de instancia que se va a crear.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 admitidos, consulta Imágenes públicas.IMAGE_FAMILY
: una familia de imágenes. Especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificasdebian-12
, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulta las prácticas recomendadas para familias de imágenes.REGION
: la región en la que se creará la plantilla de instancia.MACHINE_TYPE
: el tipo de máquina A4 o A3 Ultra especificado en la reserva que quieras consumir.RESERVATION_URL
: la URL de la reserva creada automáticamente para una reserva futura en el modo Calendario que quieras usar. Se debe utilizar uno de los valores indicados a continuación.Si la reserva creada automáticamente existe en tu proyecto, haz lo siguiente:
RESERVATION_NAME
.Si la reserva creada automáticamente está en otro proyecto:
projects/PROJECT_ID/reservations/RESERVATION_NAME
.
REST
Para crear una plantilla de instancia, haz una solicitud
POST
a uno de los siguientes métodos:Para crear una plantilla de instancia regional, usa el método
regionInstanceTemplates.insert
.Para crear una plantilla de instancia global, usa el método
instanceTemplates.insert
.
En el cuerpo de la solicitud, incluye los siguientes campos:
El campo
reservationAffinity.consumeReservationType
tiene el valorSPECIFIC_RESERVATION
.El campo
reservationAffinity.key
tiene el valorcompute.googleapis.com/reservation-name
.El campo
reservationAffinity.values
se ha definido en la URL de la reserva creada automáticamente.El campo
scheduling.instanceTerminationAction
se ha definido comoDELETE
.El campo
scheduling.onHostMaintenance
se ha definido comoTERMINATE
.El campo
scheduling.provisioningModel
se ha definido comoRESERVATION_BOUND
.
Por ejemplo, para crear una plantilla de instancia regional, haz una solicitud como la siguiente:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/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" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "RESERVATION_URL" ] }, "scheduling": { "instanceTerminationAction": "DELETE", "onHostMaintenance": "TERMINATE", "provisioningModel": "RESERVATION_BOUND" } } }
Haz los cambios siguientes:
PROJECT_ID
: ID del proyecto en el que se va a crear la plantilla de instancia.REGION
: la región en la que se creará la plantilla de instancia.INSTANCE_TEMPLATE_NAME
: el nombre de la plantilla de instancia que se va a crear.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 admitidos, consulta Imágenes públicas.IMAGE
: especifica una de las siguientes opciones:Una versión específica de la imagen del SO, por ejemplo,
debian-12-bookworm-v20240617
.Una familia de imágenes, que debe tener el formato
family/IMAGE_FAMILY
. Especifica la imagen del SO más reciente que no está obsoleta. Por ejemplo, si especificasfamily/debian-12
, se usará la versión más reciente de la familia de imágenes de Debian 12. Para obtener más información sobre cómo usar familias de imágenes, consulte las prácticas recomendadas para familias de imágenes.
MACHINE_TYPE
: el tipo de máquina A4 o A3 Ultra especificado en la reserva que quieras consumir.RESERVATION_URL
: la URL de la reserva creada automáticamente para una reserva futura en el modo Calendario que quieras usar. Se debe utilizar uno de los valores indicados a continuación.Si la reserva creada automáticamente está en tu proyecto:
RESERVATION_NAME
Si la reserva creada automáticamente está en otro proyecto:
projects/PROJECT_ID/reservations/RESERVATION_NAME
Para obtener más información sobre cómo crear una plantilla de instancia, consulta el artículo Crear plantillas de instancia.
Crear o actualizar un MIG
Después de crear la plantilla de instancia como se describe en la sección anterior, úsala para crear un MIG de la siguiente manera o actualiza un MIG. Además, debes hacer lo siguiente para preparar el MIG para las solicitudes de cambio de tamaño:
Define el tipo de actualización de MIG como oportunista (predeterminado).
Si has configurado el autoescalado en el MIG, elimina la configuración de autoescalado.
Si usas un MIG regional, define la forma de distribución objetivo como
ANY_SINGLE_ZONE
.
Para crear un MIG que sea compatible con las solicitudes de cambio de tamaño, selecciona una de las siguientes opciones:
Consola
En la consola, ve a la página Grupos de instancias. Google Cloud
Haz clic en Crear grupo de instancias. Se abre la página Crear grupo de instancias.
En el campo Nombre, introduce un nombre para el MIG.
Antes de seleccionar una plantilla de instancia, debes eliminar la configuración de autoescalado y desactivar las reparaciones de la siguiente manera:
Para eliminar la configuración de autoescalado, siga estos pasos:
En la sección Autoescalado, haz clic en la lista Modo de autoescalado y, a continuación, en Eliminar configuración de autoescalado.
En el cuadro de diálogo de confirmación, haz clic en Eliminar.
Para desactivar las reparaciones, en la sección Ciclo de vida de la instancia de VM, haga clic en la lista Acción predeterminada en caso de fallo y, a continuación, seleccione Ninguna acción.
Vuelve al campo Plantilla de instancia. En la lista Plantilla de instancia, selecciona la que has creado en la sección anterior. Si seleccionas una plantilla de instancia regional, la lista Región se define en la región de la plantilla.
Elige una de estas opciones:
Para crear una solicitud de cambio de tamaño al crear el MIG, haz lo siguiente:
En el campo Número de instancias, introduce el número de VMs que quieras crear a la vez.
Seleccione la casilla Usar la solicitud de cambio de tamaño para crear VMs a la vez.
Opcional: Si la plantilla de instancia del MIG especifica una duración de ejecución, puedes especificar otra. Para ello, en los campos Duración de ejecución solicitada y Unidad, especifica una duración de ejecución. Debes especificar una duración de entre una hora y siete días.
Para crear una solicitud de cambio de tamaño después de crear el MIG, introduce
0
en el campo Número de instancias.
En la sección Ubicación, especifica si quieres crear un MIG de zona o de región de la siguiente manera:
Para crear un MIG zonal, selecciona Una zona. Para crear un MIG regional, selecciona Varias zonas.
Selecciona la región y las zonas de la MIG.
Si vas a crear un MIG regional, haz lo siguiente:
En el campo Forma de distribución de destino, selecciona Cualquier zona.
En el cuadro de diálogo que aparece, haz clic en Inhabilitar redistribución de instancias.
Haz clic en Crear.
gcloud
Usa el comando
instance-groups managed create
con la marca--default-action-on-vm-failure
definida comodo_nothing
. Si va a crear un MIG regional, también debe incluir la marca--target-distribution-shape
con el valorany-single-zone
y la marca--instance-redistribution-type
con el valornone
.Para crear un MIG zonal, ejecuta el siguiente comando:
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zone=ZONE \ --default-action-on-vm-failure=do_nothing
Para crear un MIG regional, ejecuta el siguiente comando:
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --region=REGION \ --target-distribution-shape=any-single-zone \ --instance-redistribution-type=none \ --default-action-on-vm-failure=do_nothing
Haz los cambios siguientes:
INSTANCE_GROUP_NAME
: el nombre del MIG que se va a crear.INSTANCE_TEMPLATE_URL
: URL parcial de la plantilla de instancia que has creado en la sección anterior. Si quieres usar una plantilla de instancia regional para crear el MIG, solo puedes crear el MIG en la región de la plantilla. Especifica uno de los siguientes valores:En el caso de una plantilla de instancia regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
En el caso de una plantilla de instancia global:
INSTANCE_TEMPLATE_NAME
ZONE
: la zona en la que se creará el MIG.REGION
: la región en la que se creará el MIG.
REST
Para crear un MIG zonal, envía una solicitud
POST
con el métodoinstanceGroupManagers.insert
de la siguiente manera:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
Para crear un MIG regional, envía una solicitud
POST
con el métodoregionInstanceGroupManagers.insert
de la siguiente manera:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "distributionPolicy": { "targetShape": "ANY_SINGLE_ZONE" }, "updatePolicy": { "instanceRedistributionType": "NONE" }, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
Haz los cambios siguientes:
PROJECT_ID
: el ID del proyecto en el que se encuentra la plantilla de instancia que has creado en la sección anterior.INSTANCE_TEMPLATE_URL
: URL parcial de la plantilla de instancia que has creado en la sección anterior. Si quieres usar una plantilla de instancia regional para crear el MIG, solo puedes crear el MIG en la región de la plantilla. Especifica uno de los siguientes valores:En el caso de una plantilla de instancia regional:
regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
En el caso de una plantilla de instancia global:
global/instanceTemplates/INSTANCE_TEMPLATE_NAME
ZONE
: la zona en la que se creará el MIG.REGION
: la región en la que se creará el MIG.INSTANCE_GROUP_NAME
: el nombre del MIG que se va a crear.
Crear una solicitud de cambio de tamaño en un MIG
Antes de crear solicitudes de cambio de tamaño de MIG, asegúrate de haber preparado el MIG como se describe en la sección anterior.
Una vez que hayas creado una solicitud de cambio de tamaño y todos los recursos solicitados estén disponibles, el MIG creará el número de VMs solicitado a la vez. Las VMs se ejecutan hasta que el MIG las elimina una vez que finaliza la duración de ejecución especificada o hasta que las eliminas.
Para crear una solicitud de cambio de tamaño en un MIG, selecciona una de las siguientes opciones. Para añadir VMs con nombres específicos al MIG mediante una solicitud de cambio de tamaño, usa la CLI de gcloud o la API REST.
Consola
En la consola, ve a la página Grupos de instancias. Google Cloud
En la columna Nombre, haz clic en el nombre del MIG en el que quieras crear la solicitud de cambio de tamaño.
Se abrirá la página de vista general del MIG.
En la fila Solicitudes de cambio de tamaño, haz clic en
Editar solicitudes de cambio de tamaño.Haz clic en
Nueva solicitud de cambio de tamaño.Aparecerá el panel Nuevas solicitudes de cambio de tamaño.
En el campo Name (Nombre), introduce el nombre de la solicitud de cambio de tamaño.
En el campo Número de instancias adicionales necesarias, introduce el número de VMs que quieras añadir al MIG a la vez.
Opcional: Si la plantilla de instancia del MIG especifica una duración de ejecución, puedes especificar otra. Para ello, en los campos Duración de ejecución solicitada y Unidad, especifica una duración de ejecución. Debes especificar una duración de entre una hora y siete días.
Haz clic en Crear.
gcloud
Para crear una solicitud de cambio de tamaño en un MIG zonal, usa el comando
instance-groups managed resize-requests create
.gcloud compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --zone=ZONE
Para crear una solicitud de cambio de tamaño en un MIG regional, usa el comando
beta instance-groups managed resize-requests create
.gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --region=REGION
Haz los cambios siguientes:
INSTANCE_GROUP_NAME
: el nombre del MIG configurado para crear solicitudes de cambio de tamaño en él.RESIZE_REQUEST_NAME
: el nombre de la solicitud de cambio de tamaño, que debe ser único en el MIG especificado. De lo contrario, no se podrá crear la solicitud de cambio de tamaño.COUNT
: número de VMs que se van a añadir a la MIG a la vez.ZONE
: la zona en la que se encuentra el MIG.REGION
: la región en la que se encuentra el MIG.
También puede hacer lo siguiente:
Si la plantilla de instancia del MIG especifica una duración de ejecución, puede especificar otra. Para ello, incluye la marca
--requested-run-duration
en el comando. Debes especificar una duración de entre 10 minutos y siete días.Si tu carga de trabajo requiere nombres de máquinas virtuales específicos, puedes especificar una lista de nombres de máquinas virtuales que se van a crear mediante el comando
beta instance-groups managed resize-requests create
. En el comando, sustituye la marca--resize-request
por la marca--instances
.
REST
Para crear una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud
POST
con el métodoinstanceGroupManagerResizeRequests.insert
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
Para crear una solicitud de cambio de tamaño en un MIG regional, envía una solicitud
POST
con el métodobeta.regionInstanceGroupManagerResizeRequests.insert
.
En el cuerpo de la solicitud, incluye lo siguiente:
{ "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
Haz los cambios siguientes:
PROJECT_ID
: el ID del proyecto en el que se encuentra el MIG especificado.ZONE
: la zona en la que se encuentra el MIG.REGION
: la región en la que se encuentra el MIG.INSTANCE_GROUP_NAME
: el nombre del MIG configurado para crear solicitudes de cambio de tamaño.RESIZE_REQUEST_NAME
: el nombre de la solicitud de cambio de tamaño, que debe ser único en el MIG especificado. De lo contrario, no se podrá crear la solicitud de cambio de tamaño.COUNT
: número de VMs que se van a añadir a la MIG a la vez.
También puede hacer lo siguiente:
Si la plantilla de instancia del MIG especifica una duración de ejecución, puede especificar otra. Para ello, incluye el campo
requestedRunDuration
en el cuerpo de la solicitud. Debes especificar una duración, en segundos, de entre 10 minutos y 7 días.Si tu carga de trabajo requiere nombres de VM específicos, puedes especificar una lista de nombres de VMs que se van a crear. Para ello, envía una solicitud
POST
al métodobeta.regionInstanceGroupManagerResizeRequests.insert
de un MIG regional o al métodobeta.instanceGroupManagerResizeRequests.insert
de un MIG zonal. En el cuerpo de la solicitud, sustituye el camporesizeBy
por el campoinstanceNames
.
Siguientes pasos
Consulta cómo ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG.
Consulta cómo ver información sobre MIGs y VMs gestionadas.
- Consulta cómo ver el uso real y previsto de tus máquinas virtuales y GPUs.
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-11 (UTC).
-