创建本地 Atlas 部署
在此页面上
本教程向您展示如何使用 atlas deployments命令创建本地 Atlas 部署。 在本教程中，我们将在本地计算机上部署单节点副本集。 然后，您可以托管部署，并使用 Atlas Search 和 Atlas Vector Search。
本地 Atlas 部署支持的操作系统
操作系统 | 操作系统版本 | 架构 | 最低 CPU 核心数 | 最低可用 RAM (GB) |
|---|---|---|---|---|
macOS | 13.2 及更高版本 | x86-64、ARM | 2 | 2 |
Red Hat Enterprise Linux/CentOS | 8, 9 | x86-64、ARM | 2 | 2 |
Ubuntu | 22.04 、 24.04 | x86-64、ARM | 2 | 2 |
Debian | 11, 12 | x86-64、ARM | 2 | 2 |
Amazon Linux | 2023 | x86-64、ARM | 2 | 2 |
Windows | 10, 11 | x86 | 2 | 2 |
满足先决条件
在开始之前，请完成以下步骤以满足先决条件：
重要
有关每个必备产品的兼容性信息，请参阅相关安装页面。
安装 Atlas CLI。
示例 (MacOS)：
brew install mongodb-atlas-cli 要了解其他操作系统的 Atlas CLI 安装说明，请参阅安装或更新 Atlas CLI。
安装 mongosh版本2.0或更高版本。
示例 (MacOS)：
brew install mongosh 要了解其他操作系统的
mongosh安装说明，请参阅安装 mongosh。（可选）安装Compass版本1.39.4或更高版本。
示例 (MacOS)：
brew install mongodb-compass 要了解其他操作系统的 Compass 安装说明，请参阅下载和安装 Compass。
示例 (MacOS)：
brew tap mongodb/brew && brew install mongodb-database-tools 要了解适用于其他操作系统的MongoDB database工具安装说明，请参阅安装Database Tools 。
安装 Docker。
对于 MacOS 或 Windows，请安装 Docker Desktop v4 。31 +。
对于 Linux，请安装 Docker Engine v27 。0 +。
注意
Docker 需要网络连接来拉取和缓存 MongoDB 映像。
Podman v5.0 + Linux RHEL 版本也支持。
创建本地 Atlas 部署
使用 atlas deployments 命令创建本地 Atlas 部署。
可以通过以下方式运行该命令：
交互模式（默认）：该命令会提示您进行部署设置并提供默认值。
交互模式（自定义）：该命令会提示您进行部署设置，并允许您提供自定义值。
非交互模式：使用指定选项运行该命令。该命令不会提示您提供其他值。要了解
atlas deployments支持的所有操作，请参阅 atlas deployments。
单击以下标签页之一，查看适合您首选模式的命令。
指定如何设置本地 Atlas 数据库。
示例：
指定 default - With default settings 并按 Enter..
? How do you want to setup your local MongoDB database? [Use arrows to move, type to filter] default - With default settings custom - With custom settings cancel - Cancel set up
Creating your deployment local50 [this might take several minutes] 1/4: Downloading and completing configuration... 2/4: Starting your local environment... 3/4: Downloading MongoDB binaries to your local environment... 4/4: Creating your deployment local50... Deployment created! Connection string: mongodb://localhost:27017/?directConnection=true
运行带有选项的atlas deployments 命令。
示例：
atlas deployments setup myLocalRs1 --type local --force
[Default Settings] Deployment Name myLocalRs1 MongoDB Version 7.0 Port 49684 Creating your deployment myLocalRs1 1/2: Starting your local environment... 2/2: Creating your deployment myLocalRs1... Deployment created! Connection string: mongodb://localhost:49684/?directConnection=true connection skipped
管理本地 Atlas 部署
使用 atlas deployments 命令管理本地 Atlas 部署。您可以对本地和云端 Atlas 部署使用以下命令。您可以分别使用 --type local 或 --type atlas 来对本地或云端 Atlas 部署运行该命令。
在本地 Atlas 部署中使用 Atlas Search
使用 atlas deployments search indexes create 命令创建Atlas Search Atlas Search索引。 然后，您可以运行 Atlas Search 查询。 要了解更多信息，请参阅Atlas Search。
您可以在本地和云 Atlas 部署中运行此命令。有关详细步骤，请参阅创建 Atlas Search 索引并运行查询。
在本地 Atlas 部署中使用 Atlas Vector Search
使用atlas deployments search indexes create命令可使用 Atlas Vector Search。 要了解更多信息，请参阅如何为 Vector Atlas Search的向量嵌入创建索引。
您可以在本地和云 Atlas 部署中运行此命令。有关详细步骤，请参阅在 Atlas 部署中使用 Atlas Vector Search。
重要
要将 Atlas CLI 与 Atlas Vector Search 一起使用，您必须使用 MongoDB 7.0.5 或更高版本创建 Atlas 部署。如果您使用早期 MongoDB 版本创建了本地 Atlas 部署，则不会自动获取最新的 MongoDB 版本。您必须删除早期镜像和部署。然后，您必须创建一个新的 Atlas 部署。
支持的操作
要了解 atlas deployments 支持的所有操作，请参阅 atlas deployments。
故障排除错误
要了解有关解决本地 Atlas 部署问题的更多信息，请参阅解决本地 Atlas 部署问题。