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

故障排除错误

在此页面上

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

解决本地 Atlas 部署问题

错误：qemu 意外退出，退出代码为 -1，stderr: qemu-system-x86_64: Error: HV_DENIED

Atlas CLI 使用 Podman 和 QEMU 。我们在 MacOS x 86架构上发现了此问题。 要解决此问题，请升级到最新版本的 QEMU 并重新启动 Podman。

错误：退出状态 127

由于 已知问题 ，在 Ubuntu Linux 上使用 命令时可能会出现此错误atlas deployments setup 使用 Podman。在此公开预览阶段，我们不支持使用 Ubuntu 进行本地 Atlas 部署。

MongoNetworkError: connect ECONNREFUSED

计算机Go睡眠模式或重新启动后，可能会出现此问题。当您尝试连接到本地 Atlas 部署时，会出现此错误。

Atlas CLI 使用 Podman 和 QEMU 运行 MongoDB 的 Docker 实例。Podman 采用无守护进程架构。 因此，本地 MongoDB 实例不会自动重启。

要解决此问题，请执行以下操作：

  1. 列出可用的部署。

    atlas deployments list

  2. 要恢复container，请将以下命令复制并粘贴到终端中，并将{deployment-name}替换为要启动的部署的名称。

    atlas deployments start {deployment-name}

Windows 上的问题

在此公开预览阶段，我们不支持使用 Windows 进行本地 Atlas 部署。

本地计算机问题

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

考虑分配更多内存：

  1. 停止 Podman 机器：

    podman machine stop

  2. 根据机器设置分配更多内存：

    podman machine set --cpus 3 --memory 5120

  3. 启动 Podman 机器：

    podman machine start

  4. 列出 Podman container。

    podman ps --all

  5. 要恢复container，请将以下命令复制并粘贴到终端中，并将{container-name}替换为要启动的container的名称。

    podman start {container-name}

Podman 问题

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

要安装 Podman，请运行以下命令：

brew install podman

要初始化 Podman 机器，请运行以下命令：

podman machine init

要启动 Podman 机器，请运行以下命令：

podman machine start

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

podman kill --all && podman system prune --force && podman volume rm --all

运行诊断

如果您在使用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 指定的警报配置，则可能会出现此错误。

配置错误

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

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

HOMEDRIVE、HOMEPATH 或 USERPROFILE 为空

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