/ /

MongoDB CLI 配置文件

MongoDB CLI 配置文件存储您的配置文件。您可以通过使用文本编辑器编辑配置文件，或使用 mongocli 配置集命令来更新存储在配置文件中的设置。

重要

API密钥就像密码一样。配置文件以明文形式存储API密钥，因此请确保以适当方式保护配置文件。

配置文件位置

首次运行mongocli config命令时， MongoDB CLI会创建一个名为config.toml的配置文件。 MongoDB CLI授予运行该命令的用户对该文件的写入访问权限。 MongoDB CLI会根据您的操作系统将配置文件保存到以下位置：

%AppData/mongocli

/Users/{username}/Library/Application Support/mongocli

$XDG_CONFIG_HOME/mongocli

如果未设立$XDG_CONFIG_HOME ， MongoDB CLI将使用：

$HOME/.config/mongocli

个人资料

MongoDB CLI配置文件将相关设置和API密钥存储在名为配置文件的群组中。您可以创建或定义多个配置文件，以便可以使用MongoDB CLI从同一终端访问权限不同的MongoDB服务或项目。

注意

存储在环境变量中的任何设置都优先于存储在配置文件中的设置。

要使用特定配置文件运行 MongoDB CLI，请将 --profile <profileName> 选项附加到命令中。

默认配置文件

如果运行的命令不带 --profile 选项，MongoDB CLI 将使用默认配置文件中的设置。MongoDB CLI 会根据您配置的配置文件数量来确定默认配置文件：

如果只有一个配置文件，MongoDB CLI 会使用该配置文件作为默认配置文件。
如果您有多个配置文件，MongoDB CLI 将使用名为 default 的配置文件作为默认配置文件。如果您没有名为 default 的配置文件，并且运行需要某些设置的命令，则 MongoDB CLI 会因为缺失的设置返回错误。

例子

The following example configuration file contains the path to the MongoDB Shell, mongosh, and two profiles, default and myOpsManager.

default 配置文件连接到 Atlas 部署，并包含以下设置：

组织 ID
API 密钥
项目 ID

myOpsManager 配置文件连接到 Ops Manager 部署并包括以下设置：

MongoDB Ops Manager基本URL 。
组织 ID。
API密钥。
项目 ID。
可选：本地系统上用于签署客户端和 Ops Manager TLS 证书的 PEM 编码证书颁发机构 (CA) 证书的完整路径
可选标志，指示 CA TLS 证书是否已验证。

$XDG_CONFIG_HOME/mongocli/config.toml
mongosh_path = "/usr/local/bin/mongosh"
[default]
  organization_id = "qwer5678uiop23jb45lk78mn"
  public_api_key = "ABCDEFG"
  project_id= "5e2f04ecf10fcd33c7d4077e"
  private_api_key = "e750d2bf-1234-4cde-5678-ca4dcbcac9a4"
  service = "cloud"
[myOpsManager]
  ops_manager_ca_certificate = /etc/ssl/certs/ca.pem
  ops_manager_skip_verify = no
  ops_manager_url = "http://localhost:9080/"
  organization_id = "jklsa23123dsdf3jj456hs2"
  public_api_key = "HIJKLMN"
  project_id = "kk12jdn43jd123dkdkf97jg"
  private_api_key = "e750d2bf-9101-4cde-1121-ca4dcbcac9a5"
  service = "ops-manager"

要使用 default 配置文件运行 MongoDB CLI，请在命令中省略 --profile 选项：

mongocli <command>

要使用 myOpsManager 配置文件运行 MongoDB CLI，请在命令中省略 --profile myOpsManager 选项：

mongocli <command> --profile myOpsManager