Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Instale o MongoDB Enterprise Edition no Debian

Use este tutorial para instalar o MongoDB 9.0 Enterprise Edition usando o gerente de pacotes APT.

O MongoDB Enterprise Edition está disponível em plataformas selecionadas e é compatível com recursos relacionados à segurança e monitoramento.

Este tutorial instala o MongoDB 9.0 Enterprise Edition. Para instalar uma versão diferente do MongoDB Enterprise, use o menu suspenso de versão na barra lateral e selecione a documentação para essa versão.

MongoDB 9.0 A edição Enterprise suporta as seguintes versões Debian 64bits na arquitetura x86_64 :

  • Debian 13 "Trixie"

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, consulte o documento Notas de produção para implementações autogerenciadas para obter considerações de desempenho e recomendações de configuração.

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

Importante

O pacote mongodb fornecido pela Debian não é mantido pela MongoDB Inc. e entra em conflito com o pacote oficial mongodb-enterprise. 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.

Siga estas etapas para instalar o MongoDB Enterprise 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://pgp.mongodb.com/server-9.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-9.gpg \ --dearmor
2

Crie o arquivo de lista para Debian 13 (Trixie):

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-9.gpg ] https://repo.mongodb.com/apt/debian trixie/mongodb-enterprise/9.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
3

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

sudo apt-get update
4

Para instalar a versão estável mais recente, execute o seguinte comando:

sudo apt-get install -y mongodb-enterprise

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 -ymongodb-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 -ymongodb-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-databasemongodb-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-databasemongodb-enterprise-tools mongodb-mongosh-shared-openssl3

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 usando o gerenciador de pacote , esses diretórios padrão serão criados durante a instalação.

Se você instalou manualmente baixando os tarballs, crie os diretórios usando mkdir -p <directory> ou sudo mkdir -p <directory> dependendo do usuário que executará o MongoDB. Consulte 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 UNIX ulimit Configurações para implantações autogerenciadas 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 a edição MongoDB Enterprise 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,mongod use o sistema de inicialização integrado do seu sistema operacional. Versões recentes do Linux utilizam systemd, que utiliza o comando systemctl, enquanto versões mais antigas do Linux utilizam init do Sistema V, 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.

1

Você pode iniciar o processo mongod emitindo o seguinte comando:

sudo systemctl start mongod

Se receber um erro semelhante ao seguinte ao iniciar o mongod:

Failed to start mongod.service: Unit mongod.service not found.

Execute o seguinte comando primeiro:

sudo systemctl daemon-reload

Em seguida, execute o comando de inicialização acima novamente.

2
sudo systemctl status mongod

Opcionalmente, você pode garantir que o MongoDB iniciará após reinicialização do sistema emitindo o seguinte comando:

sudo systemctl enable mongod
3

Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:

sudo systemctl stop mongod
4

Você pode reiniciar o processo mongod emitindo o seguinte comando:

sudo systemctl restart mongod

Você pode acompanhar o estado do processo em busca de erros ou mensagens importantes observando o resultado no arquivo /var/log/mongodb/mongod.log.

5

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 que esteja sendo executado em seu host local com a porta padrão 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 ajudá-lo a começar a usar o MongoDB, o MongoDB fornece Guias de Introdução em várias edições de driver. Para obter a documentação do driver, consulte Iniciar o desenvolvimento com o 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 a instância mongod só aceita conexões de clientes que estejam sendo executados na mesma máquina. Para permitir que clientes remotos acessem a instância mongod ou para inicializar um conjunto de réplicas na instância, você deve vincular mongod a uma interface de rede acessível publicamente.

Para vincular a interface de rede, use a configuração bindIp no arquivo de configuração ou inicie o mongod com a opção de 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.

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 metapackage que instala automaticamente os pacotes do componente listados abaixo:

  • mongodb-enterprise-server: contém o daemon mongod e as configurações associadas e scripts de inicialização.

  • mongodb-enterprise-mongos: contém o daemon mongos.

  • mongodb-enterprise-cryptd: contém o binário mongocryptd.

mongodb-mongosh

Contém o MongoDB Shell (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 metapackage que instala automaticamente os pacotes do componente listados abaixo: