Overview
Utilice este tutorial para instalar MongoDB 9.0 Enterprise Edition en macOS utilizando el gestor de paquetes de terceros Homebrew.
La instalación de MongoDB mediante Homebrew también instala las herramientas de base de datos de MongoDB. Consulta la sección «Uso de las herramientas de base de datos de MongoDB» para obtener más información.
Considerations
Soporte de plataforma
MongoDB 9.0 Enterprise Edition es compatible con macOS 14 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, consulta el documento Notas de producción para implementaciones autogestionadas para obtener consideraciones de rendimiento y recomendaciones de configuración.
Antes de comenzar
Asegúrese de que su sistema cumpla con cada uno de los siguientes requisitos previos. Solo necesita realizar cada paso previo una vez en su sistema. Si ya ha realizado los pasos previos como parte de una instalación anterior de MongoDB usando Homebrew, puede saltar directamente al procedimiento de instalación.
Instalar las herramientas de línea de comandos de Xcode
Homebrew requiere las herramientas de línea de comandos de Xcode de Apple.
Para instalar las herramientas de línea de comandos de Xcode, ejecute el siguiente comando:
xcode-select --install
Instale Homebrew
macOS does not include the Homebrew brew package by default.
Para instalar Homebrew, siga las instrucciones de instalación oficiales de Homebrew.
Instale MongoDB Enterprise Edition
Para instalar MongoDB Enterprise Edition usando Homebrew, siga los siguientes pasos:
Añade el repositorio Homebrew de MongoDB.
El repositorio Homebrew de MongoDB pone a disposición en su sistema las fórmulas oficiales de Homebrew para MongoDB y las herramientas de bases de datos.
Para agregar el repositorio de MongoDB para Homebrew, ejecute el siguiente comando:
brew tap mongodb/brew
Luego, marque el grifo como de confianza:
brew trust mongodb/brew
Si ya lo ha hecho en una instalación anterior de MongoDB, puede omitir este paso.
Tip
Alternativamente, puede especificar una versión anterior de MongoDB si lo desea. También puede mantener múltiples versiones de MongoDB en paralelo de esta manera.
Tip
Si previamente instaló una versión anterior de la fórmula, es posible que encuentre un error ChecksumMismatchError. Para solucionarlo, consulte la sección de solución de problemas de ChecksumMismatchError.
Ejecute MongoDB Enterprise Edition
Siga estos pasos para ejecutar MongoDB Enterprise Edition. Estas instrucciones suponen que se utilizan los ajustes por defecto.
Puedes ejecutar MongoDB como un servicio de macOS usando brew, o puedes ejecutar MongoDB manualmente como un proceso en segundo plano.
Nota
En los sistemas macOS que hayan instalado MongoDB mediante el método de instalación Homebrew, es posible que el límite de archivos abiertos no se establezca automáticamente al iniciar MongoDB a través de brew services. Es posible que deba configurar manualmente los valores de ulimit.
Consulta Ajustes Ulimit para obtener más información.
Para ejecutar
mongodmanualmente como un proceso en segundo plano usando un archivo de configuración:Si su implementación no utiliza conexiones TLS, utilice la opción
--fork:Para macOS ejecutándose en procesadores Intel, ejecute:
mongod --config /usr/local/etc/mongod.conf --fork Para macOS con procesadores Apple Silicon, ejecuta:
mongod --config /opt/homebrew/etc/mongod.conf --fork
Si su implementación utiliza conexiones TLS, utilice GNU Screen.
Para macOS con procesadores Apple Silicon:
Para ejecutar
mongodmanualmente como un proceso en segundo plano especificando--dbpathy--logpathen la línea de comandos, ejecute:mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork Para detener un
mongodque se ejecuta como proceso en segundo plano, conéctate almongodusando mongosh, y ejecuta el comandoshutdown, según sea necesario.
Ambos métodos utilizan el archivo mongod.conf creado durante la instalación. También puede añadir sus propias opciones de configuración de MongoDB a este archivo.
Nota
MacOS impide que mongod se abra
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:
Abre Configuración del sistema
Haz clic en Privacidad y seguridad en la barra lateral.
En la sección Seguridad, haz clic en el botón Open Anyway a la derecha del mensaje sobre
mongod.
To verify that MongoDB is running, perform one of the following:
Si inició MongoDB como un servicio de macOS:
brew services list Debería ver el servicio
mongodb-enterpriselistado comostarted.Si se inició MongoDB manualmente como un proceso en segundo plano:
ps aux | grep -v grep | grep mongod Debería ver su proceso
mongoden la salida.
También puede ver la entrada de registro para ver el estado actual de su proceso mongod: /usr/local/var/log/mongodb/mongo.log.
Connect and Use MongoDB
Para comenzar a utilizar MongoDB, conecte mongosh a la instancia en ejecución. Desde un nuevo terminal, ejecute lo siguiente:
mongosh
Para obtener información sobre las operaciones CRUD (Crear, leer, actualizar, borrar), consulte:
Información Adicional
Vinculación a localhost por defecto
Por defecto, MongoDB se inicia con bindIp establecido en 127.0.0.1, que se vincula a la interfaz de red localhost. Esto significa que mongod solo puede aceptar conexiones de clientes que se ejecutan en el mismo equipo. Los clientes remotos no podrán conectarse a mongod, y mongod no podrá inicializar un set de réplicas a menos que este valor se establezca en una interfaz de red válida.
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.
Binarios incluidos
La instalación incluye los siguientes binarios:
Nota
La instalación también incluye las herramientas de base de datos MongoDB. Consulte la sección «Uso de las herramientas de base de datos MongoDB» para obtener más información.
Rutas de archivos
Además, la instalación crea los siguientes archivos y directorios en la ubicación especificada a continuación, dependiendo del hardware de su Apple:
Procesador Intel | Apple Silicon Processor | |
|---|---|---|
|
| |
|
| |
|
|
Consulte la documentación de Apple para obtener la lista actual de hardware de Apple que utiliza el procesador Apple Silicon. También puede ejecutar el siguiente comando para comprobar dónde brew ha instalado estos archivos y directorios:
brew --prefix