故障排除错误

解决本地 Atlas 部署问题

本地计算机问题

如果在创建多个本地 Atlas 部署并加载数据后，Atlas CLI 速度减慢并处于不可用状态，则可能已达到计算机的限制。

如果您使用的是适用于Windows或MacOS的Docker Desktop，请考虑分配更多内存。

Docker问题

Atlas CLI使用Docker来执行 atlas deployments 命令。

对于 macOS 或 Windows，请安装 Docker 桌面 v4.31+。
对于 Linux，请安装 Docker Engine v27.0+。

如果本地Atlas部署不起作用，您可能需要清理Docker环境并重新开始：

docker stop $(docker ps -a -q) && docker system prune -a

安装或更新 AtlasCLI 插件失败

如果Atlas CLI插件安装或更新失败，请确保您有权访问权限Github API，因为安装或更新Atlas CLI插件需要访问权限Github API 。

运行诊断

如果您在使用atlas deployments命令时遇到问题并需要支持，请运行以下命令以提供详细的诊断：

atlas deployments diagnostics <deploymentName> --output json > out.json

命令错误

错误：缺少凭证

确保您：

运行atlas config init并将 API 密钥添加到您的配置文件中，或将 API 密钥添加到环境变量中。如果您使用自定义名称创建了配置文件或使用了多个配置文件，请使用--profile标志指定正确的配置文件。
运行atlas auth login以使用 Atlas 登录档案和身份验证令牌进行身份验证。

要了解详情，请参阅从 Atlas CLI 连接。

atlas：未找到命令

atlas可执行文件所在的目录可能不在 $PATH 中。您可以将该目录添加到 $PATH，将可执行文件移至 $PATH 中的目录，或者直接从其位置运行可执行文件。

400 (请求 "TENANT_ATTRIBUTE_READ_ONLY") pitEnabled 对于租户集群来说是只读属性，用户无法更改。

如果您尝试使用共享集群的--backup参数运行Atlas 集群 create ，则可能会出现此错误。--backup参数对于小于M10的集群不可用。

401（请求“Unauthorized”）您无权使用此资源。

您提供的档案对 Atlas CLI 命令中指定的项目无效。检查公钥和私钥字符串的准确性。

如果您的档案存储在配置文件中，请确保配置文件位于正确的位置。要了解详情，请参阅查找配置文件。如果 Atlas CLI 找不到您的配置文件，并且您没有将凭证存储在环境变量中，则会导致401错误。

401（请求“Unauthorized”）当前用户无权执行此操作。

The user account or API key that you used to connect to the Atlas CLI doesn't have permission to perform the requested action. User accounts and API keys must have the appropriate user roles to run Atlas CLI commands. To assign or change a user's roles, see:

401（请求“Unauthorized”）当前登录的用户在组织 <org-id> 中不具有群组创建者角色。

This error might appear when trying to create a new project. The user account or API key that you use to authenticate must have the Organization Project Creator role at the organization level in order to create new projects.

403 (请求 "Forbidden") IP 地址 <ip-address> 不允许访问此资源。

您用于身份验证的用户 IP 地址不在所请求项目的访问列表中。将您的 IP 地址添加到访问列表以运行命令。

要了解详情，请参阅以下页面：

For project access lists, see Configure IP Access List Entries.
有关API密钥访问权限列表，请参阅Atlas 管理 API入门。

要将 IP 地址添加到 API 密钥的访问列表，请执行以下操作：

Go项目的 Access Manager 页面。

如果尚未显示，请从导航栏的 Organizations 菜单中选择包含所需项目的组织。
从 Projects（项目）页面的项目列表中选择所需的项目。
在 Projects（项目）菜单旁边，展开 Options（选项）菜单，然后单击 Project Settings（项目设置）。
单击导航栏中的 Access Manager。

Go 到 API 密钥的访问列表。

单击 API Keys 标签页。
单击在API密钥右侧。
单击Edit Permissions ，然后单击Next 。

将您的 IP 地址添加到 API 密钥的访问列表中。

在API Access List部分执行以下任务之一：
- 单击Add Access List Entry并键入IP地址。
- 如果当前用于访问Atlas 的托管也将使用此API密钥发出API请求，请单击 Use Current IP Address。
单击 Save（连接）。

404 (请求 "Not Found") 指定了无效的群组 ID（group ID） <group-id>。

使用命令输入的项目 ID 不存在。导航到 Atlas 左侧导航栏中Project部分的Settings子部分，检查您的项目 ID。

注意

group ID 和project ID在 MongoDB 云服务中是同义词。

警报配置未删除

如果 Atlas CLI 无法删除 ID 指定的警报配置，则可能会出现此错误。

未找到 podman

如果您尝试在我们的官方 Docker容器（在 v 1.26 或更高版本中的 mongodb/atlas）中运行atlas deployments 命令，则会出现此错误。相反，请按照使用Docker创建本地Atlas部署中描述的步骤进行操作。

您应该使用以下命令检查集群中过去的容器：

podman ps -a

然后，使用以下命令删除所有以 mongod 或 mongot 开头的字符串：

podman container rm -f -v <name or ID>

提示

如果您使用的是 MacOS，则可以安全地卸载 podman。

如果您使用 Homebrew 安装了 podman，请使用以下命令进行卸载：

brew uninstall podman