Cómo instalar y asegurar MongoDB en Ubuntu 24.04

MongoDB es un sistema de base de datos NoSQL (no SQL o no relacional) de código abierto, multiplataforma y distribuido. En lugar de almacenar datos en tablas como las bases de datos SQL tradicionales, MongoDB utiliza documentos flexibles para almacenar varias formas de datos. MongoDB utiliza el formato JSON binario, BSON, para almacenar datos.

MongoDB es una base de datos NoSQL distribuida con alta disponibilidad incorporada, conmutación por error automática y redundancia de datos, y escalado horizontal a través de fragmentación en clústeres distribuidos. Soporta despliegue geográfico en múltiples regiones y proporciona una API de consulta que admite operaciones CRUD (lectura y escritura), canalización de agregación de datos, búsqueda de texto y consultas geoespaciales.

En esta guía, te mostraremos cómo instalar MongoDB en un servidor Ubuntu 24.04. Estarás preparando tu servidor Ubuntu, agregando el repositorio de MongoDB, instalando el servidor MongoDB, creando un administrador para MongoDB y luego habilitando la autenticación de MongoDB. Por último, aprenderás a crear un usuario y una base de datos en MongoDB utilizando el shell ‘mongosh’.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

Un servidor Ubuntu 24.04
Un usuario no root con privilegios de administrador

Preparando el sistema

Antes de instalar MongoDB en tu sistema Ubuntu, asegúrate de haber configurado tu sistema. En este caso, estarás configurando el servidor Ubuntu con lo siguiente:

Desactivar Transparent Huge Pages a través de systemd
Aumentar los límites para el usuario predeterminado ‘mongod’
Configurar el máximo fs.file-max y habilitar swappiness a través del archivo ‘ /etc/systctl.conf ‘

Desactivar Transparent Huge Pages (THP)

Para desactivar THP en tu sistema, crearás un nuevo archivo de servicio systemd que se ejecutará automáticamente en cada arranque o inicio.

Crea un nuevo archivo de servicio ‘/etc/systemd/system/disable-thp.service‘ con el editor ‘nano’.

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

Inserta la siguiente configuración para desactivar THP a través del servicio.

[Unit]  
Description=Desactivar 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

Guarda el archivo y sal del editor.

Ahora ejecuta el comando ‘ systemctl ‘ a continuación para recargar el administrador systemd, iniciar y habilitar el servicio ‘ disable-thp ‘. Con esto, THP estará desactivado al inicio del sistema.

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

Configurando Ulimits

Después de haber desactivado THP, necesitas aumentar el máximo predeterminado de archivos y procesos para el usuario ‘mongod’ a al menos ‘ 64000 ‘.

Crea un nuevo archivo ‘/etc/security/limits.d/mongodb.conf‘ con el siguiente comando del editor ‘nano’.

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

Inserta la siguiente configuración para aumentar el máximo de archivos abiertos y procesos a ‘ 64000 ‘.

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

Guarda el archivo y sal del editor.

Configurar swappiness y fs.file-max

Por último, necesitarás aumentar el predeterminado ‘ fs.file-max ‘ y habilitar swappiness para MongoDB. Para hacer eso, editarás el archivo ‘ /etc/sysctl.conf ‘.

Abre el archivo ‘ /etc/sysctl.conf ‘ con el comando del editor ‘nano’.

sudo nano /etc/sysctl.conf

Inserta la siguiente configuración para configurar fs.file-max y habilitar swappiness.

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

Cuando termines, guarda el archivo y sal del editor.

Ahora ejecuta el comando ‘ sysctl ‘ a continuación para aplicar tus cambios sin reiniciar.

sudo sysctl -p

setup system

Instalando MongoDB con el gestor de paquetes APT

Ahora que has configurado tu sistema Ubuntu, estás listo para instalar MongoDB. En esta sección, estarás instalando la última versión de MongoDB 8.0 desde el repositorio oficial de MongoDB.

Primero, ejecuta el comando ‘ apt ‘ a continuación para actualizar tu índice de paquetes de Ubuntu e instalar los paquetes ‘ gnupg ‘ y ‘ curl ‘. Ingresa ‘ Y ‘ para confirmar la instalación.

sudo apt update && sudo apt install gnupg curl

install curl

Ahora ejecuta el siguiente comando para agregar la clave GPG y el repositorio para MongoDB. En este ejemplo, estarás instalando MongoDB 8 en tu servidor Ubuntu 24.04.

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

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

install mongodb

A continuación, ejecuta el comando ‘ apt ‘ a continuación para actualizar tu índice de paquetes e instalar el paquete ‘ mongodb-org ‘ en tu sistema. Ingresa ‘ Y ‘ para continuar con la instalación.

sudo apt update && sudo apt install mongodb-org

install mongodb

Después de que la instalación se complete, ejecuta el comando ‘ systemctl ‘ a continuación para recargar el administrador systemd. El servicio ‘ mongod ‘ se ha agregado a tu sistema Ubuntu.

sudo systemctl daemon-reload

Por último, ejecuta el comando a continuación para iniciar, habilitar y verificar el servicio ‘ mongod ‘ de MongoDB. Verás que MongoDB está funcionando en tu sistema.

sudo systemctl enable --now mongod  
sudo systemctl status mongod

check mongodb service

Asegurando el servidor MongoDB

Después de instalar MongoDB, asegurarás la instalación del servidor MongoDB con lo siguiente:

Crear un nuevo usuario administrador para MongoDB utilizando el shell ‘ mongosh ‘
Habilitar la autenticación de MongoDB editando el archivo de configuración ‘ /etc/mongod.conf ‘

Creando un usuario administrador de MongoDB

En esta sección, estarás creando un nuevo usuario administrador de MongoDB a través del shell ‘mongosh’. El shell ‘mongosh’ es una línea de comandos de cliente para interactuar con el servidor MongoDB, es como ‘mysql’ para MySQL/MariaDB y ‘psql’ para PostgreSQL.

Para crear un usuario administrador, inicia sesión en el servidor MongoDB con el comando del shell ‘ mongosh ‘ a continuación.

mongosh

Ahora ejecuta la siguiente consulta para desactivar la telemetría de MongoDB.

disableTelemetry()

A continuación, ve a la base de datos ‘ admin ‘ y ejecuta las siguientes consultas para crear un nuevo usuario administrador para MongoDB. En este ejemplo, estarás creando un nuevo usuario ‘ myAdmin ‘, luego ingresa tu nueva contraseña cuando se te pida.

use admin

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

Ahora escribe ‘ quit() ‘ para salir del shell de MongoDB.

create admin

Habilitar la autenticación de MongoDB

Ahora que has creado un usuario administrador de MongoDB, estás listo para habilitar la autenticación de MongoDB a través del archivo ‘ /etc/mongod.conf ‘.

Abre la configuración predeterminada del servidor MongoDB ‘ /etc/mongod.conf ‘ con el siguiente comando del editor ‘nano’.

sudo nano /etc/mongod.conf

Agrega las siguientes líneas para habilitar la autenticación en MongoDB.

security:  
authorization: enabled

Cuando termines, guarda el archivo y sal del editor.

Ahora ejecuta el comando ‘ systemctl ‘ a continuación para reiniciar el servidor MongoDB y aplicar tus cambios. Con esto, la autenticación de MongoDB estará habilitada.

sudo systemctl restart mongod

Probar la autenticación de MongoDB

Ahora que has asegurado la instalación del servidor MongoDB, verifiquemos tu configuración iniciando sesión en MongoDB con el shell ‘mongosh’ y el nuevo usuario administrador y contraseña.

Inicia sesión en el servidor MongoDB como usuario ‘ myAdmin ‘ con el comando ‘ mongosh ‘ a continuación. Ingresa tu contraseña cuando se te pida.

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

Una vez que hayas iniciado sesión, ejecuta la consulta a continuación para verificar el estado de tu conexión. Deberías haber iniciado sesión en el servidor MongoDB con el usuario ‘ myAdmin ‘.

db.runCommand({connectionStatus : 1})

Ahora escribe ‘ quit() ‘ para salir del servidor MongoDB.

check connection

Creando una base de datos y un usuario en MongoDB

En esta sección, aprenderás cómo crear una nueva base de datos y un usuario en MongoDB utilizando el shell ‘mongosh’. Así que asegúrate de haber iniciado sesión en MongoDB como un usuario administrador.

Primero, ejecuta la consulta a continuación para moverte a la base de datos ‘ mydb ‘.

use mydb

Ahora ejecuta la siguiente consulta para crear un nuevo usuario ‘ myUser ‘ y permitir acceso de lectura y escritura a la base de datos ‘ mydb ‘. Ingresa tu contraseña cuando se te pida.

db.createUser(  
{  
user: "myUser",  
pwd: passwordPrompt(), // o contraseña en texto claro  
roles: [ { role: "readWrite", db: "mydb" },  
{ role: "read", db: "reporting" } ]  
}  
)

Escribe ‘ quit() ‘ para salir del servidor MongoDB.

create database and user

Ahora ejecuta el comando ‘mongosh’ a continuación para iniciar sesión como ‘ myUser ‘ en la base de datos ‘ mydb ‘. Ingresa tu contraseña cuando se te pida.

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

Una vez que hayas iniciado sesión, verifica el estado de tu conexión utilizando la siguiente consulta.

db.runCommand({connectionStatus : 1})

Puedes ver a continuación que te has conectado al servidor MongoDB con el usuario ‘myUser’ y privilegios a la base de datos ‘ mydb ‘.