Faça a gestão das execuções de tarefas

Esta página descreve como ver e eliminar execuções de tarefas. Para executar, cancelar ou substituir uma configuração de tarefa, consulte o artigo Executar tarefas.

Funções necessárias

Para receber as autorizações de que precisa para gerir tarefas do Cloud Run, peça ao seu administrador para lhe conceder a função de IAM de programador do Cloud Run (roles/run.developer) no seu trabalho do Cloud Run.

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se a sua tarefa do Cloud Run interagir com Google Cloud APIs, como as bibliotecas de cliente da Google Cloud, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Veja as execuções de tarefas no seu projeto

Pode ver uma lista das execuções de tarefas no seu projeto através da Google Cloud consola ou da CLI Google Cloud:

Consola

Para ver a lista de execuções de uma tarefa:

  1. Aceda à página de tarefas do Cloud Run

  2. Na lista, localize a tarefa cujas execuções quer gerir.

  3. Clique na tarefa para apresentar a lista de execuções.

  4. Na página de detalhes da execução, selecione a execução em que tem interesse na lista. Opcionalmente, pode usar o filtro definido para um critério desejado, por exemplo, Status com um valor de completed:

gcloud

Para apresentar uma lista de todas as execuções de tarefas para todas as tarefas no seu projeto:

gcloud run jobs executions list

Para listar apenas as execuções de uma tarefa específica:

gcloud run jobs executions list --job JOB_NAME

Substitua JOB_NAME pelo nome da tarefa que está a filtrar.

Para outras formas de refinar a lista devolvida, incluindo a utilização de filtros, consulte o artigo Lista de execuções de tarefas.

Para obter o nome da execução mais recente de uma tarefa específica, use a flag --format:

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

Substitua JOB_NAME pelo nome da tarefa que está a filtrar.

Bibliotecas cliente

Para apresentar uma lista de todas as execuções de tarefas a partir do código:

API REST

Para listar as execuções de tarefas, envie um pedido HTTP GET para o ponto final jobs da API Cloud Run Admin.

Por exemplo, usar 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

Substituir:

  • ACCESS_TOKEN com um token de acesso válido para uma conta que tenha as autorizações de IAM para ver as execuções de tarefas. Por exemplo, se tiver sessão iniciada no gcloud, pode obter um token de acesso através de gcloud auth print-access-token. A partir de uma instância de contentor do Cloud Run, pode obter um token de acesso através do servidor de metadados da instância de contentor.
  • JOB-NAME com o nome do trabalho.
  • REGION com a Google Cloud região da tarefa.
  • PROJECT-ID com o Google Cloud ID do projeto.

Veja os detalhes da execução do trabalho

Pode ver os detalhes de execução de tarefas das 1000 execuções mais recentes de uma tarefa através do painel de detalhes de execução. Os detalhes de execução mais antigos são removidos e deixam de estar visíveis no painel de detalhes de execução. No entanto, os registos e os dados de monitorização das execuções mais antigas continuam disponíveis no Cloud Logging e no Cloud Monitoring, sujeitos às políticas de retenção desses produtos.

Pode usar a Google Cloud consola ou a Google Cloud CLI para ver mais detalhes acerca da execução de uma tarefa.

Consola

Para ver os detalhes de uma execução de tarefa específica:

  1. Aceda à página de tarefas do Cloud Run

  2. Clique na tarefa para abrir o painel de detalhes da tarefa.

  3. Clique na execução da tarefa que quer ver. Os detalhes da execução são apresentados no painel do lado direito.

  4. Tenha em atenção os separadores Tarefas, Contentores, Volumes, Rede, Segurança e YAML, bem como o link Ver registos.

    • Tarefas mostra informações sobre as tarefas na execução do trabalho.
    • YAML mostra a configuração da tarefa no formato YAML.
    • Clique no link Ver registos para ver os registos relacionados com a execução.
    • Os outros separadores mostram informações sobre a tarefa, o contentor, a segurança, a conetividade, entre outros, usados na execução.

gcloud

Para ver detalhes sobre a execução de uma tarefa:

Use o comando:

gcloud run jobs executions describe EXECUTION_NAME

Substitua EXECUTION_NAME pelo nome da execução.

Pode usar a flag --format para formatar a saída e obter informações adicionais. Por exemplo, como YAML:

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Bibliotecas cliente

Para ver os detalhes da execução da tarefa a partir do código:

API REST

Para ver os detalhes da execução da tarefa, envie um pedido HTTP GET para o ponto final jobs da API Cloud Run Admin.

Por exemplo, usar 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

Substituir:

  • ACCESS_TOKEN com um token de acesso válido para uma conta que tenha as autorizações de IAM para ver os detalhes de execução da tarefa. Por exemplo, se tiver sessão iniciada no gcloud, pode obter um token de acesso através de gcloud auth print-access-token. A partir de uma instância de contentor do Cloud Run, pode obter um token de acesso através do servidor de metadados da instância de contentor.
  • JOB-NAME com o nome do trabalho.
  • EXECUTION-NAME com o nome da execução da tarefa.
  • REGION com a Google Cloud região da tarefa.
  • PROJECT-ID com o Google Cloud ID do projeto.

Elimine uma execução de tarefa

Pode eliminar uma execução de tarefa, mesmo durante uma execução. Se eliminar uma execução, esta é interrompida.

Embora uma execução eliminada não seja apresentada na lista de execuções, os respetivos registos continuam disponíveis no Cloud Logging durante o restante período de retenção de registos, e os dados de monitorização continuam disponíveis no Cloud Monitoring.

Consola

Para eliminar uma execução de tarefa:

  1. Aceda à página de tarefas do Cloud Run

  2. Clique na tarefa para abrir o painel de detalhes da tarefa.

  3. Selecione a execução do trabalho que quer eliminar.

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

  5. Se lhe for pedido que confirme a eliminação, clique em Confirmar.

gcloud

Para eliminar uma execução de tarefa:

  1. Use o comando:

    gcloud run jobs executions delete EXECUTION_NAME

    Substitua EXECUTION_NAME pelo nome da execução.

  2. Se lhe for pedido que confirme, responda y. Após o êxito, é apresentada uma mensagem de êxito.

Bibliotecas cliente

Para eliminar uma execução de tarefa a partir do código:

API REST

Para eliminar uma execução de tarefa, envie um pedido HTTP DELETE para solicitar o ponto final da API Cloud Run Admin jobs

Por exemplo, usar 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

Substituir:

  • ACCESS_TOKEN com um token de acesso válido para uma conta que tenha as autorizações de IAM para eliminar execuções de tarefas. Por exemplo, se tiver sessão iniciada no gcloud, pode obter um token de acesso através de gcloud auth print-access-token. A partir de uma instância de contentor do Cloud Run, pode obter um token de acesso através do servidor de metadados da instância de contentor.
  • JOB_NAME com o nome do trabalho.
  • EXECUTION-NAME com o nome da execução da tarefa.
  • REGION com a Google Cloud região da tarefa.
  • PROJECT-ID com o Google Cloud ID do projeto.