配置 App Configuration

DevOps Insights 该服务将于 2026 年 8 月 31 日停止提供并终止。Continuous Delivery 将于 2027 年 2 月 12 日在以下区域停止提供：au-syd、ca-tor、us-east。 Code Risk Analyzer 也将于该日期在所有地区停止提供服务。 如果某个区域未实际使用这些功能，该区域内的相关功能可能会提前停用，并停止接受新实例。 了解更多

IBM Cloud® App Configuration 是一种集中化的特性管理与配置服务，为在工具链中访问、引用和复用特性开关及属性集合提供了便捷、一致且安全的方式。

您可以使用 App Configuration 服务实例仪表板来配置 App Configuration 实例，以添加和管理包含功能部件标志和属性集的特定环境和集合。 您可以通过指定根据用户属性和规则进行评估的目标段来进一步优化功能部件标志和属性的使用。

您还可以将 App Configuration 工具集成添加到工具链，并将特定功能标志或属性从服务实例应用于环境或关联管道的触发器属性。 您可以根据需要使用 App Configuration 服务实例在多个工具链中重复此过程。 例如，您可以使用服务实例在多个环境中集中存储和管理工具链所需的所有功能标志和属性。

将功能部件标志或属性应用于工具链时，会将特殊 App Configuration 功能部件标志和属性引用保存在工具链中，而不是保存在文字值中。 此功能部件支持直接从 App Configuration 服务实例集中管理功能部件标志和属性。 然后，功能部件标志和属性值将立即可用于在后续管道运行期间包含对这些功能部件标志和属性值的引用的工具链。

创建 App Configuration 集成

在工具链中创建工具 App Configuration 集成之前，请确保已在工具链可访问的区域和资源组中配置了服务 App Configuration 实例。

  1. 如果在创建工具链时配置此工具集成，并且要配置的模板中存在 App Configuration 工具集成，请单击 App Configuration 选项卡。 或者，在“更多工具”部分中，单击 App Configuration。 要在工具链与 App Configuration 服务实例之间创建授权，请从 授权类型 下拉列表中选择 为此工具链创建授权 选项。 这将授予工具链对 App Configuration 服务实例中存储的功能标志和属性的访问权。

  2. 若您已有现成的工具链并需向其中添加此工具集成，请在 IBM Cloud 控制台中点击菜单图标 （汉堡图标 ）> 平台自动化 > 工具链。 在“工具链”页面上，单击现有工具链以打开其“概述”页面。

    a. 单击 “添加工具”。

    b. 在“工具集成”部分中，单击 App Configuration。

  3. 在工具链中的“App Configuration”卡片上，输入您希望为此新工具集成显示的名称。 此名称用于标识工具链中的工具集成。

  4. 选择 App Configuration 服务实例所在的 区域 和 资源组。

  5. 从所选 App Configuration 服务实例中选择相应的 App Configuration 环境 和 App Configuration 集合 选项。

  6. 要在工具链与 App Configuration 服务实例之间创建授权，请单击 创建授权 按钮。 这将授予工具链对 App Configuration 服务实例中存储的功能标志和属性的访问权。

  7. 单击创建集成。

应用功能标志和属性

配置 App Configuration 工具集成后，可以使用它将功能标志和属性应用于工具链环境和触发器属性。

  1. 在“管道环境属性”选项卡或“触发器属性”选项卡中，单击 添加 以显示可用属性类型的列表。

  2. 选择 AppConfig 值，然后选择要应用于工具链环境和触发器属性的功能标志或属性。

  3. 指定新工具链环境或触发器属性的名称。

  4. 从其中选择 App Configuration 工具集成以及 环境 和 集合。

  5. 选择 功能部件标志 或 属性，然后从 App Configuration 服务实例内的列表中选择目标功能部件标志或属性。

  6. 单击 确定 以将 App Configuration 引用应用于与其关联的字段。

授权工具链访问功能部件标志和属性

在工具链运行时，将动态解析对存储在 App Configuration 服务实例中的功能标志和属性的引用。 要访问必需的功能部件标志和属性，必须授权工具链访问 App Configuration 实例。 如果要根据模板创建工具链，请在配置 App Configuration 集成时使用 授权类型 下拉列表。 如果要将 App Configuration 集成添加到现有工具链，请使用 创建授权 按钮。

要在 IBM Cloud中查看授权，请完成以下步骤:

  1. 在 IBM Cloud 控制台中，点击 “管理” >“访问（IAM）”。
  2. 点击 “授权”。

您还可以在“管理权限”页面上访问权限。

如果需要，您还可以手动创建授权。 要成功解析 App Configuration 引用，工具链实例必须同时具有对正确的 App Configuration 服务实例的 Viewer 和 Reader 访问权。

使用 API 配置 App Configuration

工具 App Configuration 集成支持以下配置参数，您可在 创建、读取和 更新工具集成时 通过工具链 HTTP API 和 SDK 使用这些参数。

必须在请求主体中使用 appconfig 值指定 tool_type_id 属性。

App Configuration工具集成参数
参数 用途 类型 Terraform 自变量 描述
collection-名称 必需，可更新 字符串 collection_id App Configuration 集合的ID。
环境-名称 必需，可更新 字符串 environment_id App Configuration 环境的标识。
实例名称 必需，可更新 字符串 instance_id App Configuration 服务实例的 guid。
名称 必需，可更新 字符串 名称 此工具集成的名称。App Configuration 引用包含此名称以标识配置值所在的 App Configuration 实例。 确保集成到工具链中的每个 App Configuration 工具都具有唯一名称以供解析正常运行。
区域 必需，可更新 字符串 位置 App Configuration 服务实例所在的 IBM Cloud 位置。
resource-group 必需，可更新 字符串 资源组名称 App Configuration 服务实例所在的资源组的名称。

了解更多关于 App Configuration

要了解有关 App Configuration的更多信息，请参阅 App Configuration 入门。