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.

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:

  1. Acessar a página de jobs do Cloud Run

  2. Na lista, localize o job com as execuções que você quer gerenciar.

  3. Clique no job para exibir a lista de execuções.

  4. 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:

  1. Acessar a página de jobs do Cloud Run

  2. Clique no job para abrir os detalhes.

  3. Clique na execução de job que você quer conferir. Os detalhes da execução são mostrados no painel à direita.

  4. 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:

  1. Acessar a página de jobs do Cloud Run

  2. Clique no job para abrir os detalhes.

  3. Selecione a execução do job que você quer excluir.

  4. No menu Ações, clique no ícone de reticências e em Excluir.

  5. Clique em Confirmar para confirmar a exclusão.

gcloud

Para excluir uma execução de job:

  1. Use o comando :

    gcloud run jobs executions delete EXECUTION_NAME

    Substitua EXECUTION_NAME pelo nome da execução.

  2. 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.