Variáveis de ambiente
100%

Docker Compose · Lição 5

Variáveis de ambiente

Aprenda a distinguir um valor inserido no arquivo do Compose de um valor passado para o contêiner.

Uma variável de ambiente é um valor com nome que um programa pode ler. O Compose pode usar variáveis de duas maneiras: para inserir um valor ao ler o arquivo e para passar valores a um programa dentro do contêiner.

Como inserir um valor no arquivo

Salve o exemplo como compose.env.yaml na pasta de prática. A expressão ${PAGE_MODE:-demo} usa o valor de PAGE_MODE se a variável estiver definida e não estiver vazia. Caso contrário, usa demo.

services:
  toolbox:
    image: busybox:1.36
    environment:
      PAGE_MODE: "${PAGE_MODE:-demo}"

O Compose resolve a expressão antes de criar o contêiner. Isso se chama interpolação. Você pode encontrar a mesma técnica em outros arquivos, por exemplo, para escolher uma porta do host ou uma tag de imagem.

Se PAGE_MODE não estiver definida, que valor aparece na configuração exibida?

Como conferir o valor escolhido

Uma atribuição antes de um comando define a variável só para aquela execução. Faça isso para ver como a configuração fica com outro valor. O comando config exibe as configurações depois da interpolação, sem criar contêineres.

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config

Procure PAGE_MODE: review no ambiente do serviço. O valor review é apenas para demonstração. Mantenha dados secretos fora das configurações de exemplo e da saída exibida.

A configuração exibida contém review. O que aconteceu até aqui?

Como passar um valor para o contêiner

A seção environment passa o valor escolhido para um novo contêiner. Use printenv para exibir o valor de dentro do contêiner criado para essa execução.

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE

Você deve ver review. A interpolação escolheu o valor e a configuração de ambiente o passou para o contêiner. Uma variável usada apenas para escolher a porta do host não entra automaticamente no ambiente do programa.

Como conferir o valor que o programa dentro do contêiner de ferramentas recebe?

Lição concluída

Você concluiu Variáveis de ambiente

Agora você consegue distinguir os dois usos das variáveis de ambiente.

  • Leia uma expressão com valor padrão em um arquivo do Compose.

  • Confira a configuração após a interpolação, antes de iniciar o contêiner.

  • Verifique o valor no ambiente do programa iniciado.

Salve seu progresso

Crie uma conta gratuita para salvar esta lição e continuar em qualquer dispositivo.

Criar uma conta gratuita
Próxima Lição
Voltar para Docker Compose