Gerenciar execuções de job

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.

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:

Acessar a página de jobs do Cloud Run
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:

Linha de comando

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:

Acessar a página de jobs do Cloud Run
Localize a execução do job em que você tem interesse.
Clique na execução do job para exibir a página de detalhes dela.
Observe as guias Tarefas, Registros, Configurações e YAML.
- A guia Tarefas mostra informações sobre as tarefas na execução do job.
- Registros mostra os registros relacionados à execução.
- Configuração mostra informações sobre o job, o contêiner, a segurança, a conectividade e assim por diante usados na execução.
- YAML mostra a configuração do job no formato YAML.

Linha de comando

Para ver 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:

Acessar a página de jobs do Cloud Run
Encontre a execução do job que você quer excluir.
Clique em Excluir.
Clique em Confirmar para confirmar a exclusão.

Linha de comando

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.