Konfiguration aus Azure Front Door in Clientanwendungen laden (Vorschau)

Durch die Integration von Azure App Configuration in Azure Front Door können Ihre Clientanwendungen die Konfiguration von Edge-Standorten weltweit abrufen und so eine optimale Leistung in jedem Maßstab gewährleisten. Der Integrationsprozess umfasst die folgenden Schritte:

  1. Erstellen von Konfigurationsdaten in der Azure App-Konfiguration – Definieren Sie die Schlüsselwerte, Featurekennzeichnungen oder Momentaufnahmen Ihrer Anwendung in der Azure App-Konfiguration.

  2. Verbinden Sie die Azure App-Konfiguration mit Azure Front Door – Konfigurieren Sie die Verbindung zwischen Ihrem App-Konfigurationsspeicher und Azure Front Door über das Azure-Portal. Das Portal bietet eine geführte Erfahrung zur Einrichtung des Azure Front Door-Endpunkts. Einrichten von Azure Front Door zum Herstellen einer Verbindung mit der App-Konfiguration

  3. Verbinden Sie die Anwendung mit Azure Front Door – Konfigurieren Sie Ihre Clientanwendung, um die Konfiguration über den Azure Front Door-Endpunkt mithilfe des App-Konfigurationsanbieters abzurufen. Der Anbieter verarbeitet anonyme Authentifizierungs- und dynamische Konfigurationsupdates. In diesem Dokument wird erläutert, wie Sie diese Verbindung einrichten.

  4. Bereitstellen und Verwalten der Konfiguration – Bereitstellen Ihrer Anwendung in der Produktion. Ihre Clients rufen jetzt automatisch die Konfiguration vom nächstgelegenen Azure Front Door Edge-Standort ab. Aktualisieren Sie konfigurationswerte in der Azure-App-Konfiguration nach Bedarf – Änderungen werden global basierend auf ihrer konfigurierten Azure Front Door-Cacheablaufzeit verteilt, ohne dass Anwendungsupdates oder erneute Bereitstellungen erforderlich sind.

Tipp

Eine visuelle Übersicht über das End-to-End-Setup finden Sie im Walkthrough-Video zur Konfiguration in großem Maßstab.

Clientanwendungsbeispiele

Der folgende Code veranschaulicht, wie die Konfiguration von Azure Front Door geladen wird. Die Anwendung ruft alle Schlüssel ab, die mit einem Präfix "App1:" beginnen und jede Minute nach Updates suchen. Wenn die Anwendung Aktualisierungen anfordert, gibt Azure Front Door ggf. zwischengespeicherte Werte zurück, andernfalls wird eine neue Konfiguration vom App-Konfigurationsdienst abgerufen.

Ersetzen Sie {YOUR-AFD-ENDPOINT} durch Ihren Azure Front Door-Endpunkt, der etwa wie https://xxxx.azurefd.net aussieht.

Verwenden Sie die ConnectAzureFrontDoor API, um Konfigurationseinstellungen aus Azure Front Door zu laden.

builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.ConnectAzureFrontDoor(new Uri("{YOUR-AFD-ENDPOINT}"))
            .Select("App1:*")
            .ConfigureRefresh(refreshOptions =>
            {
                refreshOptions.RegisterAll()
                    .SetRefreshInterval(TimeSpan.FromMinutes(1));
            });
});

Eine vollständige Beispiel-App finden Sie unter MAUI-App mit Azure-App-Konfiguration und Azure Front Door.

Problembehandlung

Die Konfiguration wird nicht geladen.

  • Überprüfen Sie, ob die Azure Front Door-Endpunkt-URL im Anwendungscode ordnungsgemäß konfiguriert ist.
  • Überprüfen Sie im App-Konfigurationsportal nach Warnungen, und beheben Sie ggf. die Probleme.

Die Konfiguration wird nicht aktualisiert.

  • Überprüfen Sie, ob sowohl das Aktualisierungsintervall der Anwendung als auch der Azure Front Door-Cache-TTL ordnungsgemäß konfiguriert sind. Ausführliche Informationen zum Aktualisierungsintervall der Konfiguration finden Sie unter Caching-Verhalten in der Hyperscale-Konfiguration.

Hinweis

Anwendungen, die von Azure Front Door geladen werden, können keine Sentinel Key Refresh verwenden. Wenn du Aktualisierung aktivierst, musst du die Anwendung so konfigurieren, dass alle ausgewählten Schlüssel auf Änderungen überwacht werden.

Verfügbare Sprachen

Language Mindestversion /Status Paketlink
.NET 8.5.0-Vorschau Microsoft.Extensions.Configuration.AzureAppConfiguration
JavaScript 2.3.0-Vorschau @azure/app-configuration-provider
Java Arbeiten in Bearbeitung N/A
Python Arbeiten in Bearbeitung N/A
Go Arbeiten in Bearbeitung N/A