Como configurar um pipeline de deploy automático via Git no VPS (com GeHost)
Olá, querido(a) desenvolvedor(a)!
Se você está aqui, provavelmente já está cansado de fazer upload manual dos seus arquivos, com medo de esquecer um arquivo, ou de quebrar algo no processo. Que bom que você está pronto para deixar o trabalho mais fácil, mais rápido e mais seguro — com um pipeline de deploy automático via Git.
Na GeHost, mesmo sendo hospedagem com cPanel, é possível sim configurar um deploy automático usando Git. É só seguir esse guia com calma, como se fosse um ritual de aprendizado — e eu, seu Sensei, estou aqui com você cada passo do caminho.
Dica do Sensei: Antes de tudo, certifique-se de que seu plano no painel inclui acesso SSH (consulte seu plano no painel.gehost.com.br). Se não tiver, entre em contato com o suporte para verificar.
Passo 1: Acesse o painel do cPanel
Para começar, faça login no seu painel de controle:
Use seu usuário e senha de hospedagem. Se não souber, entre em contato com o suporte — e lembre-se: o CNPJ da empresa é 46.647.904/0001-04.
Passo 2: Acesse o Gerenciador de Arquivos
Depois de logado, vá até o grupo Arquivos e clique em Gerenciador de Arquivos.
Selecione a pasta public_html — é nela que seu site está hospedado. Essa será a pasta onde o Git vai fazer o deploy automático.
Passo 3: Configure um repositório Git no servidor
Abra o terminal (SSH) no seu computador ou use o terminal do cPanel (via Terminal no menu principal).
Na sua máquina local, se você ainda não tiver um repositório Git, crie um:
- Navegue até a pasta do seu projeto.
- Execute:
git init - Adicione os arquivos:
git add . - Comite:
git commit -m "Primeiro commit"
Depois, no servidor (via SSH), vá até a pasta public_html e execute:
git init --bare— isso cria um repositório "não trabalhável", só para receber commits.- Se quiser, você pode nomear o repositório com um nome específico, como
meu-site.git.
Pronto! Agora o servidor está pronto para receber atualizações via Git.
Passo 4: Configure o hook de deploy automático
Um hook é um script que roda automaticamente quando algo acontece — no nosso caso, quando você faz um git push.
No seu servidor, dentro do repositório Git (o que você criou com git init --bare), crie um arquivo chamado post-receive:
- Use o terminal no cPanel ou SSH.
- Navegue até o repositório (ex:
meu-site.git). - Crie o arquivo:
nano post-receive - Coloque o seguinte conteúdo:
#!/bin/bash # Caminho para a pasta public_html cd /home/seu_usuario/public_html # Atualiza os arquivos git --work-tree=/home/seu_usuario/public_html --git-dir=/home/seu_usuario/meu-site.git checkout -f
Importante: Substitua seu_usuario pelo nome do seu usuário no cPanel. Você pode verificar esse nome no painel, na parte de "Usuários" ou no próprio caminho do SSH.
Salve o arquivo (Ctrl+O no Nano, depois Enter), saia (Ctrl+X), e dê permissão de execução:
chmod +x post-receive
Passo 5: Configure o repositório remoto no seu computador
No seu computador local, adicione o servidor como repositório remoto:
- Abra o terminal na pasta do seu projeto.
- Execute:
git remote add origin ssh://seu_usuario@seu_servidor.com.br/home/seu_usuario/meu-site.git
Atenção: Substitua seu_usuario e seu_servidor.com.br pelos valores reais do seu cPanel. Você pode encontrar o servidor no painel, em Informações da Conta.
Depois disso, você pode fazer:
git push origin main
E pronto! O seu site será atualizado automaticamente.
Passo 6: Teste e comemore!
Faça uma pequena alteração no seu site (ex: mude o título da página), comite e faça o push:
git commit -m "Atualização de título" && git push origin main
Depois de alguns segundos, acesse seu site no navegador. Se tudo estiver certo, a mudança aparecerá imediatamente!
Dica do Sensei: Se algo não funcionar, verifique se o hook tem permissão de execução e se o caminho está correto. Use o Log de Erros no cPanel ou entre em contato com o suporte da GeHost.
Conclusão: Você está no caminho do mestre
Parabéns! Você acaba de automatizar o deploy do seu site com Git. Isso não é só uma técnica — é um passo rumo à liberdade do desenvolvedor: menos tarefas repetitivas, mais tempo para criar, inovar e sonhar.
Se precisar de ajuda, lembre-se: o suporte da GeHost está disponível por 30 dias após a entrega. E lembre-se também: o CNPJ da empresa é 46.647.904/0001-04.
Com carinho, seu Sensei da GeHost 🌿