在macOS上安装MongoDB社区版

MONGODB ATLAS

MongoDB Atlas 是MongoDB公司提供的MongoDB云服务,无需安装开销,并提供免费的入门套餐。

概述

使用本教程在 macOS 上通过第三方的 Homebrew 包管理器安装 MongoDB 7.0 社区版。

从 MongoDB 4.4.1 开始,通过 Homebrew 安装 MongoDB 还会安装MongoDB 数据库工具。看 使用 MongoDB 数据库工具了解更多信息。

MongoDB版本

本教程将安装MongoDB 7.0社区版。要安装其他版本的MongoDB,请使用此页面左上角的版本下拉菜单选择该版本的文档。

注意事项

平台支持

MongoDB 7.0 社区版支持 macOS 10.14 或更高版本。

有关更多信息,请参见支持的平台

生产注意事项

在生产环境中部署 MongoDB 之前,请考虑 生产说明文档,其中提供了生产 MongoDB 部署的性能注意事项和配置建议。

安装MongoDB社区版

前提条件

确保您的系统满足以下每个先决条件。您只需在系统上执行每个先决步骤一次。如果您已经使用 Homebrew 执行了早期 MongoDB 安装的先决条件步骤,则可以跳到 安装程序

安装 Xcode 命令行工具

Homebrew 需要 Apple Xcode 中的 Xcode 命令行工具。

  • 通过在 macOS 终端中运行以下命令来安装 Xcode 命令行工具:

    xcode-select --install
    

安装自制软件

默认情况下,macOS 不包含 Homebrewbrew软件包。

安装MongoDB 7.0社区版

按照以下步骤使用 Homebrew 的 包管理器安装 MongoDB 社区版 。确保您已遵循 brew安装先决条件在继续之前先执行上述操作。

  1. 点击MongoDB 自制 Tap要下载 MongoDB 和数据库工具的官方 Homebrew 公式,请在 macOS 终端中运行以下命令:

    brew tap mongodb/brew
    

    如果您之前安装的 MongoDB 已经执行此操作,则可以跳过此步骤。

  2. 要更新 Homebrew 和所有现有公式:

    brew update
    
  3. 要安装 MongoDB,请在 macOS 终端应用程序中运行以下命令:

    brew install mongodb-community@7.0
    

提示:

或者,如果需要,您可以指定 MongoDB 的早期版本。您还可以通过这种方式并行维护 MongoDB 的多个版本。

提示:

如果您之前安装了旧版本的公式,则可能会遇到 ChecksumMismatchError。要解决,请参阅 对 ChecksumMismatchError 进行故障排除。

安装包括以下二进制文件:

此外,安装程序还会在下面指定的位置创建以下文件和目录,具体取决于您的 Apple 硬件:

Intel Processor Apple Silicon Processor
配置文件 /usr/local/etc/mongod.conf /opt/homebrew/etc/mongod.conf
log directory /usr/local/var/log/mongodb /opt/homebrew/var/log/mongodb
data directory /usr/local/var/mongodb /opt/homebrew/var/mongodb

苹果的文档 查看当前使用 Apple Silicon 处理器的 Apple 硬件列表。您还可以运行以下命令来检查brew这些文件和目录的安装位置:

brew --prefix

从 MongoDB 4.4.1 开始,安装还包括 MongoDB 数据库工具。看使用 MongoDB 数据库工具了解更多信息。

运行 MongoDB 社区版

请按照以下步骤运行 MongoDB社区版。这些说明假设您使用的是默认设置。

您可以使用 来将 MongoDB 作为 macOS 服务运行brew,也可以将 MongoDB 作为后台进程手动运行。建议将 MongoDB 作为 macOS 服务运行,因为这样做会 ulimit自动设置正确的系统值(有关更多信息,请参阅 ulimit 设置)。

  • 要将 MongoDB(即进程mongod作为 macOS 服务运行,请运行:

    brew services start mongodb-community@7.0
    

    要停止mongod作为 macOS 服务运行,请根据需要使用以下命令:

    brew services stop mongodb-community@7.0
    
  • 要作为后台进程手动运行 MongoDB(即mongod进程),请运行:

    • 对于运行 Intel 处理器的 macOS:

      mongod --config /usr/local/etc/mongod.conf --fork
      
    • 对于运行在 macOS 上的Apple Silicon处理器:

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

      要停止mongod作为后台进程运行,请mongod使用蒙戈什,并shutdown根据需要发出命令。

两种方法都使用mongod.conf安装期间创建的文件。您也可以将自己的 MongoDB 配置选项添加到此文件中。

笔记:

macOS 阻止 mongod 打开

macOS 可能会mongod在安装后阻止运行。如果您在开始时收到安全错误,mongod 指示无法识别或验证开发人员,请执行以下操作以授予mongod运行访问权限:

  • 打开系统偏好设置
  • 选择“安全和隐私”窗格。
  • “常规”选项卡下,单击有关消息右侧的按钮mongod,该按钮标记为“仍然打开”“仍然允许”,具体取决于您的 macOS 版本。

要验证 MongoDB 是否正在运行,请执行以下操作之一:

  • 如果您将 MongoDB作为 macOS 服务启动:

    brew services list
    

    您应该看到该服务mongodb-community列为 started

  • 如果您手动启动 MongoDB 作为后台进程

    ps aux | grep -v grep | grep mongod
    

    mongod您应该在输出中看到您的过程。

您还可以查看日志文件以了解进程的当前状态 mongod/usr/local/var/log/mongodb/mongo.log

连接和使用 MongoDB

要开始使用 MongoDB,请连接mongosh到正在运行的实例。从新终端发出以下命令:

mongosh

有关 CRUD(创建、读取、更新、删除)操作的信息,请参阅:

使用 MongoDB 数据库工具

从 MongoDB 4.4.1 开始,安装 MongoDBbrew还会安装 MongoDB 数据库工具。

MongoDB 数据库工具是用于 MongoDB 部署的命令行实用程序的集合,包括数据备份和导入/导出工具,例如 mongoimportmongodump以及监控工具,例如mongotop

在上述步骤中安装 MongoDB 服务器后,可以直接从 macOS 终端应用程序中的命令行使用数据库工具。例如你可以运行mongotop 通过在 macOS 终端中调用正在运行的 MongoDB 实例,如下所示:

mongotop

它应该启动,连接到您正在运行的mongod,并开始报告使用情况统计信息。

请参阅MongoDB 数据库工具文档有关每个数据库工具的使用信息。

附加信息

默认本地主机绑定

默认情况下,MongoDB 启动时bindIp设置为 127.0.0.1,绑定到本地主机网络接口。这意味着mongod只能接受来自同一计算机上运行的客户端的连接。除非将此值设置为有效的网络接口,否则远程客户端将无法连接到mongod,并且mongod将无法初始化副本集。

该值可以配置为:

  • 在 MongoDB 配置文件中使用bindIp, 或
  • 通过命令行参数--bind_ip

警告

在将实例绑定到可公开访问的 IP 地址之前,您必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅 安全检查表。至少,考虑 启用身份验证强化网络基础设施。

有关配置的详细信息bindIp,请参阅 IP 绑定。

校验和不匹配错误故障排除

如果您之前安装过旧版本的公式,您可能会遇到ChecksumMismatchError类似于以下内容的情况:

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.

修理:

  1. 删除下载的.tgz存档。

  2. 重新输入公式。

    brew untap mongodb/brew && brew tap mongodb/brew
    
  3. 重试安装。

    brew install mongodb-community@7.0
    

原文链接:https://www.mongodb.com/docs/v7.0/tutorial/install-mongodb-on-os-x/

译者:韩鹏帅

Copyright © 上海锦木信息技术有限公司 all right reserved,powered by Gitbook文件修订时间: 2023-09-01 17:10:26

results matching ""

    No results matching ""