Como configurar um ambiente de staging com Docker no seu VPS

Como configurar um ambiente de staging com Docker no seu VPS

Oi! Aqui é a Sensei da GeHost 🥋 Hoje eu vou te ensinar uma prática que todo time de desenvolvimento deveria ter: um ambiente de staging — uma cópia do seu site rodando à parte, onde você testa atualizações, plugins e mudanças antes de colocar tudo no ar de verdade (produção). Assim, se algo quebrar, quebra ali no staging, e ninguém além de você vê.

Vamos usar o Docker pra isso, porque ele deixa o ambiente de testes isolado, leve e fácil de apagar/recriar sempre que quiser — sem bagunçar o resto do servidor.

Antes de começar: este guia é pra quem tem um servidor com acesso via SSH (um VPS ou servidor dedicado). Os planos de hospedagem compartilhada em cPanel da GeHost não expõem terminal/Docker diretamente. Se você não tem certeza de qual é o seu tipo de ambiente, dá uma olhada no painel.gehost.com.br ou chama o suporte pra confirmar — sem pressa, eles te orientam certinho.

1. O que é "staging", afinal?

Pensa assim: seu site de verdade (produção) é o palco, na frente do público. O staging é o ensaio, nos bastidores — uma cópia idêntica onde você testa uma atualização de plugin, uma mudança de layout ou uma nova funcionalidade sem nenhum risco pro que já está funcionando pros seus visitantes.

2. Pré-requisitos

• Acesso SSH ao seu servidor (VPS/dedicado);
• Permissão de administrador (root ou usuário com sudo) nesse servidor;
• Um pouco de paciência — na primeira vez sempre parece mais complicado do que é 😄

3. Instalando o Docker no servidor

Conecte no seu servidor via SSH e rode os comandos de instalação recomendados oficialmente pelo Docker para o seu sistema operacional (por exemplo, Ubuntu/Debian). Depois de instalado, confirme que está tudo certo:

1. Verifique a versão instalada com o comando de versão do Docker (ex.: docker --version);
2. Confira também se o Docker Compose está disponível — ele é quem vai orquestrar os "containers" (as caixinhas isoladas) do seu ambiente de teste;
3. Adicione seu usuário ao grupo do Docker, pra não precisar digitar sudo toda hora.

4. Montando o ambiente de staging

A ideia é criar uma pasta separada só pro staging, com seu próprio arquivo de configuração (o famoso docker-compose.yml), descrevendo os "containers" que seu site precisa — geralmente algo como:

• Um container de aplicação/site (PHP, Node, o que for a sua stack);
• Um container de banco de dados (uma cópia dos dados de produção, nunca o banco real em uso);
• Configurações de rede e portas diferentes das usadas em produção, pra não haver conflito.

Dica da Sensei: nunca aponte o staging pro mesmo banco de dados da produção! Sempre trabalhe com uma cópia — assim um teste que dá errado não mexe em nada real.

5. Subindo o ambiente

Dentro da pasta do staging, use o comando de subir os containers em segundo plano (algo como docker compose up -d). O Docker vai baixar as imagens necessárias e ligar tudo sozinho. Depois, é só acessar pelo endereço/porta configurados pra conferir se o site subiu certinho.

6. Deixando o staging só pra você (segurança)

• Use um subdomínio próprio pro staging (ex.: staging.seudominio.com), separado do site principal;
• Considere proteger o acesso com autenticação (usuário e senha) ou restringir por IP, pra visitantes não caírem ali por engano;
• Evite indexação nos buscadores nesse ambiente de teste.

7. Rotina de uso: teste, valide, depois vá pra produção

1. Faça a mudança (atualização, plugin, novo recurso) primeiro no staging;
2. Teste com calma — navegue, clique, simule o que um cliente faria;
3. Só depois de validado, replique a mudança na produção;
4. Quando terminar os testes, você pode derrubar os containers do staging pra liberar recursos do servidor, e subir de novo quando precisar.

Dica da Sensei: monte um "modelo" (template) do seu docker-compose.yml de staging guardado num repositório próprio. Assim, da próxima vez que precisar testar algo, você sobe o ambiente em minutos — sem começar do zero.

8. Precisou de uma força?

Configuração de servidor às vezes dá um nó na cabeça, e tudo bem! Se você tiver dúvida em algum passo, ou quiser que a gente dê uma olhada junto com você, é só abrir um chamado pelo painel.gehost.com.br — a equipe da GeHost te ajuda a destravar. E lembra: todo serviço entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega, pra te dar aquela segurança nos primeiros passos.

Bora testar sem medo? Com staging, cada atualização vira um ensaio tranquilo antes da estreia. Nos vemos no próximo guia! 🥋