IBM Cloud Docs
配置 App Configuration

配置 App Configuration

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工具集成参数
参数 用途 Type 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_name App Configuration 服务实例所在的资源组的名称。

了解有关App Configuration的更多信息

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