Instalar a MongoDB Community no macOS usando .tgz
Tarball
Nesta página
Visão geral
Use este tutorial para instalar manualmente o MongoDB 8.0 MongoDB Community Edition no macOS usando um tarball .tgz
baixado.
Versão do MongoDB
Este tutorial instala o MongoDB 8.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 o MongoDB possa ser instalado manualmente através de um .tgz
tarball baixado, conforme descrito neste documento, é recomendado utilizar o gerenciador de pacotes do brew
em seu sistema para instalar o MongoDB, se possível. A utilização de um gerenciador de pacotes instala automaticamente todas as dependências necessárias, fornece um arquivo de exemplo mongod.conf
para você começar 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 8.0 A Community Edition é compatível com 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
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:
Baixar o tarball.
Baixe o tarball do MongoDB Community tgz
usando o link a seguir:
➤ Centro de downloads do MongoDB
Na menu suspenso Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione macOS.
No menu suspenso Package, selecione tgz.
Clique em Download.
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/
Baixar o tarball.
Baixe o tarball do MongoDB Community tgz
usando o link a seguir:
➤ Centro de downloads do MongoDB
Na lista suspensa Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione macOS ARM 64.
No menu suspenso Package, selecione tgz.
Clique em Download.
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 valorulimit
para 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.
Inicie uma sessão mongosh
na mesma máquina host que o mongod
. Você pode executar mongosh
sem nenhuma opção de linha de comando para se conectar a um mongod
em execução em seu localhost com a porta padrão de 27017:
mongosh
Para obter mais informações sobre como se conectar usando mongosh
, como se conectar a uma instância mongod
em execução em um host e/ou porta diferente, consulte a documentação do mongosh.
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
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.