Gerencie vagas

Esta página descreve como gerenciar jobs. Para criar um job, consulte Criar jobs. Para executar um job, consulte Executar jobs.

Resumo e imagens de imagem de contêiner para jobs do Cloud Run

A atualização do job para executar a versão mais recente do código depende de você ter especificado uma imagem de contêiner com uma tag ou um resumo.

Ao criar um job, é possível especificar uma imagem de contêiner com uma tag, por exemplo, gcr.io/my-project/my-image:tag ou com um resumo exato, por exemplo, gcr.io/my-project/my-image@sha256:41f34ab970ee.... Se você não especificar nenhum deles, a tag :latest será usada.

Se você especificou uma imagem de contêiner com uma tag, o Cloud Run resolve sua imagem em um resumo específico ao executar seu job. Isso significa que você não precisa atualizar explicitamente o job para selecionar a versão mais recente do contêiner na próxima vez que o executar.

Se você preferir que o job use um resumo específico sempre que for executado, especifique uma imagem de contêiner com um resumo exato. Nesse caso, você precisará atualizar explicitamente seu job para usar um resumo diferente se quiser que o job colete mudanças de código feitas:

gcloud run jobs update JOB_NAME --image IMAGE_URL

Substituir

JOB_NAME com um nome em minúsculas sem sublinhados
IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest;

Independentemente de como você especifica a imagem do contêiner, todas as tarefas de uma execução sempre usarão o mesmo resumo da imagem.

Ver jobs no projeto

É possível ver uma lista dos jobs no projeto usando a linha de comando gcloud:

Console

Para ver jobs:

Acesse a página de jobs do Cloud Run.
Opcionalmente, filtre o job por um dos critérios no menu suspenso, como nome do job, tempo de execução, região e assim por diante.

Linha de comando

Para listar todos os jobs no projeto:
```
gcloud run jobs list
```
Para filtrar jobs por região, siga estas etapas:
```
gcloud run jobs list --region REGION
```
Substitua REGION pelo nome da região que você está filtrando, por exemplo, us-central1.

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 por 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 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.
REGION pela região do Google Cloud do job.
PROJECT-ID pelo ID do projeto do Google Cloud.

Mais detalhes do job

Use a linha de comando do gcloud para ver mais detalhes sobre um job.

Console

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

Acessar 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.
Observe as guias Histórico, Configuração, Registros e YAML.
- A guia Histórico mostra informações sobre as tarefas na execução do job.
- Registros mostra as informações dos registros.
- Configuração mostra informações sobre o job, o contêiner, a segurança, a conectividade e assim por diante.
- YAML mostra a configuração do job no formato YAML.

Linha de comando

Para ver detalhes sobre um job:

Use o comando :

gcloud run jobs describe  JOB_NAME

Substitua JOB_NAME 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-NAME

Substitua:

ACCESS_TOKEN por 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 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.

Excluir um job

Só é possível excluir um job quando não há execuções desse job em execução no momento.

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

Para excluir um job, siga estas etapas:

Acessar a página de jobs do Cloud Run
Selecione o job.
Clique em Excluir.

Linha de comando

Para excluir um job, siga estas etapas:

Use o comando:
```
gcloud run jobs delete JOB_NAME
```
Substitua JOB_NAME pelo nome do job.
Se for solicitado a confirmação, responda y. Após a conclusão, uma mensagem 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-NAME

Substitua:

ACCESS_TOKEN por 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 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.