Crear trabajos

Consola

Para crear un trabajo nuevo, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Cloud Run:

   Ir a Cloud Run

2. Haz clic en Implementar contenedor y selecciona 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.

3. Haz clic en Contenedores, volúmenes, herramientas de redes y seguridad para establecer propiedades de trabajo adicionales.

   • En Capacidad de la tarea:
   1. En el menú Memoria, especifica la cantidad de memoria requerida. El valor predeterminado es el mínimo requerido, 512 MiB.
   2. En el menú 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 168 horas (7 días). La compatibilidad con tiempos de espera superiores a 24 horas está disponible en la versión preliminar. 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 especifica la cantidad de tareas simultáneas en el campo Límite de paralelismo personalizado.

4. De manera opcional, configura otras opciones de configuración en las pestañas correspondientes:

   • Configuración del contenedor
   • Límites de CPU
   • Límites de memoria
   • Secretos
   • Variables de entorno
   • Labels
   • Cuentas de servicio
   • Conexiones de Cloud SQL
   • Conectividad VPC

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

6. Para ejecutar el trabajo, consulta ejecuta trabajos o ejecuta trabajos según una programación.

gcloud

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

Para crear un trabajo nuevo, sigue estos pasos:

1. Ejecuta el siguiente 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 168 horas (7 días). La compatibilidad con tiempos de espera superiores a 24 horas está disponible en la versión preliminar.
     --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. Cuando se complete correctamente, verás un mensaje de éxito.

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" {
  name     = "cloud-run-job"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  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:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API de REST

Para crear un trabajo, envía una solicitud HTTP POST a fin de solicitar al extremo jobs de la API de Cloud Run Admin.

Por ejemplo, con curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB_NAME

Reemplaza lo siguiente:

• ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para crear trabajos. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes recuperar un token de acceso a través del servidor de metadatos de instancias de contenedor.
• JOB_NAME: con el nombre del trabajo que deseas crear.
• IMAGE_URL por la URL de la imagen de contenedor del trabajo, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION por la región de Google Cloud del trabajo.
• PROJECT_ID por el ID del proyecto de Google Cloud.

Consola

Para actualizar un trabajo existente, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Cloud Run:

   Ir a Cloud Run

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

3. Haz clic en el trabajo 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 de trabajo adicionales:

   • En Capacidad de la tarea:
   1. En el menú Memoria, especifica la cantidad de memoria requerida. El valor predeterminado es el mínimo requerido, 512 MiB.
   2. En el menú 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 168 horas (7 días). La compatibilidad con tiempos de espera superiores a 24 horas está disponible en la versión preliminar. 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 especifica la cantidad máxima de tareas simultáneas en el campo Límite de paralelismo personalizado.

8. De manera opcional, configura otras opciones de configuración en las pestañas correspondientes:

   • Configuración del contenedor
   • Límites de CPU
   • Límites de memoria
   • Secretos
   • Variables de entorno
   • Labels
   • Cuentas de servicio
   • Conexiones de Cloud SQL
   • Conectividad VPC

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.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Ejecuta el siguiente comando:

   gcloud run jobs update JOB_NAME

   Reemplaza lo siguiente:

   • 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 168 horas (7 días). La compatibilidad con tiempos de espera superiores a 24 horas está disponible en la versión preliminar.
     --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:

   • Configuración del contenedor
   • Límites de CPU
   • Límites de memoria
   • Secretos
   • Variables de entorno
   • Labels
   • Cuentas de servicio
   • Conexiones de Cloud SQL
   • Conexión de VPC

   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:

• Paralelismo
• Máximo de reintentos
• Tiempos de espera

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:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API de REST

Si deseas actualizar un trabajo, envía una solicitud HTTP PATCH a fin de solicitar al extremo jobs de la API de Cloud Run Admin.

Por ejemplo, con curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB_NAME

Reemplaza lo siguiente:

• ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para actualizar trabajos. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes recuperar un token de acceso a través del servidor de metadatos de instancias de contenedor.
• JOB_NAME por el nombre del trabajo que deseas actualizar.
• IMAGE_URL por la URL de la imagen de contenedor del trabajo, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION por la región de Google Cloud del trabajo.
• PROJECT_ID por el ID del proyecto de Google Cloud.