管理 gdcloud CLI 配置

配置是一组指定的 Distributed Cloud CLI 属性。这些属性是键值对,组织整理为各个部分,用于控制 gdcloud CLI 的行为。

配置中存储的常见属性包括组织控制台网址和项目 ID。您可以通过配置,将这些属性及其他设置作为一个组同时定义并启用。

配置存储在用户配置目录中(在 macOS 和 Linux 上通常为 ~/.config/gdcloud)。

如果您有多个配置,可以选择在这些配置之间切换,或者使用特定配置运行命令(借助 --configuration 标志)。如需详细了解如何切换配置,请参阅激活配置部分。

如需通过命令行查看配置(以及可用属性及其所属各部分的完整列表),请运行 gdcloud topic configurations

默认配置

gdcloud CLI 在一开始为您提供了名为 default 的单个配置。如需设置配置中的属性,请运行 gdcloud initgdcloud config set 命令。

多个配置

单个 default 配置适用于许多用例。不过,您也可以创建其他配置,并根据需要使用 gdcloud config configurations activate 在这些配置之间切换。初始 default 配置没有什么特别之处;它只是为了方便您使用。您可以按照自己的想法为此配置以及其他任何配置指定名称。

如果您想要执行以下操作,建议您使用多个配置:

  • 使用多个项目:您可以为每个项目创建一个单独的配置,并根据需要在它们之间切换。
  • 使用多个组织控制台网址
  • 执行通常具有独立性的任务:例如,您可以在一个项目中使用一种配置来处理服务 A,并在另一个项目中使用另一种配置来管理不相关的服务 B。

创建配置

如需创建配置,请运行 gdcloud config configurations create

gdcloud config configurations create NAME

您必须在创建后激活新配置,然后才能使用新配置。

激活配置

如果您有多个配置,则在给定的某个时间,只能有一个配置处于活动状态。有效配置的属性会决定 gdcloud CLI 的行为。

如需激活新配置或切换到新的有效配置,请运行 gdcloud config configurations activate

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:
    insecure_skip_tls_verify: "false"
    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(如果需要)。