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 para 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 lasGoogle Cloud APIs, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta los permisos de implementación y cómo administrar el acceso.

Visualiza las ejecuciones de trabajos en tu proyecto

Puedes ver una lista de las ejecuciones del trabajo en tu proyecto con laGoogle Cloud consola, la gcloud CLI, las bibliotecas cliente o la API de REST:

Console

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

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

    Ir a Trabajos de Cloud Run

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

  3. En la página de detalles de la ejecución, selecciona la ejecución que te interesa en la lista. De forma opcional, puedes filtrar por criterios.

gcloud

  • Para enumerar todas las ejecuciones de trabajos de todos los trabajos de tu proyecto, ejecuta el siguiente comando:

    gcloud run jobs executions list

  • Para enumerar solo las ejecuciones de un trabajo específico, ejecuta el siguiente comando:

    gcloud run jobs executions list --job JOB

    Reemplaza JOB 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 --format="value(status.latestCreatedExecution.name)"

    Reemplaza JOB por el nombre del trabajo que filtras.

Como alternativa, para ver los detalles de la ejecución de tu trabajo más reciente, consulta Cómo ver los detalles de la ejecución del trabajo.

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/executions

Reemplaza lo siguiente:

  • ACCESS_TOKEN: Es 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.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • REGION: Es la Google Cloud región del trabajo.
  • JOB por el nombre del trabajo de Cloud Run.

Visualiza los detalles de la ejecución del trabajo

Puedes ver los detalles de la ejecución de trabajos de las 1,000 ejecuciones más recientes de un trabajo en el panel de detalles de ejecución. 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 productos.

Puedes ver más detalles sobre la ejecución de un trabajo con la Google Cloud consola, gcloud CLI, las bibliotecas cliente o la API de REST:

Console

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

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

    Ir a Trabajos de Cloud Run

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

  3. Haz clic en la ejecución del trabajo que deseas ver. Los detalles de la ejecución se muestran en el panel derecho. Consulta las pestañas Tareas, Contenedores, Volúmenes, Herramientas de redes, Seguridad y YAML para obtener más detalles.

gcloud

Para ver los detalles sobre la ejecución de un trabajo, ejecuta los siguientes comandos:

  • Para describir una ejecución de trabajo específica, haz lo siguiente:

    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

  • Para describir la ejecución más reciente de un trabajo, haz lo siguiente:

    gcloud run jobs executions describe-latest --job=JOB

    Reemplaza JOB por el nombre del trabajo.

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/executions/EXECUTION_NAME

Reemplaza lo siguiente:

  • ACCESS_TOKEN: Es 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.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • REGION: Es la Google Cloud región del trabajo.
  • JOB por el nombre del trabajo de Cloud Run.
  • EXECUTION_NAME: Es el nombre de la ejecución del trabajo.

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:

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

    Ir a Trabajos de Cloud Run

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

  3. Selecciona la ejecución del trabajo que deseas borrar.

  4. En el menú Acciones, haz clic en el ícono de puntos suspensivos y, luego, en Borrar.

  5. Si se te solicite confirmar la eliminación, haz clic en Confirmar.

gcloud

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

  1. Ejecuta el comando siguiente:

    gcloud run jobs executions delete EXECUTION_NAME

    Reemplaza EXECUTION_NAME por el nombre de la ejecución.

  2. 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/executions/EXECUTION_NAME

Reemplaza lo siguiente:

  • ACCESS_TOKEN: Es 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.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • REGION: Es la Google Cloud región del trabajo.
  • JOB por el nombre del trabajo de Cloud Run.
  • EXECUTION_NAME: Es el nombre de la ejecución del trabajo.