Como configurar variáveis de ambiente para uma aplicação Python no VPS imprimir

Bem-vindo(a) à aula de hoje: Variáveis de Ambiente 🧘

Olá! Aqui é a Sensei da GeHost. Se você já viu um arquivo de configuração cheio de senhas, chaves de API e endereços de banco de dados escritos direto no código da sua aplicação Python, respira fundo: hoje vamos arrumar isso juntos. Vou te ensinar, com calma e sem termos técnicos assustadores, como usar variáveis de ambiente para deixar sua aplicação mais organizada e muito mais segura.

O que são variáveis de ambiente, afinal?

Pense nelas como post-its de configuração que ficam colados no ambiente do servidor, fora do seu código. Em vez de escrever a senha do banco de dados dentro do arquivo app.py, você guarda essa informação separadamente, e a aplicação apenas "pergunta" para o servidor: "ei, qual é o valor disso aqui?".

Isso é útil por alguns motivos simples:

• Você não corre o risco de subir uma senha sem querer para um repositório público (como o GitHub).
• Fica fácil trocar uma configuração (por exemplo, uma chave de API) sem precisar mexer no código da aplicação.
• A mesma aplicação pode se comportar de forma diferente em ambientes diferentes (teste e produção, por exemplo) só trocando essas variáveis.

💡 Dica da Sensei: se você já viu uma senha ou chave "hardcoded" (escrita direto) no meio do seu código Python, esse é o sinal perfeito para migrar para variáveis de ambiente.

Passo a passo para configurar

Passo 1 — Acesse o gerenciador de arquivos do seu painel

O primeiro passo é chegar até os arquivos da sua aplicação. Entre no cPanel e abra o Gerenciador de Arquivos. É por ali que vamos criar e editar o arquivo onde suas variáveis vão morar.

Passo 2 — Crie um arquivo .env

Dentro da pasta raiz da sua aplicação Python, crie um novo arquivo chamado .env (isso mesmo, começando com ponto). Dentro dele, você vai listar suas variáveis, uma por linha, no formato NOME=valor. Por exemplo:

• DEBUG=False
• DATABASE_URL=sua_string_de_conexao_aqui
• SECRET_KEY=sua_chave_secreta_aqui

Não use aspas, não deixe espaços em volta do sinal de igual, e não coloque esse arquivo em nenhum repositório público — ele é só para uso interno no servidor.

Passo 3 — Faça sua aplicação Python ler essas variáveis

Agora vem a mágica: sua aplicação precisa saber que esse arquivo existe. A forma mais comum e simples é usando a biblioteca python-dotenv. No topo do seu arquivo principal (geralmente app.py ou wsgi.py), adicione:

1. Instale a biblioteca com pip install python-dotenv (via terminal, se seu plano tiver acesso a ele).
2. No início do código, importe e carregue o arquivo: from dotenv import load_dotenv e depois load_dotenv().
3. A partir daí, use os.environ.get("NOME_DA_VARIAVEL") sempre que precisar daquele valor no código, em vez de escrevê-lo direto.

Se sua hospedagem tiver a interface de "Configurar App Python" disponível no painel, ela também costuma oferecer uma seção própria para cadastrar variáveis de ambiente diretamente pela tela, sem precisar do arquivo .env — nesse caso, basta preencher os campos "nome" e "valor" por ali.

Passo 4 — Reinicie a aplicação

Depois de salvar o arquivo .env (ou cadastrar as variáveis na interface do painel), é preciso reiniciar a aplicação Python para que as mudanças tenham efeito. Se estiver usando a interface de gerenciamento de apps do painel, normalmente existe um botão de "Reiniciar". Se estiver via terminal, o comando de reinício depende de como sua aplicação está configurada — na dúvida, fale com o nosso suporte.

Boas práticas para você levar dessa aula

• Nunca publique o arquivo .env em repositórios de código público.
• Use nomes de variáveis em letras maiúsculas com underscore, como MINHA_VARIAVEL — é o padrão mais lido no mundo Python.
• Evite guardar informações sensíveis (senhas, chaves) direto no código-fonte, mesmo em ambiente de testes.
• Sempre que alterar uma variável, lembre-se de reiniciar a aplicação — a mudança não é aplicada sozinha.

🌱 Dica da Sensei: se você não tem certeza de qual método sua aplicação usa para carregar variáveis de ambiente (arquivo .env, painel do cPanel ou configuração do servidor de aplicação), não tem problema nenhum em perguntar — nosso suporte te ajuda a identificar isso com carinho.

Ficou com dúvida?

Configurar variáveis de ambiente parece técnico à primeira vista, mas é um hábito simples que separa quem programa "no susto" de quem programa com tranquilidade. Se em algum passo você travar, é só acessar o painel.gehost.com.br e abrir um chamado para o nosso suporte — estamos aqui para te ajudar a crescer com segurança. 🙏