Como Instalar o MongoDB no Debian 12

MongoDB é um sistema de banco de dados NoSQL (não-SQL ou Não-Relacional) de código aberto, multiplataforma e distribuído. Em vez de armazenar dados em tabelas como bancos de dados SQL tradicionais, o MongoDB usa documentos flexíveis para armazenar várias formas de dados. O MongoDB utiliza o formato JSON binário, BSON, para armazenar dados.

O MongoDB é um banco de dados NoSQL distribuído com alta disponibilidade embutida, failover automático e redundância de dados, além de escalabilidade horizontal via sharding em clusters distribuídos, e suporta implantação geográfica em múltiplas regiões. O MongoDB também fornece uma API de consulta que suporta operações CRUD (ler e escrever), pipeline de agregação de dados, busca de texto e consultas geoespaciais.

Neste tutorial, você aprenderá como instalar o MongoDB em um servidor Debian 12. Você também aprenderá como habilitar a autenticação do MongoDB, usar o cliente ‘mongosh’ do MongoDB e usar consultas básicas para criar um novo usuário e banco de dados no MongoDB.

Pré-requisitos

Para começar este tutorial, certifique-se de que você tem o seguinte:

Um servidor Debian 12
Um usuário não-root com privilégios de administrador

Preparando o servidor Debian

Antes de instalar o MongoDB no seu servidor Debian, é recomendado aplicar as seguintes configurações:

Desabilitar transparent huge pages (THP) via o script systemd
Aumentar os limites padrão para o usuário do MongoDB
Habilitar swapiness e aumentar a memória max_mmap via o arquivo ‘ /etc/sysctl.conf ‘

Agora vamos configurar o servidor Debian.

Primeiro, execute o comando ‘ nano ‘ abaixo para criar um novo arquivo de serviço /etc/systemd/system/disable-thp.service.

sudo nano /etc/systemd/system/disable-thp.service

Cole o seguinte script de serviço para configurar o ‘ transparent_hugepage ‘ para ‘ never ‘.

[Unit]  
Description=Disable Transparent Huge Pages (THP)  
  
[Service]  
Type=simple  
ExecStart=/bin/sh -c "echo 'never' > /sys/kernel/mm/transparent_hugepage/enabled && echo 'never' > /sys/kernel/mm/transparent_hugepage/defrag"  
  
[Install]  
WantedBy=multi-user.target

Salve o arquivo e saia.

Agora execute o seguinte comando ‘ systemctl ‘ para recarregar o gerenciador systemd. Em seguida, inicie e habilite o serviço ‘ disable-thp ‘. Com isso, o ‘ transparent_hugepage ‘ será desabilitado em cada inicialização do sistema.

sudo systemctl daemon-reload  
sudo systemctl enable --now disable-thp.service

Em seguida, crie um novo arquivo /etc/security/limits.d/mongodb.conf com o editor ‘ nano ‘.

sudo nano /etc/security/limits.d/mongodb.conf

Insira a configuração abaixo para definir os limites máximos de processo e arquivo para ‘ 64000 ‘ para o usuário ‘ mongod ‘.

mongod soft nproc 64000  
mongod hard nproc 64000  
mongod soft nofile 64000  
mongod hard nofile 64000

Quando terminar, salve o arquivo e saia.

Depois disso, edite o arquivo ‘ /etc/sysctl.conf ‘ com o seguinte.

sudo nano /etc/sysctl.conf

Insira a configuração abaixo no final da linha.

fs.file-max = 2097152  
vm.max_map_count = 262144  
vm.swappiness = 1

Salve o arquivo e saia.

Por último, execute o comando ‘ sysctl ‘ abaixo para aplicar as mudanças no arquivo ‘ /etc/sysctl.conf ‘ imediatamente.

sudo sysctl -p

setup system

Instalando o servidor MongoDB no Debian

Agora que você configurou seu servidor Debian, vamos iniciar a instalação do MongoDB. Neste caso, você instalará o MongoDB 7.0 através do repositório oficial do MongoDB no seu servidor Debian.

Instale os pacotes ‘ gnupg ‘ e ‘ curl ‘ no seu sistema Debian com o seguinte:

sudo apt install gnupg curl

install gnupe curl

Agora adicione a chave GPG do MongoDB e o repositório para Debian com o comando abaixo. Neste caso, você configurará um repositório para o MongoDB 7.0.

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

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

add repo

Em seguida, execute o comando ‘ apt ‘ abaixo para atualizar sua lista de pacotes e instalar o pacote ‘mongodb-org’.

sudo apt update && sudo apt install mongodb-org -y

Na saída a seguir, você pode ver a instalação do MongoDB.

install mongodb

Após a instalação ser concluída, recarregue o gerenciador systemd com o comando ‘systemctl’.

sudo systemctl daemon-reload

Inicie e habilite o serviço ‘mongod’, em seguida, verifique para garantir que o serviço está em execução.

sudo systemctl enable --now mongod  
sudo systemctl status mongod

Se o MongoDB estiver em execução, você verá uma saída como a seguinte:

check mongodb

Protegendo o servidor MongoDB com autenticação

Com o MongoDB instalado, você precisa proteger sua instalação habilitando a autenticação do MongoDB. Nesta seção, você configurará a autenticação do MongoDB e criará um novo usuário administrador para o MongoDB. Isso mostrará como usar ‘ mongosh ‘ ou cliente MongoDB e consultas básicas do MongoDB.

Faça login no servidor MongoDB com o comando ‘ mongosh ‘ abaixo. Não há senha para a instalação padrão do MongoDB.

mongosh

Execute o comando ‘ disableTelemetry() ‘ para desabilitar a coleta de dados anônimos do MongoDB.

disableTelemetry()

Mude para o banco de dados ‘ admin ‘ com a consulta ‘ use ‘.

use admin

Agora execute a seguinte consulta para criar um novo usuário ‘ myAdmin ‘ que será usado como administrador do seu servidor MongoDB. Digite sua senha quando solicitado.

db.createUser(  
{  
user: "myAdmin",  
pwd: passwordPrompt(),  
roles: [  
{ role: "userAdminAnyDatabase", db: "admin" },  
{ role: "readWriteAnyDatabase", db: "admin" }  
]  
}  
)

Digite o comando ‘ quit() ‘ para sair do servidor MongoDB.

quit()

create user

Em seguida, edite o arquivo ‘ /etc/mongod.conf ‘ com o editor ‘ nano ‘.

sudo nano /etc/mongod.conf

Descomente a opção ‘ security ‘ e adicione ‘ authorization: enabled ‘ para habilitar a autenticação no MongoDB.

security:  
  authorization: enabled

Salve o arquivo e saia do editor.

Agora execute o comando ‘ systemctl ‘ abaixo para reiniciar o servidor MongoDB e aplicar suas modificações.

sudo systemctl restart mongod

Testando a Autenticação do MongoDB

Agora que você criou um usuário admin e habilitou a autenticação no seu servidor MongoDB. Vamos verificar sua configuração fazendo login no servidor MongoDB através do usuário ‘myAdmin’.

Execute o comando ‘ mongosh ‘ abaixo para fazer login no servidor MongoDB como um usuário de ‘myAdmin’ e insira sua senha quando solicitado.

mongosh --port 27017 --authenticationDatabase \  
"admin" -u "myAdmin" -p

Após fazer login, execute a seguinte consulta para verificar o status da conexão com o servidor MongoDB.

db.runCommand({connectionStatus : 1})

Você pode ver abaixo que você se conectou como usuário ‘ myAdmin ‘ ao servidor MongoDB.

check connection

Criando o primeiro banco de dados e usuário

Nesta seção, você criará um novo banco de dados e usuário que serão usados para sua aplicação através do cliente ‘mongosh’ do MongoDB. Portanto, certifique-se de que você está no ambiente ‘ mongosh ‘.

Primeiro, execute a consulta ‘ use ‘ para criar e mudar para o banco de dados alvo. Neste exemplo, você criará um novo banco de dados ‘ mydb ‘. Seu prompt do MongoDB mudará para ‘ mydb ‘.

use mydb

Agora execute a seguinte consulta para criar um novo usuário ‘myUser’ com privilégios para ler e escrever no banco de dados ‘ mydb ‘. Insira uma nova senha quando solicitado.

use mydb  
db.createUser(  
{  
user: "myUser",  
pwd: passwordPrompt(),  
roles: [ { role: "readWrite", db: "mydb" },  
{ role: "read", db: "reporting" } ]  
}  
)

create new database and user

Em seguida, execute as seguintes consultas para mudar para o banco de dados ‘ admin ‘ e verificar a lista de usuários no seu servidor MongoDB.

use admin  
db.system.users.find()

Você deve ver os usuários ‘ myAdmin ‘ e ‘ myUser ‘ criados como a seguinte:

Agora digite ‘ quit() ‘ para sair do servidor MongoDB.

listing users

Por último, faça login no servidor MongoDB como um novo usuário ‘ myUser ‘ no banco de dados ‘ mydb ‘ com o comando abaixo. Insira sua senha quando solicitado.

mongosh --port 27017 -u "myUser" \  
--authenticationDatabase "mydb" -p

Execute a consulta abaixo para verificar sua conexão atual

db.runCommand({connectionStatus : 1})

Na seção ‘ authInfo ‘, você pode ver que você se autenticou como usuário ‘ myUser ‘ e banco de dados ‘ mydb ‘.