Definir variáveis de ambiente de build (implantação de origem)

As variáveis de ambiente de build são pares de chave-valor que permitem transmitir a configuração para buildpacks durante a implantação de um função a partir do código-fonte. Por exemplo, no tempo de build, você pode personalizar as opções do compilador, especificar certificados no tempo de build, configurar parâmetros e assim por diante.

Esta página mostra como definir variáveis de ambiente de build que estão disponíveis em tempo de build e é relevante para desenvolvedores de plataformas que estão implantando no Cloud Run.

Antes de começar

Ativar a API Cloud Build

gcloud services enable cloudbuild.googleapis.com

Funções exigidas

Para receber as permissões necessárias para implantar a partir da origem, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

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.

Definir variáveis de ambiente de build

Você pode definir variáveis de ambiente de build para estabelecer novas variáveis ou fazer substituir as variáveis de build atuais.

gcloud

Você pode definir variáveis de ambiente de build ao implantar uma função do código-fonte:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --set-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Substitua:

  • SERVICE pelo nome do job da função do Cloud Run.
  • FUNCTION_ENTRY_POINT: pelo ponto de entrada para sua função no código-fonte.
  • KEY1=VALUE1,KEY2=VALUE2 pela lista separada por vírgulas de nomes de variáveis e seus valores implantados com uma função que permitem transmitir informações de configuração para buildpacks.

Atualizar variáveis de ambiente de build

É possível atualizar variáveis de ambiente de build para funções atuais. Essa é uma abordagem não destrutiva que altera ou adiciona um ambiente de build mas não exclui as variáveis de ambiente de build.

gcloud

Para atualizar uma variável de ambiente de build para funções atuais:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --update-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Excluir variáveis de ambiente de build

É possível excluir variáveis de ambiente de build para funções atuais.

gcloud

Para remover variáveis de ambiente de build, use --remove-build-env-vars para funções atuais:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --remove-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Como alternativa, é possível limpar as variáveis de ambiente de build usando o comando --clear-build-env-vars para funções atuais:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --clear-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Criar arquivo de variáveis de ambiente

Você usa um arquivo de variáveis de ambiente de build para funções existentes.

gcloud

Para definir variáveis de ambiente de build usando um arquivo:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --build-env-vars-file FILE_NAME.yaml

Substitua FILE_NAME.yaml, em que o conteúdo do arquivo é o seguinte:

 KEY1: VALUE1
 KEY2: VALUE2