Configurar contêineres

Nesta página, descrevemos como configurar o comando e os argumentos do ponto de entrada para jobs do Cloud Run.

Quando o Cloud Run inicia um contêiner, ele executa o comando entrypoint padrão e os argumentos de comando padrão da imagem. Se você quiser modificar os argumentos de ponto de entrada e comando padrão da imagem, use os campos command e args na configuração do contêiner. O campo command especifica o comando real executado pelo contêiner. O campo args especifica os argumentos passados para esse comando.

Funções exigidas

Para receber as permissões necessárias para configurar os jobs do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM:

Desenvolvedor do Cloud Run (roles/run.developer) no job do Cloud Run
Usuário da conta de serviço (roles/iam.serviceAccountUser) na conta de serviço

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.

Configurar ponto de entrada e argumentos

Para configurar o entrypoint de comando e os argumentos para jobs, siga estas etapas:

Console

No console do Google Cloud, acesse a página de jobs do Cloud Run:

Acesse o Cloud Run
Se você estiver configurando um novo job, clique na guia Jobs e preencha a página inicial de configurações do job conforme quiser. Se você estiver configurando um job, clique nele e em Editar.
Clique em Contêiner, variáveis e secrets, conexões e segurança para expandir a página de propriedades do job.
Clique na guia Geral.
- Especifique o comando que você quer que o contêiner execute, se não for o definido no contêiner, e, opcionalmente, especifique os argumentos para o comando entrypoint.
Clique em Criar ou Atualizar.

Linha de comando

Para definir o comando inicial e os argumentos de um novo job:
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N
```
Substituir
- JOB_NAME pelo nome do job;
- COMMAND pelo comando com que o contêiner será iniciado se você não estiver usando o comando padrão;
- ARG1 pelo argumento que você está enviando para o comando do contêiner ou use uma lista delimitada por vírgulas para mais de um argumento.
- IMAGE_URL por uma referência à imagem de contêiner, por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest;

Para atualizar o comando e os argumentos de um job existente:

gcloud run jobs update JOB_NAME --command COMMAND --args ARG1,ARG-N

YAML

Faça o download e consulte a configuração do job que já existe usando o comando gcloud run jobs describe --format export, que gera resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run jobs replace. Modifique os campos somente conforme documentado.

Para visualizar e fazer o download da configuração:

gcloud run jobs describe JOB_NAME --format export > job.yaml

Atualize os atributos args: e command:
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - args:
            - 'ARG1'
            - 'ARG-N'
            command:
            - COMMAND
            image: IMAGE
```
Substituir
- COMMAND pelo comando com que o contêiner será iniciado se você não estiver usando o comando padrão;
- ARG1 pelo argumento que você está enviando para o comando do contêiner. Se quiser, especifique outros argumentos, cada um em uma linha separada.
Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.
Atualize a configuração do job que já existe:
```
gcloud run jobs replace job.yaml
```

Para limpar os comandos e argumentos do ponto de entrada que você definiu (restaurar para os padrões do contêiner), forneça strings vazias da seguinte maneira:

gcloud run jobs update JOB_NAME --command "" --args ""

Usar sinais de igual ou vírgulas em argumentos

Se você usar sinais de igual nos argumentos, insira-os usando o seguinte formato:

gcloud run deploy  \
  --args="--repo-allowlist=github.com/example/example_demo"

Se os argumentos usarem vírgulas, consulte Como configurar variáveis de ambiente para mais detalhes sobre como fazer escape.

Ver configurações do contêiner

Para ver as configurações atuais do contêiner para o job do Cloud Run, faça o seguinte:

Console

No console do Google Cloud, acesse a página de jobs do Cloud Run:

Acessar jobs do Cloud Run
Clique no job em que você tem interesse para abrir a página Detalhes do job.
Clique na guia Configuração.
Localize a definição do contêiner nos detalhes da configuração.

Linha de comando

Use o comando a seguir:
```
gcloud run jobs describe JOB_NAME
```
Localize a configuração de contêiner na configuração retornada.