Crear tareas

Consola

Para crear un trabajo, sigue estos pasos:

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

   Ir a Cloud Run

2. Selecciona Trabajos en el menú y haz clic en Implementar contenedor para mostrar el formulario Crear trabajo.

   1. En el formulario, especifica la imagen del contenedor que contiene el código del trabajo o selecciona una de la lista de contenedores desplegados anteriormente.
   2. El nombre del trabajo se genera automáticamente 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 una vez creado.
   3. Selecciona la región en la que quieras que se encuentre tu trabajo. El selector de regiones destaca las regiones con las emisiones de carbono más bajas.
   4. Especifica el número de tareas que quieres ejecutar en el trabajo. Todas las tareas deben completarse correctamente para que el trabajo se realice correctamente. De forma predeterminada, las tareas se ejecutan en paralelo.

3. Haz clic en Contenedores, Volúmenes, Redes y Seguridad para definir propiedades de trabajo adicionales.

   • En Capacidad de tareas:
   1. En el menú Memoria, especifica la cantidad de memoria necesaria. El valor predeterminado es el mínimo necesario, 512 MiB.
   2. En el menú CPU, especifica la cantidad de CPU necesaria. El valor predeterminado es el mínimo necesario, 1 CPU.

   3. En Tiempo de espera de la tarea, especifica el tiempo máximo en segundos que puede ejecutarse la tarea (hasta 168 horas o 7 días). La compatibilidad con los tiempos de espera superiores a 24 horas está disponible en Vista previa. Cada tarea debe completarse en este plazo. El valor predeterminado es 10 minutos (600 segundos).

   4. En Número de reintentos por tarea fallida, especifica el número de reintentos en caso de que se produzcan errores en las tareas. El valor predeterminado es 3 reintentos.

   • En Paralelismo:

     1. En la mayoría de los casos, puedes seleccionar Ejecutar tantas tareas simultáneamente como sea posible.
     2. Si necesitas definir un límite inferior debido a las restricciones de escalado de los recursos a los que accede tu trabajo, selecciona Limitar el número máximo de tareas simultáneas y especifica el número de tareas simultáneas en el campo Límite de paralelismo personalizado.

4. También puedes configurar otros ajustes en las pestañas correspondientes:

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

5. Cuando haya terminado de configurar el trabajo, haga clic en Crear para crear el trabajo en Cloud Run.

6. Para ejecutar la tarea, consulta Ejecutar tareas o Ejecutar tareas según una programación.

gcloud

Para usar la línea de comandos, debes haber configurado la CLI de gcloud.

Para crear un trabajo, sigue estos pasos:

1. Ejecuta el comando:

   gcloud run jobs create JOB_NAME --image IMAGE_URL OPTIONS

   También puedes usar el comando de implementación:

   gcloud run jobs deploy JOB_NAME --image IMAGE_URL OPTIONS

   Haz los cambios siguientes:

   • JOB_NAME: el nombre del trabajo que quieras crear. Si omite este parámetro, se le pedirá el nombre del trabajo cuando ejecute el comando.
   • IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.

   • También puedes sustituir 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 y el máximo es 10.000. A cada tarea se le proporcionan 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 el número de tareas.
     --max-retries	Número de veces que se vuelve a intentar una tarea fallida. Si alguna tarea supera este límite, todo el trabajo se marcará como fallido. Por ejemplo, si se define en 1, una tarea fallida se volverá a intentar una vez, lo que supone un total de dos intentos. y el predeterminado es 3. Acepta números enteros del 0 al 10.
     --task-timeout	Acepta una duración como "2s". El valor predeterminado es de 10 minutos y el máximo es de 168 horas (7 días). La compatibilidad con los tiempos de espera superiores a 24 horas está disponible en Vista previa.
     --parallelism	Número máximo de tareas que se pueden ejecutar en paralelo. De forma predeterminada, las tareas se iniciarán en paralelo lo más rápido posible. Consulta Paralelismo para ver el intervalo de valores.
     --execute-now	Si se define, inmediatamente después de crear el trabajo, se inicia una ejecución del trabajo. Es equivalente a llamar a gcloud run jobs create seguido de gcloud run jobs execute.

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

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

2. Espera a que termine de crearse el trabajo. Si el proceso se completa correctamente, aparecerá un mensaje de confirmación.

3. Para ejecutar la tarea, consulta Ejecutar tareas o Ejecutar tareas según una programación.

YAML

Puedes almacenar la especificación de tu trabajo en un archivo YAML y, a continuación, implementarlo con la CLI de gcloud.

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

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

   Haz los cambios siguientes:

   • JOB: el nombre de tu tarea de Cloud Run. Los nombres de los trabajos deben tener 49 caracteres o menos y ser únicos por región y proyecto.
   • IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.

   También puede especificar más configuraciones, como variables de entorno o límites de memoria.

2. Implementa el nuevo trabajo con el siguiente comando:

   gcloud run jobs replace job.yaml

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

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 de cliente

Para crear un trabajo a partir de un código, sigue estos pasos:

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

API REST

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

Por ejemplo, si usas 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

Haz los cambios siguientes:

• ACCESS_TOKEN: un token de acceso válido para una cuenta que tenga los permisos de gestión de identidades y accesos para crear trabajos. Por ejemplo, si has iniciado sesión en gcloud, puedes obtener un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes obtener un token de acceso mediante el servidor de metadatos de la instancia de contenedor.
• JOB_NAME: el nombre del trabajo que quieras crear.
• IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION: la Google Cloud región del trabajo.
• PROJECT_ID: el ID del proyecto. Google Cloud

Consola

Para actualizar un trabajo, sigue estos pasos:

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

   Ir a Cloud Run

2. Haga clic en la pestaña Tareas para ver la lista de tareas.

3. Haz clic en el trabajo para que se muestre la página Detalles del trabajo.

4. Haz clic en Editar.

5. Si ha hecho cambios en el código de trabajo, especifique el nuevo resumen de imagen del contenedor.

6. Si es necesario, puede cambiar el número de tareas del trabajo.

7. Opcionalmente, haga clic en Contenedores, Volúmenes, Redes y Seguridad para actualizar las propiedades adicionales del trabajo:

   • En Capacidad de tareas:
   1. En el menú Memoria, especifica la cantidad de memoria necesaria. El valor predeterminado es el mínimo necesario, 512 MiB.
   2. En el menú CPU, especifica la cantidad de CPU necesaria. El valor predeterminado es el mínimo necesario, 1 CPU.
   3. En Tiempo de espera de la tarea, especifica el tiempo máximo en segundos que puede ejecutarse la tarea (hasta 168 horas o 7 días). La compatibilidad con los tiempos de espera superiores a 24 horas está disponible en Vista previa. Cada tarea debe completarse en este tiempo. El valor predeterminado es 10 minutos (600 segundos).
   4. En Número de reintentos por tarea fallida, especifica el número de reintentos en caso de que se produzcan errores en las tareas. El valor predeterminado es 3 reintentos.

   • En Paralelismo:

     1. En la mayoría de los casos, puedes seleccionar Ejecutar tantas tareas simultáneamente como sea posible.
     2. Si necesitas definir un límite inferior debido a las restricciones de escalado de los recursos a los que accede tu trabajo, selecciona Limitar el número de tareas simultáneas y especifica el número máximo de tareas simultáneas en el campo Límite de paralelismo personalizado.

8. También puedes configurar otros ajustes en las pestañas correspondientes:

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

9. Cuando hayas terminado de configurar el trabajo, haz clic en Guardar para crear el trabajo en Cloud Run y espera a que se complete la creación del trabajo.

10. Para ejecutar la tarea, consulta Ejecutar tareas o Ejecutar tareas 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 comando:

   gcloud run jobs update JOB_NAME

   Haz los cambios siguientes:

   • JOB_NAME: el nombre del trabajo que quieras actualizar.

   • También puedes sustituir OPTIONS por las siguientes opciones:

     Opción	Descripción
     --tasks	Acepta números enteros iguales o mayores que 1. El valor predeterminado es 1 y el máximo es 10.000. A cada tarea se le proporcionan 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 el número de tareas.
     --max-retries	Número de veces que se vuelve a intentar una tarea fallida. Si alguna tarea supera este límite, todo el trabajo se marcará como fallido. Por ejemplo, si se define en 1, una tarea fallida se volverá a intentar una vez, lo que supone 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". El valor predeterminado es de 10 minutos y el máximo es de 168 horas (7 días). La compatibilidad con los tiempos de espera superiores a 24 horas está disponible en Vista previa.
     --parallelism	Número máximo de tareas que se pueden ejecutar en paralelo. De forma predeterminada, las tareas se iniciarán lo antes posible en paralelo. Consulta Paralelismo para ver el intervalo de valores.

   Además de las opciones anteriores, puede definir otros ajustes de configuración opcionales:

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

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

3. Espera a que termine la actualización del trabajo. Si se completa correctamente, se mostrará un mensaje de éxito 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 la tarea, consulta Ejecutar tareas o Ejecutar tareas según una programación.

YAML

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

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

En un archivo YAML de configuración de una tarea, modifica los spec.template atributos secundarios que necesites para actualizar los ajustes de configuración y, a continuación, vuelve a implementar:

1. Actualiza la configuración de la tarea:

   gcloud run jobs replace job.yaml

2. Para ejecutar la tarea, consulta Ejecutar tareas o Ejecutar tareas según una programación.

Terraform

Modifica la configuración del trabajo en el archivo main.tf con el comando terraform apply. Hay instrucciones detalladas de Terraform disponibles para:

• Paralelismo
• Reintentos máximos
• Tiempos de espera

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

Bibliotecas de cliente

Para actualizar un trabajo a partir de código, sigue estos pasos:

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

API REST

Para actualizar un trabajo, envía una solicitud HTTP PATCH a la API Admin de Cloud Run jobs endpoint.

Por ejemplo, si usas 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

Haz los cambios siguientes:

• ACCESS_TOKEN: un token de acceso válido para una cuenta que tenga los permisos de gestión de identidades y accesos para actualizar trabajos. Por ejemplo, si has iniciado sesión en gcloud, puedes obtener un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes obtener un token de acceso mediante el servidor de metadatos de la instancia de contenedor.
• JOB_NAME: el nombre del puesto que quieras actualizar.
• IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION: la Google Cloud región del trabajo.
• PROJECT_ID: el ID del proyecto. Google Cloud

Consola

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

   Ir a Cloud Run

2. Para implementar en una tarea, haga clic en Tareas, busque la tarea en la lista y haga clic para abrirla. A continuación, haga clic en Ver y editar configuración para mostrar el formulario de edición de la tarea.

3. Para crear un trabajo, haga clic en Desplegar contenedor y, a continuación, en Trabajo. Proporciona el nombre del trabajo y la URL de la imagen del contenedor de trabajo principal que quieras desplegar.

4. Haz clic en Contenedores, volúmenes, redes y seguridad.

5. En la tarjeta Editar contenedor, configura el contenedor de trabajo principal según sea necesario.

6. Haga clic en Añadir contenedor y configure un contenedor auxiliar que quiera añadir junto al contenedor de trabajo principal. Si el sidecar depende de otro contenedor del servicio, indícalo en el menú desplegable Orden de inicio de los contenedores. Repite este paso con cada contenedor sidecar que vayas a implementar.

7. Haz clic en Crear para crear un servicio o en Actualizar para actualizar un trabajo. A continuación, espera a que se complete el despliegue.

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. Para desplegar varios contenedores en un trabajo, ejecuta el siguiente comando:

   gcloud run jobs create JOB \
    --container JOB_CONTAINER_NAME \
    --image='IMAGE_URL' \
    --container SIDECAR_CONTAINER_NAME \
    --image='SIDECAR_IMAGE'

   Haz los cambios siguientes:

   • JOB: el nombre del trabajo al que vas a implementar. Puedes omitir este parámetro por completo, pero se te pedirá el nombre de la tarea si lo haces.
   • JOB_CONTAINER_NAME: un nombre para el contenedor de trabajo principal.
   • IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
   • SIDECAR_CONTAINER_NAME: el nombre del contenedor sidecar, por ejemplo, sidecar.
   • SIDECAR_IMAGE: una referencia a la imagen del contenedor secundario.

   Si quiere configurar cada contenedor en el comando de implementación, proporcione la configuración de cada contenedor después de los parámetros container. Por ejemplo:

   gcloud run jobs create JOB \
     --container CONTAINER_1_NAME \
     --image='IMAGE_URL' \
     --set-env-vars=KEY=VALUE \
     --container SIDECAR_CONTAINER_NAME \
     --image='SIDECAR_IMAGE' \
     --set-env-vars=KEY_N=VALUE_N

3. Espera a que finalice la implementación de los trabajos. Si se completa correctamente, se mostrará un mensaje de éxito.

YAML

En estas instrucciones se muestra un archivo YAML básico para tu trabajo de Cloud Run con sidecars. Crea un archivo llamado job.yaml con el siguiente contenido:

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

Haz los cambios siguientes:

• JOB con el nombre del contenedor de trabajo principal de Cloud Run. Los nombres de los trabajos deben tener 49 caracteres como máximo.
• IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• SIDECAR_IMAGE: una referencia a la imagen del contenedor secundario.

Después de actualizar el archivo YAML para incluir los contenedores de entrada y sidecar, despliega el archivo en Cloud Run con el siguiente comando:

gcloud run jobs replace job.yaml

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Añade lo siguiente a un recurso google_cloud_run_v2_job en tu configuración de Terraform:


resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "europe-west1"

  template {
    template {
      containers {
        name = "CONTAINER_NAME"
        image = "IMAGE_URL"
      }
      containers {
        name = "SIDECAR_CONTAINER_NAME"
        image = "SIDECAR_IMAGE_URL"
      }
    }
  }
}

Haz los cambios siguientes:

• JOB_NAME: el nombre de tu tarea de Cloud Run.
• CONTAINER_NAME: el nombre del contenedor.
• IMAGE_URL: una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
• SIDECAR_CONTAINER_NAME: el nombre del contenedor secundario.
• SIDECAR_IMAGE_URL: una referencia a la imagen del contenedor secundario.