创建本地 Atlas 部署

安装依赖项。

1. 安装 Atlas CLI。

   如果使用Homebrew，则可以在终端中运行以下命令：

   brew install mongodb-atlas-cli

   有关其他操作系统上的安装说明，请参阅安装或更新Atlas CLI。

2. 安装 Docker。

   Docker需要网络连接来拉取和缓存MongoDB映像。

   • 对于 macOS 或 Windows，请安装 Docker 桌面 v4.31+。

   • 对于 Linux，请安装 Docker Engine v27.0+。

   • 对于Linux RHEL，您还可以使用 Podman v5.0+ 版本。

3. (Optional) Install mongosh version 2.0 or later.

   brew install mongosh

   有关其他操作系统上的安装说明，请参阅安装mongosh。

4. (Optional) Install Compass version 1.39.4 or later.

   brew install mongodb-compass

   For installation instructions on other operating systems, see Download and Install Compass.

5. （可选）安装Visual Studio Code和MongoDB for VS Code扩展。

   要学习；了解更多信息，请参阅安装MongoDB for VS Code扩展。

创建 Atlas 帐户。

If you don't already have an existing Atlas account, run atlas setup in your terminal or create a new account.

列出可用的部署。

示例：

atlas local 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

加载样本数据。

要将示例数据加载到现有部署中，请执行以下操作：

1. 执行以下命令以下载示例数据。

   curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive

2. 获取部署的端口号：

   1. 复制以下命令：

      atlas local connect <deployment name> --connectWith connectionString

   2. 将 <deployment name> 替换为您的部署名称。

   3. 运行命令。

      连接字符串包括端口号。示例，在连接字符串mongodb://localhost:27017/?directConnection=true 中，端口号为 27017。

3. 将以下命令复制并粘贴到终端，然后将 {port-number} 替换为部署端口：

   mongorestore --archive=sampledata.archive --port={port-number}

连接到部署。

1. 运行以下命令以连接到部署：

   atlas local connect

2. 指定要连接的部署并按 Enter..

3. 指定您希望连接到部署的方式，然后按 Enter..

   您可以检索连接字符串或连接到以下客户端：连接字符串：

   • mongosh 如果您安装了 mongosh

   • MongoDB Compass（如果您安装了Compass）

   • Visual Studio Code（如果安装了Visual Studio Code、Visual Studio Code CLI和MongoDB for VS Code扩展）

暂停部署。

1. 运行以下命令以暂停部署：

   atlas local stop

2. 指定要暂停的部署并按 Enter..

开始部署

1. 运行以下命令以启动部署：

   atlas local start

2. 指定要启动的部署并按 Enter..

返回部署日志。

1. 运行以下命令以返回部署的日志：

   atlas local logs

2. 指定要返回日志的部署并按 Enter..

创建云 Atlas部署。

atlas setup

创建本地 Atlas 部署。

atlas local setup

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

1. 复制以下命令：

   atlas local setup --initdb {folder}

2. 将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。

3. 运行命令。

创建数据的二进制文件。

1. 复制以下命令：

   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"

2. 将 {local-deployment-name} 占位符替换为本地Atlas部署的名称。

3. 运行命令。

复制存档。

1. 复制以下命令：

   docker cp <local deployment name>:/data/dump/dump.archive .

2. 将 {local-deployment-name} 占位符替换为本地Atlas部署的名称。

3. 运行命令。

返回连接字符串。

atlas clusters connectionStrings describe

从存档文件中恢复。

1. 复制以下命令：

   mongorestore --uri={connection-string} --archive=./dump.archive

2. 将 {connection-string} 占位符替换为连接字符串。

3. 运行命令。

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

atlas local delete

创建新的本地Atlas部署。

atlas local setup

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

1. 复制以下命令：

   atlas local setup --initdb {folder}

2. 将 {folder} 占位符替换为包含要在本地容器内按字母数字顺序运行的.js 和 .sh 文件的目录。

3. 运行命令。

创建数据的二进制文件。

1. 复制以下命令：

   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"

2. 将 {old-local-deployment-name} 占位符替换为旧的本地Atlas部署的名称。

3. 运行命令。

复制存档。

1. 复制以下命令：

   docker cp {old-local-deployment-name}:/data/dump/dump.archive .

2. 将 {old-local-deployment-name} 占位符替换为旧的本地Atlas部署的名称。

3. 运行命令。

返回新的连接字符串。

atlas local connect --connectWith connectionString

从存档文件中恢复。

1. 复制以下命令：

   mongorestore --uri={connection-string} --archive=./dump.archive

2. 将 {connection-string} 占位符替换为连接环。

3. 运行命令。

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

atlas local delete