Como configurar deploy automático via Git no seu servidor GeHost
Oi! Eu sou a Sensei da GeHost 🌱 e hoje vou te mostrar, com calma e sem enrolação, como deixar seu projeto se atualizando sozinho a cada vez que você sobe um novo código pro Git. Isso se chama deploy automático e é uma mão na roda pra quem desenvolve sites e sistemas: você programa, envia (faz o "push") pro repositório, e o servidor cuida de colocar a versão mais nova no ar.
Antes de começar: os recursos disponíveis (como acesso via Git, SSH etc.) podem variar de acordo com o seu plano. Se tiver qualquer dúvida se o seu plano contempla esse recurso, dá uma olhadinha no painel.gehost.com.br ou chama o nosso suporte — assim a gente confirma junto com você antes de qualquer configuração.
O que é o "Git Version Control" do cPanel
Seu ambiente de hospedagem GeHost usa o cPanel, e ele já vem com uma ferramenta chamada Git™ Version Control. Com ela, você conecta o seu repositório (GitHub, GitLab, Bitbucket, ou até um repositório dentro do próprio servidor) e o cPanel cuida de puxar as atualizações e colocar os arquivos no lugar certo do seu site. Vamos passo a passo.
Passo 1 — Acesse o cPanel
Entre no seu cPanel com o usuário e senha que a GeHost te enviou (se não tiver mais essas informações, veja no painel do cliente ou fale com o suporte).
Passo 2 — Encontre o "Git™ Version Control"
Na tela inicial do cPanel, procure o grupo de ferramentas de arquivos/software e clique em Git™ Version Control. Se não encontrar de primeira, use a barra de busca do próprio cPanel digitando "git".
Passo 3 — Crie o repositório
- Clique em Create (Criar).
- No campo Clone URL, cole o endereço do seu repositório remoto (ex.: a URL do seu GitHub). Se o repositório for privado, você vai precisar configurar uma chave SSH — o próprio cPanel te mostra como gerar e cadastrar essa chave.
- No campo Repository Path, defina em qual pasta o Git vai guardar o repositório. Normalmente é uma pasta separada, e depois os arquivos são levados até o public_html (ou a pasta do seu domínio/subdomínio).
- Dê um nome amigável em Repository Name e finalize clicando em Create.
Passo 4 — Configure o deploy com o arquivo .cpanel.yml
É aqui que a mágica do "automático" acontece. Dentro do seu repositório, crie um arquivo chamado .cpanel.yml na raiz. Ele diz ao cPanel o que fazer quando você mandar atualizar (deploy). Um exemplo simples e comum é copiar os arquivos da pasta do repositório para a pasta pública do site, algo como:
- deployment: (bloco principal do arquivo)
- tasks: lista de comandos, por exemplo um comando de cópia (/bin/cp -R) da pasta do repositório para o public_html
Não se preocupe em decorar a sintaxe exata: a documentação oficial do cPanel sobre Git Version Control mostra o modelo certinho, e nosso suporte pode te ajudar a revisar o seu arquivo antes de rodar pela primeira vez.
Passo 5 — Faça o deploy
De volta na tela do Git Version Control no cPanel, clique em Manage no repositório criado e depois em Update from Remote (busca as novidades do seu Git) e em seguida Deploy HEAD Commit (aplica no site). A partir daí, sempre que você fizer um push novo, é só repetir esses dois cliques — ou automatizar isso via GitHub Actions/webhook, caso seu plano tenha suporte a acesso SSH (confirme no painel).
Passo 6 — Confira se os arquivos chegaram certinho
Abra o Gerenciador de Arquivos e entre na pasta do seu site (geralmente public_html) para confirmar que os arquivos mais recentes estão lá.
💡 Dica da Sensei: sempre teste seu processo de deploy primeiro em um subdomínio ou ambiente de testes, antes de aplicar direto no site principal. Assim, se algo sair diferente do esperado, ninguém no ar sente o tranco.
💡 Outra dica: mantenha um backup recente antes de automatizar deploys — você pode gerar um pela tela de Backup do cPanel. É rapidinho e te dá tranquilidade pra testar sem medo.
Ficou com alguma dúvida?
Automatizar deploy é libertador quando está redondo, mas os primeiros ajustes merecem carinho. Se precisar de uma mãozinha para configurar a chave SSH, revisar o .cpanel.yml ou entender o que seu plano contempla, é só chamar o suporte da GeHost ou consultar o painel.gehost.com.br. Estamos aqui pra crescer junto com o seu projeto. 🌱
