Overview
Utiliza este tutorial para instalar MongoDB 8.0 Community Edition en macOS usando el administrador de paquetes de terceros Homebrew.
A partir de MongoDB 4.4.1, al instalar MongoDB a través de Homebrew también se instalan MongoDB Database Tools. Consulta Usar MongoDB Database Tools para obtener más información.
Versión de MongoDB
Este tutorial instala MongoDB 8.0 Community Edition. Para instalar una versión diferente de MongoDB Community, utiliza el menú desplegable de versión en la esquina superior izquierda de esta página para seleccionar la documentación de esa versión.
Considerations
Soporte de plataforma
MongoDB 8.0 La edición Community Edition admite macOS 14 o una versión posterior en sistemas Intel de 64bits (x86_64, Haswell o más recientes) y Apple Silicon (arm64).
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.
Instale MongoDB Community Edition
Requisitos previos
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.
Install Xcode Command-Line Tools
Homebrew requiere las herramientas de línea de comandos de Xcode de Apple.
Instale las herramientas de línea de comandos de Xcode ejecutando el siguiente comando en su Terminal de macOS:
xcode-select --install
Instale Homebrew
macOS does not include the Homebrew brew package by default.
- Instala
brewusando las instrucciones oficiales de instalación de Homebrew.
Instalando MongoDB 8.0 Community Edition
Siga estos pasos para instalar MongoDB Community Edition usando el administrador de paquetes brew de Homebrew. Asegúrese de haber seguido los prerrequisitos de instalación mencionados anteriormente antes de proceder.
Tocar MongoDB Homebrew Tap para descargar la fórmula oficial de Homebrew para MongoDB y las Database Tools, mediante el siguiente comando en el terminal de macOS:
brew tap mongodb/brew Luego, marque el grifo como una fuente confiable:
brew trust mongodb/brew Si ya lo ha hecho en una instalación anterior de MongoDB, puede omitir este paso.
To update Homebrew and all existing formulae:
brew update Para instalar MongoDB, ejecute el siguiente comando en su aplicación Terminal de macOS:
brew install mongodb-community@8.0
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 has instalado previamente una versión anterior de la fórmula, puedes encontrarte con un ChecksumMismatchError. Para resolverlo, consulta Solución de problemas de ChecksumMismatchError.
La instalación incluye los siguientes binarios:
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 | |
|---|---|---|
|
| |
|
| |
|
|
See Apple's documentation for the current list of Apple hardware using the Apple Silicon processor. You can also run the following command to check where brew has installed these files and directories:
brew --prefix
A partir de MongoDB 4.4.1, la instalación también incluye MongoDB Database Tools. Consulta Usar MongoDB Database Tools para obtener más información.
Ejecute MongoDB Community Edition
Se deben seguir estos pasos para ejecutar MongoDB Community Edition. Estas instrucciones asumen que se está utilizando la configuración por defecto.
You can run MongoDB as a macOS service using brew, or you can run MongoDB manually as a background process. It is recommended to run MongoDB as a macOS service, as doing so sets the correct system ulimit values automatically (see ulimit settings for more information).
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 To stop a
mongodrunning as a background process, connect to themongodusing mongosh, and issue theshutdowncommand as needed.
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-communitylistado 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
To begin using MongoDB, connect mongosh to the running instance. From a new terminal, issue the following:
mongosh
For information on CRUD (Create,Read,Update,Delete) operations, see:
Uso de las Database Tools de MongoDB
A partir de MongoDB 4.4.1, al instalar MongoDB a través de brew, también se instalan las Database Tools de MongoDB.
The MongoDB Database Tools are a collection of command-line utilities for working with a MongoDB deployment, including data backup and import/export tools like mongoimport and mongodump as well as monitoring tools like mongotop.
Once you have installed the MongoDB Server in the steps above, the Database Tools are available directly from the command line in your macOS Terminal application. For example you could run mongotop against your running MongoDB instance by invoking it in your macOS Terminal like so:
mongotop
Debería iniciarse, conectarse a su mongod en ejecución y comenzar el reporte de estadísticas de uso.
Consulta la Documentación sobre MongoDB Database Tools para obtener información sobre el uso de cada una de las herramientas de Database Tools.
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.
Resolución de problemas de ChecksumMismatchError
Si ha instalado previamente una versión anterior de la fórmula, podría encontrarse con un ChecksumMismatchError que se asemeja al siguiente:
Error: An exception occurred within a child process: ChecksumMismatchError: SHA256 mismatch Expected: c7214ee7bda3cf9566e8776a8978706d9827c1b09017e17b66a5a4e0c0731e1f Actual: 6aa2e0c348e8abeec7931dced1f85d4bb161ef209c6af317fe530ea11bbac8f0 Archive: /Users/kay/Library/Caches/Homebrew/downloads/a6696157a9852f392ec6323b4bb697b86312f0c345d390111bd51bb1cbd7e219--mongodb-macos-x86_64-4.2.0.tgz To retry an incomplete download, remove the file above.
Para corregir:
Remove the downloaded
.tgzarchive.Retap the formula.
brew untap mongodb/brew && brew tap mongodb/brew Vuelva a intentar la instalación.
brew install mongodb-community@8.0