Como configurar um CI/CD simples para deploy automático com a GeHost
Olá, querido(a) desenvolvedor(a)!
Seja bem-vindo(a) ao nosso guia prático, escrito com carinho para quem quer automatizar o processo de publicação do seu site ou aplicação — sem precisar fazer upload manual de arquivos toda vez que atualiza algo. Aqui, você vai aprender a montar um pipeline de CI/CD simples direto do seu cPanel, com passos claros, fáceis e totalmente acessíveis, mesmo que você seja novo nisso.
Imagine: você faz uma alteração no código, commita no GitHub, e pronto — o seu site já está atualizado no ar. Sem ficar enchendo o dia de cliques. Isso é o poder da automação. E com a GeHost, isso é possível!
O que é CI/CD?
CI/CD é uma prática de desenvolvimento que significa:
- CI (Integração Contínua): testar e integrar mudanças no código frequentemente.
- CD (Entrega Contínua): publicar automaticamente essas mudanças no ambiente de produção.
Neste guia, vamos focar no CD — a parte que faz o seu site subir automaticamente após um commit no GitHub.
Passo a passo: Configurando seu pipeline simples
1. Prepare seu repositório no GitHub
Antes de tudo, tenha seu projeto no GitHub. Certifique-se de que:
- O repositório está público ou privado (não importa).
- Seu código principal está na branch
main(oumaster). - Existe um arquivo
index.htmlouapp.phpna raiz (para testar).
✅ Dica: Use um nome simples para o repositório, como meu-site — facilita a identificação.
2. Acesse o cPanel da sua conta GeHost
Entre no seu painel de controle com as credenciais da GeHost.
3. Acesse o Gerenciador de Arquivos
No cPanel, vá até a seção Arquivos e clique em Gerenciador de Arquivos.
4. Acesse a pasta pública do seu site
No Gerenciador de Arquivos, clique em public_html (ou o nome da sua pasta principal).
É aqui que seu site será publicado. Certifique-se de que ele está vazio ou com um arquivo de teste, como index.html.
5. Crie um arquivo de configuração para o deploy automático
Na pasta public_html, crie um novo arquivo chamado .gehost-deploy (sem extensão).
Esse arquivo é o "contrato" entre o GitHub e o servidor. Ele ativa o deploy automático.
Seu conteúdo deve ser:
github: https://github.com/seu-usuario/meu-site.git
branch: main
path: public_html
Substitua seu-usuario pelo seu nome no GitHub e meu-site pelo nome do seu repositório.
✅ Dica: Use o editor do cPanel para criar esse arquivo. Clique em Novo Arquivo e digite o nome exato.
6. Conecte seu GitHub ao servidor (via webhook)
Para que o servidor saiba quando algo muda no GitHub, você precisa configurar um webhook.
Abra o seu repositório no GitHub, vá em Settings → Webhooks → Add webhook.
Preencha assim:
- Payload URL:
https://seu-dominio.com/.gehost-deploy(substitua pelo seu domínio real) - Content type:
application/json - Events: Selecione
Push - Clique em Add webhook
✅ Dica: O webhook só funciona se o arquivo .gehost-deploy estiver no servidor e o domínio for válido.
7. Teste o pipeline
Volte ao GitHub, faça uma pequena alteração no index.html (por exemplo, troque o título da página).
Salve e faça um commit.
Volte ao cPanel e verifique se o arquivo foi atualizado automaticamente em public_html.
Se sim, parabéns! Seu CI/CD está funcionando!
Pronto! Você está no futuro do desenvolvimento.
“A automação não é um luxo. É a diferença entre perder tempo e criar valor.”
— Sensei da GeHost
Se precisar de ajuda, basta entrar em contato com nosso suporte. Estamos aqui para te ajudar a crescer — com tecnologia, simplicidade e um toque de humanidade.
Seu site está mais rápido, mais seguro, e mais atual do que nunca. E tudo isso com um clique (ou um commit).
Até a próxima, e que seu código sempre faça sentido!