Como selecionar um ambiente de execução (serviços)

Nesta página, descrevemos como especificar o ambiente de execução para cada instância do Cloud Run. Para os serviços do Cloud Run, as instâncias do Cloud Run são executadas no ambiente de execução de primeira geração por padrão. Você pode mudar isso se quiser apenas nos serviços. Os jobs do Cloud Run usam automaticamente o ambiente de execução de segunda geração, e isso não pode ser alterado em jobs.

Consulte a documentação do conceito de ambientes de execução para receber assistência na escolha do ambiente que é melhor para seu serviço.

Funções exigidas

Para receber as permissões necessárias para configurar e implantar os serviços 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 serviço 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 serviço do Cloud Run interage com as APIs do Google Cloud, como as 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.

Como configurar e atualizar o ambiente de execução

Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também recebem automaticamente essa configuração, a menos que você faça atualizações explícitas para alterá-la.

Por padrão, para os serviços do Cloud Run, cada instância usa o ambiente de execução de primeira geração. Se você usar a segunda geração, também precisará especificar pelo menos 512 MiB de memória.

É possível definir o ambiente de execução usando o console do Google Cloud, a linha de comando gcloud ou um arquivo YAML ao criar um novo serviço ou implantar uma nova revisão:

Console

No console do Google Cloud, acesse o Cloud Run:

Acesse o Cloud Run
Clique em Criar serviço se estiver configurando um novo serviço em que fará uma implantação. Se você estiver configurando um serviço atual, clique nele e em Editar e implantar nova revisão.
Se você estiver configurando um novo serviço, preencha a página inicial de configurações do serviço conforme preferir e clique em Contêineres, volumes, rede, segurança para expandir a página de configurações do serviço.
Clique na guia Contêiner.
- Selecione o ambiente de execução desejado usando os botões de opção.
Clique em Criar ou Implantar.

Linha de comando

É possível atualizar o ambiente de execução de um determinado serviço usando o seguinte comando:

gcloud run services update SERVICE --execution-environment ENVIRONMENT

Substitua SERVICE pelo nome do serviço e ENVIRONMENT pelo ambiente de execução desejado. Especifique o valor gen1 para a primeira geração ou gen2 para a segunda geração.

Também é possível definir o ambiente de execução durante a implantação usando o comando:

gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT

Substituir

IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/hello:latest. Se você usa o Artifact Registry, o repositório REPO_NAME já precisará ter sido criado. O URL tem o formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
ENVIRONMENT pelo ambiente de execução desejado. Especifique o valor gen1 para a primeira geração ou gen2 para a segunda geração.

YAML

Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço existente, faça o download da configuração YAML correspondente:
```
gcloud run services describe SERVICE --format export > service.yaml
```
defina a anotação run.googleapis.com/execution-environment:
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/execution-environment: ENVIRONMENT
      name: REVISION
```
Substituir
- SERVICE pelo nome do serviço do Cloud Run
- ENVIRONMENT pelo ambiente de execução desejado. Especifique o valor gen1 para a primeira geração ou gen2 para a segunda geração.
- REVISION por um novo nome de revisão ou excluí-lo (se houver). Se você fornecer um novo nome de revisão, ele precisará atender aos seguintes critérios:
  - Começa com SERVICE-
  - Contém apenas letras minúsculas, números e -
  - Não termina com um -
  - Não excede 63 caracteres
Crie ou atualize o serviço usando o seguinte comando:
```
gcloud run services replace service.yaml
```

Ver configurações do ambiente de execução

Para ver as configurações atuais do ambiente de execução do serviço do Cloud Run:

Console

No console do Google Cloud, acesse o Cloud Run:

Acesse o Cloud Run
Clique no serviço de seu interesse para abrir a página Detalhes do serviço.
Clique na guia Revisões.
No painel de detalhes à direita, a configuração "Ambiente de execução" é listada na guia Contêiner.

Linha de comando

Use o comando a seguir:
```
gcloud run services describe SERVICE
```
Localize a configuração do ambiente de execução na configuração retornada.