Visão geral
Use este tutorial para instalar o MongoDB 8.0 Enterprise Edition no macOS usando o gerenciador de pacote Homebrew de terceiros.
A instalação do MongoDB por meio do Homebrew também instala as Database Tools. Consulte Usando as Database Tools do MongoDB para obter mais informações.
Considerações
Suporte a plataformas
MongoDB 8.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 Command-line
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 a edição MongoDB Enterprise usando Homebrew, complete as seguintes etapas:
Adicione a torneira MongoDB Homebrew.
O toque MongoDB Homebrew disponibiliza as fórmulas oficiais do MongoDB e do Database Tools Homebrew em seu sistema.
Para adicionar o toque MongoDB Homebrew, execute o seguinte comando:
brew tap mongodb/brew
Em seguida, marque o toque 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ê já instalou uma versão mais antiga da fórmula, poderá 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 instalaram 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 por meio de brew services. Talvez seja necessário configurar manualmente os valores 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 Para interromper a execução de um
mongodcomo um processo em segundo plano, conecte-se aomongodusando mongosh e execute o comandoshutdownconforme 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 Configurações do sistema
Clique em Privacidade e segurança na barra lateral.
Na seção Segurança, clique no botão Open Anyway à direita da mensagem sobre
mongod.
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
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:
Informações adicionais
Vinculação ao localhost por padrão
Por padrão, o MongoDB é iniciado com bindIp, definido como 127.0.0.1, que se vincula à interface de rede localhost. Isso significa que o mongod só pode aceitar conexões de clientes que estejam executando na mesma máquina. Os clientes remotos não conseguirão se conectar ao mongod e o mongod não conseguirá inicializar um conjunto de réplicas, a menos que esse valor seja definido como uma interface de rede válida.
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
A instalação também inclui as Database Tools MongoDB. Consulte Usando as Database Tools do MongoDB para obter mais informações.
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