Como configurar um ambiente de homologação idêntico ao de produção no VPS
Olá, querido(a) desenvolvedor(a)!
Se você está aqui, provavelmente já tem um site funcionando no ar — seu ambiente de produção — e quer criar um espaço de testes, chamado homologação, que seja exatamente igual ao seu site real. Isso é excelente prática! Evita surpresas quando você lança novas funcionalidades.
Como você está usando um VPS (Servidor Virtual Privado), você tem controle total — o que é ótimo! Mas com grande poder vem grande responsabilidade. Vamos juntos montar esse ambiente de homologação passo a passo, com cuidado e clareza. Seu Sensei da GeHost está aqui para te guiar.
Antes de começar: Entenda o que é homologação
Imagine que seu site de produção é como uma loja aberta ao público. Já o ambiente de homologação é como um projetor de testes — lá você pode brincar, testar, errar, sem afetar ninguém.
Para que funcione direitinho, ele precisa ser idêntico ao de produção:
- mesma versão do PHP
- mesmo banco de dados
- mesmos arquivos
- mesmo domínio (ou subdomínio)
Pronto? Vamos lá!
Passo 1: Faça um backup completo do ambiente de produção
Antes de qualquer coisa, salve tudo. O backup é seu seguro de vida digital.
Entre no cPanel do seu domínio principal (o de produção):
Depois de logado, vá até a seção Backup:
Clique em Backup Completo e espere o processo terminar. Isso vai gerar um arquivo com todos os arquivos, bancos de dados e configurações do seu site.
Dica do Sensei: Sempre mantenha cópias seguras desse backup. Ele é seu resgate em caso de falha.
Passo 2: Crie um novo domínio ou subdomínio para a homologação
No cPanel, acesse a seção DNS Zone:
Aqui, você pode criar um novo subdomínio, como homologacao.seudominio.com ou dev.seudominio.com.
Se já tiver um domínio dedicado para homologação, certifique-se de que ele aponta para o mesmo servidor VPS.
Passo 3: Restaure o backup no novo ambiente
Volte à tela Backup no cPanel e clique em Restaurar Backup.
Selecione o arquivo que você fez no passo 1. O sistema irá restaurar todos os arquivos e bancos de dados para o novo domínio/subdomínio.
⚠️ Atenção: Certifique-se de que o backup está sendo restaurado no domínio correto — aquele que você criou para homologação. Caso contrário, você pode sobrescrever o ambiente de produção!
Passo 4: Atualize os dados sensíveis
Depois da restauração, o ambiente ainda tem dados do ambiente de produção. Isso inclui:
- configurações de banco de dados com URLs reais
- credenciais de API
- chaves de acesso
É hora de trocar tudo que é "produção" por "homologação".
Abra o arquivo wp-config.php (se for WordPress) ou o arquivo de configuração do seu sistema (como config.php ou .env) e altere:
- URL do site: de
https://seudominio.comparahttps://homologacao.seudominio.com - Nome do banco de dados, usuário e senha — se necessário, crie um novo banco com o mesmo nome e usuários
- Chaves de API, URLs de serviços externos (ex: Stripe, Google Maps) — substitua por chaves de testes
Dica do Sensei: Use um banco de dados separado para homologação. Isso evita que você altere dados reais por acidente.
Passo 5: Teste tudo com cuidado
Abra o novo domínio de homologação no navegador e verifique:
- Se a página carrega sem erros
- Se os formulários funcionam
- Se o login funciona (com credenciais de teste)
- Se os e-mails são enviados (e não para clientes reais!)
Se algo não funcionar, volte ao backup e repita o processo com atenção. É assim que aprendemos!
Passo 6: Mantenha o ambiente atualizado e seguro
Depois de testar, não deixe o ambiente de homologação aberto para sempre. Ele é um espaço de teste, não um site oficial.
Para manter tudo seguro:
- Use senhas fortes
- Evite deixar o acesso público
- Remova o ambiente quando não for mais necessário
Princípio do Sensei: Um ambiente de homologação bem feito é como um laboratório: limpo, organizado e focado no propósito — testar com segurança.
Conclusão
Parabéns! Você acabou de criar um ambiente de homologação idêntico ao de produção — com todos os dados, configurações e funcionalidades, mas em segurança.
Esse passo é fundamental para entregar projetos confiáveis, sem surpresas no ar. E, com o tempo, você vai perceber que esse cuidado faz toda a diferença.
Se tiver dúvidas, não hesite em entrar em contato com nosso suporte. Estamos aqui para te ajudar — afinal, você é parte da nossa família GeHost.
Com carinho,
Sensei da GeHost
*Grupo G e Soluções e Eventos LTDA — CNPJ: 46.647.904/0001-04*