Momentaufnahmen

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

Eine kurze Übersicht ist in diesem Video verfügbar, wobei drei Gründe hervorgehoben 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, ist es wichtig, dass ein Rollback der fehlerhaften Konfigurationsänderungen erfolgen kann, um den Dienst wiederherzustellen. Für den Umgang mit solchen Szenarios werden Momentaufnahmen erstellt.

Konfigurationsänderungen sollten kontrolliert und konsistent bereitgestellt werden. Entwickler*innen 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 beginnen, 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 vor Änderungen an einer Momentaufnahme verhindert, dass unerwartete Einstellungen in die Produktion gelangen. Durch die Unveränderlichkeit und die einfache Möglichkeit, auf Momentaufnahmen zu verweisen, können Sie ganz einfach sicherstellen, dass die richtigen Konfigurationsänderungen sicher eingeführt werden.

Szenarios für die Verwendung von Momentaufnahmen

• Kontrollierter Rollout: Momentaufnahmen eignen sich aufgrund ihrer unveränderlichen Natur gut zur Unterstützung des kontrollierten Rollouts. Wenn Entwickler*innen 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: Momentaufnahmen können verwendet werden, um sichere Bereitstellungsmethoden für die Konfiguration zu unterstützen. Mit Momentaufnahmen können Entwickler*innen sicherstellen, dass eine LKG-Konfiguration (Last Known Good) für einen Rollback verfügbar ist, wenn während der Bereitstellung ein Problem aufgetreten ist.

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

• Überwachung: Momentaufnahmen können zu Überwachungs- und Compliancezwecken verwendet werden. Entwickler*innen können eine Aufzeichnung der Konfigurationsänderungen zwischen den Releases verwalten, indem sie die Momentaufnahmen für die Releases verwenden.

• Test- und Stagingumgebungen: Momentaufnahmen können verwendet werden, um einheitliche Test- und Stagingumgebungen zu erstellen. Entwickler*innen 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 Zusammenstellung von Clientkonfigurationen: Normalerweise benötigen die Clients von App Configuration eine Teilmenge der Schlüsselwerte aus der App Configuration-Instanz. Um die erforderlichen Schlüsselwerte abzurufen, muss Code für Abfragelogik vorhanden sein. Da Momentaufnahmen die Bereitstellung von Filtern während der Erstellungszeit unterstützen, trägt dies zur Vereinfachung der Clientzusammenstellung bei, da Clients jetzt auf die Namen der benötigten Schlüsselwerte verweisen können.

Momentaufnahmenvorgänge

Da Momentaufnahmen unveränderliche Entitäten sind, können sie nur erstellt und archiviert werden. Es ist nicht möglich, sie zu löschen oder zu bearbeiten.

• Erstellen von Momentaufnahme: 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 eine Momentaufnahme archiviert wird, ist sie weiterhin voll funktionsfähig. Wenn die Momentaufnahme archiviert wird, 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, verschwindet sie automatisch aus dem System, wenn die Ablaufzeit erreicht ist. Die Archivierung wird zur schleichenden 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.

Hinweis

Der Aufbewahrungszeitraum kann nur während der Erstellung einer Momentaufnahme festgelegt werden. Der Standardwert für den Aufbewahrungszeitraum beträgt 30 Tage für Standard-Speicher und sieben Tage für Free-Speicher.

Anforderungen für Momentaufnahmenvorgänge

In den folgenden Abschnitten werden die Berechtigungen erläutert, die zum Ausführen von Momentaufnahmenvorgä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 Lese-/Schreibzugriffsschlüssel verwendet werden.

Archivieren und Wiederherstellen einer Momentaufnahme

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 Zugriffsschlüssel mit Lese- und Schreibzugriff verwendet werden.

Lesen und Auflisten von Momentaufnahmen

Um alle Momentaufnahmen aufzulisten oder alle Schlüsselwerte in einer einzelnen Momentaufnahme nach Namen abzurufen, ist die folgende Berechtigung für Speicher erforderlich, die die Microsoft Entra-Authentifizierung verwenden. Die integrierten Rollen „Datenbesitzer“ und „Datenleser“ verfügen bereits über diese Berechtigung.

• Microsoft.AppConfiguration/configurationStores/snapshots/read

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

Abrechnungsüberlegungen und -grenzwerte

App Configuration verfügt über zwei Tarife: Free und Standard. Im Folgenden finden Sie die Details zu den Momentaufnahmenkontingenten der einzelnen Tarife.

• Free-Tarif: Dieser Tarif verfügt über ein Speicherkontingent von 10 MB für Momentaufnahmen. Sie können beliebig viele Momentaufnahmen erstellen, solange die Gesamtspeichergröße aller aktiven und archivierten Momentaufnahmen weniger als 10 MB beträgt.

• Standard-Tarif: Dieser Tarif verfügt über ein Speicherkontingent von 1 GB für Momentaufnahmen. Sie können beliebig viele Momentaufnahmen erstellen, solange die Gesamtspeichergröße aller aktiven und archivierten Momentaufnahmen weniger als 1 GB beträgt.

Die maximale Größe für eine Momentaufnahme beträgt 1 MB.

Nächste Schritte

Erstellen einer Momentaufnahme