Comienza a usar Batch

En esta página, se describe cómo comenzar a usar Batch para Google Cloud.

Descripción general

Batch es un servicio completamente administrado que te permite programar, poner en cola y ejecutar cargas de trabajo de procesamiento por lotes en los recursos de Google Cloud. Batch aprovisiona recursos y administra la capacidad en tu nombre, lo que permite que tus cargas de trabajo por lotes se ejecuten a gran escala.

Con Batch, no necesitas configurar y administrar programadores de trabajos de terceros, aprovisionar y desaprovisionar recursos ni solicitar recursos de a una zona a la vez. A fin de ejecutar un trabajo, debes especificar parámetros para los recursos necesarios para tu carga de trabajo y, luego, Batch obtiene los recursos y pone en cola el trabajo para su ejecución. Batch proporciona integración nativa con otros servicios de Google Cloud para ayudar en la programación, la ejecución, el almacenamiento y el análisis de trabajos por lotes, de modo que puedas enfocarte en enviar un trabajo y consumir los resultados.

El lote consta de los siguientes componentes:

  • Trabajo: Es un programa programado que ejecuta un conjunto de tareas hasta su finalización sin ninguna interacción del usuario, por lo general, para cargas de trabajo de procesamiento. Por ejemplo, un trabajo puede ser una sola secuencia de comandos de shell o un cálculo complejo de varias partes.

    Un trabajo se ejecuta mediante una o más acciones específicas llamadas tareas. Cada trabajo de Batch consta de un arreglo de una o más tareas que ejecutan los mismos ejecutables, que son secuencias de comandos ejecutables y contenedores para tu trabajo. Las tareas de un trabajo se pueden ejecutar en paralelo o de forma secuencial en los recursos del trabajo.

  • Tareas: Acciones programáticas que se definen como parte de un trabajo y se ejecutan cuando se ejecuta el trabajo. Cada tarea es parte del grupo de tareas de un trabajo. Los objetos ejecutables se ejecutan en cada tarea del trabajo.

  • Recursos: La infraestructura necesaria para ejecutar un trabajo. Cada trabajo por lotes se ejecuta en un grupo de instancias administrado regional (MIG) de instancias de máquina virtual (VM) de Compute Engine según los requisitos y la ubicación especificados del trabajo. Si se especifica, un trabajo también puede usar recursos de procesamiento adicionales, como GPU, o recursos de almacenamiento de lectura y escritura adicionales, como SSD locales o un bucket de Cloud Storage. Algunos de los factores que determinan la cantidad de VM aprovisionadas para un trabajo incluyen los recursos de procesamiento necesarios para cada tarea y el paralelismo del trabajo: si deseas que las tareas se ejecuten de forma secuencial en una VM o de forma simultánea en varias.

En resumen, Batch te permite crear y ejecutar trabajos que aprovisionan y usan de forma automática los recursos necesarios para ejecutar sus tareas.

Precios

No se aplican costos adicionales por usar Batch. Solo se te cobrará el costo de los recursos subyacentes necesarios para ejecutar tus trabajos.

Para obtener más información sobre los costos asociados con Batch y cómo filtrar los informes de Facturación de Cloud para ver los costos de Batch, consulta Precios.

Restricciones

Batch tiene las siguientes restricciones:

Requisitos previos

Para comenzar a usar Batch, completa los siguientes requisitos previos:

  1. Si tu proyecto nunca usó Batch, habilita Batch para tu proyecto.
  2. Configura Batch para cada usuario nuevo.

Habilita Batch para un proyecto

Para comenzar a usar Batch con un proyecto, haz lo siguiente:

  1. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  2. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud. Obtén información sobre cómo verificar si la facturación está habilitada en un proyecto.

  3. Asegúrate de que Batch esté habilitado para tu proyecto:

    1. Habilita las API de Batch mediante la consola de Google Cloud o Google Cloud CLI.

      Consola

      Habilita las API de Batch, Compute Engine, and Cloud Logging.

      Habilita las API

      gcloud

      Habilita las APIs de Batch, Compute Engine, and Cloud Logging: 

      gcloud services enable batch.googleapis.comcompute.googleapis.comlogging.googleapis.com

    2. A fin de asegurarte de que la cuenta de servicio de cada trabajo tenga los permisos necesarios a fin de permitir que el agente de servicio de Batch cree y acceda a recursos para trabajos, pídele a tu administrador que otorgue las siguientes funciones de IAM a cualquier cuenta de servicio que use tu proyecto para los trabajos de Batch.

      La cuenta de servicio que usa cada trabajo es la cuenta de servicio predeterminada de Compute Engine, pero también puedes personalizar la cuenta de servicio que usa un trabajo.

      • Informante del agente por lotes (roles/batch.agentReporter) en el proyecto
      • Para permitir que los trabajos accedan a un bucket de Cloud Storage, haz lo siguiente: Administrador de almacenamiento (roles/storage.admin) en el bucket
      • Para permitir que los trabajos generen registros en Cloud Logging, Escritor de registros (roles/logging.logWriter) en el proyecto

      Para obtener más información sobre cómo otorgar funciones a cuentas de servicio, consulta Restringe las cuentas de servicio y Administra el acceso a las cuentas de servicio.

    3. (No es necesario realizar ninguna acción). Ten en cuenta que, después de crear un trabajo por lotes, el agente de servicio por lotes (una cuenta de servicio administrada por Google) se crea automáticamente para el proyecto con el siguiente nombre:

      service-PROJECT_NUMBER@gcp-sa-cloudbatch.iam.gserviceaccount.com

      Reemplaza PROJECT_NUMBER por el número de proyecto de tu proyecto.

      Al agente de servicio por lotes se le otorga la función de IAM de Google Batch Service Agent (roles/batch.serviceAgent) de forma automática. Esta configuración es obligatoria para que tu proyecto use Batch.

      Para obtener más información, consulta Agentes de servicio.

Configura Batch para un usuario nuevo

Para comenzar a usar Batch como usuario, haz lo siguiente:

  1. A fin de obtener los permisos que necesitas para usar Batch, pídele a tu administrador que te otorgue las funciones de IAM necesarias en el proyecto. Consulta la documentación de cada tarea para ver los permisos necesarios.

    Por ejemplo, si quieres comenzar a aprender cómo usar Batch mediante la creación de un trabajo básico, considera solicitar funciones para las siguientes tareas:

    • Para crear trabajos, sigue estos pasos:
    • Para enumerar y describir trabajos: Editor de trabajos por lotes (roles/batch.jobsEditor) o Visualizador de trabajos por lotes (roles/batch.jobsViewer) en el proyecto
    • Para ver los registros de trabajos, usa el visor de registros (roles/logging.viewer) en el proyecto.
    • Para borrar trabajos, usa el Editor de trabajos por lotes (roles/batch.jobsEditor) del proyecto.

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

  2. Si deseas usar los ejemplos de línea de comandos para Batch, haz lo siguiente a fin de configurar Google Cloud CLI. Obtén más información sobre la autenticación de Google Cloud CLI.

    1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

      gcloud init

    2. Recomendado: Configura un proyecto predeterminado con el comando gcloud config set project:

      gcloud config set project PROJECT_ID

      Reemplaza PROJECT_ID por el ID del proyecto.

  3. Si deseas usar los ejemplos de la API o de la biblioteca cliente para Batch, consulta Autentica en Batch.

Obtenga asistencia

Puedes hablar sobre Batch con la comunidad en los foros de Cloud.

Si tienes problemas con Batch, consulta la documentación de solución de problemas.

Si deseas obtener asistencia o enviar comentarios sobre Batch, usa los siguientes recursos:

  • Si tienes problemas de facturación con Google Cloud, comunícate con el equipo de Asistencia para facturación.

  • Si tienes un paquete de asistencia pagada, comunícate directamente con el equipo de Asistencia de Google Cloud para los problemas con Batch.

    Google Cloud ofrece diferentes paquetes de asistencia para satisfacer distintas necesidades, como acceso a un administrador de asistencia técnica, asistencia telefónica y cobertura las 24 horas, todos los días. Para obtener más información, consulta Planes de asistencia de Google Cloud Platform.

  • A fin de proporcionar comentarios o solicitudes de funciones para Batch o informar sobre problemas de Batch sin un paquete de asistencia pagado, haz clic en el botón Enviar comentarios, que encontrarás al principio y al final de cada página de documentación de Batch. Luego, selecciona una de las siguientes opciones:

    • Para obtener comentarios relacionados con la documentación de Batch, selecciona “Comentarios de documentación”.
    • Para todos los demás comentarios sobre Batch, selecciona “Comentarios sobre el producto”.

¿Qué sigue?