使用 Azure Pipelines 在 應用程式組態 中建立快照集

Azure 應用程式組態 快照集工作的設計目的是在 Azure 應用程式組態 中建立快照集。

必要條件

• Azure 訂用帳戶 - 建立免費帳戶
• 應用程式組態存放區 - 免費建立一個存放區
• Azure DevOps 專案–免費建立一個專案
• Azure Pipelines 代理程式 2.144.0 版或更新版本和 節點 16 版或更新版本，用於在自我裝載代理程式上執行工作。

建立服務連線

服務連線可讓您從 Azure DevOps 專案中存取 Azure 訂用帳戶的資源。

1. 在 Azure DevOps 中，移至包含目標管線的專案。 在左下角中，選取 [專案設定]。

2. 在管線 下方，選取服務連線。 在右上角中，選取 [新的服務連線]。

3. 在 [新的服務連線] 中，選取 [Azure Resource Manager]。

   

4. 在 [驗證方法] 對話框中，選取 [工作負載身分識別同盟]，以建立新的工作負載身分識別同盟，或選取 [工作負載身分識別同盟] 來使用現有的工作負載身分識別同盟。

5. 輸入您的訂用帳戶、資源群組，以及服務連線的名稱。

如果您已建立新的服務主體，請尋找指派給服務連線的服務主體名稱。 您將在下一個步驟中將新的角色指派新增至此服務主體。

1. 移至 [專案設定]>[服務連線]。

2. 選取新的服務連線。

3. 選取 [管理服務主體]。

4. 請注意 [顯示名稱] 中的值。

   

新增角色指派

將適當的 應用程式組態 角色指派指派給工作內所使用的認證，讓工作可以存取 應用程式組態 存放區。

1. 移至您的目標應用程式組態存放區。

2. 在左側功能表中，選取 [存取控制 (IAM)]。

3. 在右窗格中，選取 [ 新增角色指派]。

   

4. 針對 [角色]，選取 [應用程式組態 數據擁有者]。 此角色可讓工作從應用程式組態存放區讀取，也可以使其寫入至應用程式組態存放區。

5. 您在上一區段有建立服務連線，請選取與其相關的服務主體。

   

6. 選取檢閱+指派。

在組建中使用

在本節中，瞭解如何在 Azure DevOps 建置管線中使用 Azure 應用程式組態 快照集工作。

1. 按一下 [管線]>[管線] 以瀏覽至組建管線的頁面。 如需組建管線的詳細資訊，請參閱 建立您的第一個管線。
   • 如果您要建立新的組建管線，請在進行到流程的最後一個步驟時，在 [檢閱] 索引標籤上，選取管線右側的 [顯示小幫手]。

     

   • 如果您使用現有的組建管線，請按一下右上方的 [編輯] 按鈕。

     

2. 搜尋 Azure 應用程式組態 快照集工作。

   

3. 設定工作的必要參數，以在 應用程式組態 存放區中建立快照集。 參數的說明位於下方的 Parameters區段和每個參數旁邊的工具提示中。

   

4. 儲存並將一個組建排入佇列。 建置記錄會顯示執行工作期間發生的任何失敗。

在發行版本中使用

在本節中，瞭解如何在 Azure DevOps 發行管線中使用 Azure 應用程式組態 快照集工作。

1. 選取 [管線發行]，以流覽至發行管線>頁面。 如需發行管線的詳細資訊，請移至 建立您的第一個管線。
2. 選擇現有的發行管線。 如果您沒有發行管線，請選取 [+ 新增] 以建立新的發行管線。
3. 選取右上角的 [編輯] 按鈕以編輯發行管線。
4. 在 [工作] 的下拉式清單中，選擇您要新增工作的 [階段]。 如需階段的詳細資訊，請參閱 新增階段、相依性及條件。

   

5. 按兩下 + 您要新增新工作的作業旁。

   

6. 在 [新增工作] 對話框中，在搜尋方塊中輸入 Azure 應用程式組態 快照集，然後加以選取。
7. 設定工作內的必要參數，以在 應用程式組態 存放區內建立快照集。 您可在下列 [參數] 區段中取得參數的說明，以及每個參數旁邊的工具提示。
8. 儲存發行並將其排入佇列。 發行記錄會顯示執行工作期間遇到的任何失敗。

參數

應用程式組態 快照集工作會使用下列參數：

• Azure 訂用帳戶：包含可用 Azure 服務連線的下拉式清單。 若要更新並重新整理可用的 Azure 服務連線清單，請按文字方塊右側的 [重新整理 Azure 訂用帳戶] 按鈕。

• 應用程式組態 端點：載入所選訂用帳戶下可用組態存放區端點的下拉式清單。 若要更新並重新整理可用組態存放區端點的清單，請按文本框右側的 [重新整理 應用程式組態 端點] 按鈕。

• 快照集名稱：指定快照集的名稱。

• 組合類型：預設值為 Key。

  • 索引鍵：篩選會依此組合類型套用。 快照集中的每個索引鍵/值只會由索引鍵唯一識別。 如果有多個索引鍵/值具有相同索引鍵和多個標籤，則只會根據最後一個適用的篩選來保留一個索引鍵/值。

  • 索引鍵標籤：將會套用篩選，而且產生的快照集中的每個索引鍵/值都會由索引鍵和標籤一起唯一識別。

• 篩選：代表用來建置 應用程式組態 快照集的索引鍵和標籤篩選。 篩選應該是有效的 JSON 格式。 範例 [{"key":"abc*", "label":"1.0.0"}]。 至少應指定一個篩選，最多可以指定三個篩選條件。

• 保留期間：預設值為30天。 指的是快照集在封存後將保留的天數。 封存的快照集可以在保留期間復原。

• 標記：格式為 的 {"tag1":"val1", "tag2":"val2"}JSON 物件，它會定義新增至 應用程式組態 存放區中建立之每個快照集的標籤。

疑難排解

如果發生非預期的錯誤，可以將管線變數 system.debug 設定為 true 以啟用偵錯記錄。

後續步驟

如需參數的完整參考，或在 YAML 管線中使用此管線工作，請參閱下列檔。

Azure 應用程式組態 快照集工作參考

若要瞭解如何從 應用程式組態 存放區導出索引鍵/值，並將其設定為 Azure 管線變數，請繼續進行下列檔。

使用 Azure 管線從 應用程式組態 導出設定

若要瞭解如何將機碼值從組態檔匯入至您的 應用程式組態 存放區，請繼續進行下列檔。

使用 Azure 管線將設定匯入至 應用程式組態