/ /

/ /

创建本地 Atlas 部署

本教程向您展示如何使用 atlas deployments 命令创建本地Atlas部署。在本教程中，我们将在本地计算机上部署单节点副本集。然后，您可以管理部署，并使用MongoDB Search 和MongoDB 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。
如果使用 Homebrew，则可以在终端中运行以下命令：
```
brew install mongodb-atlas-cli
```
有关其他操作系统上的安装说明，请参阅安装或更新Atlas CLI。
安装 Docker。
Docker需要网络连接来拉取和缓存MongoDB映像。
- 对于 macOS 或 Windows，请安装 Docker 桌面 v4.31+。
- 对于 Linux，请安装 Docker Engine v27.0+。
- 对于Linux RHEL，您还可以使用 Podman v5.0+ 版本。
（可选）安装mongosh版本 2.0或更高版本。
```
brew install mongosh
```
有关其他操作系统上的安装说明，请参阅安装mongosh。
（可选）安装Compass版本1.39.4或更高版本。
```
brew install mongodb-compass
```
有关其他操作系统上的安装说明，请参阅下载和安装Compass。
（可选）安装Visual Studio Code和MongoDB for VS Code扩展。
要学习；了解更多信息，请参阅安装MongoDB for VS Code扩展。

创建 Atlas 帐户。

如果您还没有Atlas帐户，请在终端中运行atlas setup 或创建一个新帐户。

创建本地 Atlas 部署

使用 atlas deployments 命令创建本地 Atlas 部署。

可以通过以下方式运行该命令：

交互模式（默认）：该命令会提示您进行部署设置并提供默认值。
交互模式（自定义）：该命令会提示您进行部署设置，并允许您提供自定义值。
非交互模式：使用指定选项运行该命令。该命令不会提示您提供其他值。要学习；了解atlas deployments 支持的所有操作，请参阅 atlas-deployments。

请单击以下标签页之一，查看首选模式的命令。

`atlas deployments`以交互模式运行命令。

atlas deployments setup

要使用自己的数据和索引初始化本地Atlas部署，请执行以下操作：

复制以下命令：
```
atlas deployments setup --initdb {folder}
```
将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。
运行命令。

指定要部署的内容。

示例：

指定local - Local Database并按 Enter ..

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database

[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017

指定如何设置本地 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

要使用自己的数据和索引初始化本地Atlas部署，请执行以下操作：

复制以下命令：
```
atlas deployments setup --initdb {folder}
```
将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。
运行命令。

指定要部署的内容。

指定 local - Local Database 并按 Enter..

示例：

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database

[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017

指定如何设置本地 Atlas 数据库。

示例：

指定 custom - With custom 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

指定部署名称。

示例：

指定 myLocalRs 并按 Enter..

? Deployment Name [This can't be changed later] (local3612) myLocalRs

指定MongoDB版本。

示例：

指定 7.0 并按 Enter..

? MongoDB Version  [Use arrows to move, type to filter]
> 7.0
  6.0

指定端口。

示例：

指定 37018 并按 Enter..

? Specify a port (49469) 37018

Creating your deployment myLocalRs
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs...
Deployment created!
Connection string: mongodb://localhost:37018/?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 setup myLocalRs1 --type local --force --initdb {folder}
```
将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。
运行命令。

管理本地 Atlas 部署

使用 atlas deployments 命令管理本地 Atlas 部署。您可以对本地和云端 Atlas 部署使用以下命令。您可以分别使用 --type local 或 --type atlas 来对本地或云端 Atlas 部署运行该命令。

列出可用的部署。

示例：

atlas deployments list

NAME        TYPE    MDB VER   STATE
local50     LOCAL   7.0.1     IDLE
local62     LOCAL   7.0.1     IDLE
myLocalRs   LOCAL   7.0.1     IDLE
myLocalRs1  LOCAL   7.0.1     IDLE

下载并加载样本数据。

执行以下命令以下载示例数据。
```
curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive
```
将以下命令复制并粘贴到终端，然后将 {port-number} 替换为部署端口：
```
mongorestore --archive=sampledata.archive --port={port-number}
```

连接到部署。

运行以下命令以连接到部署：
```
atlas deployments connect
```
指定要连接的部署并按 Enter..
指定您希望连接到部署的方式，然后按 Enter..
您可以检索连接字符串或连接到以下客户端：连接字符串：
- mongosh 如果您安装了 mongosh
- MongoDB Compass（如果您安装了Compass）
- Visual Studio Code（如果安装了Visual Studio Code、Visual Studio Code CLI和MongoDB for VS Code扩展）

暂停部署。

运行以下命令以暂停部署：
```
atlas deployments pause
```
指定要暂停的部署并按 Enter..

开始部署

运行以下命令以启动部署：
```
atlas deployments start
```
指定要启动的部署并按 Enter..

返回部署日志。

运行以下命令以返回部署的日志：
```
atlas deployments logs
```
指定要返回日志的部署并按 Enter..

删除Atlas部署

运行以下命令以删除部署：
```
atlas deployments delete
```
指定要删除的部署并按 Enter..
指定y并按Enter 。以确认。

将本地Atlas部署迁移到 Cloud Atlas部署

您可以使用Docker和MongoDB Database Tools将本地Atlas部署迁移到云Atlas部署。

创建云 Atlas部署。

atlas deployments setup --type atlas

创建本地 Atlas 部署。

atlas deployments setup --type local

要使用自己的数据和索引初始化本地Atlas部署，请执行以下操作：

复制以下命令：
```
atlas deployments setup --type local --initdb {folder}
```
将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。
运行命令。

创建数据的二进制文件。

复制以下命令：
```
docker exec -u root -it {local_deployment_name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"
```
将 {local-deployment-name} 占位符替换为本地Atlas部署的名称。
运行命令。

复制存档。

复制以下命令：
```
docker cp <local deployment name>:/data/dump/dump.archive .
```
将 {local-deployment-name} 占位符替换为本地Atlas部署的名称。
运行命令。

返回连接字符串。

atlas deployments connect --type atlas --connectWith connectionString

从存档文件中恢复。

复制以下命令：
```
mongorestore --uri={connection-string} --archive=./dump.archive
```
将 {connection-string} 占位符替换为连接字符串。
运行命令。

（可选）删除本地Atlas部署。

atlas deployments delete --type local

更新本地Atlas部署

您可以使用Docker和MongoDB Database Tools将本地Atlas部署更新到较新版本的映像。

创建新的本地Atlas部署。

atlas deployments setup --type local

要使用自己的数据和索引初始化本地Atlas部署，请执行以下操作：

复制以下命令：
```
atlas deployments setup --type local --initdb {folder}
```
将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。
运行命令。

创建数据的二进制文件。

复制以下命令：
```
docker exec -u root -it {old-local-deployment-name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"
```
将 {old-local-deployment-name} 占位符替换为旧的本地Atlas部署的名称。
运行命令。

复制存档。

复制以下命令：
```
docker cp {old-local-deployment-name}:/data/dump/dump.archive .
```
将 {old-local-deployment-name} 占位符替换为旧的本地Atlas部署的名称。
运行命令。

返回新的连接字符串。

atlas deployments connect --type local --connectWith connectionString

从存档文件中恢复。

复制以下命令：
```
mongorestore --uri={connection-string} --archive=./dump.archive
```
将 {connection-string} 占位符替换为连接环。
运行命令。

（可选）删除旧的本地Atlas部署。

atlas deployments delete --type local

将MongoDB Search 与本地Atlas部署结合使用

使用 atlas deployments search indexes create 命令创建MongoDB Search搜索索引。然后，您可以运行MongoDB Search 查询。要学习；了解更多信息，请参阅MongoDB Search。

您可以在本地和云Atlas部署中运行此命令。有关详细步骤，请参阅创建MongoDB搜索索引并运行查询。

将MongoDB Vector Search 与本地Atlas部署结合使用

使用 atlas deployments search indexes create 命令可使用MongoDB 向量搜索。要学习；了解更多信息，请参阅如何为向量搜索的向量嵌入创建索引。

您可以在本地和云Atlas部署中运行此命令。有关详细步骤，请参阅在Atlas部署中使用MongoDB Vector Search。

重要

要将Atlas CLI与MongoDB Vector Search 结合使用，您必须使用MongoDB 7.0.5 或更高版本创建Atlas部署。如果使用早期MongoDB版本创建了本地Atlas部署，则不会自动获取最新的MongoDB版本。您必须删除早期的映像和部署。然后，您必须创建新的Atlas部署。

支持的操作

要学习；了解atlas deployments 支持的所有操作，请参阅 atlas-deployments。

故障排除错误

要学习；了解有关解决本地Atlas部署问题的更多信息，请参阅解决本地Atlas部署问题。

后退

本地部署和云部署

来年

使用 Docker 部署

本地 Atlas 部署支持的操作系统

满足先决条件

重要

安装依赖项。

创建 Atlas 帐户。

创建本地 Atlas 部署

atlas deployments以交互模式运行 命令。

指定要部署的内容。

指定如何设置本地 Atlas 数据库。

atlas deployments以交互模式运行 命令。

指定要部署的内容。

指定如何设置本地 Atlas 数据库。

指定部署名称。

指定MongoDB版本。

指定端口。

运行带有选项的 atlas deployments 命令。

管理本地 Atlas 部署

列出可用的部署。

下载并加载样本数据。

连接到部署。

暂停部署。

开始部署

返回部署日志。

删除Atlas部署

将本地Atlas部署迁移到 Cloud Atlas部署

创建云 Atlas部署。

创建本地 Atlas 部署。

创建数据的二进制文件。

复制存档。

返回连接字符串。

从存档文件中恢复。

（可选）删除本地Atlas部署。

更新本地Atlas部署

创建新的本地Atlas部署。

创建数据的二进制文件。

复制存档。

返回新的连接字符串。

从存档文件中恢复。

（可选）删除旧的本地Atlas部署。

将MongoDB Search 与本地Atlas部署结合使用

将MongoDB Vector Search 与本地Atlas部署结合使用

重要

支持的操作

故障排除错误

`atlas deployments`以交互模式运行命令。

`atlas deployments`以交互模式运行命令。

运行带有选项的 `atlas deployments` 命令。