对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/
工具
/
Atlas CLI
Docs 主页
/
工具
/
Atlas CLI
Docs 主页
/
工具
/
Atlas CLI

安装或更新 Atlas CLI

安装 Atlas CLI 以从终端快速预配和管理 Atlas 数据库部署。

要在安装之前验证包，请参阅验证 Atlas CLI 包的完整性。

安装 Atlas CLI。

选择下列安装方法之一，然后按照步骤安装 Atlas CLI。

要检查您的操作系统是否与 Atlas CLI 兼容，请参阅检查兼容性。

满足先决条件

要使用 Homebrew 安装 Atlas CLI，您必须：

  1. 使用 MacOS 或 Linux 操作系统。

  2. 安装 Homebrew。

满足先决条件

要使用 Apt 安装 Atlas CLI，必须安装 gnupg 和 curl：

sudo apt-get install gnupg curl

满足先决条件

要使用 Chocolatey 安装 Atlas CLI，必须执行以下操作：

  1. 确保您的系统符合安装 Chocolatey 的要求。

  2. 使用 cmd.exe 或 PowerShell.exe 安装 Chocolatey。要学习；了解更多信息，请参阅安装 Chocolatey。

满足先决条件

要使用 Docker 安装 Atlas CLI，请安装 Docker 引擎或 Docker 桌面。

按照以下步骤操作

1

安装Atlas CLI和 mongosh。

调用以下 brew 命令来安装 Atlas CLI 和 mongosh：

brew install mongodb-atlas

注意

您也可以使用 brew install mongodb-atlas-cli 命令同时安装 Atlas CLI 和 mongosh。您无法在 Homebrew 上单独安装 Atlas CLI。

2

验证 Atlas CLI 安装是否成功。

从任意目录运行 atlas 命令：

atlas

返回结果包括 Atlas CLI 的可用命令和选项。

1

为您的MongoDB版本配置 yum。

创建/etc/yum.repos.d/mongodb-org-7.0.repo文件，以便可以直接使用yum安装 Atlas CLI。 将7.0替换为您的 MongoDB 版本。

[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc

创建/etc/yum.repos.d/mongodb-enterprise-7.0.repo文件，以便可以直接使用yum安装 Atlas CLI。 将7.0替换为您的 MongoDB 版本。

[mongodb-enterprise-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.com/yum/redhat/$releasever/mongodb-enterprise/7.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
[mongodb-enterprise-7.0]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/amazon/2023/mongodb-enterprise/7.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-7.0.asc
2

安装Atlas CLI和 mongosh。

调用以下 yum 命令来安装 Atlas CLI 和 mongosh：

sudo yum install -y mongodb-atlas

如果不想安装 mongosh，请调用以下 yum 命令，仅安装 Atlas CLI：

sudo yum install -y mongodb-atlas-cli
3

验证 Atlas CLI 安装是否成功。

从任意目录运行 atlas 命令：

atlas

返回结果包括 Atlas CLI 的可用命令和选项。

1

导入 apt 使用的公钥。

从终端发出以下命令，从https://pgp.mongodb.com/server-7.0.asc导入 MongoDB 公共 GPG 密钥。 将7.0替换为您的 MongoDB 版本。

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
   --dearmor

成功的命令会返回OK 。

2

为您的 MongoDB 版本创建列表文件。

选择 Ubuntu 或 Debian，然后选择您的版本。

为您的 Ubuntu 版本创建列表文件/etc/apt/sources.list.d/mongodb-org-7.0.list 。 将7.0替换为您的 MongoDB 版本。

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

为您的 Debian 版本创建列表文件/etc/apt/sources.list.d/mongodb-org-7.0.list 。 将7.0替换为您的 MongoDB 版本。

echo "deb http://repo.mongodb.org/apt/debian bookworm/mongodb-org/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
echo "deb http://repo.mongodb.org/apt/debian bullseye/mongodb-org/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

选择 Ubuntu 或 Debian，然后选择您的版本。

为 Ubuntu 版本创建 /etc/apt/sources.list.d/mongodb-enterprise.list 文件。将 7.0替换为 MongoDB 版本。

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.com/apt/ubuntu jammy/mongodb-enterprise/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.com/apt/ubuntu focal/mongodb-enterprise/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.com/apt/ubuntu bionic/mongodb-enterprise/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list

为 Debian 版本创建 /etc/apt/sources.list.d/mongodb-enterprise.list 文件。将 7.0替换为 MongoDB 版本。

echo "deb http://repo.mongodb.com/apt/debian bullseye/mongodb-enterprise/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
3

刷新包数据库。

调用以下 apt 命令：

sudo apt-get update
4

安装Atlas CLI和 mongosh。

调用以下 apt 命令来安装 Atlas CLI 和 mongosh：

sudo apt-get install -y mongodb-atlas

如果不想安装 mongosh，请调用以下 apt 命令，仅安装 Atlas CLI：

sudo apt-get install -y mongodb-atlas-cli
5

验证 Atlas CLI 安装是否成功。

从任意目录运行 atlas 命令：

atlas

返回结果包括 Atlas CLI 的可用命令和选项。

1

安装 Atlas CLI。

choco install mongodb-atlas
2

出现提示时，输入A 以确认安装。

3

安装后关闭并重新打开终端，查看路径更改。

4

验证 Atlas CLI 安装是否成功。

从任意目录运行 atlas 命令：

atlas

返回结果包括 Atlas CLI 的可用命令和选项。

要提取最新的 Atlas CLI Docker 镜像，请运行以下命令：

docker pull mongodb/atlas

如果运行docker pull mongodb/atlas时未指定版本标签，Docker 会自动拉取最新版本的 Docker 映像 ( mongodb/atlas:latest )。

要拉取特定版本的 Docker 映像，请运行以下命令，并将<tag>替换为版本标签：

docker pull mongodb/atlas:<tag>

要了解如何在拉取 Docker 映像后使用 Docker 运行 Atlas CLI 命令，请参阅使用 Docker 运行 Atlas CLI 命令。

1

安装 Atlas CLI。

  1. 下载并解压缩适用于您的操作系统的正确二进制文件：

    操作系统
    立即下载

    Windows

    .zip, .msi

    macOS

    .zip (x86-64), .zip (ARM)

    Ubuntu/Debian

    .deb (x86-64)、.deb (ARM)

    RHEL/CentOS/SLES/AMZ

    .rpm (x86-64)、.rpm (ARM)

    Linux

    .tar.gz (x86-64), .tar.gz (ARM)

    注意

    替换或删除任何现有的 MongoDB CLI 二进制文件，以防止版本之间的冲突。

  2. 运行可执行文件。

    （可选）将Atlas CLI添加到PATH 。

    如果执行以下操作之一，则可以从任何目录运行二进制文件：

    1. 将可执行文件的位置添加到 PATH 中。

    2. 将可执行文件移至您的 PATH 中的目录。

    您可以通过多种方式来完成此操作，具体取决于您的个人设置和环境。有关更多示例，请参阅您的 Shell 和操作系统的文档。

    例子

    在以下示例中，用户将 MongoDB CLI 的二进制文件下载并提取到 /atlascli_1.51.1-macOS_x86_64 目录。

    然后，用户将可执行文件移动到其 PATH 已存在的目录中：

    cd atlascli_1.51.1-macOS_x86_64
    mv atlas /usr/local/bin
2

验证 Atlas CLI 安装是否成功。

从任意目录运行 atlas 命令：

atlas

返回结果包括 Atlas CLI 的可用命令和选项。

更新 Atlas CLI

要更新 Atlas CLI，请按照与安装 Atlas CLI 的方法相对应的步骤进行操作：

按照以下步骤操作

1

更新 Atlas CLI。

如果您使用 mongodb-atlas 包同时安装了 Atlas CLI 和 mongosh，请调用以下 brew 命令：

brew update
brew upgrade mongodb-atlas

如果您使用 mongodb-atlas-cli 包同时安装了 Atlas CLI 和 mongosh，请调用以下 brew 命令：

brew update
brew upgrade mongodb-atlas-cli
2

验证 Atlas CLI 更新是否成功。

运行 --version 命令：

atlas --version

结果会返回您的 Atlas CLI 版本。

按照以下步骤操作

1

更新 Atlas CLI。

如果您使用 mongodb-atlas 包同时安装了 Atlas CLI 和 mongosh，请调用以下 yum 命令：

yum update mongodb-atlas

如果您仅使用 mongodb-atlas-cli 包安装了 Atlas CLI，请调用以下 yum 命令：

yum update mongodb-atlas-cli
2

验证 Atlas CLI 更新是否成功。

运行 --version 命令：

atlas --version

结果会返回您的 Atlas CLI 版本。

按照以下步骤操作

1

更新 Atlas CLI。

如果您使用 mongodb-atlas 包同时安装了 Atlas CLI 和 mongosh，请调用以下 apt 命令：

sudo apt-get install --only-upgrade mongodb-atlas

如果您仅使用 mongodb-atlas-cli 包安装了 Atlas CLI，请调用以下 apt 命令：

sudo apt-get install --only-upgrade mongodb-atlas-cli
2

验证 Atlas CLI 更新是否成功。

运行 --version 命令：

atlas --version

结果会返回您的 Atlas CLI 版本。

按照以下步骤操作

1

安装 Atlas CLI。

choco upgrade mongodb-atlas
2

验证 Atlas CLI 更新是否成功。

运行 --version 命令：

atlas --version

结果会返回您的 Atlas CLI 版本。

按照以下步骤操作

1

更新 Atlas CLI。

  1. 删除任何现有的 Atlas CLI 二进制文件，以防止版本之间的冲突。

  2. 下载并解压缩适用于您的操作系统的正确二进制文件：

    操作系统
    立即下载

    Windows

    .zip, .msi

    macOS

    .zip (x86-64), .zip (ARM)

    Ubuntu/Debian

    .deb (x86-64)、.deb (ARM)

    RHEL/CentOS/SLES/AMZ

    .rpm (x86-64)、.rpm (ARM)

    Linux

    .tar.gz (x86-64), .tar.gz (ARM)

  3. 运行可执行文件。

2

验证 Atlas CLI 更新是否成功。

运行 --version 命令：

atlas --version

结果会返回您的 Atlas CLI 版本。

采取后续步骤

从 Atlas CLI 连接以开始使用 Atlas CLI 命令。

后退

Overview

来年

检查兼容性

在此页面上