快照集

快照集是應用程式組態存放區索引鍵/值的不可變具名子集。 建立過程中會透過索引鍵和標籤篩選條件,選擇組成快照集的索引鍵/值。 建立快照集之後,其中的索引鍵/值一定會維持不變。

影片提供簡要概觀,其中強調快照集對您大有助益的三個原因。

使用快照集安全地部署

快照集的設計目的是要安全地部署組態變更。 將錯誤組態變更部署到執行中環境,可能會導致服務中斷和資料遺失等問題。 為了避免這類問題,請務必在移至生產環境之前,先行檢查組態變更。 如果發生這類問題,請務必設法復原任何錯誤組態變更,才能還原服務。 您可以建立快照集來管理這些案例。

組態變更應以受控制且一致的方式進行部署。 開發人員可以使用快照集來執行受控推出。 應用程式開始受控推出所需的唯一變更,是更新應用程式所參考的快照集名稱。 當應用程式移至生產環境時,參考快照集中的組態一定會維持不變。 這可確保快照集中的任何變更都不會造成非預期的設定變更,影響應用程式移至生產環境。 快照集的不變性和輕鬆參考的特性,讓您可以輕鬆確保可以安全推出一組正確的組態變更。

使用快照集的案例

  • 受控推出:由於快照集的不可變性質,因此非常適合用來支援受控推出。 當開發人員在組態中使用快照集時,他們確信隨著發行在不同推出階段的進展,組態仍會維持不變。

  • 上一個已知正確 (LKG) 組態:您可以使用快照集來支援組態的安全部署做法。 使用快照集時,開發人員可以確保在部署期間發生任何問題時,使用上一個已知正確 (LKG) 組態進行復原。

  • 組態版本設定:快照集可用來建立組態設定的版本歷程記錄,以便與發行版本同步。 您可以比較每個快照集中擷取的設定,以識別版本之間的變更。

  • 稽核:您可以使用快照集進行稽核和檢查合規性。 開發人員可以使用各版本的快照集,維護不同版本的組態變更記錄。

  • 測試和預備環境:您可以使用快照集來建立一致的測試和預備環境。 開發人員可以使用相同的快照集,確保不同環境使用相同的組態,這有助於偵錯和測試。

  • 簡化用戶端組態組合:通常,應用程式組態的用戶端需要應用程式組態執行個體中的索引鍵/值子集。 若要取得所需的索引鍵/值集,則必須以程式碼撰寫查詢邏輯。 由於快照集支援在建立期間提供篩選,有助於簡化用戶端組合,因為用戶端現在可以依名稱參考所需的索引鍵/值集。

快照集作業

由於快照集是不可變的實體,因此只能建立和封存。 無法刪除、清除或編輯。

  • 建立快照集:您可以定義索引鍵和標籤篩選條件,從應用程式組態執行個體擷取所需的索引鍵/值,藉此建立快照集。 篩選出的索引鍵/值會使用建立期間提供的名稱,儲存為快照集。

  • 封存快照集:封存快照集會讓它進入封存狀態。 雖然快照集已封存,但仍可正常運作。 封存快照集時,會根據快照集建立期間所設定的保留期間來設定到期時間。 如果快照集維持在封存狀態直到到期時間為止,則在到期時,就會自動從系統消失。 封存是用來逐步淘汰不再使用的快照集。

  • 復原快照集:復原快照集會讓快照集重新進入使用中狀態。 此時,快照集需遵循設定的保留期間,不再受到到期時間的限制。 復原只有在封存後的保留期間才能進行。

注意

只有在快照集建立期間才能設定保留期間。 標準存放區的保留期間預設值為 30 天,免費存放區為 7 天。

快照集作業的需求

下列各節詳述使用 Microsoft Entra ID 和 HMAC 驗證執行快照集相關作業所需的權限。

建立快照集

若要在存放區中使用 Microsoft Entra 驗證建立快照集,需要下列權限。 應用程式組態資料擁有者角色已經擁有這些權限。

  • Microsoft.AppConfiguration/configurationStores/keyvalues/read
  • Microsoft.AppConfiguration/configurationStores/snapshots/write

若要使用 HMAC 驗證建立快照集,必須使用讀寫存取金鑰。

封存和復原快照集

若要使用 Microsoft Entra 驗證封存和/或復原快照集,需要下列權限。 應用程式組態資料擁有者角色已經擁有此權限。

  • Microsoft.AppConfiguration/configurationStores/snapshots/archive/action

若要使用 HMAC 驗證封存和/或封存層快照集,必須使用讀寫存取金鑰。

讀取和列出快照集

若要列出所有快照集,或依名稱取得個別快照集中的所有索引鍵/值,則必須具備下列權限才能在存放區使用 Microsoft Entra 驗證。 內建的資料擁有者和資料讀者角色已擁有此權限。

  • Microsoft.AppConfiguration/configurationStores/snapshots/read

對於使用 HMAC 驗證的存放區,「讀取快照集」作業 (從快照集讀取索引鍵/值) 和「列出快照集」作業都可以使用讀寫存取金鑰或唯讀存取金鑰來執行。

計費考量和限制

應用程式組態有兩個階層:免費和標準。 請檢查下列詳細資料,以了解每一層中的快照集配額。

  • 免費層:此層的快照集儲存體配額為 10 MB。 只要所有使用中和封存快照集的總儲存體大小小於 10 MB,就可以建立所有需要的快照集。

  • 標準層:此層的快照集儲存體配額為 1 GB。 只要所有使用中和封存快照集的總儲存體大小小於 1 GB,就可以建立所有需要的快照集。

快照集的大小上限為 1 MB。

下一步