Nesta página, descrevemos como visualizar e excluir execuções de job. Para executar, cancelar ou modificar uma configuração de job, consulte Executar jobs.
Funções exigidas
Para ter as permissões necessárias para gerenciar os jobs do Cloud Run,
peça ao administrador para conceder a você o
papel do IAM de Desenvolvedor do Cloud Run (roles/run.developer
) no job do Cloud Run.
Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o job do Cloud Run interagir com APIs do Google Cloud, como bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.
Ver execuções do job no projeto
É possível ver uma lista das execuções do job no projeto usando o Console do Google Cloud ou a Google Cloud CLI:
Console
Para ver a lista de execuções de um job, faça o seguinte:
Na lista, localize o job com as execuções que você quer gerenciar.
Clique no job para exibir a lista de execuções.
Na página de detalhes da execução, localize a execução em que você tem interesse na lista. Opcionalmente, é possível usar o filtro definido para um critério desejado, por exemplo, Status, com um valor de completed:
gcloud
Para listar todas as execuções de jobs de todos os projetos no projeto:
gcloud run jobs executions list
Para listar apenas as execuções de um job específico:
gcloud run jobs executions list --job JOB_NAME
Substitua JOB_NAME
pelo nome do job que você está filtrando.
Para ver outras formas de refinar a lista retornada, incluindo o uso de filtros, consulte a lista de execuções de jobs.
Para ver o nome da execução mais recente de um job específico, use a sinalização --format
:
gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"
Substitua JOB_NAME
pelo nome do job que você está filtrando.
Bibliotecas de cliente
Para listar todas as execuções do job a partir do código:
API REST
Para listar as execuções de jobs, envie uma solicitação HTTP GET
ao endpoint jobs
da API Cloud Run Admin.
Por exemplo, usando 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
Substitua:
- ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para visualizar execuções de jobs.
Por exemplo, se você fez login no gcloud, é possível recuperar um
token de acesso usando
gcloud auth print-access-token
. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner. - Substitua JOB-NAME pelo nome do job.
- REGION pela região do Google Cloud do job.
- PROJECT-ID pelo ID do projeto do Google Cloud.
Ver detalhes da execução do job
É possível visualizar detalhes das 10.000 execuções mais recentes de um job usando o painel de detalhes da execução, junto com qualquer execução que tenha ocorrido nos últimos sete dias. Os detalhes das execuções mais antigas são removidos e não ficam mais visíveis no painel de detalhes da execução. No entanto, os registros e os dados de monitoramento de execuções mais antigas ainda estão disponíveis no Cloud Logging e no Cloud Monitoring, sujeitos às políticas de retenção desses produtos
É possível usar o console do Google Cloud ou a Google Cloud CLI para ver mais detalhes de uma execução de job.
Console
Para ver detalhes de uma execução de job específica:
Clique no job para abrir os detalhes.
Clique na execução de job que você quer conferir. Os detalhes da execução são mostrados no painel à direita.
Observe as guias Tarefas, Contêineres, Volumes, Rede, Segurança e YAML e também o link Ver registros.
- A guia Tarefas mostra informações sobre as tarefas na execução do job.
- YAML mostra a configuração do job no formato YAML.
- Clique no link Ver registros para conferir os registros relacionados à execução.
- As outras guias mostram informações sobre o job, o contêiner, a segurança, a conectividade e assim por diante usados na execução.
gcloud
Para conferir detalhes sobre uma execução de job:
Use o comando :
gcloud run jobs executions describe EXECUTION_NAME
Substitua EXECUTION_NAME
pelo nome da execução.
É possível usar a sinalização --format
para formatar
a saída e receber mais informações. Por exemplo, como YAML:
gcloud run jobs executions describe EXECUTION_NAME --format yaml
Bibliotecas de cliente
Para ver os detalhes da execução do job no código:
API REST
Para acessar os detalhes da execução do job, envie uma solicitação HTTP GET
ao endpoint jobs
da API Cloud Run Admin.
Por exemplo, usando 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
Substitua:
- ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para visualizar os detalhes da execução do job.
Por exemplo, se você fez login no gcloud, é possível recuperar um
token de acesso usando
gcloud auth print-access-token
. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner. - Substitua JOB-NAME pelo nome do job.
- Substitua EXECUTION-NAME pelo nome do job.
- REGION pela região do Google Cloud do job.
- PROJECT-ID pelo ID do projeto do Google Cloud.
Excluir uma execução de job
É possível excluir uma execução de job, mesmo durante uma execução. Se você excluir uma execução, ela interromperá a execução.
Embora uma execução excluída não apareça na lista de execuções, os registros dela continuarão disponíveis no Cloud Logging até o fim do período de armazenamento de registros, assim como os dados de monitoramento. continuará disponível no Cloud Monitoring.
Console
Para excluir uma execução de job:
Clique no job para abrir os detalhes.
Selecione a execução do job que você quer excluir.
No menu Ações, clique no ícone de reticências e em Excluir.
Clique em Confirmar para confirmar a exclusão.
gcloud
Para excluir uma execução de job:
Use o comando :
gcloud run jobs executions delete EXECUTION_NAME
Substitua
EXECUTION_NAME
pelo nome da execução.Se for solicitado a confirmação, responda
y
. Após a conclusão, uma mensagem será exibida.
Bibliotecas de cliente
Para excluir a execução de um job usando o código:
API REST
Para excluir uma execução de job, envie uma solicitação HTTP DELETE
para o endpoint jobs
da API Cloud Run Admin.
Por exemplo, usando 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
Substitua:
- ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para excluir execuções de jobs.
Por exemplo, se você fez login no gcloud, é possível recuperar um
token de acesso usando
gcloud auth print-access-token
. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner. - Substitua JOB_NAME pelo nome do job.
- Substitua EXECUTION-NAME pelo nome do job.
- REGION pela região do Google Cloud do job.
- PROJECT-ID pelo ID do projeto do Google Cloud.