Com o Cloud Run, é possível ver os jobs, os detalhes deles e excluir jobs durante todo o ciclo de vida. Para criar um job, consulte Criar jobs. Para executar um 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 jobs no projeto
É possível conferir uma lista dos jobs no seu projeto usando o console Google Cloud , a CLI gcloud, as bibliotecas de cliente ou a API REST:
Console
No console do Google Cloud , acesse a página de jobs do Cloud Run:
Opcional: filtre o job por um dos critérios no menu, como nome do job, tempo de execução ou região.
gcloud
Para listar todos os jobs no projeto, execute o seguinte comando:
gcloud run jobs list
Para filtrar jobs por região, execute o seguinte comando:
gcloud run jobs list --region REGION
Substitua REGION pelo nome da região que você quer filtrar, por exemplo, europe-west1.
Para outras maneiras de refinar a lista retornada, incluindo o uso de filtros, consulte lista de jobs.
Bibliotecas de cliente
Para visualizar jobs no projeto a partir do código:
API REST
Para visualizar a lista de jobs no projeto, 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
Substitua:
ACCESS_TOKEN: um token de acesso válido para uma conta com as permissões do IAM para visualizar 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.
Ver detalhes do job
Para conferir mais detalhes sobre um job, use o console Google Cloud , a CLI gcloud, as bibliotecas de cliente ou a API REST:
Console
No console do Google Cloud , acesse a página de jobs do Cloud Run:
Localize o job em que você tem interesse.
Clique no job para exibir a página de detalhes.
Navegue entre as guias Histórico, Registros, Métricas e YAML:
- A guia Histórico mostra informações sobre as tarefas na execução do job.
- Registros mostra as informações dos registros.
- Métricas mostra informações sobre as execuções do job.
- YAML mostra a configuração do job no formato YAML.
gcloud
Para conferir detalhes sobre um job, execute o seguinte comando:
gcloud run jobs describe JOB
Substitua JOB pelo nome do job.
Bibliotecas de cliente
Para visualizar detalhes sobre um job a partir do código:
API REST
Para visualizar detalhes sobre um job, envie uma solicitação HTTP GET 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 GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB
Substitua:
ACCESS_TOKEN: um token de acesso válido para uma conta com as permissões do IAM para visualizar os detalhes 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;
Excluir um job
A exclusão de um job encerra todas as execuções em andamento e todas as instâncias de contêiner em execução.
Um job excluído não aparece mais na lista de jobs, mas os registros dele continuam disponíveis no Cloud Logging até o fim do período de armazenamento de registros, e os dados de monitoramento ficam. continuará disponível no Cloud Monitoring.
Console
No console do Google Cloud , acesse a página de jobs do Cloud Run:
Selecione o job.
Clique em Excluir.
Clique em Confirmar.
gcloud
Para excluir um job, execute o seguinte comando:
gcloud run jobs delete JOB
Substitua JOB pelo nome do job.
Se for solicitado a confirmação, responda y. Após a conclusão, uma mensagem de sucesso
será exibida.
Bibliotecas de cliente
Para excluir um job a partir do código:
API REST
Para excluir um job, envie uma solicitação HTTP DELETE ao 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
Substitua:
ACCESS_TOKEN: um token de acesso válido para uma conta com as permissões do IAM para excluir 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;