Freigeben über

Aktivieren der Georeplikation

  • Artikel

In diesem Artikel wird die Replikation von Azure App Configuration-Speichern behandelt. Sie erfahren, wie Sie ein Replikat in Ihrem Konfigurationsspeicher erstellen, verwenden und löschen.

Weitere Informationen zum Konzept der Georeplikation finden Sie unter Georeplikation in Azure App Configuration.

Voraussetzungen

Erstellen und Auflisten eines Replikats

Führen Sie die folgenden Schritte aus, um ein Replikat Ihres Konfigurationsspeichers im Portal zu erstellen.

Hinweis

Das Erstellen eines Replikats für einen App Configuration-Speicher mit privaten Endpunkten, die mit statischer IP-Adresse konfiguriert sind, wird nicht unterstützt. Wenn Sie einen privaten Endpunkt mit statischer IP-Konfiguration bevorzugen, müssen Replikate erstellt werden, bevor ein privater Endpunkt einem Speicher hinzugefügt wird.

  1. Wählen Sie in Ihrem App Configuration-Speicher unter Einstellungen die Option Georeplikation aus.

  2. Wählen Sie unter Replikat(e) die Option Erstellen aus. Wählen Sie den Speicherort Ihres neuen Replikats in der Dropdownliste aus, und weisen Sie dem Replikat einen Namen zu. Dieser Replikatname muss eindeutig sein.

    Screenshot der hervorgehobenen Schaltfläche „Georeplikation“ sowie Schaltfläche „Erstellen“ für ein Replikat

  3. Klicken Sie auf Erstellen.

  4. Ihr neues Replikat sollte jetzt unter „Replikat(e)“ aufgeführt werden. Überprüfen Sie, ob der Status des Replikats „Erfolgreich“ lautet und es somit erfolgreich erstellt wurde.

    Screenshot der Liste von Replikaten, die für den Konfigurationsspeicher erstellt wurden

Löschen eines Replikats

Führen Sie die folgenden Schritte aus, um ein Replikat im Portal zu löschen.

  1. Wählen Sie in Ihrem App Configuration-Speicher unter Einstellungen die Option Georeplikation aus.

  2. Wählen Sie unter Replikat(e) das Zeichen ... rechts neben dem Replikat aus, das Sie löschen möchten. Wählen Sie im Dropdownmenü den Befehl Löschen aus.

    Screenshot mit drei Punkten rechts neben dem ausgewählten Replikat mit der Option zum Löschen

  3. Überprüfen Sie den Namen des zu löschenden Replikats, und klicken Sie zur Bestätigung auf OK.

  4. Nachdem der Vorgang abgeschlossen wurde, stellen Sie in der Liste der Replikate sicher, dass das richtige Replikat gelöscht wurde.

Skalieren und Failover mit Replikaten

Jedes Replikat, das Sie erstellen, besitzt einen dedizierten Endpunkt. Wenn sich Ihre Anwendung an mehreren Geostandorten (Geolocations) befindet, können Sie jede Bereitstellung Ihrer Anwendung an einem Standort so aktualisieren, dass eine Verbindung mit dem Replikat hergestellt wird, das dem Standort näher liegt, wodurch die Netzwerkwartezeiten zwischen Ihrer Anwendung und App Configuration minimiert werden. Da jedes Replikat über ein separates Anforderungskontingent verfügt, hilft dieses Setup auch bei der Skalierbarkeit Ihrer Anwendung, während sie sich zu einem über mehrere Regionen verteilten Dienst entwickelt.

Wenn Georeplikation aktiviert ist, und wenn ein Replikat nicht zugänglich ist, können Sie ein Failover Ihrer Anwendung auf ein anderes Replikat durchführen, um die Resilienz zu verbessern. App Configuration-Anbieterbibliotheken verfügen über integrierte Failoverunterstützung, indem mehrere Replikatendpunkte akzeptiert werden. Sie können eine Liste Ihrer Replikatendpunkte in der Reihenfolge vom bevorzugtesten Endpunkt bis hin zum am wenigsten bevorzugten Endpunkt bereitstellen. Wenn der aktuelle Endpunkt nicht zugänglich ist, führt die Anbieterbibliothek ein Failover zu einem weniger bevorzugten Endpunkt durch, versucht aber hin und wieder, eine Verbindung mit den bevorzugteren Endpunkten herzustellen. Wenn ein bevorzugter Endpunkt verfügbar wird, wechselt sie für zukünftige Anforderungen zu diesem Endpunkt.

Angenommen, Sie verfügen über eine Anwendung mit Azure App Configuration, dann können Sie diese wie im folgenden Beispielcode aktualisieren, um die Vorteile der Failoverfunktion zu nutzen. Sie können entweder eine Liste mit Endpunkten für die Microsoft Entra-Authentifizierung oder eine Liste mit Verbindungszeichenfolgen für die Authentifizierung auf Basis eines Zugriffsschlüssels bereitstellen.

Bearbeiten Sie den Aufruf der Methode AddAzureAppConfiguration, die sich häufig in der Datei program.cs Ihrer Anwendung befindet.

Verbinden mit Microsoft Entra ID

configurationBuilder.AddAzureAppConfiguration(options =>
{
    // Provide an ordered list of replica endpoints
    var endpoints = new Uri[] {
        new Uri("<first-replica-endpoint>"),
        new Uri("<second-replica-endpoint>") };
    
    // Connect to replica endpoints using Microsoft Entra authentication
    options.Connect(endpoints, new DefaultAzureCredential());

    // Other changes to options
});

Verbinden mit einer Verbindungszeichenfolge

configurationBuilder.AddAzureAppConfiguration(options =>
{
    // Provide an ordered list of replica connection strings
    var connectionStrings = new string[] {
        Environment.GetEnvironmentVariable("FIRST_REPLICA_CONNECTION_STRING"),
        Environment.GetEnvironmentVariable("SECOND_REPLICA_CONNECTION_STRING") };
    
    // Connect to replica endpoints using connection strings
    options.Connect(connectionStrings);

    // Other changes to options
});

Hinweis

Die Failoverunterstützung ist verfügbar, wenn Sie Version 6.0.0 oder höher eines der folgenden Pakete verwenden.

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

Das Failover kann auftreten, wenn der App Configuration-Anbieter die folgenden Zustände beobachtet.

  • Empfängt Antworten mit Status „Dienst nicht verfügbar“ (HTTP-Statuscode 500 oder höher).
  • Auftreten von Netzwerkkonnektivitätsproblemen.
  • Anforderungen werden gedrosselt (HTTP-Statuscode 429).

Das Failover erfolgt nicht bei Clientfehlern wie Authentifizierungsfehlern.

Automatische Replikatermittlung

Sie können einen oder mehrere Endpunkte eines georeplikationsfähigen App Configuration-Speichers angeben, mit dem die Anwendung eine Verbindung herstellen oder für die sie ein Failover ausführen soll. Wenn jedoch auf keine dieser Endpunkte zugegriffen werden kann, können die App Configuration-Anbieterbibliotheken automatisch alle zusätzlichen Replikate ermitteln und versuchen, eine Verbindung mit diesen herzustellen. Mit diesem Feature können Sie von der Georeplikation profitieren, ohne Ihren Code ändern oder Ihre Anwendung erneut bereitstellen zu müssen. Das bedeutet, dass Sie die Georeplikation aktivieren oder zusätzliche Replikate hinzufügen können, auch nachdem Ihre Anwendung bereitgestellt wurde.

Die automatisch ermittelten Replikate werden ausgewählt und zufällig verwendet. Wenn Sie bestimmte Replikate bevorzugen, können Sie deren Endpunkte explizit angeben. Dieses Feature ist standardmäßig aktiviert, Sie können jedoch auf den folgenden Beispielcode verweisen, um es zu deaktivieren.

Bearbeiten Sie den Aufruf der Methode AddAzureAppConfiguration, die sich häufig in der Datei program.cs Ihrer Anwendung befindet.

configurationBuilder.AddAzureAppConfiguration(options =>
{
    // Disable automatic replica discovery
    options.ReplicaDiscoveryEnabled = false;

    // Other changes to options
});

Hinweis

Die Unterstützung für die automatische Replikatermittlung ist verfügbar, wenn Sie Version 7.1.0 oder höher von einem der folgenden Pakete verwenden.

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

Nächste Schritte

Georeplikationskonzept