Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / / /

Instalar a MongoDB Community no macOS usando .tgz Tarball

Nesta página

  • Visão geral
  • Considerações
  • Instale o MongoDB Community Edition
  • Execute o MongoDB Community Edition
  • Informações adicionais

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.

Use este tutorial para instalar manualmente a edição MongoDB 7.0 Community no macOS usando um tarball .tgz baixado.

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.

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.

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.

O MongoDB 7.0 Community Edition suporta macOS 11 ou posterior.

Para obter mais informações, consulte Suporte à plataforma.

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.

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:

1

Baixe o tarball do MongoDB Community tgz usando o link a seguir:

Centro de downloads do MongoDB

  1. Na menu suspenso Version, selecione a versão do MongoDB para baixar.

  2. No menu suspenso Platform, selecione macOS.

  3. No menu suspenso Package, selecione tgz.

  4. Clique em Download.

2
tar -zxvf mongodb-macos-x86_64-7.0.tgz

Se o seu navegador descompactar automaticamente o arquivo como parte das transferências, o arquivo terminará em .tar.

3

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/
1

Baixe o tarball do MongoDB Community tgz usando o link a seguir:

Centro de downloads do MongoDB

  1. Na lista suspensa Version, selecione a versão do MongoDB para baixar.

  2. No menu suspenso Platform, selecione macOS ARM 64.

  3. No menu suspenso Package, selecione tgz.

  4. Clique em Download.

2
tar -zxvf mongodb-macos-arm64-7.0.tgz

Se o seu navegador descompactar automaticamente o arquivo como parte das transferências, o arquivo terminará em .tar.

3

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/
Considerações ulimit
A maioria dos sistemas operacionais do tipo Unix limita os recursos do sistema que um processo pode usar. Esses limites podem impacto negativamente a operação do MongoDB e devem ser ajustados. Consulte Configurações do UNIX ulimit para sistemas autogerenciados para obter as configurações recomendadas para sua plataforma.

Observação

Se o valor ulimit para o número de arquivos abertos estiver em 64000, o MongoDB gerará um aviso de inicialização.

Siga estas etapas para executar o MongoDB Community Edition. Estas instruções pressupõem que você esteja usando as configurações padrão.

1

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
2

Você também deve criar o diretório no qual o processo mongod escreverá seu arquivo de log:

Por exemplo, para criar o diretório ~/data/log/mongodb:

sudo mkdir -p ~/data/log/mongodb
3

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
4

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 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 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.

5

Verifique se o MongoDB foi iniciado com sucesso:

ps aux | grep -v grep | grep mongod

Se você não vir um processo mongod em execução, verifique se há mensagens de erro no arquivo de log.

6

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.

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, ou

  • por 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.

Voltar

Instalar no macOS