共用方式為

管理和使用快照集

在本文中，瞭解如何在 Azure 應用程式組態中建立、使用和管理快照集。 快照集是一組以不可變狀態儲存的應用程式組態設定。

先決條件

  • 應用程式組態存放區，如 建立存放區的教學課程所示。
  • 應用程式組態存放區中的 「DataOwner」 角色。 快照所需角色與權限的詳細資訊

將鍵-值添加到應用程式設定存放區

在您的應用程式組態存放區中，移至 [作業>組態總管 ]，然後新增下列索引鍵/值。 保留 內容類型 的預設值。 若要瞭解如何使用 Azure 入口網站或 CLI 將鍵值新增至儲存區的詳細資訊，請移至建立鍵值。

鑰匙 價值觀 標籤
app2/bgcolor 淺灰色 label2
app1/color 黑色 沒有標籤
app1/color 藍 label1
app1/color 綠色 label2
app1/color 黃色 label3
app1/message Hello label1
app1/message 你好！ label2
app2/message 早上好！ label1

建立快照

在 [作業]>[快照] 底下，選取 [建立新的快照]。

  1. 輸入 快照集名稱 ，並選擇性地新增 標記。

  2. 在 [選擇組合類型] 底下，保留預設值 [索引鍵][預設值]。

    • 使用 金鑰 組合類型時，如果您的存放區具有相同的索引鍵與不同的標籤，則快照集只會包含最後一個適用篩選中指定的索引鍵值。 與其他標籤相同的金鑰值會排除在快照集之外。
    • 使用 Key-Label 組合類型時，如果您的存放區有相同的索引鍵但不同的標籤，則依據指定的篩選條件，所有具有相同索引鍵但不同標籤的索引鍵值都會包含在快照集中。

  3. 選取 [新增篩選] 選取快照集的金鑰值。 篩選是藉由選取篩選來完成：金鑰和標籤的 [等於]、[開頭為] 和 [全部]。 您可以在一到三個篩選之間輸入。

    1. 新增第一個篩選：
      • 在 [金鑰] 下，選取 [開頭為] 並輸入 app1
      • 在 Label 底下，選擇 Equals，然後從下拉選單中選擇 label2。
    2. 新增第二個篩選：
      • 在 [金鑰] 下，選取 [開頭為] 並輸入 app1
      • 在[標籤]下選取[等於]，然後從下拉功能表中選取label1。

  4. 如果您封存快照集，根據預設，它會在封存后保留 30 天。 或者，在 [復原選項] 下，減少快照集在封存之後可使用的保留天數。

    備註

    建立快照集之後，就無法更新保留期間的持續時間。

  5. 選取 [建立] 以產生快照集。 在此範例中，所建立的快照具有 金鑰 組合類型和下列篩選：

    • 以 app1 開頭的金鑰，使用 label2 標籤
    • 開頭為 app1 的索引鍵，其標籤為 label1。

    [建立] 表單的螢幕擷取畫面，其中已如上述步驟填入資料並醒目提示 [建立] 按鈕。

  6. 請檢查表格，以瞭解組態存放區中哪些鍵值最終會根據所提供的參數出現在快照中。

    鑰匙 價值觀 標籤 包含在快照內
    app2/bgcolor 淺灰色 label2 否：不是從 app1 開始。
    app1/color 黑色 沒有標籤 否：沒有標籤 label2 或 label1。
    app1/color 藍 label1 是：具有來自最後一個適用篩選條件的正確標籤 label1 。
    app1/color 綠色 label2 否：第二個篩選所選取標籤 label1 的相同金鑰會覆寫此金鑰，不過其具有選取的標籤 label2。
    app1/color 黃色 label3 否：沒有標籤 label2 或 label1。
    app1/message Hello label1 是：具有來自最後一個適用篩選條件的正確標籤 label1 。
    app1/message 你好！ label2 否：第二個篩選所選取標籤 label1 的相同金鑰會覆寫此金鑰，不過其具有選取的標籤 label2。
    app2/message 早上好！ label1 否：不是從 app1 開始。

建立範例快照集

若要建立範例快照集並檢查快照集功能的運作方式，請使用快照集沙盒。 此沙箱包含可供操作的示例資料，以進一步瞭解快照的組合類型和篩選器的運作方式。

  1. 在 [作業]>[快照集]>[作用中快照集] 中，選取 [沙箱中的測試]。
  2. 請檢閱範例資料，並練習使用組合類型和一或多個篩選填入表單來建立快照集。
  3. 選取 [建立] 以產生範例快照集。
  4. 查看在 生成的範例快照 生成的快照結果。 根據您的選取範圍，範例快照集會顯示範例快照集中包含的全部金鑰。

使用快照

您可以針對應用程式的組態選取任意數目的快照集。 選取快照集會新增其全部金鑰值。 新增至組態之後，快照集的金鑰值會視為與其他任何金鑰值相同。

如果您有使用 Azure 應用程式組態的應用程式，您可以使用下列範例程式代碼來更新它，以使用快照集。 您只需要提供區分大小寫的快照集名稱。

編輯對 AddAzureAppConfiguration 方法的呼叫，這通常位於應用程式的 Program.cs 檔案中。 如果您沒有應用程式，您可以參考任何 .NET 快速入門指南，例如 使用 Azure 應用程式組態建立 ASP.NET 核心應用程式。

將快照集新增至您的設定

configurationBuilder.AddAzureAppConfiguration(options =>
{
    string endpoint = Environment.GetEnvironmentVariable("Endpoint"); 
    options.Connect(new Uri(endpoint), new DefaultAzureCredential());
    // Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
    options.SelectSnapshot("SnapshotName");
    
    // Other changes to options
});

備註

如果您使用下列任何套件的 7.0.0 版或更高版本，則可以使用快照功能支援。

  • Microsoft.Extensions.Configuration.AzureAppConfiguration
  • Microsoft.Azure.AppConfiguration.AspNetCore
  • Microsoft.Azure.AppConfiguration.Functions.Worker

備註

只有使用組合類型 Key 建立的快照集，才能使用上面所示的程式代碼範例來載入。

管理作用中快照集

[作業>快照] 底下的頁面會顯示兩個標籤：[使用中快照] 和 [封存的快照]。 選取 現用快照 以檢視應用程式組態儲存庫中所有現用快照的清單。

活動快照清單的螢幕截圖。

檢視現有的快照集

在 [ 作用中快照 集] 索引卷標中，選取現有快照集右邊的省略號 ... ，然後選取 [ 檢視 ] 以檢視快照集。 此動作會開啟快照集詳細數據頁面，其中顯示快照集的設定和快照集中包含的索引鍵值。

活動快照詳細檢視的螢幕擷圖。

封存快照

在 [ 作用中快照 ] 標籤中，選取現有快照右邊的省略號 ...，然後選取 [ 封存 ] 以封存快照。 選取 [ 是 ] 以確認封存或選取 [ 否 ] 以取消操作。 一旦封存快照集，就會顯示通知以確認作業並更新使用中快照集的清單。

使用中快照集中封存選項的螢幕擷取畫面。

管理封存的快照集

移至作業>快照>封存快照以檢視應用程式組態存放區中所有封存快照的清單。 封存的快照集在建立時選定的保留期間內仍可存取。

封存快照集清單的螢幕快照。

檢視封存的快照集

快照集的詳細檢視也可在封存狀態中使用。 在 [ 封存的快照 集] 索引卷標中，選取現有快照集右邊的省略號 ... ，然後選取 [ 檢視 ] 以檢視快照集。 此動作會開啟快照集詳細數據頁面，其中顯示快照集的設定和快照集中包含的索引鍵值。

封存快照集的詳細檢視螢幕快照。

復原封存的快照

在 [ 封存的快照 集] 索引卷標中，選取封存快照集右邊的省略號 ... ，然後選取 [ 復原 ] 以復原快照集。 復原快照集之後，會出現通知以確認作業，並更新封存的快照集清單。

封存快照中恢復選項的螢幕截圖。

後續步驟

Azure 應用程式組態中的快照集

  • Last updated on