En este documento, se explica cómo definir los recursos para un trabajo por lotes mediante la especificación de una plantilla de instancias de VM de Compute Engine.
De manera opcional, puedes definir los recursos para un trabajo mediante uno de los siguientes métodos:
- Usa el campo
policy
para definir los recursos de un trabajo directamente, como se muestra en Crea un trabajo básico. - Usa el campo
instanceTemplate
para definir los recursos de un trabajo mediante la especificación de una plantilla de instancias de VM, como se explica en esta sección. Este método fue necesario para crear un trabajo que use imágenes de VM no predeterminadas.
Antes de comenzar
- Si nunca usaste Batch, revisa Comienza a usar Batch y completa los requisitos previos para proyectos y usuarios a fin de habilitar Batch.
-
A fin de obtener los permisos que necesitas para crear un trabajo, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Editor de trabajos por lotes (
roles/batch.jobsEditor
) en el proyecto -
Usuario de cuenta de servicio (
roles/iam.serviceAccountUser
) en la cuenta de servicio del trabajo, que es la cuenta de servicio predeterminada de Compute Engine de forma predeterminada -
Crea un trabajo a partir de una plantilla de instancias de VM de Compute Engine:
Visualizador de Compute (
roles/compute.viewer
) en la plantilla de instancias de VM
Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.
Es posible que también puedas obtener los permisos necesarios mediante funciones personalizadas, o bien otras funciones predefinidas.
-
Editor de trabajos por lotes (
Crea un trabajo con una plantilla de instancias de VM de Compute Engine
En esta sección, se proporcionan ejemplos sobre cómo crear un trabajo básico de secuencia de comandos a partir de una plantilla de instancias de VM existente. Puedes crear un trabajo a partir de una plantilla de instancias de VM con gcloud CLI, la API de Batch, Go, Java, Node.js, Python o C++.
gcloud
Para crear un trabajo a partir de una plantilla de instancias de VM con gcloud CLI, usa el comando gcloud batch jobs submit
y especifica la plantilla de instancias de VM en el archivo de configuración JSON del trabajo.
Por ejemplo, para crear un trabajo básico de secuencia de comandos a partir de una plantilla de instancias de VM, haz lo siguiente:
Crea un archivo JSON en el directorio actual llamado
hello-world-instance-template.json
con el siguiente contenido:{ "taskGroups": [ { "taskSpec": { "runnables": [ { "script": { "text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks." } } ], "computeResource": { "cpuMilli": 2000, "memoryMib": 16 }, "maxRetryCount": 2, "maxRunDuration": "3600s" }, "taskCount": 4, "parallelism": 2 } ], "allocationPolicy": { "instances": [ { "installGpuDrivers" INSTALL_GPU_DRIVERS, "instanceTemplate": "INSTANCE_TEMPLATE_NAME" } ] }, "labels": { "department": "finance", "env": "testing" }, "logsPolicy": { "destination": "CLOUD_LOGGING" } }
Reemplaza lo siguiente:
INSTALL_GPU_DRIVERS
: Opcional Cuando se establece entrue
, Batch recupera los controladores necesarios para el tipo de GPU que especificas en tu plantilla de instancias de VM de Compute Engine, y Batch los instala por ti. Para obtener más información, consulta cómo crear un trabajo que use una GPU.INSTANCE_TEMPLATE_NAME
: Es el nombre de una plantilla de instancias de VM de Compute Engine existente. Aprende a crear y enumerar plantillas de instancias.
Ejecuta el siguiente comando:
gcloud batch jobs submit example-template-job \ --location us-central1 \ --config hello-world-instance-template.json
API
Para crear un trabajo básico con la API de Batch, usa el método jobs.create
y especifica una plantilla de instancias de VM en el campo allocationPolicy
.
Por ejemplo, para crear trabajos de secuencia de comandos básicos a partir de una plantilla de instancias de VM, usa la siguiente solicitud:
POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/jobs?job_id=example-script-job
{
"taskGroups": [
{
"taskSpec": {
"runnables": [
{
"script": {
"text": "echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks."
}
}
],
"computeResource": {
"cpuMilli": 2000,
"memoryMib": 16
},
"maxRetryCount": 2,
"maxRunDuration": "3600s"
},
"taskCount": 4,
"parallelism": 2
}
],
"allocationPolicy": {
"instances": [
{
"installGpuDrivers" INSTALL_GPU_DRIVERS,
"instanceTemplate": "INSTANCE_TEMPLATE_NAME"
}
]
},
"labels": {
"department": "finance",
"env": "testing"
},
"logsPolicy": {
"destination": "CLOUD_LOGGING"
}
}
Reemplaza lo siguiente:
PROJECT_ID
: Es el ID del proyecto.INSTALL_GPU_DRIVERS
: Opcional Cuando se establece entrue
, Batch recupera los controladores necesarios para el tipo de GPU que especificas en tu plantilla de instancias de VM de Compute Engine, y Batch los instala por ti. Para obtener más información, consulta cómo crear un trabajo que use una GPU.INSTANCE_TEMPLATE_NAME
: Es el nombre de una plantilla de instancias de VM de Compute Engine existente. Aprende a crear y enumerar plantillas de instancias.
Go
Go
Para obtener más información, consulta la documentación de referencia de la API de Batch Go.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Para obtener más información, consulta la documentación de referencia de la API de Batch Java.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Node.js
Para obtener más información, consulta la documentación de referencia de la API de Batch Node.js.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Para obtener más información, consulta la documentación de referencia de la API de Batch Python.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C++
C++
Para obtener más información, consulta la documentación de referencia de la API de Batch C++.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
¿Qué sigue?
- Si tienes problemas para crear o ejecutar un trabajo, consulta Solución de problemas.
- Consulta trabajos y tareas.
- Obtén más información sobre las opciones de creación de trabajos.