Gestionar ejecuciones de trabajos

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

Roles obligatorios

Para obtener los permisos que necesitas para gestionar tareas de Cloud Run, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Desarrollador de Cloud Run (roles/run.developer) en tu tarea de Cloud Run.

Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos sobre roles de gestión de identidades y accesos de Cloud Run y permisos de gestión de identidades y accesos de Cloud Run. Si tu trabajo de Cloud Run interactúa con APIs deGoogle Cloud , como las bibliotecas de cliente de Cloud, consulta la guía de configuración de la identidad de servicio. Para obtener más información sobre cómo conceder roles, consulta los artículos sobre permisos de implementación y gestión del acceso.

Ver las ejecuciones de trabajos de tu proyecto

Puedes ver una lista de las ejecuciones de trabajos de tu proyecto mediante laGoogle Cloud consola o Google Cloud CLI:

Consola

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

  1. Ir a la página Tareas de Cloud Run

  2. En la lista, busca el trabajo cuyas ejecuciones quieras gestionar.

  3. Haz clic en el trabajo para ver la lista de ejecuciones.

  4. En la página de detalles de la ejecución, selecciona la ejecución que te interese de la lista. También puede usar el filtro para definir los criterios que quiera. Por ejemplo, Estado con el valor Completado:

gcloud

Para ver una lista de todas las ejecuciones de todos los trabajos de tu proyecto, haz lo siguiente:

gcloud run jobs executions list

Para mostrar solo las ejecuciones de un trabajo específico, sigue estos pasos:

gcloud run jobs executions list --job JOB_NAME

Sustituye JOB_NAME por el nombre del trabajo por el que quieres filtrar.

Para ver otras formas de acotar la lista devuelta, 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)"

Sustituye JOB_NAME por el nombre del trabajo por el que quieres filtrar.

Bibliotecas de cliente

Para enumerar todas las ejecuciones de trabajos desde el código:

API REST

Para enumerar las ejecuciones de un trabajo, envía una solicitud HTTP GET al endpoint jobs de la API Admin de Cloud Run.

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

Sustituye:

Ver los detalles de ejecución de un trabajo

Puede ver los detalles de ejecución de las 1000 ejecuciones más recientes de un trabajo en el panel de detalles de ejecución. Los detalles de ejecución antiguos se eliminan y ya no se muestran en el panel de detalles de ejecución. Sin embargo, los registros y los datos de monitorización de las ejecuciones anteriores siguen estando disponibles en Cloud Logging y Cloud Monitoring, de acuerdo con las políticas de conservación de esos productos.

Puedes usar la Google Cloud consola o la CLI de Google Cloud para ver más detalles sobre la ejecución de un trabajo.

Consola

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

  1. Ir a la página Tareas de Cloud Run

  2. Haz clic en el trabajo para abrir el panel de detalles del trabajo.

  3. Haz clic en la ejecución del trabajo que quieras ver. Los detalles de la ejecución se muestran en el panel de la derecha.

  4. Fíjate en las pestañas Tareas, Contenedores, Volúmenes, Redes, Seguridad y YAML, así como en el enlace Ver registros.

    • Tareas muestra información sobre las tareas de la ejecución del trabajo.
    • YAML muestra la configuración del trabajo en formato YAML.
    • Haga clic en el enlace 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, etc., que se han usado en la ejecución.

gcloud

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

Usa el comando:

gcloud run jobs executions describe EXECUTION_NAME

Sustituye EXECUTION_NAME por el nombre de la ejecución.

Puedes usar la marca --format para dar formato a la salida y obtener información adicional. Por ejemplo, en formato YAML:

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Bibliotecas de cliente

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

API REST

Para ver los detalles de la ejecución de un trabajo, envía una solicitud HTTP GET al endpoint jobs de la API Admin de Cloud Run.

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

Sustituye:

Eliminar una ejecución de tarea

Puedes eliminar una ejecución de un trabajo, incluso durante la ejecución. Si eliminas una ejecución, se detendrá.

Aunque una ejecución eliminada no aparece en la lista de ejecuciones, sus registros siguen estando disponibles en Cloud Logging durante el resto del periodo de conservación de los registros, y los datos de monitorización siguen estando disponibles en Cloud Monitoring.

Consola

Para eliminar una ejecución de un trabajo, sigue estos pasos:

  1. Ir a la página Tareas de Cloud Run

  2. Haz clic en el trabajo para abrir el panel de detalles del trabajo.

  3. Selecciona la ejecución del trabajo que quieras eliminar.

  4. En el menú Acciones, haz clic en el icono de los tres puntos y, a continuación, en Eliminar.

  5. Si se te pide que confirmes la eliminación, haz clic en Confirmar.

gcloud

Para eliminar una ejecución de un trabajo, sigue estos pasos:

  1. Usa el comando:

    gcloud run jobs executions delete EXECUTION_NAME

    Sustituye EXECUTION_NAME por el nombre de la ejecución.

  2. Si se te pide que confirmes la acción, responde y. Si la operación se realiza correctamente, se mostrará un mensaje de éxito.

Bibliotecas de cliente

Para eliminar una ejecución de un trabajo desde el código, sigue estos pasos:

API REST

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

Sustituye: