Cloud Run te permite ver trabajos, sus detalles y borrarlos durante todo su ciclo de vida. Para crear un nuevo trabajo, consulta Crea trabajos. Para ejecutar un 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 los trabajos de tu proyecto
Puedes ver una lista de los trabajos en tu proyecto con la Google Cloud consola, la gcloud CLI, las bibliotecas cliente o la API de REST:
Console
En la Google Cloud consola, ve a la página de trabajos de Cloud Run:
Opcional: Filtra el trabajo por uno de los criterios del menú, como el nombre del trabajo, el tiempo de ejecución o la región.
gcloud
Para enumerar todos los trabajos de tu proyecto, ejecuta el siguiente comando:
gcloud run jobs list
Para filtrar trabajos por región, ejecuta el siguiente comando:
gcloud run jobs list --region REGION
Reemplaza REGION por el nombre de la región en la que deseas filtrar, por ejemplo, europe-west1.
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, haz lo siguiente:
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: Es 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 congcloud 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.
Ver detalles del trabajo
Puedes ver más detalles sobre un trabajo con la Google Cloud consola, la gcloud CLI, las bibliotecas cliente o la API de REST:
Console
En la Google Cloud consola, ve 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.
Navega entre las pestañas Historial, Registros, Métricas y YAML:
- Historial muestra información sobre las tareas en la ejecución del trabajo.
- Registros muestra la información de los registros.
- Métricas muestra información sobre las ejecuciones de trabajos.
- YAML muestra la configuración del trabajo en formato YAML.
gcloud
Para ver los detalles de un trabajo, ejecuta el siguiente comando:
gcloud run jobs describe JOB
Reemplaza JOB por el nombre del trabajo.
Bibliotecas cliente
Para ver los detalles de un trabajo desde el 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
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 del trabajo. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso congcloud 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.JOBpor el nombre del trabajo de Cloud Run.
Borra un trabajo
Si borras un trabajo, se finalizan todas las ejecuciones de trabajos en curso y todas las instancias de contenedor 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
En la Google Cloud consola, ve a la página de trabajos de Cloud Run:
Selecciona el trabajo.
Haz clic en Borrar.
Haz clic en Confirmar.
gcloud
Para borrar un trabajo, ejecuta el siguiente comando:
gcloud run jobs delete JOB
Reemplaza JOB por el nombre del trabajo.
Si se te solicita confirmar, responde y. Cuando se complete, 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
Reemplaza lo siguiente:
ACCESS_TOKEN: Es 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 congcloud 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.JOBpor el nombre del trabajo de Cloud Run.