Gerir empregos

Esta página descreve como gerir serviços. Para criar uma tarefa, consulte o artigo Crie tarefas. Para executar uma tarefa, consulte Execute 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 os trabalhos no seu projeto

Pode ver uma lista das tarefas no seu projeto através de uma das seguintes abordagens:

Consola

Para ver empregos:

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

  2. Opcionalmente, filtre a tarefa por um dos critérios no menu pendente, como o nome da tarefa, a hora de execução, a região, etc.

gcloud

  1. Para apresentar uma lista de todas as tarefas no seu projeto:

    gcloud run jobs list

  2. Para filtrar tarefas por região:

    gcloud run jobs list --region REGION

    Substitua REGION pelo nome da região que está a filtrar, por exemplo, europe-west1.

Para outras formas de refinar a lista devolvida, incluindo a utilização de filtros, consulte a lista de trabalhos.

Bibliotecas cliente

Para ver tarefas no seu projeto a partir do código:

API REST

Para ver a lista de tarefas no seu projeto, 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

Substituir:

  • ACCESS_TOKEN com um token de acesso válido para uma conta que tenha as autorizações de IAM para ver 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.
  • REGION com a Google Cloud região da tarefa.
  • PROJECT-ID com o Google Cloud ID do projeto.

Ver detalhes do trabalho

Use a linha de comando gcloud para ver mais detalhes sobre 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. Localize o trabalho no qual tem interesse.

  3. Clique na tarefa para apresentar a página de detalhes da tarefa.

  4. Tenha em atenção os separadores Histórico, Métricas, Registos, Acionadores e YAML.

    • O separador Histórico mostra informações sobre as tarefas na execução do trabalho.
    • Registos mostra as informações dos registos.
    • Métricas mostra informações sobre as execuções de tarefas.
    • YAML mostra a configuração da tarefa no formato YAML.

gcloud

Para ver detalhes sobre uma tarefa:

Use o comando:

gcloud run jobs describe  JOB_NAME

Substitua JOB_NAME pelo nome da tarefa.

Bibliotecas cliente

Para ver detalhes sobre uma tarefa a partir do código:

API REST

Para ver detalhes sobre uma 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

Substituir:

  • ACCESS_TOKEN com um token de acesso válido para uma conta que tenha as autorizações de IAM para ver os detalhes 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.
  • REGION com a Google Cloud região da tarefa.
  • PROJECT-ID com o Google Cloud ID do projeto.

Elimine uma tarefa

A eliminação de uma tarefa termina todas as execuções de tarefas em curso e todas as instâncias de contentores em execução.

Embora uma tarefa eliminada deixe de aparecer na lista de tarefas, os respetivos registos continuam a estar disponíveis no Cloud Logging durante o período de retenção de registos restante, e os dados de monitorização continuam a estar disponíveis no Cloud Monitoring.

Consola

Para eliminar uma tarefa:

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

  2. Selecione o trabalho.

  3. Clique em Eliminar.

gcloud

Para eliminar uma tarefa:

  1. Use o comando:

    gcloud run jobs delete JOB_NAME

    Substitua JOB_NAME pelo nome da tarefa.

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

Bibliotecas cliente

Para eliminar uma tarefa a partir do código:

API REST

Para eliminar uma tarefa, envie um pedido HTTP DELETE 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 DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME

Substituir:

  • ACCESS_TOKEN com um token de acesso válido para uma conta que tenha as autorizações de IAM para eliminar 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.