Como configurar um pipeline de CI/CD simples para publicar atualizações automaticamente
Oi! Aqui é a Sensei da GeHost 🥋 Hoje vamos falar de um assunto que parece complicado no nome, mas que no fundo é bem simples: CI/CD. Se você já ficou cansado de subir arquivo por FTP toda vez que faz uma alteração no site, esse guia é pra você.
De um jeito bem direto: CI/CD significa "Integração Contínua / Entrega Contínua" — na prática, é um robozinho que fica de olho no seu repositório de código (Git) e, toda vez que você manda uma atualização, ele mesmo publica as mudanças no seu site hospedado na GeHost. Sem você precisar copiar arquivo manualmente.
💡 Dica da Sensei: você não precisa entender tudo de programação pra configurar isso. É só seguir o passo a passo com calma — depois de montado uma vez, ele trabalha sozinho pra sempre.
O que você vai precisar antes de começar
- Um repositório do seu projeto no GitHub (ou GitLab) — é onde o código do seu site fica versionado.
- Os dados de acesso FTP ou SFTP da sua hospedagem GeHost (você encontra/gera esses dados no painel.gehost.com.br).
- Saber em qual pasta o seu site vive no servidor — normalmente é a public_html.
Essa é a pasta public_html que você vê no Gerenciador de Arquivos do cPanel — é justamente ela que o nosso pipeline vai atualizar sozinho a cada publicação.
Passo 1 — Confirme seus dados de acesso FTP/SFTP
- Acesse o painel.gehost.com.br com seu login.
- Localize os dados de conexão FTP/SFTP do seu serviço de hospedagem (host, usuário e senha).
- Guarde essas informações com cuidado — nunca cole senha direto no código. Isso é importante e explico o motivo no próximo passo.
Passo 2 — Guarde suas credenciais como "segredo" no GitHub
No seu repositório do GitHub, vá em Settings → Secrets and variables → Actions e crie os seguintes segredos (o nome pode ser este mesmo, pra facilitar):
- FTP_SERVER — o host do seu FTP/SFTP.
- FTP_USERNAME — seu usuário.
- FTP_PASSWORD — sua senha.
💡 Dica da Sensei: guardar como "segredo" (secret) é o que garante que ninguém consiga ver sua senha, nem mesmo olhando o histórico do código. É a forma segura de fazer isso.
Passo 3 — Crie o arquivo do pipeline (a "receita" da automação)
Dentro do seu repositório, crie o caminho .github/workflows/deploy.yml com um conteúdo parecido com este:
- Toda vez que você enviar uma atualização (um "push") pra branch principal do seu projeto, o robô é acionado.
- Ele pega os arquivos mais recentes do seu repositório.
- Ele envia esses arquivos direto pra pasta public_html da sua hospedagem via FTP/SFTP, usando os segredos que você cadastrou no Passo 2.
Um exemplo simples de workflow (usando uma ação pronta de deploy por FTP, bem comum e gratuita):
name: Deploy site
on:
push:
branches: [ main ]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Enviar arquivos via FTP
uses: SamKirkland/FTP-Deploy-Action@v4.3.5
with:
server: ${{ secrets.FTP_SERVER }}
username: ${{ secrets.FTP_USERNAME }}
password: ${{ secrets.FTP_PASSWORD }}
local-dir: ./
server-dir: /public_html/
Salve esse arquivo e envie (push) pro GitHub. Pronto — a partir daí, toda atualização que você mandar na branch principal já sobe sozinha pro seu site!
Passo 4 — Teste com calma antes de confiar 100%
- Faça uma alteração pequena e simples no código (tipo mudar um texto).
- Envie (push) essa alteração e acompanhe a aba Actions do GitHub — ela mostra se o processo rodou com sucesso ou deu erro.
- Confira o site pra ver se a alteração realmente apareceu.
Cuidados importantes antes de automatizar
- Faça um backup manual pela tela de Backup do cPanel antes de ativar a automação pela primeira vez — assim, se algo sair diferente do esperado, dá pra restaurar rapidinho.
- Use um arquivo .gitignore no seu projeto pra nunca subir senhas, arquivos de configuração sensíveis ou pastas pesadas sem necessidade (como "node_modules").
- Se seu projeto for mais robusto (com etapas de build, testes, etc.), o pipeline pode crescer com o tempo — comece simples e vá evoluindo.
- Recursos como acesso SSH variam de plano pra plano — se quiser usar Git direto no servidor, confira no painel se seu plano contempla esse recurso, ou fale com nosso suporte.
💡 Dica da Sensei: se seu site for feito em WordPress ou outro CMS, tome cuidado extra: o pipeline deve enviar só o tema/plugins que você desenvolve, não o sistema inteiro — evite sobrescrever configurações importantes do CMS sem querer.
Se algo não funcionar
Deu erro na etapa de deploy? Verifique primeiro se os dados de FTP/SFTP nos segredos do GitHub estão certinhos e se o caminho da pasta de destino (public_html ou uma subpasta) está correto. Se mesmo assim não resolver, é só chamar a gente — lembrando que todo serviço entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega, e você também pode contar com nossa equipe pelo painel.gehost.com.br depois disso.
Viu só? Nada de bicho de sete cabeças — é só configurar uma vez com carinho e deixar o robozinho trabalhar por você. 🚀