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

Instale o MongoDB Community Edition no Debian

Nesta página

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

Observação

MongoDB Atlas

O MongoDB Atlas é uma opção de serviço MongoDB hospedada na nuvem que não requer nenhuma sobrecarga de instalação e oferece uma camada grátis para começar.

Use este tutorial para instalar a MongoDB Community Edition 6.0 usando o apt gerenciador de pacotes.

Este tutorial instala a edição MongoDB 6.0 Community. 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.

MongoDB 6. O 0 Community Edition suporta as seguintes versões Debian de 64bits na arquitetura x86_64 :

  • Debian 11 "bullseye"

  • Debian 10 "Buster"

O MongoDB é compatível somente com as versões de 64 bits dessas plataformas.

Consulte Suporte da Plataforma para obter mais informações.

Antes de implantar o MongoDB em um ambiente de produção, considere o documento Notas de Produção que oferece considerações de desempenho e recomendações de configuração para produção de sistemas do MongoDB.

Para instalar o MongoDB Community em seu sistema Debian, estas instruções utilizarão o pacote oficial do mongodb-org, que é mantido e suportado pela MongoDB Inc. O pacote oficial do mongodb-org sempre contém a versão mais recente do MongoDB e está disponível em seu próprio repositório dedicado.

Importante

O pacote mongodb fornecido pela Debian não é mantido pela MongoDB Inc. e entra em conflito com o pacote mongodb-org oficial. Se já tiver instalado o mongodb pacote em seu sistema Debian, você deverá primeiro desinstalar o mongodb pacote antes de prosseguir com estas instruções.

Consulte Pacotes do MongoDB Community Edition para obter a lista completa de pacotes oficiais.

Siga estas etapas para instalar o MongoDB Community Edition usando o gerenciador de pacotes apt.

1

A partir de um terminal, instale gnupg e curl, se ainda não estiverem disponíveis:

sudo apt-get install gnupg curl

Para importar a chave GPG pública do MongoDB, execute o seguinte comando:

curl -fsSL https://www.mongodb.org/static/pgp/server-6.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg \
--dearmor
2

Crie o arquivo de lista usando o comando apropriado para sua versão do Debian:

3

Dê o seguinte comando para recarregar a base de dados do pacote local:

sudo apt-get update
4

Você pode instalar a versão estável mais recente do MongoDB ou uma versão específica do MongoDB.

Opcional. Embora você possa especificar qualquer versão disponível do MongoDB, o apt-get atualizará os pacotes quando uma versão mais nova se tornar disponível. Para evitar atualizações indesejadas, você pode fixar o pacote na versão que está instalada atualmente:

echo "mongodb-org hold" | sudo dpkg --set-selections
echo "mongodb-org-database hold" | sudo dpkg --set-selections
echo "mongodb-org-server hold" | sudo dpkg --set-selections
echo "mongodb-mongosh hold" | sudo dpkg --set-selections
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections
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 Configurações do UNIX ulimit 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.
Diretórios
Por padrão, uma instância MongoDB armazena:
  • seus arquivos de dados em /var/lib/mongodb

  • seus arquivos de log em /var/log/mongodb

Se você instalou pelo gerenciador de pacotes, estes diretórios padrão serão criados durante a instalação.Se você instalou manualmente baixando os tarballs, você poderá criar os diretórios utilizando mkdir -p <directory> ou sudo mkdir -p <directory> dependendo do usuário que executará MongoDB. (Veja as páginas de manual do Linux para obter informações sobre mkdir e sudo.) Por padrão, o MongoDB é executado usando a conta de usuário mongodb . Se você alterar o usuário que executa o processo MongoDB, também deverá modificar a permissão para os diretórios /var/lib/mongodb e /var/log/mongodb para conceder a esse usuário acesso a esses diretórios. Para especificar um diretório de arquivo de log diferente e um diretório de Data Federation, edite o configurações do systemLog.path e storage.dbPath no /etc/mongod.conf. Certifique-se de que o usuário que executa o MongoDB tenha acesso a esses diretórios.

Siga estas etapas para executar o MongoDB Community Edition em seu sistema. Estas instruções pressupõem que você esteja usando o pacote oficial mongodb-org, -- não o pacote mongodb não oficial fornecido pelo Debian -- e usando as configurações padrão.

Sistema de Inicialização

Para executar e gerenciar seu processo do mongod, você utilizará o sistema de inicialização integrado do sistema operacional. Versões recentes do Linux tendem a utilizar systemd (que utiliza o comando systemctl), enquanto versões mais antigas do Linux tendem a utilizar System V init (que utiliza o comando service).

Se você não tiver certeza de qual sistema de inicialização sua plataforma usa, execute o seguinte comando:

ps --no-headers -o comm 1

Em seguida, selecione a aba apropriada abaixo com base no resultado:

  • systemd - selecione a aba systemd (systemctl) abaixo.

  • init - selecione a aba System V Init (service) abaixo.


Para remover completamente o MongoDB de um sistema, você deve remover os próprios aplicativos MongoDB, os arquivos de configuração e quaisquer diretórios que contenham dados e registros. A seção a seguir orienta você nas etapas necessárias.

Aviso

Esse processo removerá completamente o MongoDB, sua configuração e todos os bancos de dados. Este processo não é reversível, portanto, certifique-se de fazer backup de todas as suas configurações e dados antes de continuar.

1

Interrompa o processo mongod com o seguinte comando:

sudo service mongod stop
2

Remova todos os pacotes do MongoDB que você instalou anteriormente.

sudo apt-get purge "mongodb-org*"
3

Remova bancos de dados e arquivos de log do MongoDB.

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb

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 acessível a partir dos clientes remotos.

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 a um não localhost (por exemplo, Antes de vincular sua instância a um endereço IP acessível publicamente, é importante que você tenha protegido seu cluster contra acesso não autorizado. Para obter uma lista completa das recomendações de segurança, consulte Lista de verificação de segurança. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.

Para obter mais informações sobre como configurar bindIp, veja Vinculação de IP.

O MongoDB Community Edition está disponível em seu próprio repositório dedicado e contém os seguintes pacotes com suporte oficial:

Nome do Pacote
Descrição
mongodb-org
Um metapackage que instala automaticamente os pacotes do componente listados abaixo.
mongodb-org-database

Um metapackage que instala automaticamente os pacotes do componente listados abaixo.

Nome do Pacote
Descrição
mongodb-org-server
Contém o daemon mongod, o roteiro de inicialização associado e um arquivo de configuração (/etc/mongod.conf). Utilize o roteiro de inicialização para iniciar o mongod com o arquivo de configuração. Para obter detalhes, consulte a seção "Executar o MongoDB Community Edition" acima.
mongodb-org-mongos
Contém o daemon mongos.
mongodb-mongosh
Contém o MongoDB Shell (mongosh).
mongodb-org-tools

Um metapackage que instala automaticamente os pacotes do componente listados abaixo:

Nome do Pacote
Descrição
mongodb-database-tools

Contém as seguintes ferramentas de banco de dados MongoDB:

mongodb-org-database-tools-extra
Contém o script install_compass
← Solucionar problemas de instalação do Ubuntu