En esta página se describe cómo gestionar los trabajos. Para crear una tarea, consulta Crear tareas. Para ejecutar un 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 los trabajos de un proyecto
Puede ver una lista de los trabajos de su proyecto de una de las siguientes formas:
Consola
Para ver los trabajos, sigue estos pasos:
También puedes filtrar el trabajo por uno de los criterios del menú desplegable, como el nombre del trabajo, el tiempo de ejecución, la región, etc.
gcloud
Para ver una lista de todos los trabajos de tu proyecto, sigue estos pasos:
gcloud run jobs list
Para filtrar tareas por región, sigue estos pasos:
gcloud run jobs list --region REGION
Sustituye
REGIONpor el nombre de la región por la que quieres filtrar (por ejemplo,europe-west1).
Para ver otras formas de acotar la lista de resultados, incluido el uso de filtros, consulta la lista de trabajos.
Bibliotecas de cliente
Para ver los trabajos de tu proyecto desde el código, sigue estos pasos:
API REST
Para ver la lista de trabajos de tu proyecto, 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
Sustituye:
- ACCESS_TOKEN con un token de acceso válido para una cuenta que
tenga los permisos de gestión de identidades y accesos para ver los 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. - REGION con la Google Cloud región del trabajo.
- PROJECT-ID con el Google Cloud ID del proyecto.
Ver detalles de un trabajo
Usa la línea de comandos gcloud para ver más detalles sobre una tarea.
Consola
Para ver los detalles de una ejecución de un trabajo específico, sigue estos pasos:
Busca el empleo que te interese.
Haz clic en el trabajo para ver la página de detalles.
Fíjate en las pestañas Historial, Métricas, Registros, Activadores y YAML.
- La pestaña Historial muestra información sobre las tareas de la ejecución del trabajo.
- Registros: muestra la información de los registros.
- En Métricas se muestra información sobre las ejecuciones de la tarea.
- YAML muestra la configuración del trabajo en formato YAML.
gcloud
Para ver los detalles de un trabajo, sigue estos pasos:
Usa el comando:
gcloud run jobs describe JOB_NAME
Sustituye JOB_NAME por el nombre del trabajo.
Bibliotecas de cliente
Para ver los detalles de un trabajo desde el código, sigue estos pasos:
API REST
Para ver los detalles 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
Sustituye:
- ACCESS_TOKEN con un token de acceso válido para una cuenta que tenga los permisos de gestión de identidades y accesos para ver los detalles del trabajo.
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 con el nombre del trabajo.
- REGION con la Google Cloud región del trabajo.
- PROJECT-ID con el Google Cloud ID del proyecto.
Eliminar una tarea
Si eliminas una tarea, se finalizarán todas las ejecuciones de la tarea en curso y todas las instancias de contenedor en ejecución.
Aunque una tarea eliminada ya no aparece en la lista de tareas, sus registros siguen estando disponibles en Cloud Logging durante el resto del periodo de conservación de registros, y los datos de monitorización siguen estando disponibles en Cloud Monitoring.
Consola
Para eliminar un trabajo, sigue estos pasos:
Selecciona el trabajo.
Haz clic en Eliminar.
gcloud
Para eliminar un trabajo, sigue estos pasos:
Usa el comando:
gcloud run jobs delete JOB_NAME
Sustituye
JOB_NAMEpor el nombre del trabajo.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 un trabajo desde el código, sigue estos pasos:
API REST
Para eliminar un trabajo, envía una solicitud HTTP DELETE 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 DELETE \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME
Sustituye:
- ACCESS_TOKEN con un token de acceso válido para una cuenta que
tenga los permisos de gestión de identidades y accesos para eliminar 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 con el nombre del trabajo.
- REGION con la Google Cloud región del trabajo.
- PROJECT-ID con el Google Cloud ID del proyecto.