Como configurar um pipeline de CI/CD básico para deploy automático no VPS imprimir

Como configurar um pipeline de CI/CD básico para deploy automático no VPS com a GeHost

Olá, viajante do código! Seja bem-vindo ao seu primeiro passo rumo ao deploy automático — onde cada commit no seu repositório é transformado em uma atualização no seu site, sem precisar clicar em nada. Aqui, você, o dev com coração de artesão, vai aprender a montar um pipeline simples, seguro e eficiente, mesmo sem ser um especialista em DevOps.

Na GeHost, seu VPS (servidor dedicado) é como uma casa particular no mundo digital: você tem controle total, mas também responsabilidade. Vamos usar ferramentas simples e poderosas para automatizar o que antes era trabalho manual.

Sensei diz: "A automação não tira o seu trabalho. Tira o que é repetitivo. Isso te dá tempo para criar, pensar e sonhar."

Passo 1: Prepare seu repositório no GitHub (ou GitLab)

Antes de tudo, você precisa ter seu código em um repositório online. Se ainda não tem, crie um no GitHub ou GitLab.

Seu repositório deve conter:

• Seu código principal (HTML, CSS, JS, PHP, etc.)
• Um arquivo README.md (opcional, mas recomendado)
• Um arquivo .gitignore para não enviar arquivos temporários (como node_modules, env, etc.)

Depois de criar o repositório, faça o primeiro commit com seu código. Pronto! Agora ele está no mundo digital, pronto para ser usado no pipeline.

Passo 2: Acesse o painel do cPanel do seu VPS

Para configurar o deploy automático, você precisa ter acesso ao cPanel do seu servidor. Isso é possível apenas se você tem um plano de VPS com acesso root (não é o caso de planos comuns de hospedagem).

Se você não tem acesso root, o deploy automático ainda pode ser feito com Git + SSH — mas vamos focar no cenário com acesso completo.

Para entrar no cPanel:

1. Abra o navegador e vá para painel.gehost.com.br
2. Insira seu usuário e senha (os mesmos da sua conta GeHost)
3. Na seção de servidores, clique em acessar cPanel do seu VPS

Passo 3: Configure um usuário de deploy com SSH

Vamos criar um usuário especial para o deploy automático. Isso é mais seguro do que usar o usuário principal.

1. No cPanel, vá para Usuários do Sistema (em "Segurança")
2. Clique em Adicionar Usuário
3. Nome: deploy (ou algo semelhante)
4. Senha: escolha uma forte (ex: MinhaSenhaSegura2025!)
5. Home: /home/deploy
6. Clique em Adicionar Usuário

Depois disso, vamos permitir que esse usuário acesse o servidor via SSH.

Passo 4: Configure o SSH com chave pública

Para não precisar digitar senha toda vez, vamos usar chaves SSH.

1. No seu computador (local), gere uma chave SSH com o comando:

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

Salve a chave em ~/.ssh/id_rsa (ou outro local, mas anote).

2. Abra o arquivo id_rsa.pub e copie o conteúdo (começa com ssh-rsa)
3. No cPanel, vá para SSH & Shell Access
4. Na seção "Chaves SSH", clique em Gerar nova chave
5. Coloque o conteúdo da chave pública no campo "Chave Pública"
6. Salve

Pronto! Agora o usuário deploy pode acessar o servidor sem senha.

Passo 5: Crie um script de deploy no servidor

Vamos criar um script simples que atualiza o site sempre que receber um comando via SSH.

1. No cPanel, vá para Gerenciador de Arquivos
2. Abra a pasta /home/deploy (ou a que você escolheu)
3. Crie um novo arquivo chamado deploy.sh
4. Coloque o seguinte conteúdo:

#!/bin/bash
# Script de deploy automático
cd /home/deploy/public_html
git pull origin main
echo "Deploy concluído com sucesso!"

Salve o arquivo.

4. Volte ao cPanel, clique com o botão direito no arquivo deploy.sh e selecione Editar
5. Garanta que o arquivo tenha permissão de execução. Clique em Permissões e marque "Executar" para "Usuário" (ou use 755)

Passo 6: Configure o GitHub para disparar o deploy

Agora vem a magia: o GitHub vai avisar o servidor quando você fizer um commit.

1. No GitHub, vá para o repositório → Settings → Deploy keys (ou Webhooks, se preferir)
2. Clique em Add deploy key
3. Nome: Deploy Automático
4. Coloque o conteúdo da chave pública (a mesma que você usou no cPanel)
5. Marque "Allow write access"
6. Salve

Alternativamente, você pode usar Webhooks:

• No GitHub, vá para Settings → Webhooks → Add webhook
• URL: http://seu-serve.com/webhook (você vai precisar de um serviço como webhook.site para testar)
• Eventos: push
• Salve

Para produção, use um serviço como GitHub Actions ou GitLab CI para disparar o deploy via SSH.

Passo 7: Teste o pipeline

Faça um pequeno ajuste no seu código (ex: altere o título da página), faça o commit e push:

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

Se tudo estiver certo, o script no servidor será executado automaticamente. Você pode verificar isso no terminal do servidor ou pelo log do GitHub Actions.

Dica final do Sensei

Sensei diz: "Um bom pipeline não é o mais complexo. É o que funciona, é claro e é fácil de entender. Comece simples. Depois, melhore. O importante é começar."

Se precisar de ajuda, entre em contato com o suporte da GeHost (30 dias grátis após a entrega). E lembre-se: todos os dados fiscais