Como configurar um ambiente de staging isolado com containers no VPS

Como configurar um ambiente de staging isolado com containers no VPS

Olá, querido(a) cliente da GeHost! 👋

Se você está aqui, provavelmente quer testar novas funcionalidades do seu site sem arriscar o ambiente principal — e isso é muito inteligente. No mundo do desenvolvimento, um staging isolado é como um laboratório seguro: você pode experimentar, testar e corrigir tudo sem afetar o site que seu público está vendo agora.

Aqui, vou te guiar com carinho, passo a passo, para montar um ambiente de staging usando containers — uma tecnologia moderna e poderosa que permite isolar aplicações como se fossem pequenos "veículos" independentes, com suas próprias configurações e dependências.

>

💡 Dica do Sensei: Containers são como apartamentos em um prédio: cada um tem sua própria estrutura, mas compartilha o mesmo edifício (o servidor). Isso torna tudo mais organizado, seguro e fácil de gerenciar.

---

Pré-requisitos (o que você precisa ter)

Antes de começar, confirme que seu plano no GeHost inclui acesso ao VPS (servidor dedicado virtual). Se você não tem certeza, entre no painel do cliente em painel.gehost.com.br e verifique se há opções relacionadas a "VPS" ou "servidor dedicado" no seu plano.

Se sim, ótimo! Você está pronto para avançar. Se não, saiba que o staging com containers exige um nível de controle mais avançado do que a hospedagem tradicional (como cPanel). Nesse caso, recomendo conversar com nosso suporte para verificar se há opções adequadas.

---

Passo a passo: montando seu ambiente de staging com containers

Vamos lá! Siga cada etapa com calma — cada passo é um degrau seguro rumo ao seu laboratório digital.

1. Acesse seu servidor via SSH
   Use um cliente SSH como Putty (Windows) ou o terminal do Linux/macOS. Conecte-se ao seu VPS com o IP fornecido pelo painel da GeHost (não compartilhamos IPs públicos aqui por segurança, mas você os encontra no painel). Use o usuário e senha que foram gerados na criação do VPS.
2. Atualize o sistema
   Uma vez conectado, execute este comando para garantir que seu sistema esteja atualizado:

   sudo apt update && sudo apt upgrade -y

   Isso garante que você tenha as últimas versões de segurança e ferramentas.
3. Instale o Docker
   O Docker é a ferramenta principal para criar e gerenciar containers. Instale-o com os comandos abaixo:

   sudo apt install -y docker.io docker-compose

   Após a instalação, verifique se está funcionando:

   sudo docker --version

   Você deverá ver algo como Docker version 24.0.5 (versão pode variar).
4. Crie uma pasta para o staging
   Vamos organizar tudo em um lugar específico. Crie uma pasta chamada staging no diretório raiz:

   mkdir ~/staging && cd ~/staging

   Aqui, você vai colocar todos os arquivos do seu ambiente de teste.
5. Crie um arquivo docker-compose.yml
   Esse arquivo é o "plano de construção" do seu ambiente. Ele define quais serviços (como servidor web, banco de dados, etc.) serão rodados dentro dos containers. Abra um editor de texto (como nano) e crie o arquivo:

   nano docker-compose.yml

   Cole o conteúdo abaixo (exemplo básico para um site PHP com MySQL):

   version: '3.8'
   
   services:
     web:
       image: nginx:alpine
       ports:
         - "8080:80"
       volumes:
         - ./html:/usr/share/nginx/html
       restart: unless-stopped
   
     db:
       image: mysql:8.0
       environment:
         MYSQL_ROOT_PASSWORD: rootpass
         MYSQL_DATABASE: staging_db
       volumes:
         - db_data:/var/lib/mysql
       restart: unless-stopped
   
   volumes:
     db_data:

   Salve o arquivo com Ctrl + O, confirme com Enter, e saia com Ctrl + X.

6. Suba o ambiente com Docker Compose
   Agora, basta rodar o comando que vai criar e iniciar todos os containers definidos no arquivo:

   sudo docker-compose up -d

   O parâmetro -d significa "em segundo plano" — o terminal volta a funcionar enquanto os containers rodam.
7. Verifique se tudo está funcionando
   Execute este comando para ver os containers ativos:

   sudo docker-compose ps

   Você deverá ver os serviços web e db com status Up. Parabéns! Seu ambiente de staging está no ar!
8. Teste o acesso
   Abra seu navegador e acesse: http://seu-ip-do-vps:8080 Substitua seu-ip-do-vps pelo IP do seu servidor (encontrado no painel da GeHost). Se tudo estiver certo, você verá a página padrão do Nginx — ou o conteúdo que você colocar na pasta html (criada na etapa anterior).

---

Como usar seu ambiente de staging

Com o staging rodando, você pode:

• Testar novas versões do seu site sem afetar o público;
• Instalar atualizações de plugins ou frameworks;
• Simular erros de configuração sem risco;
• Compartilhar o ambiente com sua equipe (com acesso controlado).

Quando estiver pronto para migrar as alterações para o ambiente principal, basta fazer um backup da versão de staging e aplicar no site de produção — com cuidado, claro!

---

Dicas do Sensei

• Use nomes claros: Chame sua pasta de staging de algo como meusite-staging para não se confundir.
• Proteja o acesso: Evite deixar o porto 8080 aberto para o mundo. Use um firewall (como ufw) para restringir acesso apenas a IPs autorizados.
• Faça backup periodicamente: Mesmo que seja um ambiente de teste, salve os dados importantes. Use o comando docker-compose down para parar os containers e docker-compose up -d para levantar de novo.
• Atualize com cuidado: Ao atualizar o Docker ou o sistema, verifique se o docker-compose.yml ainda é compatível com as versões novas.

---

Quer ajuda?

Se algo não funcionar, ou se quiser uma configuração mais complexa (como WordPress, Laravel, Node.js, etc.), entre em contato com nosso suporte. Estamos aqui para te ajudar — com paciência, respeito e um bom café (virtual, claro!).

Seu sucesso é nosso propósito. 💚

GeHost — onde seu site cresce com segurança.
Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)