Como configurar variáveis de ambiente separadas para produção e desenvolvimento no VPS

Como configurar variáveis de ambiente separadas para produção e desenvolvimento no VPS

Olá, querido(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu guia de mão na massa, com carinho e paciência — como se estivéssemos conversando sobre café, no seu cantinho favorito. Aqui na GeHost, acreditamos que tecnologia deve ser acessível, segura e, acima de tudo, inteligente ao te ajudar a crescer.

Hoje vamos falar de um assunto super importante para quem desenvolve: variáveis de ambiente separadas para produção e desenvolvimento. Isso quer dizer: você pode ter um ambiente de testes (desenvolvimento) e outro real (produção) com configurações diferentes — sem riscos, sem confusão, sem perda de dados.

É como ter duas cozinhas: uma para experimentar novas receitas (desenvolvimento), e outra para servir pratos ao público (produção). Tudo com seus próprios ingredientes, temperos e segredos.

Sensei diz: “O bom desenvolvedor não confunde o que é teste com o que é real. Ele separa com sabedoria.”

Por que separar variáveis de ambiente?

Imagine que você coloca a senha do banco de dados de produção no seu código de teste. Se alguém acessar o repositório público (como no GitHub), seu sistema pode ser invadido. Isso é perigoso.

Separar variáveis de ambiente é como colocar uma porta de segurança entre o que é teste e o que é real. Assim, você:

• Protege dados sensíveis (senhas, chaves de API, URLs de banco).
• Testa mudanças sem afetar o site real.
• Garante que o sistema funcione igual em todos os ambientes.

Passo a passo: como fazer isso no seu VPS (com cPanel)

Na GeHost, seu VPS é uma máquina dedicada, com controle total — mas ainda assim, tudo é gerenciado por meio do cPanel. Vamos usar esse painel para configurar as variáveis de forma segura e organizada.

1. Entre no seu painel cPanel
   Acesse painel.gehost.com.br com suas credenciais. É lá que você controla tudo.
2. Localize o diretório do seu projeto
   No cPanel, vá até Gerenciador de Arquivos (). Navegue até a pasta onde seu projeto está (geralmente dentro de public_html ou uma subpasta).
3. Crie duas pastas separadas
   Dentro da pasta do seu projeto, crie duas pastas:
   • config/dev — para variáveis de desenvolvimento.
   • config/prod — para variáveis de produção.
   Você pode fazer isso diretamente no Gerenciador de Arquivos — clique com o botão direito na pasta principal e escolha "Criar Pasta".
4. Crie arquivos de variáveis
   Dentro de cada pasta, crie um arquivo chamado .env:
   • config/dev/.env — com as variáveis de teste (ex: banco local, URL de teste).
   • config/prod/.env — com as variáveis reais (ex: banco de produção, chave de API real).

   Exemplo de conteúdo no .env (não copie isso diretamente — use seus próprios valores):

   DB_HOST=localhost
   DB_USER=dev_user
   DB_PASS=dev_senha123
   APP_ENV=development

   Para produção, troque os valores para os reais, sem expor senhas em código.

5. Configure o sistema para ler o ambiente certo
   No seu código (ex: PHP, Node.js, Python), você deve configurar o sistema para carregar o arquivo .env com base no ambiente. Por exemplo, em PHP, você pode usar uma função que verifica o domínio ou uma variável de sistema para decidir qual .env carregar.

6. Proteja os arquivos .env
   Em produção, nunca deixe o arquivo .env acessível via navegador. No cPanel, vá até Gerenciador de Arquivos e clique com o botão direito no arquivo .env em config/prod/. Selecione "Editar" e mude as permissões para 600 (somente leitura e escrita pelo dono). Isso evita que qualquer pessoa o acesse diretamente.
7. Use o .gitignore para proteger o .env
   Se você usa Git (recomendado!), adicione .env ao arquivo .gitignore para que ele nunca seja enviado ao repositório público.

   .env
   .env.local

Dica do Sensei

“Sempre teste seu ambiente de desenvolvimento antes de subir para produção. E nunca, nunca, suba um .env com senhas reais para o GitHub.”

Importante: segurança e boas práticas

• Use senhas fortes e únicas para cada ambiente.
• Evite usar arquivos .env no diretório público (public_html).
• Atualize suas variáveis periodicamente (ex: troque senhas de banco).
• Se precisar de ajuda, entre em contato com o suporte da GeHost — estamos aqui para te ajudar, com carinho e respeito.

Próximos passos

Depois de configurar, teste seu sistema em ambos os ambientes. Verifique se:

• O site de desenvolvimento funciona com dados de teste.
• O site de produção usa os dados reais e não falha.
• Os arquivos .env não estão acessíveis via navegador.

Parabéns! Você está no caminho certo: profissional, seguro e organizado.

Se precisar de ajuda com algo, não hesite. A GeHost está aqui — com você, sempre.

Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*