Configurar variáveis de ambiente para pools de worker

Nesta página, descrevemos como configurar variáveis de ambiente para seu pool de workers do Cloud Run.

Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também recebem essa configuração de modo automático, a menos que você faça atualizações explícitas para alterar esse comportamento.

Funções exigidas

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

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 pool de trabalhadores do Cloud Run interagir com APIs doGoogle 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.

Defina as variáveis de ambiente

É possível definir variáveis de ambiente usando a Google Cloud CLI ao criar um novo pool de trabalhadores ou implantar uma nova revisão:

gcloud

Para especificar variáveis de ambiente ao implantar o pool de trabalhadores, use a flag --set-env-vars:

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

Substitua:

  • WORKER_POOL: o nome do pool de workers
  • KEY1=VALUE1,KEY2=VALUE2: a lista separada por vírgulas de nomes e valores de variáveis
  • IMAGE_URL com uma referência à imagem de contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest

Atualizar variáveis de ambiente

É possível atualizar as variáveis de ambiente de execução para os serviços atuais. Essa é uma abordagem não destrutiva que altera ou adiciona variáveis de ambiente de execução, mas não as exclui.

gcloud

Para atualizar as variáveis de ambiente de um pool de worker atual, use a flag --update-env-vars:

gcloud beta run worker-pools update WORKER_POOL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Substitua:

  • WORKER_POOL: o nome do pool de workers
  • KEY1=VALUE1,KEY2=VALUE2: a lista separada por vírgulas de nomes e valores de variáveis

Excluir variáveis de ambiente

gcloud

Para remover seletivamente variáveis de ambiente de um pool de worker atual, use a flag --remove-env-vars:

gcloud beta run worker-pools update WORKER_POOL --remove-env-vars KEY1,KEY2

Substitua:

  • WORKER_POOL: o nome do pool de workers
  • KEY1,KEY2: a lista de nomes de variáveis separada por vírgulas

Como alternativa, limpe todas as variáveis de ambiente definidas anteriormente com a flag --clear-env-vars:

gcloud beta run worker-pools update WORKER_POOL --clear-env-vars

Substitua WORKER_POOL pelo nome do pool de workers.

Ver a configuração da variável de ambiente para o pool de workers

  1. No Google Cloud console, acesse o Cloud Run:

    Acessar o Cloud Run

  2. Clique em Pools de workers para mostrar a lista de pools de workers implantados.

  3. Clique no pool de workers que você quer examinar para mostrar o painel de detalhes.

  4. Clique na guia Contêineres para mostrar a configuração do contêiner do pool de workers.

Código de amostra

Para ver um exemplo de código que mostra como acessar as variáveis de ambiente no código, consulte Como processar a configuração confidencial com o Gerenciador de segredos no tutorial de autenticação de usuário final.

A seguir

É possível usar variáveis de ambiente para definir uma configuração de buildpacks. Para detalhes específicos da linguagem, consulte a documentação de buildpacks para: