En este documento, se explica cómo definir los recursos de VM para un trabajo por lotes mediante la especificación de una plantilla de instancias de VM de Compute Engine cuando creas el trabajo.
Batch define de forma automática los tipos de recursos de VM en los que se ejecuta un trabajo (subcampos instances[]
), a menos que los definas mediante uno de los siguientes métodos:
- Usa el campo
policy
para definir los recursos de VM de un trabajo directamente, como se muestra en Crea un trabajo básico. - Usa el campo
instanceTemplate
para definir los recursos de VM de un trabajo mediante la especificación de una plantilla de instancias de VM, como se explica en este documento. Este método es necesario para crear un trabajo que use imágenes de VM no predeterminadas.
Antes de comenzar
- Si no has usado Batch antes, revisa Comienza a usar Batch y completa los requisitos previos para los proyectos y usuarios a fin de habilitar Batch.
-
Si quieres 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 de forma predeterminada es la cuenta de servicio predeterminada de Compute Engine -
Crea un trabajo a partir de una plantilla de instancia 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 a través de los roles personalizados o de otros roles predefinidos.
-
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 de 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 configura 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 en tu nombre. 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 básicos de secuencia de comandos 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 configura comotrue
, 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 en tu nombre. 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
Si deseas 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
Si deseas 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
Si deseas 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
Si deseas 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++
Si deseas 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.
- Visualiza trabajos y tareas.
- Obtén más información sobre las opciones de creación de trabajos.