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

故障排除错误

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

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

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

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

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

如果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可执行文件所在的目录可能不在 $PATH 中。 您可以将该目录添加到 $PATH,将可执行文件移至 $PATH 中的目录,或者直接从其位置运行可执行文件。

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

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

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

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

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

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

要了解详情,请参阅以下页面:

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

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

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

  3. 在 Projects(项目)菜单旁边,展开 Options(选项)菜单,然后单击 Project Settings(项目设置)。

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

2
  1. 单击 API Keys 标签页。

  2. 单击在API密钥右侧。

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

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

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

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

  2. 单击 Save(连接)。

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

注意

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

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

如果您尝试在我们的官方 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 无法访问您的主目录,则可能会出现此错误。

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