Observação
MongoDB Atlas
MongoDB Atlas is a hosted MongoDB service option in the cloud which requires no installation overhead and offers a free cluster to get started.
Visão geral
Use este tutorial para instalar o MongoDB 7.0 Enterprise Edition no macOS usando o gerenciador de pacotes Homebrew de terceiros.
Installing MongoDB through Homebrew also installs the MongoDB Database Tools. See Using the MongoDB Database Tools for more information.
Considerações
Suporte a plataformas
MongoDB 7.0 A edição Enterprise suporta macOS 14 ou posterior e requer uma arquitetura de CPU Has disso ou mais recente.
Para obter mais informações, consulte Suporte à plataforma.
Notas de produção
Antes de implantar o MongoDB em um ambiente de produção, consulte o documento Notas de produção para implementações autogerenciadas para obter considerações de desempenho e recomendações de configuração.
Antes de começar
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.
Para instalar as FERRAMENTAS de linha de comando do Xcode, execute o seguinte comando:
xcode-select --install
Instalar o Homebrew
O macOS não inclui o pacote Homebrew brew por padrão.
Para instalar o Homebrew, use as instruções oficiais de instalação do Homebrew.
Instale o MongoDB Enterprise Edition
Para instalar o MongoDB Enterprise usando o Homebrew, siga estas etapas:
Adicione o tap do MongoDB no Homebrew.
O tap MongoDB Homebrew disponibiliza as fórmulas oficiais do MongoDB e do Database Tools Homebrew no seu sistema.
Para adicionar o tap do Homebrew do MongoDB, execute o seguinte comando:
brew tap mongodb/brew
Em seguida, marque o tap como confiável:
brew trust mongodb/brew
Se já tiver feito isso para uma instalação anterior do MongoDB, você pode pular esta etapa.
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.
Executar o MongoDB Enterprise Edition
Siga estas etapas para executar a edição MongoDB Enterprise. Estas instruções presumem 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.
Observação
Para sistemas macOS que tenham instalado o MongoDB usando o método de instalação Homebrew, o limite de arquivos abertos pode não ser definido automaticamente ao iniciar o MongoDB através de brew services. Talvez você precise configurar manualmente os valores de ulimit.
Consulte Configurações do Ulimit para obter mais informações.
Para executar
mongodo 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
--forkopçã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 Apple Silicon:
Para executar
mongodmanualmente como um processo em segundo plano especificando--dbpathe--logpathna linha de comando, execute:mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork To stop a
mongodrunning as a background process, connect to themongodusing mongosh, and issue theshutdowncommand as needed.
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, rotulado com 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-enterpriselistado 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
mongodna 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
To begin using MongoDB, connect mongosh to the running instance. From a new terminal, issue the following:
mongosh
Para obter informações sobre operações de CRUD (criar, ler, atualizar, excluir), consulte:
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.
Binários incluídos
A instalação inclui os seguintes binários:
Observação
The installation also includes the MongoDB Database Tools. See Using the MongoDB Database Tools for more information.
Caminhos de arquivo
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 | |
|---|---|---|
|
| |
|
| |
|
|
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