Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB
Instale o MongoDB Enterprise Edition no Debian
Nesta página
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.
Visão geral
Use este tutorial para instalar a edição MongoDB 7.0 Enterprise usando o apt
gerenciador de pacotes.
O MongoDB Enterprise Edition está disponível em plataformas selecionadas e é compatível com vários recursos relacionados à segurança e monitoramento.
Versão do MongoDB
Este tutorial instala MongoDB 7.0 Enterprise Edition. Para instalar uma versão diferente do MongoDB Enterprise, use o menu suspenso de versão no canto superior esquerdo desta página para selecionar a documentação dessa versão.
Considerações
Suporte a plataformas
A edição MongoDB 7.0 Enterprise suporta as seguintes versões Debian de 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.
Notas de produção
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.
Pacotes oficiais do MongoDB
Para instalar o MongoDB Enterprise em seu sistema Debian, estas instruções utilizarão o pacote oficial do mongodb-enterprise
, que é mantido e suportado pela MongoDB Inc. O pacote oficial do mongodb-enterprise
sempre contém a versão mais recente do MongoDB e está disponível em seu próprio repositório.
Importante
O pacote mongodb
fornecido pela Debian não é mantido pela MongoDB Inc. e entra em conflito com o pacote mongodb-enterprise
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 Enterprise Edition para obter a lista completa de pacotes oficiais.
Instale o MongoDB Enterprise Edition
Siga estas etapas para instalar o MongoDB Enterprise Edition usando o gerenciador de pacotes apt
.
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://pgp.mongodb.com/server-7.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \ --dearmor
Crie um arquivo /etc/apt/sources.list.d/mongodb-enterprise.list
para MongoDB.
Crie o arquivo de lista usando o comando apropriado para sua versão do Debian:
Se você quiser instalar pacotes do MongoDB Enterprise a partir de uma série de versões específica, poderá especificar a série de versões de uma versão do MongoDB compatível com sua compilação Debian na configuração do repositório. Por exemplo, para restringir seu sistema à série de versões 6.0, adicione o seguinte repositório:
Instalar os pacotes do MongoDB Enterprise
Instale o MongoDB Enterprise.
Emitir o seguinte comando:
sudo apt-get install -y mongodb-enterprise
Instale uma versão específica do MongoDB Enterprise.
Para instalar uma versão específica, você deve especificar cada pacote de componente individualmente junto com o número da versão, como no exemplo a seguir:
sudo apt-get install -y mongodb-enterprise=7.0.7 mongodb-enterprise-database=7.0.7 mongodb-enterprise-server=7.0.7 mongodb-mongosh=7.0.7 mongodb-enterprise-mongos=7.0.7 mongodb-enterprise-tools=7.0.7
Se você instalar o mongodb-enterprise=7.0.7
somente e não incluir os pacotes de componentes, a versão mais recente de cada pacote MongoDB será instalada independentemente da versão especificada.
Marque uma versão específica do MongoDB Enterprise.
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 não intencionais, fixe o pacote. Para fixar a versão do MongoDB na versão instalada atualmente, emita a seguinte sequência de comando:
echo "mongodb-enterprise hold" | sudo dpkg --set-selections echo "mongodb-enterprise-server hold" | sudo dpkg --set-selections echo "mongodb-enterprise-database hold" | sudo dpkg --set-selections echo "mongodb-mongosh hold" | sudo dpkg --set-selections echo "mongodb-enterprise-mongos hold" | sudo dpkg --set-selections echo "mongodb-enterprise-tools hold" | sudo dpkg --set-selections
Observação
Você também pode instalar o MongoDB Shell que usa o OpenSSL do sistema. Você já deve ter instalado o OpenSSL em seu sistema antes de instalar esta versão do MongoDB Shell.
Você pode instalar todos os pacotes MongoDB Enterprise e MongoDB Shell que usam o OpenSSL do sistema sem remover o MongoDB Shell primeiro. Por exemplo:
sudo apt-get install -y mongodb-enterprise mongodb-mongosh-shared-openssl11
O exemplo a seguir remove o MongoDB Shell e depois instala o MongoDB Shell que usa o OpenSSL 1,1 do sistema:
sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y mongodb-mongosh-shared-openssl11
O exemplo a seguir remove o MongoDB Shell e depois instala o MongoDB Shell que usa o OpenSSL 3 do sistema:
sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y mongodb-mongosh-shared-openssl3
Você também pode escolher os pacotes MongoDB para instalar.
O exemplo a seguir instala o MongoDB Enterprise e ferramentas, e o MongoDB Shell que utiliza o OpenSSL 1,1 do sistema:
sudo apt-get install -y mongodb-enterprise-database mongodb-enterprise-tools mongodb-mongosh-shared-openssl11
O exemplo a seguir instala o MongoDB Enterprise e ferramentas, e o MongoDB Shell que utiliza o OpenSSL 3 do sistema:
sudo apt-get install -y mongodb-enterprise-database mongodb-enterprise-tools mongodb-mongosh-shared-openssl3
Executar o MongoDB Enterprise Edition
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.
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.
Procedimento
Siga estas etapas para executar o MongoDB Enterprise Edition em seu sistema. Estas instruções pressupõem que você esteja usando o pacote oficial mongodb-enterprise
, não o pacote mongodb
não oficial fornecido pelo Debian, e estão 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 embutido 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.
Desinstalar MongoDB
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.
Pare o MongoDB.
Interrompa o processo mongod
com o seguinte comando:
sudo service mongod stop
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 que seja acessível aos clientes remotos.
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 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.
Pacotes do MongoDB Enterprise Edition
A edição MongoDB Enterprise 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-enterprise | Um metapackage que instala automaticamente os pacotes do componente listados abaixo. | ||||||||
mongodb-enterprise-database | Um
| ||||||||
mongodb-mongosh | Contém o Shell do MongoDB ( mongosh ). | ||||||||
mongodb-shared-openssl* | Contém o MongoDB Shell que usa a versão OpenSSL já instalada em seu computador ( mongosh ). | ||||||||
mongodb-enterprise-tools | Um
|