配置是一组指定的 Distributed Cloud CLI 属性。这些属性是键值对,组织整理为各个部分,用于控制 gdcloud CLI 的行为。
配置中存储的常见属性包括组织控制台网址和项目 ID。您可以通过配置,将这些属性及其他设置作为一个组同时定义并启用。
配置存储在用户配置目录中,在 macOS 和 Linux 上通常为 ~/.config/gdcloud
。另请注意,必须允许写入配置目录。
如果您有多个配置,可以选择在这些配置之间切换,或者使用特定配置运行命令(借助 --configuration
标志)。如需详细了解如何切换配置,请参阅激活配置部分。
如需通过命令行查看配置,以及可用的属性及其所属各部分的完整列表,请运行 gdcloud topic
configurations
。
默认配置
gdcloud CLI 最初会创建一个名为 default
的配置。您可以通过运行 gdcloud
init
命令或直接运行 gdcloud config set
来设置配置中的属性。
多个配置
单个 default
配置适用于许多用例。不过,您也可以创建其他配置,并根据需要使用 gdcloud config configurations activate
在这些配置之间切换。初始 default
配置只是为了方便您使用,并非是使用此功能的必要条件。您可以按照自己的想法为此配置以及其他任何配置指定名称。
如果您想要执行以下操作,建议您使用多个配置:
- 使用多个项目:您可以为每个项目创建一个单独的配置,并根据需要在它们之间切换。
- 使用多个组织控制台网址。
- 执行通常具有独立性的任务:例如,您可以在一个项目中使用一种配置来处理服务 A,并在另一个项目中使用另一种配置来管理不相关的服务 B。
创建配置
如需创建配置,请运行以下命令:
gdcloud config configurations create NAME
您必须在创建后激活新配置,然后才能使用新配置。
激活配置
如果您有多个配置,则在给定的某个时间,只能有一个配置处于活动状态。活动配置的属性会决定 gdcloud CLI 的行为。
如需激活新配置或切换到新的有效配置,请运行以下命令:
gdcloud config configurations activate NAME
gdcloud config list
将始终向您显示有效配置中的属性。
如需更改单个命令调用的有效配置,请为任意 gcloud CLI 命令应用 --configuration
标志:
gdcloud auth print-identity-token --configuration=CONFIGURATION
列出配置
如需列出 gdcloud CLI 中的配置,请运行以下命令:
gdcloud config configurations list
gdcloud CLI 会列出配置并显示哪个配置处于有效状态:
NAME ISACTIVE PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default False example-project-default https://console.default-org.example.com
config-project-1 False example-project-1 https://console.org-1.example.com
config-project-2 False example-project-2 https://console.org-2.example.com
设置配置属性
如需设置和取消设置活跃配置中的属性,请运行:
gdcloud config set project PROJECT
查看配置属性
如需查看配置中的属性,请运行以下命令:
gdcloud config configurations describe NAME
gdcloud CLI 会显示配置属性:
is_active: false
name: default
properties:
accessibility:
screen_reader: "false"
auth:
login_config_cert_path: /tmp/root-web-tls-ca.cert
core:
organization_console_url: https://console.example.com
project: example-project
如需查看活跃配置中的属性,请运行以下命令:
gdcloud config list
删除配置
如需删除配置,请运行以下命令:
gdcloud config configurations delete NAME
您无法删除活跃配置。如需在删除之前切换到另一个配置,请使用 gdcloud config configurations activate
(如果需要)。