Administra ejecuciones de trabajos

En esta página, se describe cómo ver y borrar ejecuciones de trabajos. Para ejecutar, cancelar o anular una configuración de trabajo, consulta Ejecuta trabajos.

Roles obligatorios

Para obtener los permisos que necesitas a fin de administrar los trabajos de Cloud Run, pídele a tu administrador que te otorgue el rol de IAM de desarrollador de Cloud Run (roles/run.developer) en tu trabajo de Cloud Run.

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu trabajo de Cloud Run interactúa con las APIs de Google Cloud, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información acerca de cómo otorgar roles, consulta Permisos de implementación y Administra el acceso.

Visualiza las ejecuciones de trabajos en tu proyecto

Puedes ver una lista de las ejecuciones del trabajo en tu proyecto con la consola de Google Cloud o la CLI de Google Cloud:

Console

Para ver la lista de ejecuciones de un trabajo, sigue estos pasos:

Ir a la página de trabajos de Cloud Run
En la lista, ubica el trabajo cuyas ejecuciones deseas administrar.
Haz clic en el trabajo para ver la lista de ejecuciones.
En la página de detalles de la ejecución, selecciona la ejecución que te interesa en la lista. También puedes usar el conjunto de filtros en los criterios deseados, por ejemplo, Estado con un valor de completado:

gcloud

Para enumerar todas las ejecuciones de trabajos de todos los trabajos de tu proyecto, sigue estos pasos:

gcloud run jobs executions list

Para enumerar solo las ejecuciones de un trabajo específico, haz lo siguiente:

gcloud run jobs executions list --job JOB_NAME

Reemplaza JOB_NAME por el nombre del trabajo que filtras.

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

Para obtener el nombre de la última ejecución de un trabajo específico, usa la marca --format:

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

Reemplaza JOB_NAME por el nombre del trabajo que filtras.

Bibliotecas cliente

Para enumerar todas las ejecuciones de trabajos a partir del código, sigue estos pasos:

API de REST

Para enumerar las ejecuciones de trabajos, 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/executions

Reemplaza lo siguiente:

ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para ver las ejecuciones de 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.

Visualiza los detalles de la ejecución del trabajo

Puedes ver los detalles de la ejecución de trabajos de las 10,000 ejecuciones más recientes de un trabajo mediante el panel de detalles de ejecución, junto con las ejecuciones que se produjeron en los últimos siete días. Se quitan los detalles más antiguos de ejecución y ya no son visibles en el panel de detalles de ejecución. Sin embargo, los registros y los datos de supervisión de las ejecuciones más antiguas aún están disponibles en Cloud Logging y Cloud Monitoring, sujetos a las políticas de retención de esos servicios. productos.

Puedes usar la consola de Google Cloud o Google Cloud CLI para ver más detalles sobre la ejecución de 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
Haz clic en el trabajo para abrir su panel de detalles.
Haz clic en la ejecución de trabajo que quieres ver. Los detalles de la ejecución se muestran en el panel derecho.
Observa las pestañas Tareas, Contenedores, Volúmenes, Herramientas de redes, Seguridad y YAML, así como el vínculo Ver registros.
- Tareas muestra información sobre las tareas en la ejecución del trabajo.
- YAML muestra la configuración del trabajo en formato YAML.
- Haz clic en el vínculo Ver registros para ver los registros relacionados con la ejecución.
- Las otras pestañas muestran información sobre el trabajo, el contenedor, la seguridad, la conectividad y demás datos de la ejecución.

gcloud

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

Usa el comando:

gcloud run jobs executions describe EXECUTION_NAME

Reemplaza EXECUTION_NAME por el nombre de la ejecución.

Puedes usar la marca --format para dar formato al resultado y obtener información adicional. Por ejemplo, como YAML:

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Bibliotecas cliente

Para ver los detalles de la ejecución del trabajo desde el código, sigue estos pasos:

API de REST

Para ver los detalles de la ejecución del trabajo, 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/executions/EXECUTION-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 de la ejecución del trabajo. 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.
EXECUTION-NAME por el nombre de la ejecución del trabajo.
REGION por la región de Google Cloud del trabajo.
PROJECT-ID por el ID del proyecto de Google Cloud.

Borra la ejecución de un trabajo

Puedes borrar la ejecución de un trabajo, incluso durante una ejecución. Si borras una ejecución, se impide que la ejecución continúe.

Aunque una ejecución borrada no aparece en la lista de ejecuciones, 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 disponible en Cloud Monitoring.

Console

Para borrar la ejecución de un trabajo, sigue estos pasos:

Ir a la página de trabajos de Cloud Run
Haz clic en el trabajo para abrir su panel de detalles.
Selecciona la ejecución del trabajo que deseas borrar.
En el menú Acciones, haz clic en el ícono de puntos suspensivos y, luego, en Borrar.
Si se te solicite confirmar la eliminación, haz clic en Confirmar.

gcloud

Para borrar la ejecución de un trabajo, sigue estos pasos:

Usa el comando:
```
gcloud run jobs executions delete EXECUTION_NAME
```
Reemplaza EXECUTION_NAME por el nombre de la ejecución.
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 la ejecución de un trabajo del código, sigue estos pasos:

API de REST

Para borrar la ejecución de un trabajo, envía una solicitud HTTP DELETE 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 DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

Reemplaza lo siguiente:

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