配置 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 引數 說明
收藏品名稱 必要，可更新 字串 收藏集編號 App Configuration 集合的 ID。
環境名稱 必要，可更新 字串 環境識別碼 App Configuration 環境的 ID。
實例名稱 必要，可更新 字串 instance_id App Configuration 服務實例的 guid。
名稱 必要，可更新 字串 名稱 此工具整合的名稱。App Configuration 參照包含此名稱，以識別配置值所在的 App Configuration 實例。 請確定每一個整合至工具鏈的 App Configuration 工具都具有唯一名稱，可讓解析正常運作。
區域 必要，可更新 字串 位置 App Configuration 服務實例所在的 IBM Cloud 位置。
資源群組 必要，可更新 字串 資源群組名稱 App Configuration 服務實例所在的資源群組名稱。

進一步了解 App Configuration

若要進一步瞭解 App Configuration，請參閱 開始使用 App Configuration。