Momentaufnahmen

Ein Momentaufnahme ist eine benannte, unveränderliche Teilmenge der Schlüsselwerte eines App Configuration-Speichers. Die Schlüsselwerte, aus denen eine Momentaufnahme besteht, werden während der Erstellungszeit durch die Verwendung von Schlüssel- und Bezeichnungsfiltern ausgewählt. Nachdem eine Momentaufnahme erstellt wurde, bleiben die darin enthaltenen Schlüsselwerte garantiert unverändert.

Eine kurze Übersicht finden Sie in diesem Video, in dem drei Gründe genannt werden, aus denen Momentaufnahmen für Sie hilfreich sein können.

Sichere Bereitstellung mit Momentaufnahmen

Momentaufnahmen sind für die sichere Bereitstellung von Konfigurationsänderungen konzipiert. Die Bereitstellung fehlerhafter Konfigurationsänderungen in einer ausgeführten Umgebung kann zu Problemen wie Dienstunterbrechungen und Datenverlust führen. Um solche Probleme zu vermeiden, ist es wichtig, Konfigurationsänderungen überprüfen zu können, bevor diese auf Produktionsumgebungen angewendet werden. Wenn ein solches Problem auftritt, muss ein Rollback der fehlerhaften Konfigurationsänderungen möglich sein, um den Dienst wiederherzustellen. Für genau solche Szenarien werden Momentaufnahmen erstellt.

Konfigurationsänderungen sollten kontrolliert und konsistent bereitgestellt werden. Entwicklungsteams können Momentaufnahmen verwenden, um einen kontrollierten Rollout durchzuführen. Die einzige Änderung, die an einer Anwendung vorgenommen werden muss, um einen kontrollierten Rollout zu starten, besteht darin, den Namen der Momentaufnahme zu aktualisieren, auf die die Anwendung verweist. Wenn die Anwendung in die Produktion übergeht, wird garantiert, dass die Konfiguration in der zugehörigen Momentaufnahme unverändert bleibt. Diese Garantie der Unveränderlichkeit einer Momentaufnahme verhindert, dass unerwartete Einstellungen in die Produktion gelangen. Durch die Unveränderlichkeit und die einfache Referenzierbarkeit von Momentaufnahmen können Sie problemlos sicherstellen, dass die richtigen Konfigurationsänderungen sicher eingeführt werden.

Szenarien für die Verwendung von Momentaufnahmen

• Kontrollierter Rollout: Momentaufnahmen eignen sich aufgrund ihrer Unveränderbarkeit gut zur Unterstützung kontrollierter Rollouts. Wenn Entwicklungsteams Momentaufnahmen für die Konfiguration verwenden, können sie sicher sein, dass die Konfiguration unverändert bleibt, während das Release verschiedene Phasen des Rollouts durchläuft.

• LKG-Konfiguration (Last Known Good, Letzte bekannte fehlerfreie Konfiguration): Momentaufnahmen können zur Unterstützung sicherer Bereitstellungsmethoden für die Konfiguration verwendet werden. Mit Momentaufnahmen können Entwicklungsteams sicherstellen, dass eine LKG-Konfiguration für einen Rollback verfügbar ist, wenn während der Bereitstellung ein Problem aufgetreten ist.

• Versionsverwaltung für Konfigurationen: Mit Momentaufnahmen kann ein Versionsverlauf der Konfigurationseinstellungen für die Synchronisierung mit Releaseversionen erstellt werden. Einstellungen, die in den einzelnen Momentaufnahmen erfasst werden, können verglichen werden, um Änderungen zwischen Versionen zu identifizieren.

• Auditing: Nutze Snapshots für Audit- und Compliance-Zwecke. Entwickler können Konfigurationsänderungen zwischen den Veröffentlichungen aufzeichnen, indem sie Snapshots für die Veröffentlichungen verwenden.

• Test- und Stagingumgebungen: Momentaufnahmen können verwendet werden, um einheitliche Test- und Stagingumgebungen zu erstellen. Entwicklungsteams können sicherstellen, dass dieselbe Konfiguration in verschiedenen Umgebungen verwendet wird, indem sie dieselbe Momentaufnahme verwenden. Das kann beim Debuggen und Testen hilfreich sein.

• Vereinfachte Client-Konfigurationszusammensetzung: In der Regel benötigen App-Konfigurationsclients eine Teilmenge der Schlüsselwerte einer App-Konfigurationsinstanz. Ohne Snapshots benötigen Clients Abfragelogik im Code, um die erforderlichen Schlüsselwerte abzurufen. Da Snapshots Filter zur Erstellung unterstützen, können Clients den erforderlichen Satz von Schlüsselwerten mit Namen angeben.

Momentaufnahmevorgänge

Da Snapshots unveränderlich sind, können Sie sie erstellen und archivieren, aber nicht löschen, endgültig löschen oder bearbeiten.

• Erstellen von Momentaufnahmen: Momentaufnahmen können erstellt werden, indem die Schlüssel- und Bezeichnungsfilter definiert werden, um die erforderlichen Schlüsselwerte aus der App Configuration-Instanz zu erfassen. Die gefilterten Schlüsselwerte werden als Momentaufnahme mit dem bei der Erstellung angegebenen Namen gespeichert.

• Archivieren von Momentaufnahmen: Durch die Archivierung einer Momentaufnahme wird sie in einen archivierten Zustand versetzt. Während der Archivierung sind Momentaufnahmen weiterhin voll funktionsfähig. Bei der Archivierung einer Momentaufnahme wird eine Ablaufzeit basierend auf dem Aufbewahrungszeitraum festgelegt, der während der Erstellung der Momentaufnahme konfiguriert wurde. Wenn die Momentaufnahme bis zur Ablaufzeit im archivierten Zustand verbleibt, wird sie bei erreichen der Ablaufzeit automatisch aus dem System entfernt. Die Archivierung wird zur Ausmusterung von Momentaufnahmen verwendet, die nicht mehr verwendet werden.

• Wiederherstellen von Momentaufnahmen: Durch die Wiederherstellung einer Momentaufnahme wird sie wieder in einen aktiven Zustand versetzt. An diesem Punkt unterliegt die Momentaufnahme nicht mehr der Ablaufzeit, die auf dem konfigurierten Aufbewahrungszeitraum basiert. Die Wiederherstellung ist nur im Aufbewahrungszeitraum nach der Archivierung möglich.

Anforderungen für Momentaufnahmevorgänge

In den folgenden Abschnitten werden die Berechtigungen erläutert, die zum Ausführen von Momentaufnahmevorgängen mit Microsoft Entra ID- und HMAC-Authentifizierung erforderlich sind.

Erstellen einer Momentaufnahme

Zum Erstellen einer Momentaufnahme in Speichern mit Microsoft Entra-Authentifizierung sind die folgenden Berechtigungen erforderlich. Die Rolle „App Configuration-Datenbesitzer“ verfügt bereits über diese Berechtigungen.

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

Zum Erstellen einer Momentaufnahme mithilfe der HMAC-Authentifizierung muss ein Schlüssel mit Lese-/Schreibzugriff verwendet werden.

Archivieren und Wiederherstellen von Momentaufnahmen

Zum Archivieren und/oder Wiederherstellen einer Momentaufnahme mit Microsoft Entra-Authentifizierung ist die folgende Berechtigung erforderlich. Die Rolle „App Configuration-Datenbesitzer“ verfügt bereits über diese Berechtigung.

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

Zum Archivieren und/oder Wiederherstellen einer Momentaufnahme mithilfe der HMAC-Authentifizierung muss ein Schlüssel mit Lese-Schreibzugriff verwendet werden.

Lesen und Auflisten von Momentaufnahmen

Um alle Snapshots aufzulisten oder alle Schlüsselwerte in einem einzelnen Snapshot nach Namen abzurufen, benötigen Sie folgende Berechtigung für Stores, die Microsoft Entra-Authentifizierung verwenden. Die integrierten Rollen Data Owner und Data Reader enthalten diese Berechtigung bereits.

• Microsoft.AppConfiguration/configurationStores/snapshots/read

Für Speicher mit HMAC-Authentifizierung können sowohl der Vorgang „Momentaufnahme lesen“ (zum Lesen der Schlüsselwerte aus einer Momentaufnahme) als auch der Vorgang „Momentaufnahmen auflisten“ entweder mit den Schlüsseln mit Lese-/Schreibzugriff oder den mit schreibgeschütztem Zugriff ausgeführt werden.

Abrechnungsüberlegungen und -grenzwerte

Die App-Konfiguration verfügt über vier Stufen: Kostenlos, Entwickler, Standard und Premium. In der folgenden Tabelle sind die Speicherkontingente für Momentaufnahmen für jede Ebene zusammengefasst.

Sie können beliebig viele Momentaufnahmen erstellen, solange die Gesamtspeichergröße aller aktiven und archivierten Momentaufnahmen das Kontingent für die Ebene nicht überschreitet. Die maximale Größe für eine einzelne Momentaufnahme beträgt 1 MB.

Nächste Schritte