Docs 菜单
Docs 主页
/
MongoDB Atlas
/
Atlas CLI

故障排除错误

在此页面上

  • 解决本地 Atlas 部署问题
  • 命令错误
  • 配置错误

解决本地 Atlas 部署问题

本地计算机问题

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

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

Docker问题

Atlas CLI使用 Docker 用于atlas deployments 命令。

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

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

运行诊断

如果您在使用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”）当前用户无权执行此操作。

您用于连接 Atlas CLI的用户帐户或 API 密钥无权执行请求的操作。 用户帐户和 API 密钥必须具有适当的用户角色才能运行 Atlas CLI 命令。 要分配或更改用户角色，请参阅：

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

尝试创建新项目时可能会出现此错误。 用于身份验证的用户帐户或 API 密钥必须具有组织级别的Organization Project Creator角色才能创建新项目。

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

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

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

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

1

转到项目的 Access Manager（概览）页面。

  1. 如果尚未显示，请从导航栏的 Organizations 菜单中选择包含所需项目的组织。

  2. 从 Projects（项目）页面的项目列表中选择所需的项目。

  3. 在 Projects（项目）菜单旁边，展开 Options（选项）菜单，然后单击 Project Settings（项目设置）。

  4. 单击导航栏中的 Access Manager。

2

Go 到 API 密钥的访问列表。

  1. 单击 API Keys 标签页。

  2. 单击在 API密钥右侧。

  3. 单击Edit Permissions ，然后单击Next 。

3

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

  1. 在API Access List部分执行以下任务之一：

    • 单击Add Access List Entry并键入IP地址。

    • 如果当前用于访问 Atlas 的主机也将使用此 API 密钥发出 API 请求，请单击Use Current IP Address 。

  2. 单击 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

配置错误

读取主目录时出现空白输出

如果 Atlas CLI 无法访问您的主目录，则可能会出现此错误。

HOMEDRIVE、HOMEPATH 或 USERPROFILE 为空

如果 Atlas CLI 无法访问您的主目录，则可能会出现此错误。