Como configurar variáveis de ambiente separadas para produção e staging no deploy

Como configurar variáveis de ambiente separadas para produção e staging no deploy

Olá, querido(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu guia de mão na massa, escrito com carinho pelo Sensei da GeHost — aqui para te ajudar a dominar o mundo do deploy com tranquilidade, clareza e um toque de humanidade. 🌟

Quando você está desenvolvendo um site ou aplicativo, é essencial ter ambientes separados: um para testes (staging) e outro para o mundo real (produção). E, para isso, as variáveis de ambiente são seu superpoder — elas permitem que você mude configurações sem mexer no código.

Hoje, vamos te ensinar, passo a passo, como configurar variáveis de ambiente diferentes para produção e staging no seu site hospedado na GeHost — mesmo que você seja novo nisso. Vamos com calma, como se fosse um chá de menta com um amigo.

Passo 1: Entenda o que são variáveis de ambiente

Imagine que você tem um app que precisa se conectar a um banco de dados. Em produção, ele se conecta ao banco real. Em staging, ele se conecta a um banco de teste. Em vez de mudar o código toda vez, você usa variáveis de ambiente como "chaves" que dizem: “agora estou em produção” ou “agora estou em staging”.

💡 Dica do Sensei: Variáveis de ambiente são como segredos que seu app lê em tempo real. Nunca coloque senhas, chaves de API ou URLs reais no código — isso é como deixar a chave da casa na porta.

Passo 2: Crie arquivos de variáveis separados

No seu projeto, você pode usar arquivos como:

• .env.staging — para o ambiente de testes
• .env.production — para o ambiente real

Exemplo de conteúdo em .env.staging:

APP_ENV=staging
DB_HOST=localhost
DB_NAME=meuapp_staging
DB_USER=usuario_staging
DB_PASS=senha123

Exemplo em .env.production:

APP_ENV=production
DB_HOST=127.0.0.1
DB_NAME=meuapp_prod
DB_USER=usuario_prod
DB_PASS=senha_segura_muito_mais_longa

⚠️ Importante: Nunca suba esses arquivos ao servidor com senhas reais no código! Use apenas os arquivos de configuração no seu ambiente local.

Passo 3: Configure o cPanel para usar o ambiente certo

Na GeHost, o cPanel é seu parceiro de confiança. Vamos usar o Gerenciador de Arquivos para colocar os arquivos no lugar certo.

1. Entre no Painel do Cliente da GeHost.
2. Logue com seu usuário e senha.
3. Clique em cPanel (na aba “Hospedagem”).
4. No painel, localize e clique em Gerenciador de Arquivos.

Na tela do Gerenciador de Arquivos, vá até a pasta onde seu projeto está hospedado — geralmente public_html ou uma subpasta como meuapp.

Passo 4: Suba os arquivos de configuração

Na pasta do seu projeto no public_html, você pode subir:

• .env.staging — apenas para uso local ou em servidores de teste
• .env.production — para o ambiente de produção

💡 Dica do Sensei: Em produção, você pode até renomear o arquivo para .env e deixar apenas ele ativo. Assim, o app lê automaticamente as configurações certas.

Passo 5: Use um script de deploy para escolher o ambiente

Se você usa um sistema de deploy automático (como Git + CI/CD), pode configurar o script para copiar o arquivo correto no momento do deploy:

• Se for deploy para produção, copie .env.production para .env.
• Se for deploy para staging, copie .env.staging para .env.

Exemplo em um script:

if [ "$DEPLOY_ENV" = "production" ]; then
  cp .env.production .env
else
  cp .env.staging .env
fi

Assim, o app sempre usa as configurações certas — sem confusão!

Passo 6: Teste com segurança

Depois de fazer o deploy:

• Verifique se o site está funcionando.
• Confira se as conexões com banco de dados, APIs ou serviços externos estão corretas.
• Use logs ou ferramentas como Métricas no cPanel para ver se tudo está como esperado.

Resumo final: seu guia de ouro

Para manter tudo organizado:

• Use .env.staging e .env.production separados.
• Suba apenas o arquivo certo no momento do deploy.
• Evite colocar senhas no código.
• Teste sempre antes de ir para produção.

Se precisar de ajuda, o Sensei da GeHost está aqui — e o suporte está disponível por 30 dias após a entrega, no painel do cliente. Basta entrar em contato com a equipe que te ajuda com carinho.

Seu projeto está mais seguro, mais organizado e pronto para brilhar. E lembre-se: o melhor código é o que você não precisa mudar depois. 😊

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