保存连接设置
您可以将常用的连接设置另存为配置文件。 配置文件存储项目 ID、组织 ID 以及可选的 API密钥,以便在将来的 Atlas CLI 会话中使用。 为了节省时间,您可以指定配置文件,而不是在每个命令中使用 --projectId
和--orgId
标志。 Atlas CLI 将您的配置文件存储在名为config.toml
的配置文件中。
注意
存储在环境变量中的任何设置都优先于存储在配置文件中的设置。使用--projectId
和--orgId
标志指定的任何项目或组织都优先于配置文件和环境变量。
找到配置文件
Atlas CLI 将配置文件保存到以下位置,具体取决于您的操作系统:
%AppData/atlascli
/Users/{username}/Library/Application Support/atlascli
$XDG_CONFIG_HOME/atlascli
默认情况下,Atlas CLI 会将配置文件保存在$XDG_CONFIG_HOME
环境变量中定义的路径中。您可以将$XDG_CONFIG_HOME
变量中定义的路径修改为您的首选位置。要了解有关修改$XDG_CONFIG_HOME
变量的更多信息,请参阅 XDG 基本目录规范。
如果未设置$XDG_CONFIG_HOME
,Atlas CLI 将使用:
$HOME/.config/atlascli
Atlas CLI 向运行命令的用户授予对该文件的读写访问权限。
创建配置文件
首次运行atlas auth login
或atlas config init
命令时,Atlas CLI 会自动创建config.toml
文件和默认配置文件。 如果运行命令时未指定配置文件、环境变量或--projectId
和--orgId
标志,Atlas CLI 将使用该命令的默认配置文件。
选择您的使用案例
根据您的使用案例选择连接方法:
命令 | 身份验证方法 | 用例(Use Case) |
---|---|---|
atlas auth login | Atlas 登录凭证和身份验证令牌 | 最适合非编程使用 |
atlas config init | API 密钥 | 最适合编程使用 |
要了解更多信息,请参阅选择连接方法。
满足先决条件
将您主机的 IP 地址添加到 IP 访问列表中。
如果选择
atlas config init
作为连接方法,则必须配置 API 密钥。如果您的 Atlas CLI 安装在防火墙后面,并且您想使用代理URL ,请设置
HTTP_PROXY
或HTTPS_PROXY
环境变量。重要
Atlas CLI 支持
http
、https
和socks5
方案。 您必须在代理服务的访问列表中指定cloud.mongodb.com/
作为主目标 URL。 如果您的代理配置启用了身份验证,则还必须指定用户名和密码。要了解详情,请参阅 代理服务器。
按照以下步骤操作
选择一个使用案例,然后按照步骤创建配置文件。
选择默认配置文件或命名配置文件。
创建默认配置文件以:
在不指定配置文件、环境变量或
--projectId
和--orgId
标志的情况下运行命令。使用
--profile default
标志。
创建命名配置文件以使用--profile <profileName>
标志。
按照以下步骤创建默认配置文件。如果默认配置文件已存在,这些命令将更新默认配置文件的值。
验证您的配置文件设置。
查看配置文件或运行atlas config describe
命令以验证您的配置文件。 对于默认配置文件, <profileName>
是default
。
atlas config describe <profileName>
该命令会返回以下设置。为了安全起见,Atlas CLI 会编辑访问令牌并刷新令牌值。
SETTING VALUE "access_token": "redacted", "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "project_id": "60c94857241ae99848af45ad", "refresh_token": "redacted", "service": "cloud"
按照以下步骤创建具有自定义名称的配置文件。
验证您的配置文件设置。
查看配置文件或运行atlas config describe
命令以验证您的配置文件。 对于默认配置文件, <profileName>
是default
。
atlas config describe <profileName>
该命令会返回以下设置。为了安全起见,Atlas CLI 会编辑访问令牌并刷新令牌值。
SETTING VALUE "access_token": "redacted", "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "project_id": "60c94857241ae99848af45ad", "refresh_token": "redacted", "service": "cloud"
选择默认配置文件或命名配置文件。
创建默认配置文件以:
在不指定配置文件、环境变量或
--projectId
和--orgId
标志的情况下运行命令。使用
--profile default
标志。
创建命名配置文件以使用--profile <profileName>
标志。
按照以下步骤创建默认配置文件。如果默认配置文件已存在,这些命令将更新默认配置文件的值。
验证您的配置文件设置。
查看配置文件或运行atlas config describe
命令以验证您的配置文件。 对于默认配置文件, <profileName>
是default
。
atlas config describe <profileName>
该命令返回以下设置。为了安全起见,Atlas CLI 会编辑API密钥值。
SETTING VALUE "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "private_api_key": "redacted", "project_id": "60c94857241ae99848af45ad", "public_api_key": "redacted", "service": "cloud"
按照以下步骤创建具有自定义名称的配置文件。
验证您的配置文件设置。
查看配置文件或运行atlas config describe
命令以验证您的配置文件。 对于默认配置文件, <profileName>
是default
。
atlas config describe <profileName>
该命令返回以下设置。为了安全起见,Atlas CLI 会编辑API密钥值。
SETTING VALUE "mongosh_path": "/usr/local/bin/mongosh", "org_id": "60c9877baf349d6fc4fd9744", "output": "json", "private_api_key": "redacted", "project_id": "60c94857241ae99848af45ad", "public_api_key": "redacted", "service": "cloud"
更新配置文件
您可以通过以下方式更新配置文件中存储的设置:
使用文本编辑器编辑
config.toml
文件。运行
atlas config set
命令进行设置。 这将编辑config.toml
文件中的单个值。
使用配置文件运行命令
要使用配置文件运行 Atlas CLI 命令,请执行以下操作:
将
--profile <profileName>
标志附加到命令或省略--profile <profileName>
标志以使用默认配置文件。
例子
此命令使用名为myProfile
的配置文件:
atlas <command> --profile myProfile
此命令使用默认配置文件:
atlas <command>