Como configurar um pipeline simples de deploy automático via Git no VPS imprimir

  • 0

Como configurar um pipeline simples de deploy automático via Git no seu servidor

Oi! Aqui é a Sensei da GeHost 🥋 e hoje eu vou te ensinar uma mágica que economiza um tempão: em vez de subir arquivo por arquivo via FTP toda vez que você atualiza seu site ou sistema, você faz um git push e o próprio servidor já atualiza tudo sozinho. Isso é o que chamamos de pipeline de deploy automático. Vamos com calma, passo a passo, que não tem mistério nenhum.

O que é isso, na prática?

Pensa assim: você tem o código do seu projeto guardado num repositório Git (pode ser no GitHub, GitLab, Bitbucket ou até um repositório só seu). Em vez de copiar arquivo por arquivo pro servidor, você configura uma "ponte" entre o seu repositório e o servidor. Quando você manda uma atualização (git push), o servidor recebe o aviso e atualiza os arquivos do site automaticamente. Sem FTP, sem arrastar pasta, sem esquecer nenhum arquivo no meio do caminho.

Dica da Sensei: pipeline de deploy é ótimo pra quem já usa Git no dia a dia (times de dev, freelancers, agências). Se você ainda não usa Git no seu projeto, tudo bem — comece migrando o versionamento primeiro, o deploy automático vem depois como um "bônus".

Caminho 1 — usando o recurso de Git do próprio painel (o mais simples)

Se a sua hospedagem é em plano cPanel da GeHost, você não precisa mexer em nada complicado: o cPanel já tem uma ferramenta pronta chamada "Git™ Version Control", que resolve boa parte do trabalho sem precisar digitar comando nenhum no terminal.

  1. Acesse o cPanel da sua conta (login e senha ficam no seu painel.gehost.com.br, na área do serviço de hospedagem).
  2. Na tela inicial do cPanel, procure a seção de ferramentas de desenvolvimento/arquivos e clique em "Git™ Version Control".
  3. Clique em "Create" (criar) e informe o endereço do seu repositório (o "clone URL", geralmente algo como https://github.com/seuusuario/seurepositorio.git) e a pasta de destino (por exemplo, dentro de public_html).
  4. O cPanel clona o repositório pra dentro da hospedagem. A partir daí, toda vez que você atualizar o código lá na origem (GitHub/GitLab), é só voltar nessa mesma tela e clicar em "Pull or Deploy" → "Update from Remote" pra trazer a versão mais nova.
Tela de login do cPanel Painel inicial do cPanel com os grupos de ferramentas

Depois de atualizar, dá uma espiadinha no Gerenciador de Arquivos pra confirmar que os arquivos novos realmente chegaram na pasta certa (geralmente public_html ou uma subpasta do seu site):

Gerenciador de Arquivos do cPanel mostrando a árvore de pastas

Caminho 2 — deploy automático de verdade, com "post-receive hook" (pra quem tem um servidor/VPS próprio com acesso via terminal)

Se o seu projeto roda num servidor onde você tem acesso via terminal (SSH), dá pra automatizar 100%: nem precisa clicar em "atualizar" — o próprio git push já dispara o deploy. A receita clássica é assim:

  1. Crie um repositório "nu" (bare) no servidor, que vai ser o destino dos seus pushes:
    git init --bare /caminho/para/meu-projeto.git
  2. Crie um "hook" de pós-recebimento dentro desse repositório, no arquivo hooks/post-receive. É um script simples que roda automaticamente toda vez que alguém dá push. Um exemplo básico:
    #!/bin/bash
    git --work-tree=/caminho/do/site --git-dir=/caminho/para/meu-projeto.git checkout -f
  3. Dê permissão de execução ao arquivo: chmod +x hooks/post-receive.
  4. No seu computador, adicione esse repositório como um "remote" de produção:
    git remote add producao ssh://usuario@servidor/caminho/para/meu-projeto.git
  5. A partir de agora, sempre que quiser publicar uma atualização, basta rodar:
    git push producao main
Dica da Sensei: teste esse fluxo primeiro num ambiente de testes (uma cópia do site) antes de usar em produção — assim você garante que o script do hook está funcionando certinho antes de qualquer atualização "valer pra valer".

Boas práticas pra não se enrolar

  • Nunca suba senhas, chaves de API ou arquivos de configuração sensíveis direto no repositório — use variáveis de ambiente ou arquivos ignorados pelo Git (.gitignore).
  • Faça sempre um backup antes de configurar o pipeline pela primeira vez. O cPanel tem uma ferramenta própria pra isso:
Tela de Backup do cPanel
  • Combine com o time qual é a branch de produção (normalmente main ou master) — só ela deve disparar o deploy automático, pra não publicar código ainda em teste sem querer.
  • Se algo der errado no meio do caminho, é só restaurar o backup e revisar o script do hook com calma — sem pânico.

Ficou com dúvida?

Se precisar de uma mãozinha pra configurar o Git Version Control no seu plano, ou tiver alguma dúvida na hora de montar o hook, é só chamar o suporte da GeHost pelo painel.gehost.com.br — todo serviço entregue já vem com 30 dias de suporte gratuito após a entrega, e a gente adora ajudar a destravar esse tipo de configuração. Bora automatizar esse deploy! 🚀


Esta resposta lhe foi útil?

« Retornar