Freigeben über

Verwalten und Verwenden von Momentaufnahmen

  • Artikel

In diesem Artikel erfahren Sie, wie Sie Momentaufnahmen in Azure App Configuration erstellen, verwenden und verwalten. Eine Momentaufnahme ist ein Satz von App Configuration-Einstellungen, die in einem unveränderlichen Zustand gespeichert werden.

Voraussetzungen

Hinzufügen von Schlüssel-Wert-Paaren zum App Configuration-Speicher

Wechseln Sie im App Configuration-Speicher zu Vorgänge>Konfigurations-Explorer, und fügen Sie die folgenden Schlüssel-Wert-Paare hinzu. Übernehmen Sie den Standardwert für Inhaltstyp. Weitere Informationen zum Hinzufügen von Schlüssel-Wert-Paaren zu einem Speicher mithilfe des Azure-Portals oder der CLI finden Sie unter Erstellen eines Schlüssel-Wert-Paars.

Schlüssel Wert Label
app2/bgcolor Hellgrau label2
app1/color Schwarz Keine Bezeichnung
app1/color Blau label1
app1/color Grün label2
app1/color Gelb label3
app1/message Hello label1
app1/message Hallo! label2
app2/message Guten Morgen! label1

Erstellen einer Momentaufnahme

Wählen Sie unter Vorgänge>Momentaufnahmen die Option Neue Momentaufnahme erstellen aus.

  1. Geben Sie einen Momentaufnahmennamen ein, und fügen Sie optional auch Tags hinzu.

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

    • Wenn Ihr Speicher beim Kompositionstyp Key identische Schlüssel mit unterschiedlichen Bezeichnungen aufweist, ist nur das im letzten anwendbaren Filter angegebene Schlüssel-Wert-Paar in der Momentaufnahme enthalten. Identische Schlüssel-Wert-Paare mit anderen Bezeichnungen werden nicht in die Momentaufnahme aufgenommen.
    • 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üssel-Wert-Paare für Ihre Momentaufnahme auszuwählen. Die Filterung erfolgt durch Auswählen von Filtern: Ist gleich, Beginnt mit, Beliebiges von und Alle für Schlüssel und Bezeichnungen. Sie können zwischen einem und drei Filtern angeben.

    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 Bezeichnung die Option Ist gleich aus, und wählen Sie im Dropdownmenü label2 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 Bezeichnung die Option Ist gleich aus, und wählen Sie im Dropdownmenü label1 aus.

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

    Hinweis

    Die Dauer des Aufbewahrungszeitraums kann nach der Erstellung der Momentaufnahme nicht mehr aktualisiert werden.

  5. Wählen Sie Erstellen aus, um die Momentaufnahme zu generieren. In diesem Beispiel verfügt die erstellte Momentaufnahme über den Kompositionstyp Key (Schlüssel) und die folgenden Filter:

    • Schlüssel, die mit app1 beginnen und über die Bezeichnung label2 verfügen
    • Schlüssel, die mit app1 beginnen und über die Bezeichnung label1 verfügen

    Screenshot of the Create form with data filled as above steps and Create button highlighted.

  6. Überprüfen Sie die Tabelle, um zu verstehen, welche Schlüssel-Wert-Paare aus dem Konfigurationsspeicher basierend auf den bereitgestellten Parametern in die Momentaufnahme aufgenommen werden.

    Schlüssel Wert Label In der Momentaufnahme enthalten
    app2/bgcolor Hellgrau label2 Nein: beginnt nicht mit app1.
    app1/color Schwarz Keine Bezeichnung Nein: verfügt nicht über die Bezeichnung label2 oder label1.
    app1/color Blau label1 Ja: Verfügt über die richtige Bezeichnung label1 aus dem letzten der anwendbaren Filter.
    app1/color Grün label2 Nein: Derselbe Schlüssel mit der vom zweiten Filter ausgewählten Bezeichnung label1 überschreibt diesen, obwohl er die ausgewählte Bezeichnung label2 aufweist.
    app1/color Gelb label3 Nein: verfügt nicht über die Bezeichnung label2 oder label1.
    app1/message Hello label1 Ja: Verfügt über die richtige Bezeichnung label1 aus dem letzten der anwendbaren Filter.
    app1/message Hallo! label2 Nein: Derselbe Schlüssel mit der vom zweiten Filter ausgewählten Bezeichnung label1 überschreibt diesen, obwohl er die ausgewählte Bezeichnung label2 aufweist.
    app2/message Guten Morgen! label1 Nein: beginnt nicht mit app1.

Erstellen von Beispielmomentaufnahmen

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

  1. Wählen Sie unter Vorgänge>Momentaufnahmen>Aktive Momentaufnahmen die Option In Sandbox testen aus.
  2. Überprüfen Sie die Beispieldaten, und üben Sie die Erstellung 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 unter Generierte Beispielmomentaufnahme die generierte Momentaufnahme an. Das Beispielmomentaufnahme zeigt alle Schlüssel an, die gemäß Ihrer Auswahl in die Beispielmomentaufnahme aufgenommen wurden.

Momentaufnahmen verwenden

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

Wenn Sie über eine Anwendung mit Azure App Configuration verfügen, dann können Sie diese wie im folgenden Beispielcode aktualisieren, um Momentaufnahmen zu verwenden. Sie müssen nur den Namen der Momentaufnahme angeben. Dieser unterscheidet zwischen Groß-/Kleinschreibung.

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

Hinzufügen von Momentaufnahmen zu Ihrer Konfiguration

configurationBuilder.AddAzureAppConfiguration(options =>
{
    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"));

    // 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

Die Unterstützung von Momentaufnahmen 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 dem Kompositionstyp Key erstellt wurden, können mithilfe der oben gezeigten Codebeispiele geladen werden.

Verwalten aktiver Momentaufnahmen

Auf der Seite unter Vorgänge>Momentaufnahmen werden zwei Registerkarten angezeigt: Aktive Momentaufnahmen und Archivierte Momentaufnahmen. Wählen Sie Aktive Momentaufnahmen aus, um die Liste aller aktiven Momentaufnahmen in einem App Configuration-Speicher anzuzeigen.

Screenshot of the list of active snapshots.

Anzeigen vorhandener Momentaufnahmen

Wählen Sie auf der Registerkarte Aktive Momentaufnahmen die Auslassungspunkte ... rechts neben einer vorhandenen Momentaufnahme und dann Anzeigen aus, um eine Momentaufnahme anzuzeigen. Dadurch wird eine Seite mit Momentaufnahmendetails geöffnet, auf der die Einstellungen der Momentaufnahme und die in der Momentaufnahme enthaltenen Schlüssel-Wert-Paare angezeigt werden.

Screenshot of the detailed view of an active snapshot.

Archivieren einer Momentaufnahme

Wählen Sie auf der Registerkarte Aktive Momentaufnahmen die Auslassungspunkte ... rechts neben einer vorhandenen Momentaufnahme und dann Archivieren aus, um eine Momentaufnahme zu archivieren. Bestätigen Sie die Archivierung, indem Sie Ja auswählen, oder brechen Sie sie mit Nein ab. Nachdem ein Momentaufnahme archiviert worden ist, wird eine Benachrichtigung zur Bestätigung des Vorgangs angezeigt, und die Liste der aktiven Momentaufnahmen wird aktualisiert.

Screenshot of the archive option in the active snapshots.

Verwalten archivierter Momentaufnahmen

Wechseln Sie zu Vorgänge>Momentaufnahmen>Archivierte Momentaufnahmen, um die Liste aller in einem App Configuration-Speicher archivierten Momentaufnahmen anzuzeigen. Archivierte Momentaufnahmen bleiben über den Aufbewahrungszeitraum, der während der Erstellung ausgewählt wurde, hinweg zugänglich.

Screenshot of the list of archived snapshots.

Anzeigen einer archivierten Momentaufnahme

Eine detaillierte Ansicht der Momentaufnahme ist auch im archivierten Zustand 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. Dadurch wird eine Seite mit Momentaufnahmendetails geöffnet, auf der die Einstellungen der Momentaufnahme und die in der Momentaufnahme enthaltenen Schlüssel-Wert-Paare angezeigt werden.

Screenshot of the detailed view of an archived snapshot.

Wiederherstellen einer archivierten Momentaufnahme

Wählen Sie auf der Registerkarte Archivierte Momentaufnahmen die Auslassungspunkte ... rechts neben einer archivierten Momentaufnahme und anschließend Wiederherstellen aus, um eine Momentaufnahme wiederherzustellen. Nachdem eine Momentaufnahme wiederhergestellt worden ist, wird eine Benachrichtigung zur Bestätigung des Vorgangs angezeigt, und die Liste der archivierten Momentaufnahmen wird aktualisiert.

Screenshot of the recover option in the archived snapshots.

Nächste Schritte

Momentaufnahmen in Azure App Configuration