Como configurar um ambiente de staging automatizado com Git no VPS

Como configurar um ambiente de staging automatizado com Git no VPS

Olá, querido aluno da GeHost! 😊

Se você está aqui, provavelmente já entende que ter um ambiente de staging — ou seja, uma versão de teste da sua aplicação antes de ir para produção — é essencial para evitar surpresas no site do seu cliente ou no seu projeto. E o melhor? Com Git, isso pode ser feito de forma automatizada, segura e rápida.

Este guia foi escrito com carinho para você, que quer aprender, sem precisar de experiência técnica profunda. Vamos juntos, passo a passo, montar um sistema de staging no seu VPS com Git. A GeHost está aqui com você, como sempre!

📌 O que você vai precisar

• Um VPS (servidor dedicado) com acesso via SSH (geralmente incluso em planos de hospedagem avançados).
• Conhecimento básico de terminal (linha de comando).
• Um repositório Git (no GitHub, GitLab ou outro serviço).
• Domínio de teste (ex: staging.seudominio.com.br).
• Acesso ao painel do cliente da GeHost: painel.gehost.com.br.

🛠️ Passo a passo: montando o staging com Git

1. Acesse seu VPS via SSH

Use um cliente SSH como Putty (Windows) ou o terminal nativo (macOS/Linux). Conecte-se ao seu VPS com os dados fornecidos na sua conta.

Se não souber como, entre em contato com o suporte da GeHost — estamos aqui para ajudar! 💬

2. Crie uma pasta para o staging

No seu VPS, vá para a pasta onde os arquivos do seu site são armazenados (geralmente /home/usuario/public_html).

Execute este comando:

mkdir -p /home/usuario/public_html/staging

Substitua usuario pelo seu nome de usuário no servidor.

3. Inicialize um repositório Git no staging

Entre na pasta do staging:

cd /home/usuario/public_html/staging

Depois, inicialize o Git:

git init

Pronto! Agora você tem um repositório Git no seu ambiente de teste.

4. Adicione o repositório remoto (ex: GitHub)

Volte ao seu repositório no GitHub (ou GitLab) e copie o link do repositório (ex: https://github.com/seu-usuario/seu-projeto.git).

No terminal do VPS, execute:

git remote add origin https://github.com/seu-usuario/seu-projeto.git

Substitua o link pelo seu repositório real.

5. Faça o primeiro pull (baixe o código)

Para trazer o código do repositório remoto para o staging, use:

git pull origin main

Se o seu branch principal for master, troque main por master.

Pronto! Seu código agora está no ambiente de staging.

6. Configure o domínio de staging

No painel da GeHost (painel.gehost.com.br), vá em Domínios → Gerenciar Domínios.

Adicione um novo subdomínio, como staging.seudominio.com.br, apontando para a pasta /home/usuario/public_html/staging.

7. Automatize o pull com um webhook (opcional, mas poderoso)

Para automatizar a atualização do staging sempre que você fizer um push no GitHub, você pode usar um webhook.

No GitHub, vá em Settings → Webhooks → Add webhook.

Configure assim:

• Payload URL: https://staging.seudominio.com.br/webhook (crie um arquivo PHP nesse caminho para receber o webhook).
• Content type: application/json
• Events: Push

No seu VPS, crie um arquivo PHP em /home/usuario/public_html/staging/webhook.php com o seguinte conteúdo:

<?php
// Arquivo: webhook.php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $output = shell_exec('cd /home/usuario/public_html/staging && git pull origin main 2>&1');
    echo "Atualização realizada: " . $output;
} else {
    echo "Acesso negado.";
}
?>

Este script, quando acionado pelo GitHub, atualiza automaticamente o staging com o novo código.

💡 Dica do Sensei da GeHost

Se você não tiver certeza sobre o caminho do seu usuário ou a estrutura do servidor, entre no painel da GeHost, acesse o Terminal (SSH) e digite whoami. Assim, você descobre seu nome de usuário com segurança.

🔐 Segurança: não deixe o webhook exposto

Para proteger o webhook, você pode:

• Usar um token de segurança no URL (ex: https://staging.seudominio.com.br/webhook?token=seguro123).
• Requerer autenticação básica no servidor.
• Restringir o acesso por IP (via .htaccess).

Essas medidas evitam que qualquer um ative a atualização do seu staging.

✅ Pronto! Você tem um staging automatizado!

Parabéns, mestre do staging! 🎉

Agora, toda vez que você fizer um git push no GitHub, o seu ambiente de teste será atualizado automaticamente — sem precisar entrar no servidor, sem comandos manuais. É como ter um robô cuidando do seu site de teste!

📬 Precisa de ajuda?

Se algo não funcionar, ou se precisar de suporte personalizado, entre em contato com o suporte da GeHost. Estamos aqui para você, com 30 dias grátis após a entrega — e sempre com um sorriso no coração.

Seu sucesso é o nosso propósito. 💚

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