Administrar empleos

En esta página, se describe cómo administrar los trabajos. Para crear un nuevo trabajo, consulta Crea trabajos. Para ejecutar un trabajo, consulta Ejecuta trabajos.

Resumen de etiquetas de imágenes y contenedores para trabajos de Cloud Run

La forma en que actualizas tu trabajo para ejecutar la última versión de tu código depende de si especificaste una imagen de contenedor con una etiqueta o un resumen.

Cuando creas un trabajo, puedes especificar una imagen de contenedor con una etiqueta, por ejemplo, gcr.io/my-project/my-image:tag, o con un resumen exacto, por ejemplo, gcr.io/my-project/my-image@sha256:41f34ab970ee.... Si no especificas ninguno de estos, se usa la etiqueta :latest.

Si especificaste una imagen de contenedor con una etiqueta, Cloud Run resuelve la imagen en un resumen específico cuando ejecutas el trabajo. Esto significa que no necesitas actualizar tu trabajo de forma explícita para seleccionar la versión más reciente de tu contenedor la próxima vez que ejecutes tu trabajo.

Si prefieres que tu trabajo use un resumen de contenedor específico cada vez que se ejecuta, puedes especificar una imagen de contenedor con un resumen exacto. En este caso, debes actualizar tu trabajo de forma explícita para usar un resumen diferente si deseas que tu trabajo recoja los cambios de código que realizaste:

gcloud run jobs update JOB_NAME --image IMAGE_URL

Reemplazar

JOB_NAME por un nombre en minúscula sin guiones bajos
IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest

Sin importar cómo especifiques tu imagen de contenedor, todas las tareas de una ejecución siempre usarán el mismo resumen de imágenes de contenedor.

Visualiza los trabajos de tu proyecto

Puedes ver una lista de los trabajos de tu proyecto con la línea de comandos de gcloud:

Console

Para ver los trabajos, sigue estos pasos:

Ir a la página de trabajos de Cloud Run.
De manera opcional, filtra el trabajo por alguno de los criterios del menú desplegable, como el nombre del trabajo, el tiempo de ejecución, la región, etcétera.

Línea de comandos

Para enumerar todos los trabajos de tu proyecto, sigue estos pasos:
```
gcloud run jobs list
```
Para filtrar trabajos por región, haz lo siguiente:
```
gcloud run jobs list --region REGION
```
Reemplaza REGION por el nombre de la región en la que filtras, por ejemplo, us-central1.

Para conocer otras formas de definir mejor la lista que se muestra, incluido el uso de filtros, consulta la lista de trabajos.

Bibliotecas cliente

Para ver los trabajos de tu proyecto desde el código, sigue estos pasos:

API de REST

Para ver la lista de trabajos de tu proyecto, envía una solicitud HTTP GET 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 GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs

Reemplaza lo siguiente:

ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para ver 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.
REGION por la región de Google Cloud del trabajo.
PROJECT-ID por el ID del proyecto de Google Cloud.

Ver detalles del trabajo

Usa la línea de comandos de gcloud para ver más detalles sobre un trabajo.

Console

Para ver los detalles de una ejecución de trabajo específica, sigue estos pasos:

Ir a la página de trabajos de Cloud Run
Ubica el trabajo que te interesa.
Haz clic en el trabajo para mostrar su página de detalles.
Observa las pestañas Historial, Configuración, Registros y YAML.
- La pestaña Historial muestra información sobre las tareas en la ejecución del trabajo.
- Registros muestra la información de los registros.
- Configuración muestra información sobre el trabajo, el contenedor, la seguridad, la conectividad, etcétera.
- YAML muestra la configuración del trabajo en formato YAML.

Línea de comandos

Para ver los detalles de un trabajo, sigue estos pasos:

Usa el comando:

gcloud run jobs describe  JOB_NAME

Reemplaza JOB_NAME por el nombre del trabajo.

Bibliotecas cliente

Para visualizar los detalles sobre un trabajo a partir de código, haz lo siguiente:

API de REST

Para ver los detalles de un servicio, envía una solicitud HTTP GET 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 GET \
  -d '' \
  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 ver los detalles del servicio. 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.
REGION por la región de Google Cloud del trabajo.
PROJECT-ID por el ID del proyecto de Google Cloud.

Borra un trabajo

Puedes borrar un trabajo solo si no hay ejecuciones de ese trabajo en ejecución.

Aunque un trabajo borrado ya no aparece en la lista de trabajos, sus registros siguen disponibles en Cloud Logging durante el resto del período de retención de registros y los datos de supervisión siguen estando disponibles en Cloud Monitoring.

Console

Para borrar un trabajo, sigue estos pasos:

Ir a la página de trabajos de Cloud Run
Selecciona el trabajo.
Haz clic en Borrar.

Línea de comandos

Para borrar un trabajo, sigue estos pasos:

Usa el comando:
```
gcloud run jobs delete JOB_NAME
```
Reemplaza JOB_NAME por el nombre del trabajo.
Si se te solicita confirmar, responde y. Si la operación se completa de manera correcta, se mostrará un mensaje de éxito.

Bibliotecas cliente

Para borrar un trabajo del código, sigue estos pasos:

API de REST

Para borrar un trabajo, envía una solicitud HTTP DELETE 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 DELETE \
  -d '' \
  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 borrar 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.
REGION por la región de Google Cloud del trabajo.
PROJECT-ID por el ID del proyecto de Google Cloud.