Como configurar um pipeline de CI/CD simples para deploy no VPS imprimir

Como configurar um pipeline de CI/CD simples para deploy no VPS com a GeHost

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

Seja bem-vindo(a) ao nosso Sensei da GeHost — aqui, você aprende com carinho, passo a passo, como trazer seus projetos do código à vida, de forma segura, rápida e com muito orgulho no coração. 🌟

No mundo de hoje, não adianta só escrever código. O que importa é entregar com qualidade, com frequência e sem dor de cabeça. E isso é possível com um pipeline de CI/CD simples — mesmo que você seja novo nisso.

Este guia foi feito especialmente para você, cliente leigo da GeHost, que quer automatizar o deploy do seu site ou aplicativo no seu servidor (VPS), sem precisar subir arquivos manualmente toda hora.

💡 Dica do Sensei: Você não precisa de um VPS "poderoso" ou de um servidor complexo. Com a GeHost, você já tem tudo que precisa para começar — inclusive o ambiente de desenvolvimento completo, com acesso ao cPanel, arquivos, banco de dados e mais.

Antes de começar: o que é CI/CD?

Imagine que você está cozinhando um prato especial. Cada vez que muda um ingrediente (ou código), precisa testar, ajustar e servir. CI/CD é como ter uma cozinha inteligente:

• CI (Integração Contínua): sempre que você envia código, o sistema testa automaticamente.
• CD (Entrega Contínua): quando tudo está certo, o sistema deploya o código no servidor — sem você precisar fazer nada.

É como se seu site se atualizasse sozinho, com segurança e precisão. 🚀

Passo a passo: montando seu pipeline simples

Vamos usar ferramentas populares e fáceis: GitHub (para armazenar código), GitHub Actions (para automatizar o CI/CD) e seu servidor da GeHost (o VPS onde seu site roda).

1. Prepare seu código no GitHub

Se você ainda não tem um repositório no GitHub:

1. Crie um repositório público ou privado em github.com.
2. Adicione seu código (HTML, CSS, JS, PHP, etc.) dentro da pasta raiz.
3. Salve com um arquivo chamado index.html ou index.php — o arquivo principal do seu site.

✅ Dica: Use um nome claro para o repositório, como meu-site-gehost.

2. Configure o acesso ao seu servidor via SSH

Para o GitHub Actions atualizar seu servidor, ele precisa se conectar por SSH. Siga os passos:

1. Entre no painel da GeHost.
2. Na seção Segurança, vá até SSH Access (ou similar — o nome pode variar levemente).
3. Ative o acesso SSH (se ainda não estiver ativo).
4. Verifique o usuário SSH e o endereço do servidor — você vai precisar disso depois.

⚠️ Importante: Não compartilhe suas credenciais com ninguém. Use chaves SSH em vez de senhas.

3. Crie uma chave SSH e adicione ao GitHub

Esta é a parte mais técnica, mas tranquila!

1. Abra o terminal (ou Git Bash no Windows).
2. Execute: ssh-keygen -t ed25519 -C "gehost-ci@meu-site.com"
3. Salve a chave em ~/.ssh/id_ed25519 (ou aceite o padrão).
4. Copie a chave pública: cat ~/.ssh/id_ed25519.pub
5. Entre no GitHub → Settings → SSH and GPG keys → New SSH key.
6. Cole a chave pública e salve.

✅ Agora o GitHub pode se conectar ao seu servidor com segurança.

4. Configure o GitHub Actions

Volte ao seu repositório no GitHub. Clique em Actions no topo da tela.

Escolha Set up a workflow yourself (ou "Criar um workflow").

Substitua o conteúdo do arquivo .github/workflows/deploy.yml por este:

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.6
        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!"

💡 Atenção: Substitua SEU_USUARIO pelo nome do seu usuário no cPanel (ex: meucliente).

5. Adicione as credenciais como segredos

Você precisa proteger suas credenciais no GitHub:

1. No GitHub, vá para Settings → Secrets and variables → Actions.
2. Clique em New repository secret.
3. Crie três segredos:

• HOST → o endereço do seu servidor (ex: seu-servidor.gehost.com.br).
• USERNAME → o nome do usuário do cPanel (ex: meucliente).
• SSH_KEY → cole a chave privada (o conteúdo de id_ed25519, sem aspas).

⚠️ Atenção: Nunca coloque a chave privada em código aberto. Use apenas segredos do GitHub.

6. Faça o primeiro deploy

Volte ao repositório, faça um commit e envie o código:

1. Abra o terminal.
2. Execute: git add .
git commit -m "Primeiro deploy via CI/CD"
git push origin main

Pronto! O GitHub Actions vai rodar, conectar ao seu servidor via SSH e atualizar o site automaticamente.

🔍 Verifique: Acesse seu site no navegador. Se o conteúdo estiver atualizado, parabéns! 🎉 Você acaba de criar um pipeline de CI/CD simples e poderoso.

Como monitorar o pipeline

Volte ao GitHub → Actions. Lá você verá todos os deploys, com logs detalhados. Se algo der errado, o sistema mostra exatamente onde.

Se precisar, você pode ajustar o script a qualquer momento — basta editar o arquivo .github/workflows/deploy.yml.

Pronto para mais?

Com este pipeline básico, você já pode:

• Atualizar seu site com um único comando.
• Testar mudanças em ambiente de desenvolvimento antes de publicar.
• Evitar erros humanos (como esquecer de atualizar um arquivo).

Quer ir além? Pode adicionar testes automáticos, backups, notificações por e-mail ou até usar o GitLab CI ou CircleCI — mas isso é para o próximo nível. 😎

Quer ajuda?

Se ficar com dúvidas, não se