Passe a configuração por variáveis de ambiente

Codificar diretamente um caminho de modelo ou uma chave de API grava-os permanentemente na imagem. Em vez disso, passe-os como variáveis de ambiente durante a execução.

Use os.getenv para ler uma variável, com um valor padrão adequado. Assim, seu código se adapta a cada ambiente sem precisar de alterações.

A instrução ENV do Dockerfile define um valor padrão incorporado à imagem. Ela é útil para configurações não secretas que raramente mudam.

Substitua qualquer valor usando -e com docker run. Assim, a mesma imagem atende ao ambiente de homologação ou de produção com configurações diferentes.

Mantenha muitas variáveis organizadas em um arquivo e carregue-o com --env-file. Seu comando de execução continua curto e legível.

Mantenha os arquivos secretos fora do Git e da imagem. Adicione seu .env ao .gitignore e ao .dockerignore para que eles nunca vazem.

Segredos reais, como senhas de banco de dados, devem vir de um cofre ou do gerenciador de segredos da sua plataforma, sendo injetados apenas em tempo de execução.

Verifique as variáveis obrigatórias quando o aplicativo iniciar e falhe de forma explícita se alguma estiver ausente. Uma falha clara é melhor do que uma previsão incorreta e silenciosa.

A regra de doze fatores diz para armazenar a configuração no ambiente. Isso mantém uma única imagem portátil em todos os destinos de implantação.

Ferramentas como pydantic-settings leem variáveis de ambiente em um objeto de configuração tipado, validando tipos e valores padrão em um único lugar organizado.

A vantagem é compilar uma vez e executar essa mesma imagem nos ambientes de desenvolvimento, homologação e produção, alterando apenas as variáveis injetadas.

Você leu a configuração com os.getenv, definiu valores padrão por meio de ENV, substituiu valores com -e e --env-file e manteve os segredos fora da imagem. Uma imagem portátil. ✅