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 edição MongoDB 7.0 Community usando o gerenciador de pacotes apt.

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.

O MongoDB 7.0 Community Edition suporta as seguintes versões Debiande 64 bits na arquitetura x86_64:

  • Debian 12 "Biblioteca"

  • Debian 11 "bullseye"

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-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.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

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 abaixo 64000, o MongoDB gerará um aviso de inicialização.

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 o 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 com a conta de usuário mongodb. Se você alterar o usuário que executa o processo MongoDB, também deverá modificar a permissão /var/lib/mongodb para /var/log/mongodb os diretórios e para conceder a este usuário acesso a estes diretórios.

Para especificar um diretório de arquivo de log diferente e diretório de arquivo de dados, edite as 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 que seja acessível aos 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 sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra acessos não autorizados. 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 Shell do MongoDB (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
← Solução de problemas