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 doGoogle Cloud , como as 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 conferir uma lista das execuções de jobs no projeto usando o consoleGoogle Cloud , a CLI gcloud, as bibliotecas de cliente ou a API REST:
Console
Para ver a lista de execuções de um job, siga estas etapas:
No console do Google Cloud , acesse a página de jobs do Cloud Run:
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. Você também pode filtrar por critérios.
gcloud
Para listar todas as execuções de jobs de todos os projetos no projeto, execute o seguinte comando:
gcloud run jobs executions list
Para listar apenas as execuções de um job específico, execute o seguinte comando:
gcloud run jobs executions list --job JOB
Substitua
JOBpelo 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 --format="value(status.latestCreatedExecution.name)"
Substitua
JOBpelo nome do job que você está filtrando.
Como alternativa, para conferir os detalhes da execução mais recente do job, consulte Ver detalhes da execução do job.
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/executions
Substitua:
ACCESS_TOKEN: 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 usandogcloud 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.PROJECT_ID: o ID do projeto do Google Cloud .REGION: a Google Cloud região do job.JOB: o nome do seu job do Cloud Run;
Ver detalhes da execução do job
É possível conferir detalhes das 1.000 execuções mais recentes de um job usando o painel de detalhes da execução. 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 conferir mais detalhes sobre a execução de um job usando o console Google Cloud , a CLI gcloud, as bibliotecas de cliente ou a API REST:
Console
Para ver detalhes de uma execução de job específica:
No console do Google Cloud , acesse a página de jobs do Cloud Run:
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. Consulte as guias Tarefas, Contêineres, Volumes, Rede, Segurança e YAML para mais detalhes.
gcloud
Para conferir detalhes sobre a execução de um job, execute os seguintes comandos:
Para descrever uma execução de job específica:
gcloud run jobs executions describe EXECUTION_NAME
Substitua
EXECUTION_NAMEpelo nome da execução.É possível usar a sinalização
--formatpara formatar a saída e receber mais informações. Por exemplo, como YAML:gcloud run jobs executions describe EXECUTION_NAME --format yaml
Para descrever a execução mais recente de um job:
gcloud run jobs executions describe-latest --job=JOB
Substitua
JOBpelo nome do job.
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/executions/EXECUTION_NAME
Substitua:
ACCESS_TOKEN: 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 usandogcloud 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.PROJECT_ID: o ID do projeto do Google Cloud .REGION: a Google Cloud região do job.JOB: o nome do seu job do Cloud Run;EXECUTION_NAME: o nome da execução do job.
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:
No console do Google Cloud , acesse a página de jobs do Cloud Run:
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, siga estas etapas:
Execute este comando:
gcloud run jobs executions delete EXECUTION_NAME
Substitua
EXECUTION_NAMEpelo 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/executions/EXECUTION_NAME
Substitua:
ACCESS_TOKEN: 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 usandogcloud 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.PROJECT_ID: o ID do projeto do Google Cloud .REGION: a Google Cloud região do job.JOB: o nome do seu job do Cloud Run;EXECUTION_NAME: o nome da execução do job.