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.
Você pode definir variáveis de ambiente de build ao implantar uma função do código-fonte:
gcloud beta run deploySERVICE \ --source . \ --functionFUNCTION_ENTRY_POINT \ --set-build-env-varsKEY1=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.
Para atualizar uma variável de ambiente de build para funções atuais:
gcloud beta run deploySERVICE \ --source . \ --functionFUNCTION_ENTRY_POINT \ --update-build-env-varsKEY1=VALUE1,KEY2=VALUE2
Excluir variáveis de ambiente de build
É possível excluir variáveis de ambiente de build para funções atuais.
Para remover variáveis de ambiente de build, use --remove-build-env-vars
para funções atuais:
gcloud beta run deploySERVICE \ --source . \ --functionFUNCTION_ENTRY_POINT \ --remove-build-env-varsKEY1=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 deploySERVICE \ --source . \ --functionFUNCTION_ENTRY_POINT \ --clear-build-env-varsKEY1=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.
Para definir variáveis de ambiente de build usando um arquivo:
gcloud beta run deploySERVICE \ --source . \ --functionFUNCTION_ENTRY_POINT \ --build-env-vars-fileFILE_NAME .yaml
Substitua FILE_NAME.yaml, em que o conteúdo do arquivo é o seguinte:
KEY1: VALUE1
KEY2: VALUE2