Instale o MongoDB Community Edition no macOS
Nesta página
Observação
MongoDB Atlas
O MongoDB Atlas é uma opção de serviço MongoDB hospedado em nuvem que não requer sobrecarga de instalação e oferece camada grátis para começar.
Visão geral
Use este tutorial para instalar o MongoDB 7.0 Community Edition no macOS usando o Homebrew, um sistema para gerenciamento de pacotes produzido por terceiros.
A partir do MongoDB 4.4.1, instalar o MongoDB por meio do Homebrew também instala as Database Tools do MongoDB database. Consulte Usando as Database Tools do MongoDB para mais informações.
Versão do MongoDB
Este tutorial instala o MongoDB 7.0 Community Edition. Para instalar uma versão diferente do MongoDB Community, use o menu suspenso de versão no canto superior esquerdo desta página para selecionar a documentação dessa versão.
Considerações
Suporte a plataformas
O MongoDB 7.0 Community Edition suporta macOS 11 ou posterior.
Para obter mais informações, consulte Suporte à plataforma.
Notas de produção
Antes de implantar o MongoDB em um ambiente de produção, considere o documento Notas de produção para implantações autogerenciadas, que oferece considerações de desempenho e recomendações de configuração para implantações de produção do MongoDB.
Instale o MongoDB Community Edition
Pré-requisitos
Certifique-se de que seu sistema atenda a cada um dos seguintes pré-requisitos. Você só precisa executar cada etapa de pré-requisito uma vez em seu sistema. Se você já executou as etapas de pré-requisito como parte de uma instalação MongoDB anterior usando Homebrew, você pode pular para o procedimento de instalação.
Instalar ferramentas xcode de linha de comando
O Homebrew requer as ferramentas de linha de comando do Xcode da Apple.
Instale as ferramentas de linha de comando do Xcode executando o seguinte comando no Terminal do seu macOS:
xcode-select --install
Instalar o Homebrew
O macOS não inclui o pacote Homebrew brew
por padrão.
Instale
brew
usando as instruções oficiais de instalação do Homebrew.
Instalando o MongoDB 7.0 Community Edition
Siga estas etapas para instalar o MongoDB Community Edition usando o gerenciador de pacotes brew
da Homebrew. Certifique-se de ter seguido os pré-requisitos de instalação acima antes de continuar.
Clique em Toque em Homebrew de MongoDB para baixar a fórmula oficial Homebrew para MongoDB e as Database Tools, executando o seguinte comando no seu Terminal macOS:
brew tap mongodb/brew Se já tiver feito isso para uma instalação anterior do MongoDB, você pode pular esta etapa.
Para atualizar o Homebrew e todas as fórmulas existentes:
brew update Para instalar o MongoDB, execute o seguinte comando em seu aplicativo Terminal do macOS:
brew install mongodb-community@7.0
Dica
Alternativamente, você pode especificar uma versão anterior do MongoDB, se desejado. Você também pode manter múltiplas versões do MongoDB lado a lado desta maneira.
Dica
Se você tiver instalado anteriormente uma versão mais antiga da fórmula, você pode encontrar um ChecksumMismatchError. Para resolver o problema, consulte Solução de problemas de ChecksumMismatchError.
A instalação inclui os seguintes binários:
Além disso, a instalação cria os seguintes arquivos e diretórios no local especificado abaixo, dependendo do seu hardware da Apple:
Processador Intel | Processador Apple Silicon | |
---|---|---|
/usr/local/etc/mongod.conf | /opt/homebrew/etc/mongod.conf | |
/usr/local/var/log/mongodb | /opt/homebrew/var/log/mongodb | |
/usr/local/var/mongodb | /opt/homebrew/var/mongodb |
Consulte a documentação da Apple para obter a lista atual de hardware da Apple que usa o chip da Apple. Você também pode executar o seguinte comando para verificar onde brew
instalou estes arquivos e diretórios:
brew --prefix
A partir do MongoDB 4.4.1, a instalação também inclui o MongoDB Database Tools. Consulte Usando o MongoDB Database Tools para mais informações.
Execute o MongoDB Community Edition
Siga estas etapas para executar o MongoDB Community Edition. Estas instruções pressupõem que você esteja usando as configurações padrão.
Você pode executar o MongoDB como um serviço macOS usando brew
ou pode executar o MongoDB manualmente como um processo de background. É recomendável executar o MongoDB como um serviço macOS, pois isso define os valores ulimit
corretos do sistema automaticamente (consulte as configurações de ulimit para obter mais informações).
Para executar o MongoDB (ou seja, o processo
mongod
) como um serviço macOS, execute:brew services start mongodb-community@7.0 Para interromper a execução de um
mongod
como um serviço macOS, use o seguinte comando, conforme necessário:brew services stop mongodb-community@7.0 Para executar
mongod
o manualmente como um processo de background utilizando um arquivo de configuração:Se a sua implantação não utilizar conexões TLS, utilize a
--fork
opção:Para macOS em execução em processadores Intel, execute:
mongod --config /usr/local/etc/mongod.conf --fork Para macOS em execução em processadores Apple Silicon, execute:
mongod --config /opt/homebrew/etc/mongod.conf --fork Se o seu sistema utilizar conexões TLS, utilize o GNU Screen.
Para macOS em execução em processadores Intel:
Para macOS em execução em processadores Apple Silicon:
Para executar
mongod
manualmente como um processo em segundo plano especificando--dbpath
e--logpath
na linha de comando, execute:mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork Para interromper a execução de um
mongod
como um processo em segundo plano, conecte-se aomongod
usando mongosh e execute o comandoshutdown
conforme necessário.
Ambos os métodos usam o arquivo mongod.conf
criado durante a instalação. Você também pode adicionar suas próprias opções de configuração do MongoDB a esse arquivo.
Observação
O macOS impede que o mongod Abra
macOS pode impedir que o mongod
seja executado após a instalação. Se você receber um erro de segurança ao iniciar o mongod
indicando que o desenvolvedor não pôde ser identificado ou verificado, faça o seguinte para conceder acesso ao mongod
para executar:
Abra as Preferências do sistema
Selecione o painel Segurança e Privacidade.
Na aba Geral, clique no botão à direita da mensagem sobre
mongod
, denominado Open Anyway ou Allow Anyway, dependendo da sua versão do macOS.
Para verificar se o MongoDB está em execução, execute um dos seguintes procedimentos:
Se você iniciou o MongoDB como um serviço macOS:
brew services list Você deverá ver o serviço
mongodb-community
listado comostarted
.Se você iniciou o MongoDB manualmente como um processo em segundo plano:
ps aux | grep -v grep | grep mongod Você deverá ver o processo
mongod
na saída.
Você pode também consultar o arquivo de log para verificar o status atual do seu processo mongod
: /usr/local/var/log/mongodb/mongo.log
.
Como conectar e usar o MongoDB
Para começar a utilizar o MongoDB, conecte mongosh
à instância em execução. Em um novo terminal, emita o seguinte:
mongosh
Para obter informações sobre operações de CRUD (criar, ler, atualizar, excluir), consulte:
Usando as Database Tools do MongoDB
A partir do MongoDB 4.4.1, a instalação do MongoDB pelo brew
também instala as Database Tools do MongoDB.
O MongoDB Database Tools é uma coleção de utilitários de linha de comando para trabalhar com uma implantação do MongoDB, incluindo backup de dados e ferramentas de importação/exportação como mongoimport
e mongodump
, bem como ferramentas de monitoramento como mongotop
.
Uma vez que você instalou o Servidor MongoDB nas etapas acima, as Database Tools estão disponíveis diretamente na linha de comando no seu aplicativo Terminal do macOS. Por exemplo, você pode executar mongotop
em sua instância do MongoDB em execução invocando-a no Terminal do seu macOS da seguinte forma:
mongotop
Ele deve iniciar, conectar-se ao seu mongod
em execução e começar a relatar estatísticas de uso.
Consulte a documentação das Database Tools do MongoDB para obter informações de uso para cada uma das Database Tools.
Informações adicionais
Vinculação ao localhost por padrão
By default, MongoDB launches with bindIp
set to 127.0.0.1
, which binds to the localhost network interface. This means that the mongod
can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod
, and the mongod
will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.
Este valor pode ser configurado de duas maneiras:
no arquivo de configuração do MongoDB com
bindIp
, oupor meio do argumento linha de comando
--bind_ip
Aviso
Antes de vincular sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte Lista de verificação de segurança para implantações autogerenciadas. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.
Para obter mais informações sobre como configurar bindIp
, consulte Vinculação de IP em implementações autogerenciadas.
Solução de problemas ChecksumMismatchError
Se você já instalou uma versão mais antiga da fórmula, poderá encontrar um ChecksumMismatchError
semelhante a:
Error: An exception occurred within a child process: ChecksumMismatchError: SHA256 mismatch Expected: c7214ee7bda3cf9566e8776a8978706d9827c1b09017e17b66a5a4e0c0731e1f Actual: 6aa2e0c348e8abeec7931dced1f85d4bb161ef209c6af317fe530ea11bbac8f0 Archive: /Users/kay/Library/Caches/Homebrew/downloads/a6696157a9852f392ec6323b4bb697b86312f0c345d390111bd51bb1cbd7e219--mongodb-macos-x86_64-4.2.0.tgz To retry an incomplete download, remove the file above.
Para corrigir:
Remova o arquivo
.tgz
baixado.Toque novamente na fórmula.
brew untap mongodb/brew && brew tap mongodb/brew Tente instalar novamente.
brew install mongodb-community@7.0