Crear y ejecutar una tarea básica

En este documento se explican los conceptos básicos para crear tareas de Batch: cómo crear y ejecutar una tarea basada en una secuencia de comandos o una imagen de contenedor, y cómo usar variables predefinidas y personalizadas. Para obtener más información sobre cómo crear y ejecutar tareas, consulta el artículo Descripción general de la creación y la ejecución de tareas.

Antes de empezar

  1. Si no has usado Batch antes, consulta el artículo Empezar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.

  2. Para obtener los permisos que necesitas para crear un trabajo, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

    Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

    También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

  3. Cada vez que crees un trabajo, asegúrate de que tenga una configuración de red válida.
    • Si tu carga de trabajo o proyecto no tiene ningún requisito de red específico y no has modificado la red predeterminada de tu proyecto, no tienes que hacer nada.
    • De lo contrario, tendrás que configurar la red al crear un trabajo. Consulta cómo configurar la red de un trabajo antes de crear un trabajo básico para poder modificar los ejemplos que se muestran a continuación y adaptarlos a tus requisitos de red.
    Para obtener más información sobre la configuración de red de un trabajo, consulta la información general sobre redes de Batch.
  4. Cada vez que crees un trabajo, asegúrate de que tenga un entorno de sistema operativo (SO) de máquina virtual válido.
    • Si no tienes ningún requisito específico de imagen de SO de VM o de disco de arranque para tu carga de trabajo o proyecto, no tienes que hacer nada.
    • De lo contrario, debes preparar una opción de entorno de SO de VM válida. Antes de crear un trabajo básico, puedes usar la configuración predeterminada del entorno del SO de la VM o personalizarlo para adaptar los ejemplos que se muestran a continuación a tus necesidades.
    Para obtener más información sobre el entorno del SO de la VM de un trabajo, consulta la descripción general del entorno del SO de la VM.

Crear una tarea básica

Para obtener información sobre todos los campos que puede especificar en un trabajo, consulte la documentación de referencia del recurso REST projects.locations.jobs. En resumen, un trabajo consta de una matriz de una o varias tareas que ejecutan uno o varios ejecutables, que son los scripts o contenedores ejecutables de tu trabajo. Para cubrir los aspectos básicos, en esta sección se explica cómo crear un trabajo de ejemplo con un solo elemento ejecutable, ya sea una secuencia de comandos o una imagen de contenedor:

El trabajo de ejemplo de ambos tipos de trabajos contiene un grupo de tareas con un array de 4 tareas. Cada tarea imprime un mensaje y su índice en la salida estándar y en Cloud Logging. La definición de este trabajo especifica un paralelismo de 2, lo que indica que el trabajo debe ejecutarse en 2 VMs para permitir que se ejecuten 2 tareas a la vez.

Crear un trabajo de contenedor básico

Puedes seleccionar o crear una imagen de contenedor para proporcionar el código y las dependencias para que tu trabajo se ejecute desde cualquier entorno de computación. Para obtener más información, consulta los artículos sobre trabajar con imágenes de contenedor y ejecutar contenedores en instancias de VM.

Puedes crear un trabajo de contenedor básico con la Google Cloud consola, la CLI de gcloud, la API Batch, Go, Java, Node.js, Python o C++.

Consola

Para crear un trabajo de contenedor básico con la Google Cloud consola, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Lista de tareas.

    Ir a la lista de tareas

  2. Haz clic en Crear. Se abrirá la página Crear tarea por lotes. En el panel de la izquierda, se selecciona la página Detalles de la tarea.

  3. Configura la página Detalles del empleo:

    1. Opcional: En el campo Nombre del trabajo, personaliza el nombre del trabajo.

      Por ejemplo, escribe example-basic-job.

    2. Configura la sección Detalles de la tarea:

      1. En la ventana Nuevo ejecutable, añade al menos una secuencia de comandos o un contenedor para que se ejecute este trabajo.

        Por ejemplo, para añadir un contenedor, haz lo siguiente:

        1. Selecciona URL de imagen del contenedor (opción predeterminada).

        2. En el campo URL de la imagen del contenedor, introduce la URL de la imagen del contenedor que quieras ejecutar en cada tarea de este trabajo.

          Por ejemplo, para usar la busyboximagen del contenedor de Docker, introduce la siguiente URL:

          gcr.io/google-containers/busybox

        3. Opcional: Para anular el comando ENTRYPOINT de la imagen de contenedor, introduce un comando en el campo Punto de entrada.

          Por ejemplo, introduce lo siguiente:

          /bin/sh

        4. Opcional: Para anular el comando CMD de la imagen del contenedor, haz lo siguiente:

          1. Seleccione la casilla Anular el comando CMD de la imagen de contenedor. Aparecerá un campo.

          2. En el campo, introduce uno o varios comandos, separando cada uno con un salto de línea.

            Por ejemplo, introduce los siguientes comandos:

            -c
echo Hello world! This is task ${BATCH_TASK_INDEX}. This job has a total of ${BATCH_TASK_COUNT} tasks.

          3. Haz clic en Listo.

      2. En el campo Número de tareas, introduce el número de tareas de este trabajo. El valor debe ser un número entero entre 1 y el límite de tareas por grupo de tareas.

        Por ejemplo, escribe 4.

      3. En el campo Paralelismo, introduce el número de tareas que se van a ejecutar simultáneamente. El número no puede ser superior al número total de tareas y debe ser un número entero comprendido entre 1 y el límite de tareas paralelas por trabajo.

        Por ejemplo, escribe 2.

  4. Configura la página Especificaciones de recursos:

    1. En el panel de la izquierda, haga clic en Especificaciones de recursos. Se abrirá la página Especificaciones de los recursos.

    2. En la sección Modelo de aprovisionamiento de VMs, selecciona una de las siguientes opciones para el modelo de aprovisionamiento de las VMs de este trabajo:

      • Si tu tarea puede soportar la interrupción temporal y quieres máquinas virtuales con descuento, selecciona Acceso puntual.

      • De lo contrario, selecciona Estándar.

      Por ejemplo, selecciona Estándar (opción predeterminada).

    3. Selecciona la ubicación de este trabajo:

      1. En el campo Región, selecciona una región.

        Por ejemplo, selecciona us-central1 (Iowa) (opción predeterminada).

      2. En el campo Zona, haz una de las siguientes acciones:

        • Si quieres que esta tarea solo se ejecute en una zona específica, selecciona una zona.

        • De lo contrario, selecciona cualquiera.

        Por ejemplo, selecciona cualquiera (opción predeterminada).

    4. Selecciona una de las siguientes familias de máquinas:

      • Para las cargas de trabajo habituales, haz clic en Uso general.

      • Para cargas de trabajo que requieran un alto rendimiento, haga clic en Optimizado para la computación.

      • Para cargas de trabajo que requieren un uso intensivo de la memoria, haz clic en Memoria optimizada.

      • En el caso de las cargas de trabajo optimizadas para aceleradores, haga clic en GPUs. Para obtener más información, consulta Crear y ejecutar un trabajo que use GPUs.

      Por ejemplo, haz clic en Propósito general (opción predeterminada).

    5. En el campo Serie, selecciona una serie de máquinas para las VMs de este trabajo.

      Por ejemplo, si has seleccionado General purpose (Usos generales) para la familia de máquinas, selecciona E2 (predeterminado).

    6. En el campo Tipo de máquina, selecciona un tipo de máquina para las VMs de este trabajo.

      Por ejemplo, si has seleccionado E2 para la serie de máquinas, selecciona e2-medium (2 vCPU, 4 GB de memoria) (opción predeterminada).

    7. Configura la cantidad de recursos de VM necesarios para cada tarea:

      1. En el campo Cores (Núcleos), introduce la cantidad de vCPUs por tarea.

        Por ejemplo, introduce 1 (valor predeterminado).

      2. En el campo Memoria, introduce la cantidad de RAM en GB por tarea.

        Por ejemplo, introduce 0.5 (valor predeterminado).

  5. Opcional: Para revisar la configuración del trabajo, en el panel de la izquierda, haz clic en Vista previa.

  6. Haz clic en Crear.

En la página Detalles de la tarea se muestra la tarea que has creado.

gcloud

Para crear un trabajo de contenedor básico con la CLI de gcloud, haz lo siguiente:

  1. Crea un archivo JSON que especifique los detalles de configuración de tu trabajo. Por ejemplo, para crear un trabajo de contenedor básico, crea un archivo JSON con el siguiente contenido. Para obtener más información sobre todos los campos que puedes especificar en un trabajo, consulta la documentación de referencia del recurso REST projects.locations.jobs.

    .