Como Instalar MongoDB Community Edition com Docker: Guia Completo Passo a Passo

Está buscando uma forma rápida e eficiente de configurar o MongoDB no seu ambiente de desenvolvimento? O Docker pode ser seu melhor aliado nessa jornada! Neste guia completo, vou te mostrar como instalar e executar o MongoDB Community Edition usando contêineres Docker, economizando tempo e evitando dores de cabeça com configurações complexas.

Por Que Usar Docker para Rodar MongoDB?

Antes de mergulharmos no passo a passo, vale entender os benefícios de utilizar o Docker para suas implementações de MongoDB:

• Rapidez na implementação: configure um ambiente MongoDB em minutos, não horas
• Gerenciamento simplificado de arquivos de configuração
• Facilidade para testar diferentes versões e recursos do MongoDB
• Isolamento de ambiente, evitando conflitos com outras aplicações

Se você já trabalha com desenvolvimento web ou aplicações que precisam de um banco de dados NoSQL, essa abordagem vai revolucionar seu fluxo de trabalho!

Pré-requisitos: O Que Você Precisa Antes de Começar

Para seguir este tutorial com sucesso, você precisará ter:

1. Docker instalado em seu sistema
2. MongoDB Shell (mongosh) para interagir com seu banco de dados
3. Conhecimento básico de linha de comando

Nota importante: As imagens do MongoDB 5.0+ requerem compatibilidade com AVX em seu sistema. Se seu computador não suportar AVX, você precisará usar uma versão anterior à 5.0.

⚠️ Atenção: Versões do MongoDB anteriores à 5.0 atingiram o fim da vida útil e não são mais suportadas oficialmente. Use essas versões apenas para testes!

Tutorial Passo a Passo: Instalando MongoDB com Docker

1. Baixando a Imagem Oficial do MongoDB Community

O primeiro passo é obter a imagem oficial do MongoDB a partir do Docker Hub. Execute este comando no seu terminal:

bash
docker pull mongodb/mongodb-community-server:latest

Esse comando baixa a versão mais recente do MongoDB Community Edition. O download pode levar alguns minutos, dependendo da sua conexão com a internet.

2. Executando o MongoDB como um Contêiner

Após baixar a imagem, você pode iniciar um contêiner MongoDB com o seguinte comando:

bash
docker run --name mongodb -p 27017:27017 -d mongodb/mongodb-community-server:latest

Vamos entender o que cada parte deste comando faz:

• --name mongodb: Define um nome amigável para o contêiner
• -p 27017:27017: Mapeia a porta 27017 do contêiner para a porta 27017 do seu computador
• -d: Executa o contêiner em modo "detached" (em segundo plano)
• mongodb/mongodb-community-server:latest: Especifica a imagem a ser utilizada

Deseja uma Versão Específica do MongoDB?

Se precisar utilizar uma versão específica do MongoDB, basta especificar a tag após os dois pontos (:). Por exemplo, para MongoDB 5.0:

bash
docker run --name mongodb -p 27017:27017 -d mongodb/mongodb-community-server:5.0-ubuntu2004

Configurações Avançadas: Adicionando Opções de Linha de Comando

Você pode personalizar ainda mais sua instância MongoDB adicionando opções de linha de comando ao final do comando docker run. Por exemplo, para configurar um Replica Set:

docker run -p 27017:27017 -d mongodb/mongodb-community-server:latest --name mongodb --replSet myReplicaSet

3. Verificando se o Contêiner Está em Execução

Para confirmar que seu contêiner MongoDB está funcionando corretamente, execute:

docker container ls

Você deverá ver uma saída semelhante a esta:

CONTAINER ID   IMAGE                                       COMMAND                  CREATED         STATUS         PORTS       NAMES
c29db5687290   mongodb/mongodb-community-server:5.0-ubi8   "docker-entrypoint.s…"   4 seconds ago   Up 3 seconds   27017/tcp   mongodb

Se o contêiner aparecer na lista com status "Up", significa que está funcionando corretamente!

4. Conectando-se ao MongoDB com o MongoDB Shell

Agora que seu MongoDB está em execução, você pode se conectar a ele usando o MongoDB Shell:

mongosh --port 27017

Você deverá ver a mensagem de boas-vindas do MongoDB Shell, indicando que a conexão foi estabelecida com sucesso.

5. Validando sua Implementação

Para confirmar que sua instância MongoDB está funcionando corretamente, execute o comando "Hello":

javascript
db.runCommand({ hello: 1 })

Se tudo estiver correto, você receberá uma resposta com detalhes sobre sua implementação MongoDB, incluindo informações como isWritablePrimary: true e outros parâmetros de configuração.

Verificação de Segurança (Opcional): Autenticando Sua Imagem

Para ambientes com requisitos de segurança mais rigorosos, você pode verificar a autenticidade da imagem MongoDB usando o Cosign. Este procedimento é opcional, mas recomendado para ambientes de produção.

Siga estes passos:

1. Instale o Cosign seguindo as instruções no Repositório Cosign GitHub
2. Baixe a chave pública da MongoDB:

   bash
   curl https://cosign.mongodb.com/server.pem > server.pem

3. Verifique a assinatura:

   bash
   COSIGN_REPOSITORY=docker.io/mongodb/signatures cosign verify --private-infrastructure --key=./server.pem docker.io/mongodb/mongodb-community-server:latest

Solução de Problemas Comuns na Instalação do MongoDB com Docker

O contêiner fecha logo após ser iniciado?

Verifique os logs do contêiner com:

bash
docker logs mongodb

Este comando mostrará qualquer erro que possa estar impedindo o MongoDB de iniciar corretamente.

Não consegue se conectar ao MongoDB?

Certifique-se de que o mapeamento de portas está correto e que nenhum outro serviço está usando a porta 27017 em sua máquina. Tente:

bash
docker run --name mongodb -p 27018:27017 -d mongodb/mongodb-community-server:latest

E então conecte-se usando:

bash
mongosh --port 27018

Conclusão: Seu Ambiente MongoDB Está Pronto!

Parabéns! Você agora tem uma instância do MongoDB Community Edition rodando perfeitamente em um contêiner Docker. Esta configuração é ideal para:

• Desenvolvimento local de aplicações
• Testes de funcionalidades
• Ambientes de homologação
• Aprendizado da tecnologia MongoDB

Lembre-se que para ambientes de produção, é recomendado considerar o MongoDB Enterprise Edition com configurações adicionais de segurança e performance.

Descubra como criar arquivos de lote (.BAT) no Windows e automatizar tarefas rapidamente. Confira o tutorial completo aqui:  Como criar um arquivo de lote (bat) para otimizar o Windows

Tem dúvidas ou encontrou alguma dificuldade durante a instalação? Deixe seu comentário abaixo e ficarei feliz em ajudar!

E não esqueça de explorar nosso curso completo para levar seus conhecimentos em MongoDB ao próximo nível e se destacar como desenvolvedor!