En este documento, se describe cómo crear un grupo de instancias administrado (MIG) que use un tipo de máquina optimizado para aceleradores A3 Edge. Para obtener más información sobre el tipo de máquina, consulta A3 Edge en la documentación de Compute Engine.
Crear un MIG te permite administrar varias máquinas virtuales (VMs) como una sola entidad. Cada VM en un MIG se basa en una plantilla de instancias. Al administrar automáticamente el estado y el tamaño del grupo de instancias, los MIG proporcionan alta disponibilidad y escalabilidad. Para obtener más información sobre los MIG, consulta Grupos de instancias administrados.
Para obtener información sobre las opciones de creación de VM y clústeres, consulta la página de Descripción general de la creación de VMs y clústeres.
Limitaciones
Cuando crees un MIG con VMs de A3 Edge, ten en cuenta las limitaciones tanto del tipo de máquina como del MIG.
Limitaciones de las VMs de A3 Edge
Según la serie de máquinas que usen las VMs de tu MIG, se aplican las siguientes limitaciones:
- No recibirás descuentos por uso continuo ni descuentos por compromiso de uso flexible para las instancias que usan un tipo de máquina A3 Edge.
- Solo puedes usar un tipo de máquina A3 Edge en ciertas regiones y zonas.
- No puedes usar Persistent Disks regionales en una instancia que use un tipo de máquina A3 Edge.
- El tipo de máquina A3 Edge solo está disponible en la plataforma de CPU Sapphire Rapids.
- No se admiten cambios de tipo de máquina para el tipo de máquina A3 Edge. Para cambiar a este tipo de máquina o dejar de usarlo, debes crear una instancia nueva.
- No puedes ejecutar sistemas operativos Windows en un tipo de máquina A3 Edge.
- Los tipos de máquinas A3 Edge no admiten usuarios únicos.
Limitaciones del MIG
Cuando creas un MIG con VMs de A3 Edge, se aplican las siguientes limitaciones:
- Debes desactivar las reparaciones en el MIG, como se describe en este documento.
- No puedes configurar la flexibilidad de instancias en el MIG.
Limitaciones para las solicitudes de cambio de tamaño del MIG
Para las solicitudes de cambio de tamaño de MIG, se aplican las siguientes limitaciones:
En los MIG regionales, solo puedes usar la forma de distribución objetivo
ANY_SINGLE_ZONE.Solo puedes establecer el modo de grupo en espera del MIG en
manual(predeterminado).No puedes configurar el escalado automático.
Si el MIG contiene solicitudes de cambio de tamaño aceptadas, no puedes cambiar el tamaño objetivo del MIG.
No puedes borrar ni abandonar las instancias administradas en un estado
CREATINGque el MIG crea para una solicitud de cambio de tamaño. Para borrar esas instancias administradas, debes cancelar la solicitud de cambio de tamaño.
Para obtener más información, consulta todas las limitaciones de las solicitudes de cambio de tamaño.
Antes de comenzar
Antes de crear un MIG, si aún no lo hiciste, completa los siguientes pasos:
- Elige una opción de consumo: La opción de consumo que elijas determinará cómo obtendrás y usarás los recursos de GPU. Para obtener más información, consulta Elige una opción de consumo.
- Obtén capacidad: El proceso para obtener capacidad difiere para cada opción de consumo. Para obtener información sobre el proceso para obtener capacidad para la opción de consumo que elegiste, consulta Descripción general de la capacidad.
Roles obligatorios
Para obtener los permisos que necesitas
para crear un MIG,
pídele a tu administrador que te otorgue el rol de IAM
Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para crear un MIG. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para crear un MIG:
-
Para crear un MIG, haz lo siguiente:
compute.instanceGroupManagers.createen el proyecto
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Descripción general
La creación de un MIG con el tipo de máquina A3 Edge incluye los siguientes pasos:
- Crea redes de VPC
- Opcional: Crea una política de posición compacta
- Crea una plantilla de instancias
- Crea un MIG
- Instala controladores de GPU
Para cada MIG, debes elegir si deseas usar una política de posición compacta, usar solicitudes de cambio de tamaño o ninguna de las dos. Para obtener más información sobre cuándo usar cada opción, consulta Limitaciones del MIG en este documento.
Crea redes de VPC
Para habilitar la comunicación eficiente de tus VMs con GPU, debes crear una red de administración y una o más redes de datos. La red de administración se usa para el acceso externo, por ejemplo, SSH, y para la mayoría de las comunicaciones de red generales. Las redes de datos se usan para la comunicación de alto rendimiento entre las GPUs en diferentes VMs, por ejemplo, para el tráfico de acceso directo remoto a la memoria (RDMA).
Para estas redes de VPC, recomendamos establecer la unidad de transmisión máxima (MTU) en un valor mayor. Los valores de MTU más altos aumentan el tamaño del paquete y reducen la sobrecarga del encabezado del paquete, lo que aumenta la capacidad de procesamiento de los datos de carga útil. Para obtener más información sobre cómo crear redes de VPC, consulta Crea y verifica una red MTU de marcos jumbo.
Crea una red de administración, subred y regla de firewall
Completa los siguientes pasos para configurar la red de administración:
Crea la red de administración con el comando
networks create:gcloud compute networks create NETWORK_NAME_PREFIX-mgmt-net \ --project=PROJECT_ID \ --subnet-mode=custom \ --mtu=8244Crea la subred de administración con el comando
networks subnets create:gcloud compute networks subnets create NETWORK_NAME_PREFIX-mgmt-sub \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --region=REGION \ --range=192.168.0.0/24Crea reglas de firewall con el comando
firewall-rules create.Crea una regla de firewall para la red de administración.
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-internal \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=tcp:0-65535,udp:0-65535,icmp \ --source-ranges=192.168.0.0/16Crea la regla de firewall
tcp:22para limitar las direcciones IP de origen que pueden conectarse a la VM mediante SSH.gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ssh \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=tcp:22 \ --source-ranges=SSH_SOURCE_IP_RANGECrea la regla de firewall
icmpque se puede usar para verificar si hay problemas de transmisión de datos en la red.gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ping \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=icmp \ --source-ranges=0.0.0.0/0
Reemplaza lo siguiente:
NETWORK_NAME_PREFIX: Es el prefijo del nombre que se usará para las subredes y las redes de VPC.PROJECT_ID: El ID de tu proyectoREGION: Es la región en la que deseas crear las redes.SSH_SOURCE_IP_RANGE: el rango de IP en formato CIDR. Esto especifica qué direcciones IP de origen pueden conectarse a tu VM mediante SSH.
Crea redes de datos, subredes y reglas de firewall
A3 Edge requiere cuatro redes de datos. Usa el siguiente comando para crear cuatro redes de datos, cada una con subredes y reglas de firewall.
for N in $(seq 1 4); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
--project=PROJECT_ID \
--subnet-mode=custom \
--mtu=8244
gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--region=REGION \
--range=192.168.$N.0/24
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--action=ALLOW \
--rules=tcp:0-65535,udp:0-65535,icmp \
--source-ranges=192.168.0.0/16
done
Opcional: Crea una política de posición compacta
Puedes especificar la posición de la VM creando una política de posición compacta. Cuando aplicas una política de posición compacta a tus VMs, Compute Engine hace su mejor esfuerzo para crear VMs que estén lo más cerca posible entre sí. Si tu aplicación es sensible a la latencia y requiere la máxima compactación, especifica el campo maxDistance (versión preliminar) cuando crees una política de posición compacta. Un valor de maxDistance más bajo garantiza una colocación más cercana de las VM, pero también aumenta la probabilidad de que no se creen algunas VMs.
gcloud
Para crear una política de posición compacta, usa el
comando gcloud beta compute resource-policies create group-placement:
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 VMs, que se puede especificar (vista previa, recomendado) o no especificar (quita la marca--max-distance). Según lo que admita tu tipo de máquina, puedes especificar uno de los siguientes valores:- Para colocar las VMs en el mismo subbloque, haz lo siguiente:
1 - Para colocar las VMs en el mismo bloque, haz lo siguiente:
2 - Para colocar VMs en bloques adyacentes:
3
- Para colocar las VMs en el mismo subbloque, haz lo siguiente:
REGION: la región en la que deseas crear la política de posición compacta. Especifica la región que contiene la zona en la que planeas crear instancias y verifica que el tipo de máquina que deseas usar esté disponible en esa región. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.
REST
Para crear una política de posición compacta, realiza una solicitud POST al
método resourcePolicies.insert de la versión beta.
En el cuerpo de la solicitud, incluye el campo collocation configurado como COLLOCATED y el campo maxDistance.
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 de tu proyectoPOLICY_NAME: el nombre de la política de posición compacta.MAX_DISTANCE: Es la configuración de distancia máxima para tus VMs, que se puede especificar (vista previa, recomendada) o no especificar (quitar el campomaxDistance). Según lo que admita tu tipo de máquina, puedes especificar uno de los siguientes valores:- Para colocar las VMs en el mismo subbloque, haz lo siguiente:
1 - Para colocar las VMs en el mismo bloque, haz lo siguiente:
2 - Para colocar VMs en bloques adyacentes:
3
- Para colocar las VMs en el mismo subbloque, haz lo siguiente:
REGION: la región en la que deseas crear la política de posición compacta. Especifica la región que contiene la zona en la que planeas crear instancias y verifica que el tipo de máquina que deseas usar esté disponible en esa región. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.
Crea una plantilla de instancias
Especifica las propiedades de la VM para un MIG creando una plantilla de instancias.
Para crear una plantilla de instancias, selecciona una de las siguientes opciones:
Los siguientes comandos también establecen el permiso de acceso para tus instancias. Para simplificar la administración de permisos, Google recomienda que configures el permiso de acceso en una instancia como accesocloud-platform y, luego, uses roles de IAM para definir a qué servicios puede acceder la instancia. Para obtener más información, consulta las prácticas recomendadas para los permisos.
Para crear una plantilla de instancias para las VMs de A3 Edge, debes especificar cuatro interfaces de red adicionales para el tráfico de GPUDirect-TCPX. Si aún no lo hiciste, debes crear cuatro redes de VPC como se describe en Crea redes de VPC.
gcloud
Para crear una plantilla de instancias regional, usa el
comando gcloud compute instance-templates create.
Los parámetros que debes especificar dependen de la opción de consumo que uses para esta implementación. Selecciona la pestaña que corresponda a tu opción de consumo.
Reserva
Antes de ejecutar el comando, revisa todos los pasos que se indican a continuación para determinar si debes incluir marcas adicionales.
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--instance-template-region=REGION \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--reservation-affinity=specific \
--reservation=RESERVATION \
--provisioning-model=RESERVATION_BOUND \
--instance-termination-action=DELETE \
--maintenance-policy=TERMINATE \
--restart-on-failure
Completa los siguientes pasos:
-
Reemplaza lo siguiente:
INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.MACHINE_TYPE: Es el tipo de máquina que se usará para la instancia de A3 Edge. Para obtener más información, consulta Tipos de máquinas con GPU en la documentación de Compute Engine.IMAGE_FAMILY: Es la familia de imágenes de la imagen de SO que deseas usar. Para obtener una lista de todos los sistemas operativos compatibles, consulta Sistemas operativos compatibles. Para la serie de máquinas A3 Edge, te recomendamos que uses la imagen de Container-Optimized OScos-121-ltso posterior y que inhabilite las actualizaciones automáticas.IMAGE_PROJECT: Es el ID del proyecto de la imagen de SO. Por ejemplo, usacos-cloudpara la imagen de Container-Optimized OScos-121-ltso posterior.REGION: Es la región en la que deseas crear la plantilla de instancias. Especifica una región en la que esté disponible el tipo de máquina que deseas usar. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.DISK_TYPE: El tipo de disco de arranque. Para esta serie de máquinas, te recomendamos que useshyperdisk-balanced. Para obtener más información sobre los tipos de discos compatibles con tu tipo de máquina, consulta Máquinas con GPU en la familia de máquinas optimizadas para aceleradores en la documentación de Compute Engine.DISK_SIZE: Es el tamaño del disco de arranque en GB. Para obtener más información, consulta Límites de tamaño de Google Cloud Hyperdisk o Límites de tamaño de Persistent Disk, según el tipo de disco.GVNIC_NAME_PREFIX: Es el prefijo del nombre que especificaste cuando creaste las subredes y las redes de VPC estándar que usan NIC de gVNIC.-
RESERVATION: Es el nombre de la reserva o un bloque específico dentro de una reserva. Para obtener el nombre de la reserva o los bloques disponibles, consulta Cómo ver la capacidad reservada. Según tus requisitos de ubicación de la instancia, elige una de las siguientes opciones:Para crear instancias en varios bloques o en un solo bloque, haz lo siguiente:
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
Además, para un solo bloque, aplica una política de posición compacta que especifique una colocación conjunta de bloques (
maxDistance=2) . Luego, Compute Engine aplica la política a la reserva y crea instancias en el mismo bloque.Para crear instancias en un bloque específico, sigue estos pasos:
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
-
Opcional: Si elegiste usar una política de posición compacta, agrega la siguiente marca al comando:
--resource-policies=POLICY_NAME
Reemplaza lo siguiente:
POLICY_NAME: el nombre de la política de posición compacta.
- Ejecute el comando.
Inicio flexible
Antes de ejecutar el comando, revisa todos los pasos que se indican a continuación para determinar si debes incluir marcas adicionales.
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--instance-template-region=REGION \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--reservation-affinity=none \
--instance-termination-action=DELETE \
--max-run-duration=RUN_DURATION \
--maintenance-policy=TERMINATE \
--provisioning-model=FLEX_START
Completa los siguientes pasos:
-
Reemplaza lo siguiente:
INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.MACHINE_TYPE: Es el tipo de máquina que se usará para la instancia de A3 Edge. Para obtener más información, consulta Tipos de máquinas con GPU en la documentación de Compute Engine.IMAGE_FAMILY: Es la familia de imágenes de la imagen de SO que deseas usar. Para obtener una lista de todos los sistemas operativos compatibles, consulta Sistemas operativos compatibles. Para la serie de máquinas A3 Edge, te recomendamos que uses la imagen de Container-Optimized OScos-121-ltso posterior y que inhabilite las actualizaciones automáticas.IMAGE_PROJECT: Es el ID del proyecto de la imagen de SO. Por ejemplo, usacos-cloudpara la imagen de Container-Optimized OScos-121-ltso posterior.REGION: Es la región en la que deseas crear la plantilla de instancias. Especifica una región en la que esté disponible el tipo de máquina que deseas usar. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.DISK_TYPE: El tipo de disco de arranque. Para esta serie de máquinas, te recomendamos que useshyperdisk-balanced. Para obtener más información sobre los tipos de discos compatibles con tu tipo de máquina, consulta Máquinas con GPU en la familia de máquinas optimizadas para aceleradores en la documentación de Compute Engine.DISK_SIZE: Es el tamaño del disco de arranque en GB. Para obtener más información, consulta Límites de tamaño de Google Cloud Hyperdisk o Límites de tamaño de Persistent Disk, según el tipo de disco.GVNIC_NAME_PREFIX: Es el prefijo del nombre que especificaste cuando creaste las subredes y las redes de VPC estándar que usan NIC de gVNIC.RUN_DURATION: Es la duración de la que deseas que se ejecuten las VMs solicitadas. Debes darle formato al valor como la cantidad de días, horas, minutos o segundos, seguidos ded,h,mys, respectivamente. Por ejemplo, especifica30mpara 30 minutos o1d2h3m4spara un día, dos horas, tres minutos y cuatro segundos. El valor debe ser de entre 10 minutos y siete días.
- Ejecute el comando.
Spot
Antes de ejecutar el comando, revisa todos los pasos que se indican a continuación para determinar si debes incluir marcas adicionales.
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--instance-template-region=REGION \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--provisioning-model=SPOT \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--no-restart-on-failure
Completa los siguientes pasos:
-
Reemplaza lo siguiente:
INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.MACHINE_TYPE: Es el tipo de máquina que se usará para la instancia de A3 Edge. Para obtener más información, consulta Tipos de máquinas con GPU en la documentación de Compute Engine.IMAGE_FAMILY: Es la familia de imágenes de la imagen de SO que deseas usar. Para obtener una lista de todos los sistemas operativos compatibles, consulta Sistemas operativos compatibles. Para la serie de máquinas A3 Edge, te recomendamos que uses la imagen de Container-Optimized OScos-121-ltso posterior y que inhabilite las actualizaciones automáticas.IMAGE_PROJECT: Es el ID del proyecto de la imagen de SO. Por ejemplo, usacos-cloudpara la imagen de Container-Optimized OScos-121-ltso posterior.REGION: Es la región en la que deseas crear la plantilla de instancias. Especifica una región en la que esté disponible el tipo de máquina que deseas usar. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.DISK_TYPE: El tipo de disco de arranque. Para esta serie de máquinas, te recomendamos que useshyperdisk-balanced. Para obtener más información sobre los tipos de discos compatibles con tu tipo de máquina, consulta Máquinas con GPU en la familia de máquinas optimizadas para aceleradores en la documentación de Compute Engine.DISK_SIZE: Es el tamaño del disco de arranque en GB. Para obtener más información, consulta Límites de tamaño de Google Cloud Hyperdisk o Límites de tamaño de Persistent Disk, según el tipo de disco.GVNIC_NAME_PREFIX: Es el prefijo del nombre que especificaste cuando creaste las subredes y las redes de VPC estándar que usan NIC de gVNIC.TERMINATION_ACTION: Es la acción que se debe realizar cuando Compute Engine interrumpe la instancia, ya seaSTOP(predeterminada) oDELETE.
-
Opcional: Si elegiste usar una política de posición compacta, agrega la siguiente marca al comando:
--resource-policies=POLICY_NAME
Reemplaza lo siguiente:
POLICY_NAME: el nombre de la política de posición compacta.
- Ejecute el comando.
REST
Para crear una plantilla de instancias regional, realiza una solicitud POST al
método regionInstanceTemplates.insert.
Los parámetros que debes especificar dependen de la opción de consumo que uses para esta implementación. Selecciona la pestaña que corresponda a tu opción de consumo.
Reserva
Antes de enviar la solicitud, revisa todos los pasos que se indican a continuación para determinar si debes incluir campos adicionales.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates
{
"name": "INSTANCE_TEMPLATE_NAME",
"properties": {
"machineType": "MACHINE_TYPE",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
}
],
"reservationAffinity": {
"consumeReservationType": "SPECIFIC_RESERVATION",
"key": "compute.googleapis.com/reservation-name",
"values": [
"RESERVATION"
]
},
"scheduling": {
"provisioningModel": "RESERVATION_BOUND",
"instanceTerminationAction": "DELETE",
"onHostMaintenance": "TERMINATE",
"automaticRestart": true
}
}
}
Completa los siguientes pasos:
-
Reemplaza lo siguiente:
INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.MACHINE_TYPE: Es el tipo de máquina que se usará para la instancia de A3 Edge. Para obtener más información, consulta Tipos de máquinas con GPU en la documentación de Compute Engine.IMAGE_FAMILY: Es la familia de imágenes de la imagen de SO que deseas usar. Para obtener una lista de todos los sistemas operativos compatibles, consulta Sistemas operativos compatibles. Para la serie de máquinas A3 Edge, te recomendamos que uses la imagen de Container-Optimized OScos-121-ltso posterior y que inhabilite las actualizaciones automáticas.IMAGE_PROJECT: Es el ID del proyecto de la imagen de SO. Por ejemplo, usacos-cloudpara la imagen de Container-Optimized OScos-121-ltso posterior.REGION: Es la región en la que deseas crear la plantilla de instancias. Especifica una región en la que esté disponible el tipo de máquina que deseas usar. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.DISK_SIZE: Es el tamaño del disco de arranque en GB. Para obtener más información, consulta Límites de tamaño de Google Cloud Hyperdisk o Límites de tamaño de Persistent Disk, según el tipo de disco.DISK_TYPE: El tipo de disco de arranque. Para esta serie de máquinas, te recomendamos que useshyperdisk-balanced. Para obtener más información sobre los tipos de discos compatibles con tu tipo de máquina, consulta Máquinas con GPU en la familia de máquinas optimizadas para aceleradores en la documentación de Compute Engine.NETWORK_PROJECT_ID: Es el ID del proyecto de la red.GVNIC_NAME_PREFIX: Es el prefijo del nombre que especificaste cuando creaste las subredes y las redes de VPC estándar que usan NIC de gVNIC.REGION: Es la región de la subred.-
RESERVATION: Es el nombre de la reserva o un bloque específico dentro de una reserva. Para obtener el nombre de la reserva o los bloques disponibles, consulta Cómo ver la capacidad reservada. Según tus requisitos de ubicación de la instancia, elige una de las siguientes opciones:Para crear instancias en varios bloques o en un solo bloque, haz lo siguiente:
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
Además, para un solo bloque, aplica una política de posición compacta que especifique una colocación conjunta de bloques (
maxDistance=2) . Luego, Compute Engine aplica la política a la reserva y crea instancias en el mismo bloque.Para crear instancias en un bloque específico, sigue estos pasos:
projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME/reservationBlocks/RESERVATION_BLOCK_NAME
-
Opcional: Si elegiste usar una política de posición compacta, agrega el siguiente subcampo
instancePropertiesal cuerpo de la solicitud:"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de la política de posición compacta.REGION: Es la región de la política de posición compacta.POLICY_NAME: el nombre de la política de posición compacta.
- Envía la solicitud.
Inicio flexible
Antes de enviar la solicitud, revisa todos los pasos que se indican a continuación para determinar si debes incluir campos adicionales.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates
{
"name": "INSTANCE_TEMPLATE_NAME",
"properties": {
"machineType": "MACHINE_TYPE",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
}
],
"reservationAffinity": {
"consumeReservationType": "NO_RESERVATION"
},
"scheduling": {
"instanceTerminationAction": "DELETE",
"maxRunDuration": {
"seconds": RUN_DURATION
},
"onHostMaintenance": "TERMINATE",
"provisioningModel": "FLEX_START"
}
}
}
Completa los siguientes pasos:
-
Reemplaza lo siguiente:
INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.MACHINE_TYPE: Es el tipo de máquina que se usará para la instancia de A3 Edge. Para obtener más información, consulta Tipos de máquinas con GPU en la documentación de Compute Engine.IMAGE_FAMILY: Es la familia de imágenes de la imagen de SO que deseas usar. Para obtener una lista de todos los sistemas operativos compatibles, consulta Sistemas operativos compatibles. Para la serie de máquinas A3 Edge, te recomendamos que uses la imagen de Container-Optimized OScos-121-ltso posterior y que inhabilite las actualizaciones automáticas.IMAGE_PROJECT: Es el ID del proyecto de la imagen de SO. Por ejemplo, usacos-cloudpara la imagen de Container-Optimized OScos-121-ltso posterior.REGION: Es la región en la que deseas crear la plantilla de instancias. Especifica una región en la que esté disponible el tipo de máquina que deseas usar. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.DISK_SIZE: Es el tamaño del disco de arranque en GB. Para obtener más información, consulta Límites de tamaño de Google Cloud Hyperdisk o Límites de tamaño de Persistent Disk, según el tipo de disco.DISK_TYPE: El tipo de disco de arranque. Para esta serie de máquinas, te recomendamos que useshyperdisk-balanced. Para obtener más información sobre los tipos de discos compatibles con tu tipo de máquina, consulta Máquinas con GPU en la familia de máquinas optimizadas para aceleradores en la documentación de Compute Engine.NETWORK_PROJECT_ID: Es el ID del proyecto de la red.GVNIC_NAME_PREFIX: Es el prefijo del nombre que especificaste cuando creaste las subredes y las redes de VPC estándar que usan NIC de gVNIC.REGION: Es la región de la subred.RUN_DURATION: Es la duración, en segundos, por la que deseas que se ejecuten las VMs solicitadas. El valor debe estar entre600, que es 600 segundos (10 minutos), y604800, que es 604,800 segundos (siete días).
- Envía la solicitud.
Spot
Antes de enviar la solicitud, revisa todos los pasos que se indican a continuación para determinar si debes incluir campos adicionales.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates
{
"name": "INSTANCE_TEMPLATE_NAME",
"properties": {
"machineType": "MACHINE_TYPE",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
}
],
"scheduling":
{
"provisioningModel": "SPOT",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": false
}
}
}
Completa los siguientes pasos:
-
Reemplaza lo siguiente:
INSTANCE_TEMPLATE_NAME: el nombre de la plantilla de instancias.MACHINE_TYPE: Es el tipo de máquina que se usará para la instancia de A3 Edge. Para obtener más información, consulta Tipos de máquinas con GPU en la documentación de Compute Engine.IMAGE_FAMILY: Es la familia de imágenes de la imagen de SO que deseas usar. Para obtener una lista de todos los sistemas operativos compatibles, consulta Sistemas operativos compatibles. Para la serie de máquinas A3 Edge, te recomendamos que uses la imagen de Container-Optimized OScos-121-ltso posterior y que inhabilite las actualizaciones automáticas.IMAGE_PROJECT: Es el ID del proyecto de la imagen de SO. Por ejemplo, usacos-cloudpara la imagen de Container-Optimized OScos-121-ltso posterior.REGION: Es la región en la que deseas crear la plantilla de instancias. Especifica una región en la que esté disponible el tipo de máquina que deseas usar. Para obtener información sobre las regiones, consulta Disponibilidad de GPU por regiones y zonas.DISK_SIZE: Es el tamaño del disco de arranque en GB. Para obtener más información, consulta Límites de tamaño de Google Cloud Hyperdisk o Límites de tamaño de Persistent Disk, según el tipo de disco.DISK_TYPE: El tipo de disco de arranque. Para esta serie de máquinas, te recomendamos que useshyperdisk-balanced. Para obtener más información sobre los tipos de discos compatibles con tu tipo de máquina, consulta Máquinas con GPU en la familia de máquinas optimizadas para aceleradores en la documentación de Compute Engine.NETWORK_PROJECT_ID: Es el ID del proyecto de la red.GVNIC_NAME_PREFIX: Es el prefijo del nombre que especificaste cuando creaste las subredes y las redes de VPC estándar que usan NIC de gVNIC.REGION: Es la región de la subred.TERMINATION_ACTION: Es la acción que se debe realizar cuando Compute Engine interrumpe la instancia, ya seaSTOP(predeterminada) oDELETE.
-
Opcional: Si elegiste usar una política de posición compacta, agrega el siguiente subcampo
instancePropertiesal cuerpo de la solicitud:"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de la política de posición compacta.REGION: Es la región de la política de posición compacta.POLICY_NAME: el nombre de la política de posición compacta.
- Envía la solicitud.
Después de crear la plantilla de instancias, puedes verla para consultar su ID y revisar sus propiedades.
Crear un MIG
Después de completar todos los pasos anteriores, crea un MIG según tu situación de la siguiente manera:
| Situación | Método para crear un MIG y VMs en él | Ejemplo |
|---|---|---|
| Tienes varios trabajos paralelos que pueden comenzar con cualquier cantidad de VMs. | Crea un MIG y usa el tamaño objetivo para especificar la cantidad de VMs que deseas incluir en el grupo. Consulta Crea un MIG con un tamaño objetivo. |
Trabajos de inferencia de AA |
| Tienes un trabajo que requiere distribución en una cantidad exacta de VMs. | Crea un MIG sin VMs y, luego, crea una solicitud de cambio de tamaño en el MIG.
La solicitud de cambio de tamaño te ayuda a obtener VMs de una sola vez. |
Trabajos de entrenamiento y ajuste de AA distribuidos |
Crea un MIG con un tamaño objetivo
Si puedes iniciar tu trabajo sin crear todas las VMs a la vez, crea un MIG con un tamaño objetivo. El tamaño objetivo determina la cantidad de VMs en el MIG. Cuando especificas un tamaño objetivo, el MIG comienza a crear VMs según la disponibilidad de recursos actual. Si algún recurso no está disponible temporalmente, el MIG intentará crear VMs de forma continua para alcanzar el tamaño objetivo.
Para crear un MIG con un tamaño objetivo, selecciona una de las siguientes opciones:
gcloud
Para crear un MIG con un tamaño de destino especificado, usa el comando instance-groups managed
create.
Crea un MIG zonal o regional de la siguiente manera:
- Para crear un MIG zonal, usa el siguiente comando:
gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=TARGET_SIZE \ --zone=ZONE
- Para crear un MIG regional, usa el siguiente comando:
gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=TARGET_SIZE \ --region=REGION
MIG_NAME: Es el nombre del MIG.INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:- Para una plantilla de instancias regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID - Para una plantilla de instancias global:
INSTANCE_TEMPLATE_ID
- Para una plantilla de instancias regional:
TARGET_SIZE: Es la cantidad de instancias que deseas en el MIG.ZONE: Es la zona en la que deseas crear el MIG.REGION: la región en la que deseas crear el MIG. En el caso de un MIG regional, en lugar de una región, puedes especificar las zonas de esa región con la marca--zones.
REST
Para crear un MIG con un tamaño objetivo especificado, realiza una solicitud POST.
Crea un MIG zonal o regional de la siguiente manera:
- Para crear un MIG zonal, realiza una solicitud
POSTal métodoinstanceGroupManagers.insert.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": TARGET_SIZE } - Para crear un MIG regional, realiza una solicitud
POSTal métodoregionInstanceGroupManagers.insert.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "name": "MIG_NAME", "instanceTemplate": "INSTANCE_TEMPLATE_URL", "targetSize": TARGET_SIZE }
PROJECT_ID: Es el ID del proyecto.ZONE: Es la zona en la que deseas crear el MIG.REGION: la región en la que deseas crear el MIG.INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:- Para una plantilla de instancias regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID - Para una plantilla de instancias global:
INSTANCE_TEMPLATE_ID
- Para una plantilla de instancias regional:
MIG_NAME: Es el nombre del MIG.TARGET_SIZE: Es la cantidad de instancias que deseas tener en el MIG.
Crea un MIG y una solicitud de cambio de tamaño
Si necesitas varias VMs a la vez para iniciar un trabajo, crea un MIG y una solicitud de cambio de tamaño en el MIG, como se describe en esta sección.Para crear una solicitud de cambio de tamaño en un MIG, selecciona una de las siguientes opciones:
gcloud
Los parámetros que debes especificar dependen de la opción de consumo que uses para esta implementación. Selecciona la pestaña que corresponda al modelo de aprovisionamiento de tu opción de consumo.
Reserva
Crea un MIG zonal o regional y una solicitud de cambio de tamaño de la siguiente manera:
-
Para crear un MIG zonal y una solicitud de cambio de tamaño en él, haz lo siguiente:
-
Crea un MIG zonal con el comando
instance-groups managed createde la siguiente manera.gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zone=ZONE -
Crea una solicitud de cambio de tamaño en el MIG zonal con el comando
instance-groups managed resize-requests createde la siguiente manera. Este comando especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.gcloud compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --zone=ZONE
-
-
Para crear un MIG regional y una solicitud de cambio de tamaño en él, haz lo siguiente:
-
Crea un MIG regional con el comando
instance-groups managed createde la siguiente manera.gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zones=ZONE \ --target-distribution-shape=any-single-zone \ --instance-redistribution-type=none -
Crea una solicitud de cambio de tamaño en el MIG regional con el comando
instance-groups managed resize-requests createde la siguiente manera. Este comando especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.gcloud compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --region=REGION
-
Inicio flexible
Crea un MIG zonal o regional y una solicitud de cambio de tamaño de la siguiente manera:
-
Para crear un MIG zonal y una solicitud de cambio de tamaño en él, haz lo siguiente:
-
Crea un MIG zonal con el comando
instance-groups managed createde la siguiente manera.gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --default-action-on-vm-failure=do-nothing \ --zone=ZONE -
Crea una solicitud de cambio de tamaño en el MIG zonal con el comando
instance-groups managed resize-requests createde la siguiente manera. Este comando especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.gcloud compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --zone=ZONE
-
-
Para crear un MIG regional y una solicitud de cambio de tamaño en él, haz lo siguiente:
-
Crea un MIG regional con el comando
instance-groups managed createde la siguiente manera.gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --default-action-on-vm-failure=do-nothing \ --region=REGION \ --target-distribution-shape=any-single-zone \ --instance-redistribution-type=none -
Crea una solicitud de cambio de tamaño en el MIG regional con el comando
instance-groups managed resize-requests createde la siguiente manera. Este comando especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.gcloud compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --region=REGION
-
Spot
Crea un MIG zonal o regional y una solicitud de cambio de tamaño de la siguiente manera:
-
Para crear un MIG zonal y una solicitud de cambio de tamaño en él, haz lo siguiente:
-
Crea un MIG zonal con el comando
instance-groups managed createde la siguiente manera.gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zone=ZONE -
Crea una solicitud de cambio de tamaño en el MIG zonal con el comando
instance-groups managed resize-requests createde la siguiente manera. Este comando especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.gcloud compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --zone=ZONE
-
-
Para crear un MIG regional y una solicitud de cambio de tamaño en él, haz lo siguiente:
-
Crea un MIG regional con el comando
instance-groups managed createde la siguiente manera.gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zones=ZONE \ --target-distribution-shape=any-single-zone \ --instance-redistribution-type=none -
Crea una solicitud de cambio de tamaño en el MIG regional con el comando
instance-groups managed resize-requests createde la siguiente manera. Este comando especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.gcloud compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --region=REGION
-
MIG_NAME: Es el nombre del MIG.INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:- Para una plantilla de instancias regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID - Para una plantilla de instancias global:
INSTANCE_TEMPLATE_ID
- Para una plantilla de instancias regional:
ZONE: Es la zona en la que deseas crear el MIG. En el caso de un MIG regional, también debes especificar una zona. Esta zona debe ser la que contiene el perfil de tu red de VPC y debe ser una zona en la que el tipo de máquina esté disponible. Para obtener más información, consulta Limitaciones.RESIZE_REQUEST_NAME: El nombre de la solicitud de cambio de tamaño, que debe ser único dentro del MIG especificado. De lo contrario, la creación de la solicitud de cambio de tamaño fallará.COUNT: Es la cantidad de instancias que se agregarán al MIG a la vez.REGION: la región en la que deseas crear el MIG.
Crea una solicitud de cambio de tamaño especificando una lista de nombres de VM
Si tu carga de trabajo requiere nombres de VM específicos, especifica una lista de nombres para crear las VMs. La cantidad de nombres que especifiques determina la cantidad de VMs que el MIG crea a la vez.
Para crear una solicitud de cambio de tamaño con nombres de VM específicos en un MIG, usa el comando gcloud compute instance-groups managed resize-requests create beta con la marca --instances:
-
En un MIG zonal, ejecuta el siguiente comando:
gcloud beta compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --instances=INSTANCE_NAMES \ --zone=ZONE -
En un MIG regional, ejecuta el siguiente comando:
gcloud beta compute instance-groups managed resize-requests create MIG_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --instances=INSTANCE_NAMES \ --region=REGION
INSTANCE_NAMES por una lista separada por comas de los nombres de las VMs. Por
ejemplo, instance-1,instance-2,instance-3.
REST
Los parámetros que debes especificar dependen de la opción de consumo que uses para esta implementación. Selecciona la pestaña que corresponda al modelo de aprovisionamiento de tu opción de consumo.
Reserva
Crea un MIG zonal o regional y una solicitud de cambio de tamaño de la siguiente manera:
- Para crear un MIG zonal y una solicitud de cambio de tamaño en él, haz lo siguiente:
- Para crear un MIG zonal, realiza una solicitud
POSTal métodoinstanceGroupManagers.insertde la siguiente manera.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": 0 } - Crea una solicitud de cambio de tamaño en el MIG zonal realizando una solicitud
POSTal métodoinstanceGroupManagerResizeRequests.insertde la siguiente manera. En esta solicitud, se especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
- Para crear un MIG zonal, realiza una solicitud
- Para crear un MIG regional y una solicitud de cambio de tamaño en él, haz lo siguiente:
- Crea un MIG regional realizando una solicitud
POSTal métodoregionInstanceGroupManagers.insertde la siguiente manera.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": 0, "distributionPolicy": { "targetShape": "ANY_SINGLE_ZONE", "zones": [ { "zone": "projects/PROJECT_ID/zones/ZONE" } ] }, "updatePolicy": { "instanceRedistributionType": "NONE" } } - Crea una solicitud de cambio de tamaño en el MIG regional realizando una solicitud
POSTal métodoregionInstanceGroupManagerResizeRequests.insertde la siguiente manera. En esta solicitud, se especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
- Crea un MIG regional realizando una solicitud
Inicio flexible
Crea un MIG zonal o regional y una solicitud de cambio de tamaño de la siguiente manera:
- Para crear un MIG zonal y una solicitud de cambio de tamaño en él, haz lo siguiente:
- Para crear un MIG zonal, realiza una solicitud
POSTal métodoinstanceGroupManagers.insertde la siguiente manera.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": 0, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } } - Crea una solicitud de cambio de tamaño en el MIG zonal realizando una solicitud
POSTal métodoinstanceGroupManagerResizeRequests.insertde la siguiente manera. En esta solicitud, se especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
- Para crear un MIG zonal, realiza una solicitud
- Para crear un MIG regional y una solicitud de cambio de tamaño en él, haz lo siguiente:
- Crea un MIG regional realizando una solicitud
POSTal métodoregionInstanceGroupManagers.insertde la siguiente manera.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": 0, "distributionPolicy": { "targetShape": "ANY_SINGLE_ZONE", "zones": [ { "zone": "projects/PROJECT_ID/zones/ZONE" } ] }, "updatePolicy": { "instanceRedistributionType": "NONE" }, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } } - Crea una solicitud de cambio de tamaño en el MIG regional realizando una solicitud
POSTal métodoregionInstanceGroupManagerResizeRequests.insertde la siguiente manera. En esta solicitud, se especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
- Crea un MIG regional realizando una solicitud
Spot
Crea un MIG zonal o regional y una solicitud de cambio de tamaño de la siguiente manera:
- Para crear un MIG zonal y una solicitud de cambio de tamaño en él, haz lo siguiente:
- Para crear un MIG zonal, realiza una solicitud
POSTal métodoinstanceGroupManagers.insertde la siguiente manera.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": 0 } - Crea una solicitud de cambio de tamaño en el MIG zonal realizando una solicitud
POSTal métodoinstanceGroupManagerResizeRequests.insertde la siguiente manera. En esta solicitud, se especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
- Para crear un MIG zonal, realiza una solicitud
- Para crear un MIG regional y una solicitud de cambio de tamaño en él, haz lo siguiente:
- Crea un MIG regional realizando una solicitud
POSTal métodoregionInstanceGroupManagers.insertde la siguiente manera.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": 0, "distributionPolicy": { "targetShape": "ANY_SINGLE_ZONE", "zones": [ { "zone": "projects/PROJECT_ID/zones/ZONE" } ] }, "updatePolicy": { "instanceRedistributionType": "NONE" } } - Crea una solicitud de cambio de tamaño en el MIG regional realizando una solicitud
POSTal métodoregionInstanceGroupManagerResizeRequests.insertde la siguiente manera. En esta solicitud, se especifica la cantidad de VMs que deseas crear. Si tu carga de trabajo requiere nombres de VM específicos, crea una solicitud de cambio de tamaño especificando una lista de nombres de VM.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests { "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
- Crea un MIG regional realizando una solicitud
PROJECT_ID: Es el ID del proyecto.ZONE: Es la zona en la que deseas crear el MIG. Esta zona debe ser la misma que contiene el perfil de tu red de VPC y debe ser una zona en la que esté disponible el tipo de máquina que elegiste. Para obtener más información, consulta Limitaciones.REGION: la región en la que deseas crear el MIG. Esta región debe ser la misma que contiene el perfil de tu red de VPC y debe contener una zona en la que esté disponible el tipo de máquina que elegiste. Para obtener más información, consulta Limitaciones.INSTANCE_TEMPLATE_URL: Es la URL de la plantilla de instancias que deseas usar para crear instancias en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancias. Especifica uno de los siguientes valores:- Para una plantilla de instancias regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID - Para una plantilla de instancias global:
INSTANCE_TEMPLATE_ID
- Para una plantilla de instancias regional:
MIG_NAME: Es el nombre del MIG.RESIZE_REQUEST_NAME: El nombre de la solicitud de cambio de tamaño, que debe ser único dentro del MIG especificado. De lo contrario, la creación de la solicitud de cambio de tamaño fallará.COUNT: Es la cantidad de instancias que se agregarán al MIG a la vez.
Crea una solicitud de cambio de tamaño especificando una lista de nombres de VM
Si tu carga de trabajo requiere nombres de VM específicos, especifica una lista de nombres para crear las VMs. La cantidad de nombres que especifiques determina la cantidad de VMs que el MIG crea a la vez.
Para crear una solicitud de cambio de tamaño con nombres de VM específicos en un MIG, usa uno de los siguientes métodos:
-
En un MIG zonal, envía una solicitud
POSTcon el métodobeta.instanceGroupManagerResizeRequests.insert:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME/resizeRequests
-
En un MIG regional, envía una solicitud
POSTcon el métodobeta.regionInstanceGroupManagerResizeRequests.insert:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME/resizeRequests
Por ejemplo, para especificar dos nombres de VM, incluye lo siguiente en el cuerpo de la solicitud:
{
"name": "RESIZE_REQUEST_NAME",
"instances": [
{
"name": "INSTANCE_NAME_1"
},
{
"name": "INSTANCE_NAME_2"
}
]
}
Reemplaza
INSTANCE_NAME_1, INSTANCE_NAME_2 por los nombres de las VMs.
Próximos pasos
- Verifica el consumo de la reserva
- Cómo ver la topología de una instancia de procesamiento
- Supervisa VMs
- Cómo informar un host defectuoso
- Cómo ver, cancelar o borrar solicitudes de cambio de tamaño
- Soluciona problemas de consumo de reservas