Como configurar um ambiente de containers com Docker Compose para múltiplos serviços

Como configurar um ambiente de containers com Docker Compose para múltiplos serviços

Olá, querido(a) cliente da GeHost! Seja bem-vindo(a) ao seu novo passo rumo ao mundo da desenvolvimento moderno e organizado. Aqui, você vai aprender, de forma simples e prática, como usar Docker Compose para rodar múltiplos serviços — como um site, um banco de dados e um painel administrativo — todos juntos, como se fossem um só sistema. E o melhor: tudo isso pode ser feito diretamente no seu servidor de hospedagem, com segurança e controle.

Antes de começar: não se preocupe se isso parece complexo. A GeHost acredita que tecnologia deve ser acessível. Vamos juntos, passo a passo, como um verdadeiro Sensei guiando seu aprendizado.

Pré-requisitos: o que você precisa ter

Para seguir este guia, você precisa de:

• Um plano de hospedagem GeHost com acesso ao cPanel (todos os planos incluem isso).
• Conhecimento básico de terminal (ou acesso ao Terminal no cPanel).
• Permissão para instalar ferramentas no servidor (isso está disponível em todos os planos GeHost).

Dica do Sensei: Se você ainda não tem acesso ao painel, acesse painel.gehost.com.br com seus dados de login. Se precisar de ajuda, o suporte está disponível por 30 dias após a entrega — não hesite em pedir!

Passo 1: Acesse o Terminal no cPanel

Primeiro, entre no seu painel de controle:

1. Abra o painel.gehost.com.br.
2. Localize e clique em Terminal na seção "Outros" do cPanel.
3. Selecione o terminal e clique em Conectar.

Passo 2: Instale o Docker (se ainda não estiver instalado)

Na GeHost, o Docker já vem habilitado em todos os planos. Mas vamos garantir que está pronto para uso:

Abra o terminal e digite:

docker --version

Se aparecer a versão do Docker, ótimo! Se não, o sistema pode precisar de uma atualização. Nesse caso, entre em contato com o suporte — eles ajudam a resolver isso rapidamente.

Passo 3: Crie uma pasta para o seu projeto

É importante organizar tudo dentro de uma pasta separada. Isso evita confusões e facilita a manutenção.

No terminal, digite:

mkdir meu-projeto-docker

Em seguida, acesse a pasta:

cd meu-projeto-docker

Passo 4: Crie o arquivo docker-compose.yml

Este é o coração do seu projeto. Ele define todos os serviços que você quer rodar.

No terminal, crie o arquivo com o editor nano:

nano docker-compose.yml

Depois, cole o seguinte conteúdo (um exemplo simples com um site e um banco de dados):

version: '3.8'

services:
  app:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
    restart: unless-stopped

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: senha123
      MYSQL_DATABASE: minha_app
    volumes:
      - db_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  db_data:

Pressione Ctrl + X, depois Y para salvar e sair.

Passo 5: Crie a estrutura de arquivos do seu site

Vamos criar uma página simples para testar o serviço do Nginx:

mkdir html

Em seguida, crie um arquivo de página HTML:

nano html/index.html

Coloque este conteúdo:

<!DOCTYPE html>
<html>
<head>
  <title>Meu Site com Docker</title>
</head>
<body>
  <h1>Olá do Docker Compose!</h1>
  <p>Seu ambiente está rodando com múltiplos serviços!</p>
</body>
</html>

Salve com Ctrl + X, Y, e Enter.

Passo 6: Inicie os serviços com Docker Compose

Volte ao terminal e execute:

docker-compose up -d

O parâmetro -d significa "em segundo plano" — seus serviços vão rodar sem travar o terminal.

Dica do Sensei: Se aparecer um erro como "command not found", verifique se o Docker está instalado. Caso precise, o suporte da GeHost está lá para te ajudar — não se preocupe!

Passo 7: Acesse seu aplicativo

Seu site está rodando na porta 8080. Para acessá-lo:

Abra seu navegador e vá para:

http://seu-servidor:8080

Substitua seu-servidor pelo endereço do seu servidor (você pode encontrar isso no painel do cliente ou pedir ao suporte).

Se tudo der certo, você verá a página "Olá do Docker Compose!" — parabéns! Seu ambiente está funcionando!

Passo 8: Gerencie seus serviços

Veja o status de todos os serviços:

docker-compose ps

Interrompa todos os serviços:

docker-compose down

Reinicie com novas alterações:

docker-compose up -d --build

Conclusão: Você está no caminho certo!

Parabéns, guerreiro da tecnologia! Você acabou de configurar um ambiente com múltiplos serviços usando Docker Compose — uma habilidade valiosa no mundo moderno de desenvolvimento.

Lembre-se: a GeHost está aqui para te apoiar. Se tiver dúvidas, se algo não funcionar, ou precisar de ajuda com configurações avançadas, basta entrar em contato com o suporte no painel.gehost.com.br.

Seu sucesso é nosso propósito. E lembre-se: cada grande sistema começou com um único comando.

Com carinho,
Sensei da GeHost
*Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)*