Como configurar CI/CD simples para publicar atualizações de um site automaticamente

Olá, querido(a) desenvolvedor(a) ou criador(a) de sites! 🌟 Seja bem-vindo(a) ao seu primeiro passo rumo à automação — e sim, você não precisa ser um especialista em DevOps para fazer isso. Aqui, na GeHost, acreditamos que tecnologia deve ser acessível, prática e, acima de tudo, tranquila. Vamos juntos montar um sistema simples de CI/CD (Integração Contínua / Entrega Contínua) para que toda vez que você atualizar seu site no GitHub, a nova versão seja publicada automaticamente no seu domínio. Fácil, rápido e sem estresse.

Este guia é pensado para quem está começando — não precisa saber nada de servidores ou scripts complexos. Apenas siga os passos com calma, como se fosse um ritual de criação: cada ação é um passo no caminho da sua liberdade digital.

Passo 1: Prepare seu site no GitHub

Antes de tudo, seu site precisa estar no GitHub. Se ainda não está, crie um repositório com o código do seu site (HTML, CSS, JS, PHP, etc.).

Use um nome claro, como meu-site-empresa.
Garanta que o repositório seja público ou privado, mas que você tenha acesso completo.
Adicione um arquivo index.html ou index.php como página inicial.

Dica do Sensei: Mantenha seu código organizado. Use pastas como css/, js/, img/. Isso facilita tudo depois.

Passo 2: Acesse o painel do cliente da GeHost

Entre no painel do cliente da GeHost pelo link: painel.gehost.com.br.

Use seu login e senha (os mesmos que você usou para contratar o plano). Se não tem acesso, entre em contato com o suporte — estamos aqui para ajudar.

Tela de login do cPanel com campos de usuário e senha

Passo 3: Acesse o cPanel

Depois de logado no painel, clique em cPanel (geralmente no topo da página). Você será redirecionado para o painel de controle do servidor.

Painel inicial do cPanel com grupos de ferramentas como E-mail, Arquivos, Banco de Dados, etc.

Passo 4: Configure um usuário SSH (opcional, mas recomendado)

Para automatizar a publicação, precisamos de acesso seguro ao servidor. O cPanel permite criar um usuário SSH com acesso limitado.

Na seção Segurança, clique em Gerenciador de Usuários SSH (ou procure por "SSH" no menu).

Se ainda não tiver um usuário SSH, crie um com um nome simples, como deploy. Não use seu nome de usuário principal.

Depois de criado, anote o nome do usuário e a senha (ou use uma chave SSH, se preferir).

Dica do Sensei: Não use a senha do cPanel principal. Isso é como dar a chave da casa para um empregado. Use um usuário dedicado para automação.

Passo 5: Configure o GitHub Actions (automatização)

Agora, vamos voltar ao GitHub. Abra o repositório do seu site e vá em Actions no menu superior.

Clique em Set up a workflow yourself (ou procure por "workflow" no menu).

Substitua o conteúdo do arquivo por este exemplo simples (mantenha o nome .github/workflows/deploy.yml):

name: Deploy to GeHost

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Deploy via SSH
        uses: appleboy/ssh-action@v0.1.6
        with:
          host: ${{ secrets.HOST }}
          username: ${{ secrets.USERNAME }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            cd /home/usuario/public_html
            git pull origin main
            echo "Deploy concluído!"

⚠️ Importante: Substitua usuario pelo nome do seu usuário cPanel (não o nome do domínio).

Passo 6: Configure as chaves no GitHub

No GitHub, vá em Settings → Secrets and variables → Actions.

Crie três variáveis:

HOST: o endereço do seu servidor (ex: seu-dominio.com ou 147.93.141.142 — consulte seu contrato ou painel).
USERNAME: o nome do usuário SSH criado (ex: deploy).
SSH_KEY: a chave privada SSH gerada. Para gerar, use o terminal:

ssh-keygen -t rsa -b 4096 -C "deploy@gehost.com"

Copie o conteúdo da chave privada (arquivo id_rsa) e cole como valor da variável SSH_KEY.

Dica do Sensei: Nunca compartilhe sua chave privada com ninguém. O GitHub criptografa esses segredos — mas cuidado mesmo assim.

Passo 7: Teste o deploy

Volte ao repositório no GitHub e faça um pequeno ajuste no index.html (ex: mude uma frase).

Salve e envie (push) as alterações.

Volte para Actions e veja o workflow rodando. Se tudo estiver certo, você verá uma mensagem de "Deploy concluído!".

Abra seu site no navegador. A nova versão já está lá — sem precisar fazer upload manual!

Passo 8: Mantenha tudo seguro e organizado

Revise suas chaves SSH periodicamente.
Evite deixar o repositório público se o site for privado.
Use branches como develop e main para testar antes de publicar.
Se precisar de ajuda, entre em contato com o suporte da GeHost — estamos aqui para você.

Palavras do Sensei: Automatizar não é fugir do trabalho — é liberar seu tempo para criar, sonhar e inovar. Você está no caminho certo. Parabéns por estar aqui, com a coragem de começar.

Quer saber mais?

Se quiser ir além — como usar bancos de dados, e-mails automáticos ou testes de qualidade — o suporte da GeHost está pronto para te guiar. Lembre-se: você não está sozinho.

Seu site, sua história. Nossa tecnologia, seu apoio. 🌱

Com carinho,
Sensei da GeHost
*Grupo G e Soluções e Eventos LTDA – CNPJ: 46.647.904/0001-04*

Como configurar CI/CD simples para publicar atualizações de um site automaticamente