Administrar empleos

En esta página, se describe cómo administrar los trabajos. Para crear un nuevo trabajo, consulta Crea trabajos. Para ejecutar un 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 los trabajos de tu proyecto

Puedes ver una lista de los trabajos de tu proyecto a través de uno de los siguientes enfoques:

Console

Para ver los trabajos, sigue estos pasos:

Ir a la página de trabajos de Cloud Run.
De manera opcional, filtra el trabajo por alguno de los criterios del menú desplegable, como el nombre del trabajo, el tiempo de ejecución, la región, etcétera.

gcloud

Para enumerar todos los trabajos de tu proyecto, sigue estos pasos:
```
gcloud run jobs list
```
Para filtrar trabajos por región, haz lo siguiente:
```
gcloud run jobs list --region REGION
```
Reemplaza REGION por el nombre de la región en la que filtras, por ejemplo, us-central1.

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, sigue estos pasos:

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 por 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 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.
REGION por la región de Google Cloud del trabajo.
PROJECT-ID por el ID del proyecto de Google Cloud.

Ver detalles del trabajo

Usa la línea de comandos de gcloud para ver más detalles sobre 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
Ubica el trabajo que te interesa.
Haz clic en el trabajo para mostrar su página de detalles.
Observa las pestañas Historial, Métricas, Registros, Activadores y YAML.
- La pestaña 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 trabajo.
- 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

Reemplaza JOB_NAME 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-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 del servicio. 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.

Borra un trabajo

Puedes borrar un trabajo solo si no hay ejecuciones de ese trabajo 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

Para borrar un trabajo, sigue estos pasos:

Ir a la página de trabajos de Cloud Run
Selecciona el trabajo.
Haz clic en Borrar.

gcloud

Para borrar un trabajo, sigue estos pasos:

Usa el comando:
```
gcloud run jobs delete JOB_NAME
```
Reemplaza JOB_NAME por el nombre del trabajo.
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 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-NAME

Reemplaza lo siguiente:

ACCESS_TOKEN por 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 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.