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:
-
Desenvolvedor de origem do Cloud Run (
roles/run.sourceDeveloper) -
Usuário da conta de serviço (
roles/iam.serviceAccountUser)
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