Como usar GitHub Actions para CI/CD na GeHost Print

Como usar GitHub Actions para CI/CD na GeHost — Guia para Devs Iniciantes (e Curiosos!)

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

Seja bem-vindo(a) ao nosso Sensei da GeHost — seu companheiro de jornada no mundo da tecnologia, com paciência, calor humano e um toque de magia digital. Hoje vamos aprender algo incrível: como usar GitHub Actions para automatizar o deploy do seu projeto na GeHost, com CI/CD (Integração Contínua e Entrega Contínua).

Não se preocupe se você é novo no assunto. Vamos passo a passo, como se fosse um bate-papo entre amigos. Prometo: sem jargões desnecessários, só clareza e alegria de aprender!

📌 O que é CI/CD? (em linguagem humana)

Imagine que você escreve um código novo, testa, e quer colocar no ar automaticamente — sem precisar fazer tudo manualmente. Isso é o CI/CD:

• CI (Integração Contínua): toda vez que você envia código novo, o sistema testa e verifica se está tudo certo.
• CD (Entrega Contínua): se tudo estiver ok, o código é automaticamente enviado para o servidor — ou seja, o site é atualizado.

Com o GitHub Actions, você pode fazer isso diretamente do seu repositório no GitHub, sem sair do navegador. E a GeHost está pronta para receber esse fluxo! 🎉

🔧 Passo a Passo: Configurando o CI/CD com GitHub Actions na GeHost

Antes de começar, certifique-se de que:

• Você tem um repositório no GitHub com seu projeto (HTML, CSS, JS, PHP, etc.).
• Seu site já está hospedado na GeHost (com domínio e acesso ao cPanel).
• Seu projeto tem um arquivo de configuração chamado .github/workflows/deploy.yml (vamos criar isso agora).

1. Acesse o seu repositório no GitHub

Abra seu repositório no GitHub. Você verá a lista de arquivos e pastas do seu projeto.

Na barra superior, clique em Actions (no menu principal).

2. Crie um novo workflow

Na página de Actions, clique em Set up a workflow yourself.

Isso abrirá um editor de código. Aqui você vai colar o conteúdo do workflow.

3. Cole o código do workflow (exemplo básico)

Copie e cole este código no editor:

name: Deploy to GeHost

on:
  push:
    branches:
      - main

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

      - name: Deploy via SSH
        uses: easingthemes/ssh-deploy@v2.2.0
        with:
          SSH_KEY: ${{ secrets.SSH_KEY }}
          HOST: seu-servidor.gehost.com.br
          USERNAME: seu-usuario
          PORT: 22
          REMOTE_PATH: /public_html/
          LOCAL_PATH: .

⚠️ Importante: Substitua os campos entre chaves:

• seu-servidor.gehost.com.br → o servidor da GeHost (você encontra isso no cPanel).
• seu-usuario → seu usuário do cPanel (não é o e-mail).

Esse código diz: "quando eu enviar um novo código para o main, faça o deploy no servidor da GeHost via SSH".

4. Configure as credenciais no GitHub

Para o SSH funcionar, precisamos salvar as credenciais no GitHub como secrets.

Vá em Settings → Secrets and variables → Actions.

Clique em New repository secret.

Crie dois segredos:

• SSH_KEY: cole aqui sua chave privada SSH (vamos ver como gerar em breve).
• HOST: coloque o endereço do servidor (ex: seu-servidor.gehost.com.br).

⚠️ Nunca coloque sua senha no GitHub! Use apenas chaves SSH.

5. Gerar chave SSH (passo essencial)

Se você ainda não tem uma chave SSH, abra o terminal (ou Git Bash) e digite:

ssh-keygen -t rsa -b 4096 -C "seu-email@exemplo.com"

Pressione Enter três vezes (aceite os padrões).

Depois, veja o conteúdo da chave pública:

cat ~/.ssh/id_rsa.pub

Copie tudo o que aparecer (começa com ssh-rsa).

6. Adicione a chave pública no cPanel da GeHost

Entre no cPanel da sua conta GeHost:

Depois de logar, vá em SSH Access (no grupo "Security").

Clique em Manage SSH Keys.

Clique em Import Key e cole sua chave pública (a que você copiou).

Salve. Pronto! Agora o servidor aceita conexões seguras do GitHub.

7. Ative o workflow

Volte ao seu repositório no GitHub, vá para Actions, e veja se o workflow aparece com status "Success" (ou "Pending").

Se tudo estiver certo, toda vez que você fizer um git push no main, o código será enviado automaticamente para o servidor da GeHost!

🎉 Parabéns! Você acabou de automatizar seu deploy!

Agora, você pode focar no que importa: criar coisas incríveis. O resto é automático!

Dica do Sensei: Teste o workflow com uma pequena alteração no index.html — salve, faça o git push, e veja o site atualizando em segundos! É como mágica… mas com código. 😉

❓ Dúvidas comuns?

• Posso usar isso com sites em PHP? Sim! O workflow funciona com qualquer linguagem hospedada na GeHost.
• Como sei se o deploy deu certo? Verifique o arquivo no public_html do cPanel — ele deve estar atualizado.
• Posso usar SSL com isso? Sim! O certificado SSL é gerenciado pelo cPanel, independentemente do deploy.

💡 Quer ir além?

Depois que dominar isso, você pode:

• Adicionar testes automáticos (ex: verificar se o site abre).
• Enviar notificações por e-mail ou Telegram quando o deploy for feito.
• Usar diferentes branches (ex: staging para testes, main para produção).

Se precisar de ajuda, é só chamar o Sensei da GeHost — estamos aqui para te ajudar, com um sorriso no coração. 💛

Até a próxima, e que seu código sempre compile com sucesso!