Como configurar um pipeline simples de CI/CD para deploy automático imprimir

Como configurar um pipeline simples de CI/CD para deploy automático

Olá! Aqui é a Sensei da GeHost 🌱 Se você já se cansou de fazer upload de arquivo por arquivo toda vez que atualiza o site, este guia é para você. Vamos montar, passo a passo, um jeitinho de fazer o seu código ir do computador direto para o servidor sozinho, sempre que você enviar uma atualização.

"CI/CD" parece um nome complicado, mas a ideia é simples: CI (Integração Contínua) é testar/checar o código automaticamente, e CD (Entrega/Deploy Contínuo) é publicar essa atualização automaticamente. Para a maioria dos nossos clientes, o que importa mesmo é a parte do deploy automático — e é nisso que vamos focar.

💡 Este guia é para quem já tem (ou vai criar) um projeto versionado no GitHub, GitLab ou Bitbucket. Se seu site ainda não usa Git, primeiro é preciso criar o repositório do projeto — aí sim configuramos o deploy automático.

Passo 1 — Descubra as credenciais de acesso do seu plano

Antes de tudo, entre no painel.gehost.com.br e verifique quais formas de acesso o seu plano disponibiliza (FTP/SFTP e, dependendo do plano, acesso via Git ou SSH). Cada plano da GeHost tem recursos diferentes, então o caminho ideal pode variar — se tiver dúvida sobre o que está incluso no seu plano, é só chamar o suporte.

De um modo geral, existem dois caminhos bem tranquilos para montar seu pipeline:

• Caminho A — GitHub/GitLab Actions + envio automático por FTP/SFTP (funciona em praticamente qualquer plano de hospedagem com FTP).
• Caminho B — Git Version Control do cPanel (se o seu plano oferecer essa ferramenta no painel).

Caminho A — Deploy automático via GitHub Actions + FTP

1. No painel do cliente, gere ou confira o usuário e a senha de FTP/SFTP da sua hospedagem.
2. No seu repositório (GitHub, por exemplo), vá em Settings → Secrets and variables → Actions e cadastre suas credenciais como "segredos" (nunca deixe usuário/senha escritos direto no código): algo como FTP_SERVER, FTP_USERNAME e FTP_PASSWORD.
3. Crie o arquivo .github/workflows/deploy.yml no seu projeto com um passo que, a cada push na branch principal, envia os arquivos atualizados via FTP/SFTP para a pasta public_html (ou a pasta do seu domínio).
4. Faça um commit de teste e envie (git push). Acompanhe a aba "Actions" do repositório: se ficar verde, o deploy funcionou!
5. Confira no Gerenciador de Arquivos do cPanel se os arquivos realmente chegaram atualizados na pasta do site.

🌟 Dica da Sensei: use sempre SFTP em vez de FTP puro quando o seu plano oferecer essa opção — os dados trafegam de forma criptografada, o que é bem mais seguro.

Caminho B — Git Version Control (dentro do cPanel)

1. Faça login no cPanel e procure pela ferramenta "Git™ Version Control" (ela aparece no painel se o seu plano disponibiliza esse recurso).
2. Clique em "Criar" e informe a URL do seu repositório remoto (GitHub/GitLab/Bitbucket) e a pasta de destino (por exemplo, public_html).
3. Depois de criado, cada vez que quiser publicar uma nova versão, use a opção "Pull or Deploy" dentro dessa mesma tela para trazer as últimas alterações do repositório.
4. Para automatizar de verdade (sem precisar clicar em "Pull" manualmente), você pode configurar um webhook no seu repositório que, a cada push, dispara essa atualização — se precisar de ajuda para deixar isso 100% automático, nosso suporte pode te orientar sobre a melhor forma dentro do seu plano.

Boas práticas antes de automatizar

• Teste primeiro em um subdomínio (tipo teste.seudominio.com.br) antes de apontar o pipeline direto para o site principal.
• Faça um backup manual antes da primeira automação, só por precaução — é rapidinho pelo cPanel.
• Nunca coloque senhas ou chaves de acesso direto no código — use sempre os "segredos"/variáveis de ambiente da sua ferramenta de CI/CD.
• Revise sempre qual pasta está recebendo os arquivos, para não sobrescrever algo por engano.

Ficou com alguma dúvida?

Sem problemas! Automatizar o deploy dá um trabalhinho na primeira vez, mas depois vira rotina tranquila. Se travar em algum passo, ou quiser confirmar quais recursos (FTP, SSH ou Git) estão disponíveis no seu plano específico, é só falar com o nosso suporte pelo painel.gehost.com.br. Estamos aqui para ajudar! 🌱