Teilen über

Verwalten und Verwenden von Momentaufnahmen

In diesem Artikel erfahren Sie, wie Sie Momentaufnahmen in der Azure-App-Konfiguration erstellen, verwenden und verwalten. Snapshot ist eine Gruppe von App-Konfigurationseinstellungen, die in einem unveränderlichen Zustand gespeichert sind.

Voraussetzungen

Hinzufügen von Schlüsselwerten zum App-Konfigurationsspeicher

Wechseln Sie im App-Konfigurationsspeicher zum Operations>Configuration Explorer , und fügen Sie die folgenden Schlüsselwerte hinzu. Belassen Sie den Inhaltstyp mit dem Standardwert. Weitere Informationen zum Hinzufügen von Schlüssel-Werten zu einem Speicher mithilfe des Azure-Portals oder der CLI finden Sie unter Erstellen eines Schlüssel-Werts.

Schlüssel Wert Etikett
app2/bgcolor Hellgrau Label2
app1/color Schwarze Keine Bezeichnung
app1/color Blau Bezeichnung1
app1/color Grün Label2
app1/color Gelb Label3
app1/message Hallo Bezeichnung1
app1/message Hallo! Label2
app2/message Guten Morgen! Bezeichnung1

Erstellen einer Momentaufnahme

Unter Operationen>Momentaufnahmen wählen Sie Neue Momentaufnahme erstellen aus.

  1. Geben Sie einen Momentaufnahmenamen ein und fügen Sie optional Tags hinzu.

  2. Behalten Sie unter Kompositionstyp auswählen den Standardwert Schlüssel (Standardeinstellung) bei.

    • Wenn der Schlüsselkompositionstyp identische Schlüssel mit unterschiedlichen Bezeichnungen aufweist, wird nur der im letzten anwendbaren Filter angegebene Schlüsselwert in die Momentaufnahme aufgenommen. Identische Schlüsselwerte mit anderen Bezeichnungen werden aus der Momentaufnahme weggelassen.
    • Wenn Ihr Speicher beim Kompositionstyp Schlüssel-Bezeichnung identische Schlüssel mit unterschiedlichen Bezeichnungen aufweist, sind alle Schlüssel-Wert-Paare mit identischen Schlüsseln, aber unterschiedlichen Bezeichnungen abhängig von den angegebenen Filtern in der Momentaufnahme enthalten.

  3. Wählen Sie "Filter hinzufügen" aus, um die Schlüsselwerte für Ihre Momentaufnahme auszuwählen. Die Filterung erfolgt durch Auswählen von Filtern: Gleich, Beginnt mit, Eines von und Alle für Schlüssel und für Bezeichnungen. Sie können zwischen einem und drei Filtern eingeben.

    1. Fügen Sie den ersten Filter hinzu:
      • Wählen Sie unter „Schlüssel“ die Option „Beginnt mit“ aus und geben Sie „app1“ ein.
      • Wählen Sie unter "Beschriftung" die Option "Gleich" aus, und wählen Sie " Label2 " im Dropdownmenü aus.
    2. Fügen Sie den zweiten Filter hinzu:
      • Wählen Sie unter „Schlüssel“ die Option „Beginnt mit“ aus und geben Sie „app1“ ein.
      • Wählen Sie unter "Beschriftung" die Option "Gleich" aus, und wählen Sie "Label1" im Dropdownmenü aus.

  4. Wenn Sie eine Momentaufnahme archivieren, wird sie standardmäßig 30 Tage nach der Archivierung aufbewahrt. Optionalerweise können Sie unter Wiederherstellungsoptionen die Anzahl der Aufbewahrungstage verringern, während deren die Momentaufnahme nach der Archivierung verfügbar sein wird.

    Hinweis

    Die Dauer des Aufbewahrungszeitraums kann nicht aktualisiert werden, nachdem die Momentaufnahme erstellt wurde.

  5. Wählen Sie "Erstellen" aus, um die Momentaufnahme zu generieren. In diesem Beispiel weist die erstellte Momentaufnahme den Typ Schlüsselkomposition und die folgenden Filter auf:

    • Schlüssel, die mit app1 beginnen, mit label2 label
    • Schlüssel, die mit app1 und dem Label label1 beginnen.

    Screenshot des Formulars

  6. Überprüfen Sie die Tabelle, um zu verstehen, welche Schlüsselwerte aus dem Konfigurationsspeicher auf Grundlage der gegebenen Parameter in der Momentaufnahme gespeichert werden.

    Schlüssel Wert Etikett In der Momentaufnahme enthalten
    app2/bgcolor Hellgrau Label2 Nein: Beginnt nicht mit app1.
    app1/color Schwarze Keine Bezeichnung Nein: hat nicht die Bezeichnung label2 oder label1.
    app1/color Blau Bezeichnung1 Ja: hat die richtige Bezeichnung label1 aus den letzten anwendbaren Filtern.
    app1/color Grün Label2 Nein: Derselbe Schlüssel mit der Bezeichnung label1, der vom zweiten Filter ausgewählt wurde, überschreibt diesen, obwohl er die ausgewählte Bezeichnung label2 aufweist.
    app1/color Gelb Label3 Nein: hat nicht die Bezeichnung label2 oder label1.
    app1/message Hallo Bezeichnung1 Ja: hat die richtige Bezeichnung label1 aus den letzten anwendbaren Filtern.
    app1/message Hallo! Label2 Nein: Derselbe Schlüssel mit der Bezeichnung label1, der vom zweiten Filter ausgewählt wurde, überschreibt diesen, obwohl er die ausgewählte Bezeichnung label2 aufweist.
    app2/message Guten Morgen! Bezeichnung1 Nein: Beginnt nicht mit app1.

Erstellen Sie Beispielmomentaufnahmen

Verwenden Sie den Snapshot-Sandkasten, um Beispielmomentaufnahmen zu erstellen und zu überprüfen, wie das Snapshot-Feature funktioniert. Diese Sandbox enthält Beispieldaten, mit denen Sie experimentieren können, um besser zu verstehen, wie der Kompositionstyp der Momentaufnahme und die Filter funktionieren.

  1. Wählen Sie in Operations>Snapshots>Active snapshotsTest in Sandbox aus.
  2. Überprüfen Sie die Beispieldaten und üben Sie das Erstellen von Momentaufnahmen, indem Sie das Formular mit einem Kompositionstyp und einem oder mehreren Filtern ausfüllen.
  3. Wählen Sie "Erstellen" aus, um die Beispielmomentaufnahme zu generieren.
  4. Sehen Sie sich das snapshot-Ergebnis an, das unter "Generierte Beispielmomentaufnahme" generiert wurde. Die Beispielmomentaufnahme zeigt alle Schlüssel an, die darin enthalten sind, entsprechend Ihrer Auswahl.

Verwenden von Momentaufnahmen

Sie können eine beliebige Anzahl von Momentaufnahmen für die Konfiguration der Anwendung auswählen. Wenn Sie eine Momentaufnahme auswählen, werden alle Schlüsselwerte hinzugefügt. Nach dem Hinzufügen zu einer Konfiguration werden die Schlüsselwerte aus Momentaufnahmen genauso behandelt wie jeder andere Schlüsselwert.

Wenn Sie über eine Anwendung mit der Azure App-Konfiguration verfügen, können Sie sie mit dem folgenden Beispielcode aktualisieren, um Momentaufnahmen zu verwenden. Sie müssen nur den Namen der Momentaufnahme angeben, bei der die Groß-/Kleinschreibung beachtet wird.

Bearbeiten Sie den Aufruf der Methode AddAzureAppConfiguration, die sich häufig in der Datei Program.cs Ihrer Anwendung befindet. Wenn Sie nicht über eine Anwendung verfügen, können Sie auf eines der .NET-Schnellstarthandbücher verweisen, z. B. das Erstellen einer ASP.NET Kern-App mit der Azure-App-Konfiguration.

Hinzufügen von Momentaufnahmen zu Ihrer Konfiguration

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
});

Hinweis

Snapshot-Unterstützung ist verfügbar, wenn Sie Version 7.0.0 oder höher eines der folgenden Pakete verwenden.

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

Hinweis

Nur Momentaufnahmen, die mit kompositionstyp Key erstellt wurden, können mit den oben gezeigten Codebeispielen geladen werden.

Verwalten aktiver Momentaufnahmen

Die Seite unter Operations>Snapshots zeigt zwei Registerkarten an: Aktive Momentaufnahmen und archivierte Momentaufnahmen. Wählen Sie aktive Momentaufnahmen aus, um die Liste aller aktiven Momentaufnahmen in einem App-Konfigurationsspeicher anzuzeigen.

Screenshot der Liste der aktiven Momentaufnahmen.

Vorhandene Momentaufnahme anzeigen

Wählen Sie auf der Registerkarte Aktive Momentaufnahmen die Auslassungspunkte ... rechts neben einer vorhandenen Momentaufnahme und dann Anzeigen aus, um eine Momentaufnahme anzuzeigen. Diese Aktion öffnet eine Momentaufnahmedetailseite, auf der die Einstellungen der Momentaufnahme und die Schlüsselwerte angezeigt werden, die in der Momentaufnahme enthalten sind.

Screenshot der detaillierten Ansicht einer aktiven Momentaufnahme.

Archivieren einer Momentaufnahme

Wählen Sie auf der Registerkarte " Aktive Momentaufnahmen " die Auslassungspunkte ... rechts neben einer vorhandenen Momentaufnahme aus, und wählen Sie "Archivieren " aus, um eine Momentaufnahme zu archivieren. Bestätigen Sie die Archivierung, indem Sie "Ja" auswählen oder die Aktion mit "Nein" abbrechen. Sobald eine Momentaufnahme archiviert wurde, wird eine Benachrichtigung angezeigt, um den Vorgang zu bestätigen, und die Liste der aktiven Momentaufnahmen wird aktualisiert.

Screenshot der Archivoption in den aktiven Momentaufnahmen.

Verwalten archivierter Momentaufnahmen

Wechseln Sie zu "Operations>Snapshots>Archivierte Momentaufnahmen ", um die Liste aller archivierten Momentaufnahmen in einem App-Konfigurationsspeicher anzuzeigen. Archivierte Momentaufnahmen bleiben für den Aufbewahrungszeitraum verfügbar, der während der Erstellung ausgewählt wurde.

Screenshot der Liste der archivierten Momentaufnahmen.

Archivierte Momentaufnahme anzeigen

Auch die detaillierte Ansicht der Momentaufnahme ist im Archivzustand verfügbar. Wählen Sie auf der Registerkarte Archivierte Momentaufnahmen die Auslassungspunkte ... rechts neben einer vorhandenen Momentaufnahme und dann Anzeigen aus, um eine Momentaufnahme anzuzeigen. Diese Aktion öffnet eine Momentaufnahmedetailseite, auf der die Einstellungen der Momentaufnahme und die Schlüsselwerte angezeigt werden, die in der Momentaufnahme enthalten sind.

Screenshot der detaillierten Ansicht einer archivierten Momentaufnahme.

Wiederherstellen einer archivierten Momentaufnahme

Wählen Sie auf der Registerkarte "Archivierte Momentaufnahmen " die Auslassungspunkte ... rechts neben einer archivierten Momentaufnahme aus, und wählen Sie " Wiederherstellen " aus, um eine Momentaufnahme wiederherzustellen. Sobald eine Momentaufnahme wiederhergestellt wurde, wird eine Benachrichtigung angezeigt, um den Vorgang zu bestätigen, und die Liste der archivierten Momentaufnahmen wird aktualisiert.

Screenshot der Option

Nächste Schritte

Momentaufnahmen in der Azure App-Konfiguration

  • Last updated on