Como automatizar o deploy do seu site via GitHub Actions na hospedagem GeHost

Como automatizar o deploy do seu site via GitHub Actions na hospedagem GeHost

Olá, querido(a) desenvolvedor(a) ou criador(a) de sites! Seja bem-vindo(a) ao seu novo ritual de publicação — sem precisar clicar em "enviar" manualmente. Com o GitHub Actions e a GeHost, você pode automatizar o deploy do seu site com apenas um push no repositório. É como se o seu código soubesse voar direto para o servidor, com precisão de relógio.

Este guia foi feito especialmente para quem quer entender, sem medo, como tornar o processo de publicação mais rápido, seguro e tranquilo. Vamos juntos, passo a passo?

Pré-requisitos: o que você precisa ter

• Um repositório no GitHub com seu site (HTML, CSS, JS, etc.).
• Uma conta ativa na GeHost com acesso ao cPanel.
• Um domínio já apontado para o servidor da GeHost (ou o site será acessado via subdomínio).
• Permissão para criar chaves SSH (não é obrigatório, mas recomendado).

Passo 1: Configure o acesso via SSH no cPanel

Antes de qualquer automação, precisamos permitir que o GitHub Actions "converse" com o seu servidor. Para isso, vamos gerar uma chave SSH e adicioná-la ao cPanel.

1. Entre no seu painel do cliente: painel.gehost.com.br.
2. Na aba de hospedagem, clique em cPanel.
3. Na tela inicial do cPanel, procure por SSH Access (geralmente no grupo "Segurança").

Passo 2: Gere uma chave SSH no GitHub

Agindo do lado do GitHub, vamos criar uma chave que permita o acesso seguro ao servidor.

4. No GitHub, vá em Settings → SSH and GPG keys.
5. Clique em New SSH key.
6. Coloque um título (ex: "GeHost - Deploy Automático").
7. Abra o terminal do seu computador e execute:

ssh-keygen -t ed25519 -C "gehost-deploy@entexp.com.br"

Pressione Enter para aceitar o local padrão. Não coloque senha (opcional, mas pode atrapalhar a automação).

8. Copie o conteúdo da chave pública (arquivo ~/.ssh/id_ed25519.pub) e cole no campo "Key" do GitHub.
9. Salve a chave.

Passo 3: Adicione a chave ao cPanel

Agora, vamos permitir que o GitHub acesse o servidor via SSH.

10. No cPanel, vá em SSH Access → Manage SSH Keys.
11. Clique em Import Key.
12. Na seção "Public Key", cole a chave pública que você gerou no GitHub (a que está no arquivo .pub).
13. Salve.

Passo 4: Crie um script de deploy no seu repositório

É hora de ensinar o GitHub Actions o que fazer quando um novo código for enviado.

14. No seu repositório no GitHub, crie uma pasta chamada .github/workflows.
15. Dentro dela, crie um arquivo chamado deploy.yml.
16. Coloque o seguinte conteúdo (ajuste os valores conforme seu caso):

name: Deploy to GeHost

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 concluído com sucesso!"

Importante: Substitua SEU_USUARIO pelo nome do usuário do cPanel (encontrado no painel do cliente).

Passo 5: Configure as variáveis no GitHub

Para segurança, as credenciais não ficam no código. Vamos armazená-las como segredos.

17. No GitHub, vá em Settings → Secrets and variables → Actions.
18. Clique em New repository secret.
19. Crie três segredos:
• HOST: o endereço do servidor (ex: ssh.gehost.com.br — consulte seu plano no painel).
• USERNAME: o nome do usuário do cPanel (ex: meuusuario).
• SSH_KEY: cole aqui a chave privada (o arquivo id_ed25519, sem o .pub).

Passo 6: Teste o deploy

Pronto! Agora, toda vez que você fizer um git push no branch main, o GitHub Actions vai:

• Buscar o código.
• Conectar ao servidor via SSH.
• Atualizar o site com o novo código.

Para testar, faça uma pequena alteração no site (ex: mude o título da página) e execute:

git add .
git commit -m "Teste deploy automático"
git push origin main

Verifique no painel do GitHub em Actions se o workflow rodou com sucesso. Se sim, seu site já está atualizado!

Dica final do Sensei

Se algo der errado, verifique:

• Se a chave SSH está correta no GitHub e no cPanel.
• Se o caminho do diretório (public_html) está certo.
• Se o usuário do cPanel tem permissão para escrever no diretório.

Com o tempo, você vai sentir o poder da automação. Um dia, talvez nem precise pensar no deploy — o código se publica sozinho. E isso é magia? Não. É tecnologia com coração.

Se precisar de ajuda, o suporte da GeHost está aqui — e está grátis por 30 dias após a entrega. Não hesite em chamar!