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 manualmente a edição MongoDB 7.0 Community no macOS usando um tarball .tgz baixado.
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.
Método de instalação
Embora você possa instalar o MongoDB manualmente usando um .tgz tarball baixado, conforme descrito neste documento, recomendamos usar o gerenciador de pacote brew em seu sistema, se possível. A utilização de um gerenciador de pacote instala automaticamente todas as dependências necessárias, fornece um arquivo de exemplo mongod.conf e simplifica futuras tarefas de atualização e manutenção.
➤ Consulte Instalar o MongoDB usando o Gerenciador de Pacotes brew para obter instruções.
Considerações
MongoDB Shell, mongosh
Ao utilizar o pacote .tgz para instalar o servidor, você precisa seguir as instruções de instalação do mongosh para baixar e instalar o mongosh separadamente.
Suporte a plataformas
MongoDB 7.0 A Community Edition é compatível com 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.
Instale o MongoDB Community Edition
Para instalar manualmente o MongoDB Community Edition a partir de .tgz, selecione a aba que corresponde ao processador do seu Mac e siga as seguintes etapas:
Certifique-se de que os binários estejam em um diretório listado na variável de ambiente PATH.
Os binários do MongoDB estão no diretório bin/ do tarball. Você também pode:
Copie os binários para um diretório listado na sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/ Crie links simbólicos para os binários a partir de um diretório listado na sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
Certifique-se de que os binários estejam em um diretório listado na variável de ambiente PATH.
Os binários do MongoDB estão no diretório bin/ do tarball. Você também pode:
Copie os binários para um diretório listado na sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/ Crie links simbólicos para os binários a partir de um diretório listado na sua variável
PATH, como/usr/local/bin. Substitua/path/to/the/mongodb-directory/pelo seu diretório de instalação.sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
Execute o MongoDB Community Edition
- Considerações ulimit
A maioria dos sistemas operacionais do tipo Unix limita os recursos do sistema que um processo pode usar. Esses limites podem impactar negativamente a operação do MongoDB e devem ser ajustados. Consulte UNIX ulimit Configurações para implantações autogerenciadas para obter as configurações recomendadas para sua plataforma.
Observação
Se o valor
ulimitpara o número de arquivos abertos estiver em64000, o MongoDB gerará um aviso de inicialização.
Procedimento
Siga estas etapas para executar o MongoDB Community Edition. Estas instruções pressupõem que você esteja usando as configurações padrão.
Crie o diretório de dados.
Antes de iniciar o MongoDB pela primeira vez, você deve criar o diretório para o qual o processo do mongod gravará os dados.
Por exemplo, para criar o diretório ~/data/db:
sudo mkdir -p ~/data/db
Defina permissões para os diretórios de dados e registro.
Certifique-se de que a conta de usuário que executa mongod tenha permissões de leitura e gravação para esses dois diretórios. Se você estiver executando mongod como sua própria conta de usuário e tiver acabado de criar os dois diretórios acima, eles já deverão estar acessíveis ao seu usuário. Caso contrário, você pode usar chown para definir a propriedade, substituindo o usuário apropriado:
sudo chown <user> ~/data/db sudo chown <user> ~/data/log/mongodb
Execute o MongoDB.
Para executar o MongoDB, execute o processo mongod no prompt do sistema, fornecendo os dois parâmetros dbpath e logpath mencionados acima e o parâmetro fork para executar mongod em segundo plano. Alternativamente, você pode optar por armazenar os valores para dbpath, logpath, fork e muitos outros parâmetros em um arquivo de configuração.
Execute o mongod com parâmetros de linha de comando
Execute o processo do mongod no prompt do sistema, fornecendo os três parâmetros necessários diretamente na linha de comando:
mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork
Execute o mongod com um arquivo de configuração
Execute o processo do mongod no prompt do sistema, fornecendo o caminho para um arquivo de configuração com o parâmetro config :
mongod --config /usr/local/etc/mongod.conf
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.
Comece a usar o MongoDB.
Start a mongosh session on the same host machine as the mongod. You can run mongosh without any command-line options to connect to a mongod that is running on your localhost with the default port of 27017:
mongosh
For more information on connecting using mongosh, such as to connect to a mongod instance running on a different host and/or port, see the mongosh documentation.
Para ajudar você a começar a usar o MongoDB, o MongoDB fornece guias de introdução em várias edições de drivers. Consulte Introdução ao MongoDB para ver as edições disponíveis.
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.