Crear trabajos

En esta página, se describe cómo crear y actualizar trabajos de Cloud Run a partir de una imagen de contenedor existente. A diferencia de un servicio de Cloud Run, que escucha y entrega solicitudes, un trabajo de Cloud Run solo ejecuta sus tareas y se cierra cuando finaliza. Un trabajo no escucha ni entrega solicitudes.

Después de crear o actualizar un trabajo, puedes hacer lo siguiente:

Puedes estructurar un trabajo como una sola tarea o como varias tareas independientes (hasta 10,000 tareas) que se pueden ejecutar en paralelo. Cada tarea ejecuta una instancia de contenedor y se puede configurar para que se reintente en caso de falla. Cada tarea conoce su índice, que se almacena en la variable de entorno CLOUD_RUN_TASK_INDEX. El recuento general de tareas se almacena en la variable de entorno CLOUD_RUN_TASK_COUNT. Si procesas datos en paralelo, el código es responsable de determinar qué tarea controla qué subconjunto de los datos.

Puedes establecer tiempos de espera para las tareas y especificar la cantidad de reintentos en caso de falla de la tarea. Si alguna tarea excede la cantidad máxima de reintentos, esa tarea se marca como con errores y el trabajo se marca como con errores una vez que se ejecuten todas las tareas.

De forma predeterminada, cada tarea se ejecuta durante 10 minutos como máximo: puedes cambiar a un tiempo más corto o a un máximo de 24 horas. Para ello, cambia la configuración del tiempo de espera de las tareas.

No hay un tiempo de espera explícito para la ejecución de un trabajo: después de que se completaron todas las tareas, la ejecución del trabajo está completa.

Los trabajos usan el entorno de ejecución de segunda generación.

Permisos de IAM necesarios para crear y ejecutar

Para usar trabajos de Cloud Run, debes tener uno de los siguientes roles:

  • Administrador de Cloud Run para obtener permisos completos para crear, actualizar, borrar y ejecutar trabajos
  • Invocador de Cloud Run para ejecutar trabajos
  • Visualizador de Cloud Run para ver y enumerar trabajos

Si configuras un rol personalizado, usa los siguientes permisos:

  • run.jobs.{create/update/run/delete/get/list/getIamPolicy/setIamPolicy}
  • run.executions.{get/list/delete}
  • run.tasks.{get/list}

run.jobs.run permite que un usuario ejecute un trabajo para iniciar una ejecución nueva. No hay un permiso de run.executions.create separado: la única forma de crear una ejecución es ejecutar un trabajo.

Imágenes y registros de contenedores compatibles

Puedes usar imágenes de contenedor almacenadas en Artifact Registry, Container Registry (obsoleto o Docker Hub. Google recomienda el uso de Artifact Registry.

Solo puedes usar los siguientes tipos de imágenes de contenedor:

Solo debes considerar Docker Hub para implementar imágenes de contenedor populares, como las imágenes oficiales de Docker o las imágenes de OSS patrocinadas por Docker. Para obtener una mayor disponibilidad, Google recomienda implementar estas imágenes de Docker Hub mediante un repositorio remoto de Artifact Registry.

Si almacenas imágenes de contenedor en otro tipo de Container Registry, sigue las instrucciones en implementar imágenes de registros no compatibles.

Crea un trabajo nuevo

Puedes crear un trabajo nuevo mediante la consola de Google Cloud, Google Cloud CLI, YAML o Terraform.

Consola

Para crear un trabajo nuevo, sigue estos pasos:

  1. Ir a Cloud Run

  2. Haz clic en la pestaña Trabajos.

  3. Haz clic en Crear trabajo para mostrar el formulario Crear trabajo.

    1. En el formulario, especifica la imagen de contenedor que contiene el código del trabajo o selecciona los elementos de una lista de contenedores implementados antes.
    2. El nombre del trabajo se genera de forma automática a partir de la imagen de contenedor. Puedes editar o cambiar el nombre del trabajo según sea necesario. El nombre de un trabajo no se puede cambiar después de que se crea el trabajo.
    3. Selecciona la región donde quieres que se ubique el trabajo. El selector de regiones destaca las regiones con el impacto de carbono más bajo.
    4. Especifica la cantidad de tareas que deseas ejecutar en el trabajo. Todas las tareas deben realizarse con éxito para que el trabajo tenga éxito. De forma predeterminada, las tareas se ejecutan en paralelo.
  4. Haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para establecer propiedades adicionales del trabajo.

    • En Capacidad de la tarea:
    1. En el menú desplegable Memoria, especifica la cantidad de memoria requerida. El valor predeterminado es el mínimo requerido, 512 MiB.
    2. En el menú desplegable de CPU, especifica la cantidad de CPU requerida. El valor predeterminado es el mínimo requerido, 1 CPU.
    3. En Tiempo de espera de la tarea, especifica la cantidad máxima de tiempo en segundos que la tarea puede ejecutarse, hasta 24 horas. Consulta Configura el tiempo de espera de las tareas para obtener detalles completos y las limitaciones del uso de más de una hora. Cada tarea debe completarse dentro de este plazo: El tiempo predeterminado es 10 minutos (600 segundos).

    4. En Cantidad de reintentos por tarea con errores, especifica la cantidad de reintentos en caso de fallas de tarea. El valor predeterminado es 3 reintentos.

    • En paralelismo:

      1. En la mayoría de los casos, puedes seleccionar Ejecutar tantas tareas como sea posible.
      2. Si necesitas establecer un límite inferior debido a las restricciones de escalamiento en los recursos a los que accede tu trabajo, selecciona Limita la cantidad máxima de tareas simultáneas y especificar la cantidad de tareas simultáneas en el cuadro de texto Límite de paralelismo personalizado.
  5. De manera opcional, configura otras opciones de configuración en las pestañas correspondientes:

  6. Cuando termines de configurar tu trabajo, haz clic en Crear para crear el trabajo en Cloud Run.

  7. Para ejecutar el trabajo, consulta Ejecuta trabajos o Ejecuta trabajos según una programación.

Línea de comandos

Para usar la línea de comandos, debes tener configurada gcloud CLI.

Para crear un trabajo nuevo, sigue estos pasos:

  1. Ejecute el comando:

    gcloud run jobs create JOB_NAME --image IMAGE_URL OPTIONS
    Como alternativa, usa el comando de implementación:
    gcloud run jobs deploy JOB_NAME --image IMAGE_URL OPTIONS

    • Reemplaza JOB_NAME por el nombre del trabajo que deseas crear. Puedes omitir este parámetro, pero se te solicitará el nombre del trabajo si lo haces.
    • Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest.
    • De manera opcional, reemplaza OPTIONS por cualquiera de las siguientes opciones:

      Opción Descripción
      --tasks Acepta números enteros mayores o iguales que 1. El valor predeterminado es 1; el máximo es 10,000. Cada tarea recibe las variables de entorno CLOUD_RUN_TASK_INDEX con un valor entre 0 y el número de tareas menos 1, junto con CLOUD_RUN_TASK_COUNT, que es la cantidad de tareas
      --max-retries La cantidad de veces que se reintenta una tarea con errores. Una vez que una tarea falla más allá de este límite, todo el trabajo se marca como con errores. Por ejemplo, si se establece en 1, una tarea con errores se reintenta una vez, para un total de dos intentos. El valor predeterminado es 3. Acepta números enteros del 0 al 10.
      --task-timeout Acepta una duración como “2s”. La configuración predeterminada es de 10 minutos. El máximo es de 24 horas. Consulta Configura el tiempo de espera de las tareas para obtener detalles completos y las limitaciones del uso de más de una hora.
      --parallelism La cantidad máxima de tareas que se pueden ejecutar en paralelo. De forma predeterminada, las tareas se iniciarán lo más rápido posible en paralelo. Consulta Paralelismo para conocer el rango de valores.
      --execute-now Si se configura, de inmediato después de crear el trabajo, se inicia una ejecución de trabajo. Equivalente a llamar a gcloud run jobs create seguido de gcloud run jobs execute.

      Además de las opciones anteriores, también debes especificar más opciones de configuración, como variables de entorno o límites de memoria.

      Para obtener una lista completa de las opciones disponibles cuando creas un trabajo, consulta la documentación de la línea de comandos gcloud run jobs create.

  2. Espera a que finalice la creación del trabajo. Verás un mensaje de éxito cuando finalices de forma correcta.

  3. Para ejecutar el trabajo, consulta Ejecuta trabajos o Ejecuta trabajos según una programación.

YAML

Puedes almacenar la especificación de trabajo en un archivo YAML y, luego, implementarla con gcloud CLI.

  1. Crea un archivo job.yaml nuevo con este contenido:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - image: IMAGE

    Reemplazar

    • JOB por el nombre del trabajo de Cloud Run. Los nombres de trabajos deben tener 49 caracteres o menos, y deben ser únicos por región y proyecto.
    • IMAGE por la URL de la imagen de contenedor.

    También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.

  2. Implementa el servicio nuevo mediante el siguiente comando:

    gcloud run jobs replace job.yaml

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Para crear un nuevo trabajo de Cloud Run, usa el recurso google_cloud_run_v2_job y modifica tu archivo main.tf como se muestra en el siguiente fragmento.

resource "google_cloud_run_v2_job" "default" {
  provider     = google-beta
  name         = "cloud-run-job"
  location     = "us-central1"
  launch_stage = "BETA"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Bibliotecas cliente

Para crear un trabajo a partir de código, haz lo siguiente:

Ubicaciones de Cloud Run

Cloud Run es regional, lo que significa que la infraestructura que ejecuta los servicios se ubica en una región específica, y Google la administra para que esté disponible de manera redundante en todas las zonas de esa región.

El cumplimiento de los requisitos de latencia, disponibilidad o durabilidad es el factor principal para seleccionar la región en la que se ejecutan los servicios de Cloud Run. Por lo general, puedes seleccionar la región más cercana a los usuarios, pero debes considerar la ubicación de los otros productos de Google Cloud que usa el servicio de Cloud Run. Si usas productos de Google Cloud en varias ubicaciones, la latencia y el costo del servicio pueden verse afectados.

Cloud Run está disponible en las siguientes regiones:

Sujetas a los Precios del nivel 1

  • asia-east1 (Taiwán)
  • asia-northeast1 (Tokio)
  • asia-northeast2 (Osaka)
  • europe-north1 (Finlandia)ícono de hoja Bajo nivel de CO2
  • europe-southwest1 (Madrid)
  • europe-west1 (Bélgica) ícono de hoja Bajo nivel de CO2
  • europe-west4 (Países Bajos)
  • europe-west8 (Milán)
  • europe-west9 (París) ícono de hoja Bajo nivel de CO2
  • me-west1 (Tel Aviv)
  • us-central1 (Iowa) ícono de hoja Bajo nivel de CO2
  • us-east1 (Carolina del Sur)
  • us-east4 (Virginia del Norte)
  • us-east5 (Columbus)
  • us-south1 (Dallas)
  • us-west1 (Oregón) ícono de hoja Bajo nivel de CO2

Sujetas a los Precios del nivel 2

  • africa-south1 (Johannesburgo)
  • asia-east2 (Hong Kong)
  • asia-northeast3 (Seúl, Corea del Sur)
  • asia-southeast1 (Singapur)
  • asia-southeast2 (Yakarta)
  • asia-south1 (Bombay, India)
  • asia-south2 Delhi (India)
  • australia-southeast1 (Sídney)
  • australia-southeast2 (Melbourne)
  • europe-central2 (Varsovia, Polonia)
  • europe-west10 (Berlín)
  • europe-west12 (Turín)
  • europe-west2 (Londres, Reino Unido) ícono de hoja Bajo nivel de CO2
  • europe-west3 (Fráncfort, Alemania) ícono de hoja Bajo nivel de CO2
  • europe-west6 (Zúrich, Suiza) ícono de hoja Bajo nivel de CO2
  • me-central1 (Doha)
  • me-central2 (Dammam)
  • northamerica-northeast1 (Montreal) ícono de hoja Bajo nivel de CO2
  • northamerica-northeast2 (Toronto) ícono de hoja Bajo nivel de CO2
  • southamerica-east1 (São Paulo, Brasil) ícono de hoja Bajo nivel de CO2
  • southamerica-west1 (Santiago, Chile) ícono de hoja Bajo nivel de CO2
  • us-west2 (Los Ángeles)
  • us-west3 (Salt Lake City)
  • us-west4 (Las Vegas)

Si ya creaste un servicio de Cloud Run, puedes ver la región en el panel de Cloud Run en la consola de Google Cloud.

Cuando creas un trabajo nuevo, el agente de servicio de Cloud Run debe poder acceder al contenedor, que es el caso predeterminado.

Actualiza un trabajo existente

Para cambiar cualquier configuración de configuración, debes actualizar el trabajo, incluso si no hay cambios en la imagen de contenedor. Ten en cuenta que para cualquier configuración sin cambios, la configuración anterior continúa usándose.

Puedes actualizar un trabajo existente con la consola de Google Cloud, Google Cloud CLI, YAML o Terraform.

Consola

Para actualizar un trabajo existente, sigue estos pasos:

  1. Ir a Cloud Run

  2. Haz clic en la pestaña Trabajos para ver la lista de trabajos.

  3. Haz clic en el trabajo deseado para mostrar la página Detalles del trabajo.

  4. Haz clic en Edit.

  5. Si realizaste cambios en el código de tu trabajo, especifica el resumen de la imagen del contenedor nuevo.

  6. De manera opcional, cambia la cantidad de tareas que están en el trabajo si es necesario.

  7. De manera opcional, haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para actualizar las propiedades adicionales del trabajo como desees:

    • En Capacidad de la tarea:
    1. En el menú desplegable Memoria, especifica la cantidad de memoria requerida. El valor predeterminado es el mínimo requerido, 512 MiB.
    2. En el menú desplegable de CPU, especifica la cantidad de CPU requerida. El valor predeterminado es el mínimo requerido, 1 CPU.
    3. En Tiempo de espera de la tarea, especifica la cantidad máxima de tiempo en segundos que la tarea puede ejecutarse, hasta 24 horas. Cada tarea debe completarse dentro de este plazo. El tiempo predeterminado es 10 minutos (600 segundos).
    4. En Cantidad de reintentos por tarea con errores, especifica la cantidad de reintentos en caso de fallas de tarea. El valor predeterminado es 3 reintentos.
    • En paralelismo:

      1. En la mayoría de los casos, puedes seleccionar Ejecutar tantas tareas como sea posible.
      2. Si necesitas establecer un límite inferior debido a las restricciones de escalamiento en los recursos a los que accede tu trabajo, selecciona Limita la cantidad de tareas simultáneas y especificar la cantidad máxima de tareas simultáneas en el cuadro de texto Límite de paralelismo personalizado.
  8. De manera opcional, configura otras opciones de configuración en las pestañas correspondientes:

  9. Cuando termines de configurar tu trabajo, haz clic en Guardar para crear el trabajo en Cloud Run y espera a que termine la creación del trabajo.

  10. Para ejecutar el trabajo, consulta Ejecuta trabajos o Ejecuta trabajos según una programación.

Línea de comandos

  1. En la consola de Google Cloud, activa Cloud Shell.

    Activar Cloud Shell

    En la parte inferior de la consola de Google Cloud, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Ejecute el comando:

    gcloud run jobs update JOB_NAME

    Reemplazar

    • JOB_NAME por el nombre del trabajo que deseas actualizar
    • De manera opcional, reemplaza OPTIONS por las siguientes opciones:

      Opción Descripción
      --tasks Acepta números enteros iguales o mayores que 1. El valor predeterminado es 1; el máximo es 10,000. Cada tarea recibe las variables de entorno CLOUD_RUN_TASK_INDEX con un valor entre 0 y el número de tareas menos 1, junto con CLOUD_RUN_TASK_COUNT, que es la cantidad de tareas
      --max-retries La cantidad de veces que se reintenta una tarea con errores. Una vez que una tarea falla más allá de este límite, todo el trabajo se marca como con errores. Por ejemplo, si se establece en 1, una tarea con errores se reintenta una vez, para un total de dos intentos. El predeterminado es 3. Acepta números enteros del 0 al 10.
      --task-timeout Acepta una duración como “2s”. La configuración predeterminada es de 10 minutos. El máximo es de 24 horas.
      --parallelism La cantidad máxima de tareas que se pueden ejecutar en paralelo. De forma predeterminada, las tareas se iniciarán lo más rápido posible en paralelo. Consulta Paralelismo para conocer el rango de valores.

    Además de las opciones anteriores, puedes definir otras opciones de configuración opcionales:

    Para obtener una lista completa de las opciones disponibles cuando creas un trabajo, consulta la documentación de la línea de comandos gcloud run jobs create.

  3. Espera a que finalice la actualización del trabajo. Cuando el proceso finalice correctamente, se mostrará un mensaje similar al siguiente:

    Job [JOB_NAME] has been successfully updated.
    View details about this job by running `gcloud run jobs describe JOB_NAME`.
    See logs for this execution at: https://console.cloud.google.com/logs/viewer?project=PROJECT_ID&resource=cloud_run_revision/service_name/JOB_NAME
    
  4. Para ejecutar el trabajo, consulta Ejecuta trabajos o Ejecuta trabajos según una programación.

YAML

Si necesitas descargar o ver la configuración de un trabajo existente, usa el siguiente comando para guardar los resultados en un archivo YAML:

gcloud run jobs describe JOB --format export > job.yaml

Desde un archivo YAML de configuración de trabajo, modifica cualquier atributo secundario spec.template como desees para actualizar los parámetros de configuración y, luego, vuelve a implementar:

  1. Actualiza la configuración del trabajo existente:

    gcloud run jobs replace job.yaml
  2. Para ejecutar el trabajo, consulta Ejecuta trabajos o Ejecuta trabajos según una programación.

Terraform

Realiza los cambios a la configuración de tu trabajo en tu archivo main.tf con el comando terraform apply. Las instrucciones detalladas de Terraform están disponibles para los siguientes elementos:

Para obtener más información, consulta las opciones de línea de comandos terraform apply.

Bibliotecas cliente

Sigue estos pasos para actualizar un trabajo existente a partir de código:

Código de muestra

Para ver muestras de código con trabajos simples, consulta las guías de inicio rápido específicas del lenguaje.

¿Qué sigue?

Después de crear o actualizar un trabajo, puedes hacer lo siguiente: