MongoDb Docker

Por que usar MongoDB com Docker

Instalar o MongoDB diretamente no sistema operacional deixa um serviço rodando o tempo todo, consumindo memória mesmo quando você não está programando. Além disso, trocar de versão ou limpar o ambiente costuma dar trabalho.

Com o MongoDB Docker, o banco vive dentro de um container que você liga e desliga quando quiser. Assim, cada projeto pode usar a versão de que precisa, e remover tudo leva apenas um comando.

Outro ganho é a padronização. Afinal, toda a equipe sobe o mesmo ambiente com o mesmo comando, independentemente do sistema operacional de cada pessoa.

Por fim, o container isola o banco do restante do sistema. Assim, testar uma nova versão do Mongo ou começar com um banco vazio deixa de ser arriscado, porque basta criar outro container ao lado do atual, em uma porta diferente.

Requisitos

Antes de começar, prepare três itens: um bom terminal, o Docker instalado e, no Windows, o WSL 2. Cada um deles aparece nas próximas subseções.

Obtendo a imagem do MongoDB no Docker

Primeiro, confirme que o Docker está em execução e abra um novo terminal. Em seguida, verifique a versão instalada com o comando docker --version.

No ambiente usado no material original, a saída foi a mostrada abaixo. A sua versão provavelmente será mais nova, mas os comandos deste guia continuam os mesmos.

Docker version 19.03.12, build 48a66213fe

O próximo passo é obter a imagem do Mongo, que serve de molde para criar os containers. Para isso, execute o comando pull.

docker pull mongo

Note que a primeira mensagem será Using default tag: latest. Isso significa que o Docker baixa a versão mais recente dessa imagem, normalmente com a última versão estável do Mongo.

Caso queira uma versão específica, consulte as tags disponíveis no Docker Hub. Por exemplo, docker pull mongo:7.0 baixa a linha 7.0 e evita surpresas quando uma nova versão principal sai.

Em projetos de equipe, fixar a tag é uma boa prática. Dessa forma, todo mundo roda o MongoDB Docker na mesma versão, e o comportamento do banco não muda de uma hora para outra.

Rodando o MongoDB Docker

Para criar e executar o container, use o comando abaixo. Não se esqueça de trocar os valores de MONGO_INITDB_ROOT_USERNAME e MONGO_INITDB_ROOT_PASSWORD pelo usuário e pela senha que você deseja.

docker run --name mongodb -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=balta -e MONGO_INITDB_ROOT_PASSWORD=e296cd9f mongo

Cada parte do comando tem uma função clara. A lista abaixo resume o papel de cada uma.

• --name mongodb dá um nome fixo ao container, o que facilita os próximos comandos.
• -p 27017:27017 publica a porta padrão do Mongo no host.
• -e MONGO_INITDB_ROOT_USERNAME e -e MONGO_INITDB_ROOT_PASSWORD criam o usuário administrador na primeira inicialização.
• mongo indica a imagem baixada no passo anterior.

As duas variáveis de ambiente só têm efeito quando o container inicia com o diretório de dados vazio. Ou seja, se você mudar a senha depois, precisa recriar o container ou alterar o usuário pelo próprio Mongo.

docker run -v ~/docker --name mongodb -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=balta -e MONGO_INITDB_ROOT_PASSWORD=e296cd9f mongo

docker volume create mongodb-data
docker run -d --name mongodb -p 27017:27017 -v mongodb-data:/data/db -e MONGO_INITDB_ROOT_USERNAME=balta -e MONGO_INITDB_ROOT_PASSWORD=e296cd9f mongo

Gerenciando o container no dia a dia

Depois de criado, o container não precisa ser recriado a cada uso. Basta ligá-lo e desligá-lo com os comandos start e stop.

# Inicia o container já existente
docker start mongodb

# Para o container sem apagar os dados
docker stop mongodb

# Lista os containers em execução
docker ps

# Mostra os logs do Mongo
docker logs mongodb

O comando docker logs ajuda bastante quando o banco não sobe. Em geral, a mensagem de erro aparece logo nas últimas linhas da saída.

Se preferir declarar tudo em arquivo, o Docker Compose descreve o mesmo ambiente em YAML. Dessa forma, o MongoDB Docker sobe com docker compose up -d e para com docker compose down.

services:
  mongodb:
    image: mongo
    container_name: mongodb
    ports:
      - "27017:27017"
    environment:
      MONGO_INITDB_ROOT_USERNAME: balta
      MONGO_INITDB_ROOT_PASSWORD: e296cd9f
    volumes:
      - mongodb-data:/data/db
    restart: unless-stopped

volumes:
  mongodb-data:

A política restart: unless-stopped religa o container quando o Docker reinicia, a menos que você o tenha parado manualmente. Para um ambiente de desenvolvimento, esse comportamento costuma ser o mais confortável.

Connection string do MongoDB Docker

Se você usou as mesmas configurações deste artigo, a connection string será igual à mostrada abaixo. Caso tenha alterado usuário, senha ou porta, ajuste os valores correspondentes.

mongodb://balta:e296cd9f@localhost:27017/admin

A string segue o formato mongodb://usuario:senha@host:porta/banco. Nesse caso, o banco admin também funciona como base de autenticação, porque o usuário root nasce nele.

Quando a aplicação precisa acessar outro banco com o usuário root, informe a base de autenticação com o parâmetro authSource. Por exemplo, mongodb://balta:e296cd9f@localhost:27017/store?authSource=admin conecta no banco store autenticando pelo admin.

Essa mesma string funciona no driver oficial do MongoDB para .NET, Node.js ou qualquer outra linguagem. Assim, a aplicação nem percebe que o MongoDB Docker roda dentro de um container.

Acessando o shell do Mongo no container

Além do Compass, você pode abrir o shell do Mongo diretamente dentro do container. Para isso, use o comando docker exec com as flags -it, que mantêm a sessão interativa.

docker exec -it mongodb mongosh -u balta -p e296cd9f --authenticationDatabase admin

As imagens mais recentes trazem o mongosh, o shell moderno do Mongo. Já as imagens anteriores à versão 6.0 usam o shell antigo, chamado mongo, com os mesmos parâmetros.

Dentro do shell, comandos como show dbs e use store ajudam a explorar o banco. Para sair, digite exit.

// Retorna { ok: 1 } quando o servidor responde
db.runCommand({ ping: 1 })

Conectando uma aplicação .NET ao MongoDB Docker

Com o banco no ar, o próximo passo natural é consumi-lo a partir de uma aplicação. Como exemplo, vamos usar o driver oficial do MongoDB para .NET, distribuído pelo pacote MongoDB.Driver.

dotnet new console -o MongoSample
cd MongoSample
dotnet add package MongoDB.Driver

Em seguida, crie uma classe simples para representar os documentos e grave um registro na coleção. O exemplo usa a connection string montada na seção anterior.

using MongoDB.Bson;
using MongoDB.Driver;

// Mesma connection string usada no Compass
var connectionString = "mongodb://balta:e296cd9f@localhost:27017/admin";

var client = new MongoClient(connectionString);
var database = client.GetDatabase("store");
var products = database.GetCollection<Product>("products");

await products.InsertOneAsync(new Product { Name = "Keyboard", Price = 199.90m });

var all = await products.Find(_ => true).ToListAsync();
foreach (var product in all)
    Console.WriteLine($"{product.Name}: {product.Price}");

public class Product
{
    public ObjectId Id { get; set; }
    public string Name { get; set; } = string.Empty;
    public decimal Price { get; set; }
}

O MongoClient abre a conexão, o GetDatabase seleciona o banco e o GetCollection aponta para a coleção. Repare que o Mongo cria o banco store e a coleção products automaticamente na primeira gravação.

Em uma aplicação real, a connection string fica no appsettings.json ou em variáveis de ambiente, e não no código. Dessa forma, você troca o MongoDB Docker local por um cluster em produção sem alterar nenhuma linha.

Boas práticas de segurança no MongoDB Docker

Mesmo em desenvolvimento, alguns cuidados simples evitam dores de cabeça. Afinal, um banco exposto na rede com senha fraca é um alvo fácil.

Primeiro, publique a porta apenas na interface local com -p 127.0.0.1:27017:27017. Assim, só a sua própria máquina acessa o banco, mesmo quando você está em uma rede compartilhada.

Além disso, evite deixar usuário e senha escritos diretamente no docker-compose.yml versionado. O Docker Compose lê variáveis de um arquivo .env, que você pode manter fora do controle de versão.

Por fim, crie um usuário com a role readWrite para cada aplicação, em vez de usar o root em todo lugar. Com isso, um vazamento de credencial afeta apenas um banco, e não o MongoDB Docker inteiro.

Erros comuns no MongoDB Docker

Mesmo com tudo configurado, alguns problemas aparecem com frequência. O mais comum envolve autenticação, e os outros costumam envolver porta ou volume.

// Seleciona o banco em que o usuário será criado
use your_database

db.createUser(
{
   user: "balta",
   pwd: "baltaio",
   roles: [
     { role: "readWrite", db: "your_database" }
   ]
})

Conclusão sobre MongoDB Docker

Com poucos comandos, você colocou o MongoDB Docker em funcionamento sem instalar nenhum serviço permanente na máquina. Além disso, aprendeu a persistir os dados, gerenciar o container e montar a connection string.

O mesmo raciocínio vale para outros bancos. Por exemplo, o artigo SQL Server no Docker aplica a mesma ideia ao banco relacional da Microsoft.

A partir daqui, o próximo passo é conectar a sua aplicação ao banco e criar usuários específicos para cada projeto. Assim, o ambiente de desenvolvimento fica organizado, seguro e fácil de reproduzir.

FAQ

Qual a porta padrão do MongoDB no Docker?

A porta padrão do Mongo é a 27017. Você a publica no host com a flag -p 27017:27017.

Os dados somem quando eu paro o container?

Não, parar o container mantém os dados. Eles só se perdem quando você remove o container sem um volume mapeado para /data/db.

Posso mudar a senha do root depois de criar o container?

As variáveis MONGO_INITDB só valem na primeira inicialização com o diretório vazio. Depois disso, altere a senha pelo shell ou recrie o container e o volume.

Qual shell uso dentro do container?

Nas imagens recentes, use mongosh. Nas imagens anteriores à versão 6.0, o shell se chama mongo.

Preciso do WSL 2 para rodar o Mongo no Windows?

O WSL 2 é a recomendação para o Docker Desktop no Windows. Ele precisa estar instalado antes do Docker.