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

Como configurar um pipeline de CI/CD simples para deploy automático no VPS (com GeHost)

Olá, querido(a) desenvolvedor(a)!

Se você está aqui, provavelmente já entende que o trabalho de desenvolver um site ou app é só metade da jornada. A outra metade — colocar o código no ar com segurança, rapidez e sem erros — é onde o verdadeiro poder do CI/CD entra em cena.

Hoje, vou te guiar, passo a passo, como montar um pipeline simples de CI/CD para fazer o deploy automático do seu projeto diretamente no seu servidor (VPS) com a GeHost. E não se preocupe: mesmo que você seja novo nisso, com um toque de paciência e um pouquinho de curiosidade, você vai conseguir!

Sensei diz: "O segredo não é saber tudo. É começar onde você está, com o que você tem. O resto vem com o tempo."

Passo 1: Prepare seu código no GitHub (ou outro repositório)

Antes de qualquer coisa, seu código precisa estar em um repositório de código-fonte. O mais comum é usar o GitHub — mas você pode usar GitLab, Bitbucket, etc.

• Crie um repositório com seu projeto (ex: meu-site).
• Adicione todos os arquivos: HTML, CSS, JS, PHP, imagens, etc.
• Comite e faça o push para o repositório remoto.

Seu código está agora em segurança, versionado e pronto para o próximo passo.

Passo 2: Acesse o painel do cPanel (via GeHost)

Para configurar o deploy automático, você vai precisar do acesso ao cPanel do seu plano GeHost.

1. Abra o navegador e vá para painel.gehost.com.br.
2. Insira seu usuário e senha (os mesmos usados na compra).
3. Após logar, clique em cPanel no painel do cliente.

Passo 3: Crie um usuário SSH (com acesso ao servidor)

Para que o GitHub possa enviar o código automaticamente para o seu servidor, precisamos de um usuário com acesso SSH — como se fosse uma porta secreta para o seu VPS.

1. No cPanel, vá até a seção Segurança.
2. Clique em SSH Access.
3. Na parte de Gerenciar SSH, clique em Gerar chave SSH.
4. Salve a chave privada (arquivo id_rsa) em seu computador — não compartilhe com ninguém!
5. Em seguida, clique em Adicionar usuário SSH.
6. Digite um nome de usuário (ex: deploy).
7. Selecione a chave pública gerada anteriormente.
8. Clique em Adicionar.

Pronto! Agora seu servidor sabe que esse usuário pode entrar com segurança.

Passo 4: Configure o deploy no GitHub (usando Actions)

Agora vamos usar o GitHub Actions — uma ferramenta gratuita e poderosa para automatizar tarefas.

1. No seu repositório no GitHub, vá para a aba Actions.
2. Clique em New workflow.
3. Escolha a opção Set up a workflow yourself.
4. Cole o código abaixo (substitua os dados genéricos pelo seu):

name: Deploy to GeHost VPS

on:
  push:
    branches: [ main ]

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

      - name: Deploy via SSH
        uses: appleboy/ssh-action@v0.1.7
        with:
          host: ${{ secrets.HOST }}
          username: ${{ secrets.USERNAME }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            cd /home/SEU_USUARIO/public_html
            git pull origin main
            echo "Deploy realizado com sucesso!"

Importante: Esse código é um exemplo. Você precisará:

• Substituir SEU_USUARIO pelo nome do usuário do cPanel (ex: meucliente).
• Colocar o IP ou domínio do seu servidor no secrets.HOST.
• Adicionar as chaves no GitHub como Secrets (em Settings > Secrets and variables > Actions).

Passo 5: Adicione as chaves secretas no GitHub

Para que o GitHub Actions consiga se conectar ao seu servidor, você precisa salvar as chaves como segredos:

1. No GitHub, vá para Settings > Secrets and variables > Actions.
2. Clique em New repository secret.
3. Crie três segredos:
• HOST: o IP ou domínio do seu servidor (ex: meudominio.com).
• USERNAME: o nome do usuário SSH criado (ex: deploy).
• SSH_KEY: cole aqui a chave privada (o conteúdo do arquivo id_rsa).

Depois de salvar, o GitHub vai usar essas chaves para se conectar ao seu servidor toda vez que você fizer um push no main.

Passo 6: Teste o deploy automático

Pronto! Agora é só fazer um pequeno teste:

1. Edite um arquivo no seu projeto (ex: index.html).
2. Salve e faça um git push no GitHub.
3. Volte para o GitHub e vá até a aba Actions.
4. Veja o workflow rodando — se tudo estiver certo, ele vai mostrar "Deploy realizado com sucesso!".

Depois de alguns segundos, abra seu site no navegador. Seu novo conteúdo já está lá — sem você ter digitado um único comando no terminal!

Passo 7: Mantenha o sistema seguro

Um pipeline automático é poderoso, mas com grande poder vem grande responsabilidade. Siga estas boas práticas:

• Nunca compartilhe a chave privada (SSH_KEY).
• Use um usuário dedicado ao deploy (não use o usuário principal).
• Evite permitir acesso SSH para usuários não confiáveis.
• Revise as ações periodicamente no GitHub.

Sensei diz: "A automação não é para substituir o cuidado. É para liberar seu tempo para o que realmente importa: criar."

Conclusão

Parabéns, você acabou de configurar um pipeline de CI/CD simples, seguro e eficiente para deploy automático no seu servidor com GeHost!

Esse é um passo enorme na jornada de desenvolvedor. Agora você não precisa mais se preocupar com "esqueci de fazer o upload", nem com "deu erro no FTP". Tudo acontece sozinho, com precisão e confiança.

Se tiver dúvidas, não hesite em entrar em contato com o suporte da GeHost — e lembre-se: você tem 30 dias grátis após a entrega para qualquer ajuda.

Até a próxima, com código no coração e paciência no coração.

Com carinho,
Sensei da GeHost