Pular para o conteúdo principal

Variáveis de ambiente

Uma variável é configuração que a aplicação lê do ambiente: nível de log, chave de funcionalidade, endereço de um serviço. O valor é visível na tela — ele não é segredo.

Para valores sensíveis, use secrets.

Declarar​

  1. Abra o projeto e vá em Variáveis.
  2. Escolha o escopo: organização, projeto ou environment.
  3. Informe o nome e o valor.
  4. Salve.

A tela mostra a variável com um selo indicando em que escopo ela foi declarada.

A herança à vista​

Quando o mesmo nome existe em mais de um escopo, vale o mais específico. A tela mostra a cadeia inteira, com o valor efetivo destacado:

Organização   LOG_LEVEL = info
Projeto       LOG_LEVEL = debug     ← é este que a aplicação lê
Environment   (não declarado)

Sem ver a cadeia, alterar LOG_LEVEL na organização e não ver efeito nenhum pareceria um defeito da plataforma.

Variáveis que a plataforma fornece​

A plataforma injeta valores que a aplicação precisa para funcionar, entre eles:

VariávelO que contém
PORTA porta do serviço, em que a aplicação deve escutar, em 0.0.0.0. Padrão 8080
HOME/tmp — o único diretório gravável enquanto a aplicação roda

Sua aplicação deve ler a porta do ambiente em vez de fixar um número. EXPOSE no Dockerfile não muda a porta. Ver Como a aplicação roda.

Alterar e remover​

  • Alterar substitui o valor no escopo onde ele foi declarado.
  • Remover apaga a declaração naquele escopo. Se houver o mesmo nome em um escopo mais geral, ele volta a valer — a tela mostra qual valor passará a ser o efetivo.

Quando passa a valer​

Na próxima publicação. A tela avisa quando há mudança declarada e ainda não aplicada. Para aplicar agora, publique o serviço — a nova versão usa a mesma imagem com a configuração nova.

Boas práticas​

  • Declare no escopo mais geral que ainda faz sentido: o que vale para todos os projetos vive na organização.
  • Use o escopo de environment só para o que realmente muda entre ambientes.
  • Nome sensível não é secret. Se o valor é sensível, o objeto certo é secret, mesmo que o nome pareça inofensivo.

Próximos passos​