Como configurar um ambiente Docker básico para testar uma aplicação antes de subir ao VPS

Como configurar um ambiente Docker básico para testar uma aplicação antes de subir ao VPS

Olá, viajante da tecnologia! 🌟 Seja bem-vindo ao seu primeiro passo seguro rumo ao desenvolvimento com confiança. Aqui, na GeHost, acreditamos que todo grande sistema começa com um pequeno experimento. Hoje, vamos te ensinar, com carinho e clareza, como montar um ambiente Docker básico para testar sua aplicação antes de colocá-la no ar — como se fosse um ensaio geral no palco antes da estreia!

Este guia é feito especialmente para você que está começando, que quer entender o que está acontecendo sem se perder em jargões complexos. Vamos juntos, passo a passo, como um verdadeiro sensei e seu aluno favorito.

Por que usar Docker para testes?

Docker é como um "mini-servidor" dentro do seu computador. Ele permite que você rode sua aplicação em um ambiente isolado e controlado — como se fosse uma caixa de areia segura. Assim, você pode testar, mudar, quebrar e recomeçar sem riscos para o sistema real.

Dica do Sensei: Antes de subir sua aplicação ao VPS (ou ao servidor real), sempre teste em um ambiente que simule o ambiente de produção. Docker é o melhor amigo desse processo.

Pré-requisitos: O que você precisa

• Um computador com sistema operacional Windows, macOS ou Linux.
• Internet estável.
• Conhecimento básico de terminal (ou linha de comando).
• Instalação do Docker Desktop (gratuito e oficial).

Se você ainda não instalou o Docker, vá em docker.com e baixe a versão para seu sistema. É rápido, seguro e feito para iniciantes.

Passo a passo: montando seu ambiente Docker

1. Abra o Docker Desktop

Após instalar, abra o aplicativo. Ele vai iniciar automaticamente. Você verá uma pequena caixa de diálogo com um ícone de contêiner (como um navio) — isso significa que o Docker está pronto para funcionar.

2. Crie uma pasta para sua aplicação

Escolha uma localização no seu computador (ex: Documentos/meu-projeto) e crie uma pasta com o nome da sua aplicação. Dentro dessa pasta, vamos colocar o código e o arquivo de configuração do Docker.

3. Crie um arquivo chamado Dockerfile

Abra um editor de texto (como o Bloco de Notas, VS Code ou Sublime) e crie um novo arquivo. Salve-o na pasta da sua aplicação com o nome exato: Dockerfile (sem extensão, e com letra maiúscula).

Escreva dentro dele o seguinte conteúdo, adaptando conforme sua aplicação:

FROM node:18-alpine

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

EXPOSE 3000

CMD ["npm", "start"]

Explicando: Este comando diz ao Docker: “Use uma imagem pronta com Node.js 18 (leve e rápida), vá para a pasta /app, instale as dependências, copie seu código e execute o comando de start na porta 3000.”

4. Crie um arquivo docker-compose.yml

Novamente, no mesmo diretório da sua aplicação, crie um novo arquivo chamado docker-compose.yml.

Coloque este conteúdo nele:

version: '3.8'

services:
  app:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/app
    restart: unless-stopped

O que isso faz? Define que o serviço chamado app será construído a partir do Dockerfile na pasta atual, mapeia a porta 3000 do seu computador para a porta 3000 dentro do contêiner, e permite que você veja as alterações em tempo real enquanto edita o código.

5. Abra o terminal na pasta da aplicação

Abra o terminal (ou prompt de comando) e navegue até a pasta onde você criou o Dockerfile e o docker-compose.yml. Por exemplo:

cd Documentos/meu-projeto

6. Execute o comando para subir o contêiner

Execute este comando no terminal:

docker-compose up

Se tudo estiver certo, o Docker vai começar a baixar a imagem, instalar as dependências e rodar sua aplicação. Você verá uma saída no terminal com mensagens como “Starting app ...” e “Listening on port 3000”.

7. Teste sua aplicação

Agora, abra seu navegador e vá para http://localhost:3000. Se tudo funcionou, você verá sua aplicação rodando — exatamente como se estivesse no servidor real!

Se precisar parar, pressione Ctrl + C no terminal.

8. Pronto! Você está testando com segurança

Qualquer alteração no código (como mudar um texto ou corrigir um erro) será refletida imediatamente no navegador, pois o volume está mapeado. Isso é o poder do Docker: testar rápido, sem riscos.

Como usar isso com a GeHost?

Quando você estiver satisfeito com o funcionamento do seu projeto no Docker, pode então subir sua aplicação ao seu VPS ou hospedagem na GeHost. Como o ambiente de testes simula o ambiente real, você terá muito mais confiança no que está sendo publicado.

Se precisar de ajuda para migrar seu projeto para o servidor real, entre em contato com nosso suporte — estamos aqui para ajudar, sempre.

Dica extra do Sensei

Use o Docker como seu laboratório pessoal. Teste novas versões, novas funcionalidades, novos frameworks — tudo em um ambiente seguro, sem afetar o que está no ar. Assim, você cresce com segurança.

Se você gostou deste guia, compartilhe com um colega que também está aprendendo. Na GeHost, acreditamos que o conhecimento é mais forte quando é compartilhado com carinho.

Até o próximo passo, com todo meu apoio,
— Sensei da GeHost