Nota
MongoDB Atlas
MongoDB Atlas es una opción de servicio MongoDB alojado en la nube que no requiere instalación y ofrece un nivel gratuito para comenzar.
Overview
Utiliza este tutorial para instalar MongoDB 7.0 de forma manual Community Edition en macOS usando un tarball .tgz descargado.
Versión de MongoDB
Este tutorial instala MongoDB 7.0 Community Edition. Para instalar una versión diferente de MongoDB Community, utilice el menú desplegable de versiones en la esquina superior izquierda de esta página para seleccionar la documentación correspondiente.
Método de instalación
Aunque MongoDB se puede instalar manualmente mediante un tarball .tgz descargado, como se describe en este documento, se recomienda utilizar el administrador de paquetes brew del sistema para instalar MongoDB, si es posible. El uso de un administrador de paquetes instala automáticamente todas las dependencias necesarias, proporciona un archivo mongod.conf de ejemplo para que comience y simplifica las tareas futuras de actualización y mantenimiento.
➤ Ver Instale MongoDB usando el Administrador de paquetes brew para obtener instrucciones.
Considerations
MongoDB Shell, mongosh
Cuando utilice el paquete .tgz para instalar el servidor, debe seguir las instrucciones de instalación de mongosh para descargar e instalar mongosh por separado.
Soporte de plataforma
MongoDB 7.0 Community Edition es compatible con macOS 11 o posterior y requiere una arquitectura de CPU Haswell o más reciente.
Para obtener más información, consulte Soporte de la plataforma.
Notas de producción
Antes de implementar MongoDB en un entorno de producción, considera el documento Notas de Producción para Implementaciones Autogestionadas, que ofrece consideraciones de rendimiento y recomendaciones de configuración para implementaciones de MongoDB en producción.
Instale MongoDB Community Edition
Para instalar manualmente MongoDB Community Edition desde el .tgz, seleccione la pestaña que corresponda al procesador de su Mac y complete los siguientes pasos:
Descarga el archivo tarball.
Descarga el archivo tarball de MongoDB Community tgz desde el siguiente enlace:
En el Version En el menú desplegable, seleccione la versión de MongoDB que desea descargar.
En el menú desplegable Platform, selecciona macOS.
En el menú desplegable Package, selecciona tgz.
Haga clic en Download.
Asegúrese de que los archivos binarios estén en un directorio indicado en su PATH variable de entorno.
Los binarios de MongoDB están en el directorio bin/ del archivo tarball. Puedes elegir entre:
Se deben copiar los binarios en un directorio que aparezca en la variable
PATH, como/usr/local/bin. Se debe sustituir/path/to/the/mongodb-directory/por el directorio de instalación.sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/ Se deben crear enlaces simbólicos a los binarios desde un directorio que aparezca en la variable
PATH, como/usr/local/bin. Se debe sustituir/path/to/the/mongodb-directory/por el directorio de instalación.sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
Descarga el archivo tarball.
Descarga el archivo tarball de MongoDB Community tgz desde el siguiente enlace:
En el menú desplegable Version, selecciona la versión de MongoDB que deseas descargar.
En el menú desplegable Platform, selecciona macOS ARM 64.
En el menú desplegable Package, selecciona tgz.
Haga clic en Download.
Asegúrese de que los archivos binarios estén en un directorio indicado en su PATH variable de entorno.
Los binarios de MongoDB están en el directorio bin/ del archivo tarball. Puedes elegir entre:
Se deben copiar los binarios en un directorio que aparezca en la variable
PATH, como/usr/local/bin. Se debe sustituir/path/to/the/mongodb-directory/por el directorio de instalación.sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/ Se deben crear enlaces simbólicos a los binarios desde un directorio que aparezca en la variable
PATH, como/usr/local/bin. Se debe sustituir/path/to/the/mongodb-directory/por el directorio de instalación.sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
Ejecute MongoDB Community Edition
- Consideraciones sobre ulimit
- La mayoría de los sistemas operativos similares a Unix limitan los recursos del sistema que un proceso puede utilizar. Estos límites pueden tener un impacto negativo en la operación de MongoDB y deben ajustarse. Se debe consultar Configuraciones de UNIX
ulimitpara implementaciones autogestionadas y conocer las configuraciones recomendadas para la plataforma.Nota
Si el valorulimitpara el número de archivos abiertos es inferior a64000, MongoDB genera una advertencia de inicio.
Procedimiento
Se deben seguir estos pasos para ejecutar MongoDB Community Edition. Estas instrucciones asumen que se está utilizando la configuración por defecto.
Crear el directorio de datos.
Antes de iniciar MongoDB por primera vez, debe crear el directorio en el que el proceso escribirá los mongod datos.
Por ejemplo, para crear el directorio ~/data/db:
sudo mkdir -p ~/data/db
Establecer permisos para los directorios de datos y registros.
Asegúrese de que la cuenta de usuario que ejecuta mongod tenga permisos de lectura y escritura para estos dos directorios. Si ejecuta con su propia cuenta de usuario y acaba de crear los dos directorios anteriores, ya deberían ser accesibles para su usuario. De lo contrario, puede mongod usar chown para establecer la propiedad, sustituyendo al usuario correspondiente:
sudo chown <user> ~/data/db sudo chown <user> ~/data/log/mongodb
Ejecuta MongoDB.
Para ejecutar MongoDB, ejecute el proceso en el símbolo del sistema, proporcionando los mongod parámetros dbpath y logpath mencionados anteriormente, y el fork parámetro para ejecutar mongod en segundo plano. Como alternativa, puede almacenar los valores dbpath logpathforkde,, y muchos otros parámetros en un archivo de configuración.
Ejecutar mongod con parámetros de línea de comandos
Ejecute el proceso en el indicador del sistema, proporcionando los tres parámetros necesarios directamente en la línea de mongod comandos:
mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork
Ejecutar mongod con un archivo de configuración
Ejecuta el proceso mongod en el indicador del sistema, especificando la ruta a un archivo de configuración con el parámetro config:
mongod --config /usr/local/etc/mongod.conf
MacOS puede impedir que mongod se ejecute después de la instalación. Si recibe un error de seguridad al iniciar mongod que indica que el desarrollador no pudo ser identificado o verificado, haga lo siguiente para conceder acceso a mongod para ejecutar:
Abra Preferencias del sistema
Seleccione el panel Seguridad y privacidad.
En la pestaña General, haga clic en el botón a la derecha del mensaje sobre
mongod, etiquetado como Open Anyway o Allow Anyway según su versión de macOS.
Comienza a utilizar MongoDB.
Inicie una sesiónmongoshen el mismo host quemongod. Puede ejecutarmongoshsin opciones de línea de comandos para conectarse a unmongodque se ejecuta en su host local con el puerto predeterminado27017:
mongosh
Para obtener más información sobre cómo conectarse usando mongosh, por ejemplo, para conectarse a una instancia mongod que se ejecuta en un host y/o puerto diferente, consulta la documentación de mongosh.
Para ayudarle a empezar a usar MongoDB, MongoDB ofrece guías de inicio en varias ediciones del controlador. Consulte "Introducción a MongoDB" para conocer las ediciones disponibles.
Información Adicional
Vinculación a localhost por defecto
By default, MongoDB launches with bindIp set to 127.0.0.1, which binds to the localhost network interface. This means that the mongod can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod, and the mongod will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.
Este valor se puede configurar:
en el archivo de configuración de MongoDB con
bindIp, omediante el argumento de la línea de comandos
--bind_ip
Advertencia
Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.
Para obtener más información sobre cómo configurar bindIp, consulta Vinculación de IP en Implementaciones Autogestionadas.