Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Instale MongoDB Community Edition en macOS

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 15 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.

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.

  1. 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.

  2. To update Homebrew and all existing formulae:

    brew update

  3. 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

/usr/local/etc/mongod.conf

/opt/homebrew/etc/mongod.conf

/usr/local/var/log/mongodb

/opt/homebrew/var/log/mongodb

/usr/local/var/mongodb

/opt/homebrew/var/mongodb

Consulta la documentación de Apple para obtener la lista actual de hardware de Apple que utiliza el procesador Apple Silicon. También puedes ejecutar el siguiente comando para verificar dónde brew ha instalado estos archivos y directorios:

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 MongoDB (es decir, el proceso mongod) como un servicio en macOS, ejecute:

    brew services start mongodb-community@8.0

    Para detener un mongod que se está ejecutando como servicio de macOS, utilice el siguiente comando según sea necesario:

    brew services stop mongodb-community@8.0

  • Para ejecutar mongod manualmente 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 ejecutándose en procesadores Intel:

          1

          Inicie su pantalla.

          screen -S <name-of-screen>
          2

          Comenzar mongod.

          mongod --config /usr/local/etc/mongod.conf
          3

          Desconéctese de la pantalla.

          Desconéctese de la pantalla escribiendo Ctrl+a y luego haciendo clic en d.

          4

          Vea todas las pantallas activas.

          screen -ls

        • Para macOS con procesadores Apple Silicon:

          1

          Inicie su pantalla.

          screen -S <name-of-screen>
          2

          Comenzar mongod.

          mongod --config /opt/homebrew/etc/mongod.conf
          3

          Desconéctese de la pantalla.

          Desconéctese de la pantalla escribiendo Ctrl+a y luego haciendo clic en d.

          4

          Vea todas las pantallas activas.

          screen -ls

  • Para ejecutar mongod manualmente como un proceso en segundo plano especificando --dbpath y --logpath en la línea de comandos, ejecute:

    mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork

    Para detener un mongod que se ejecuta como proceso en segundo plano, conéctate al mongod usando mongosh, y ejecuta el comando shutdown, 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-community listado como started.

  • Si se inició MongoDB manualmente como un proceso en segundo plano:

    ps aux | grep -v grep | grep mongod

    Debería ver su proceso mongod en 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

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.

MongoDB Database Tools son una colección de utilidades de línea de comandos para trabajar con una implementación de MongoDB, que incluye herramientas de copia de seguridad de datos e importación/exportación como mongoimport y mongodump, así como herramientas de supervisión como mongotop.

Una vez que haya instalado el MongoDB Server según los pasos anteriores, las Database Tools están disponibles directamente desde la línea de comandos en su aplicación Terminal de macOS. Por ejemplo, podría ejecutar mongotop contra su instancia de MongoDB en ejecución invocándola en su Terminal de macOS de la siguiente manera:

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, o

  • mediante 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:

  1. Remove the downloaded .tgz archive.

  2. Retap the formula.

    brew untap mongodb/brew && brew tap mongodb/brew

  3. Vuelva a intentar la instalación.

    brew install mongodb-community@8.0
Volver
Instalar en Amazon
Next
Instale en Windows
Califique esta página

En esta página