Dela via

Aktivera geo-replikering

  • Artikel

Den här artikeln beskriver replikering av Azure App Configuration-butiker. Du får lära dig hur du skapar, använder och tar bort en replik i konfigurationsarkivet.

Mer information om begreppet geo-replikering finns i Geo-replikering i Azure App Configuration.

Förutsättningar

Skapa och lista en replik

Följ stegen nedan om du vill skapa en replik av konfigurationsarkivet i portalen.

Kommentar

Det går inte att skapa en replik för ett App Configuration Store med privata slutpunkter som konfigurerats med statisk IP. Om du föredrar en privat slutpunkt med statisk IP-konfiguration måste repliker skapas innan någon privat slutpunkt läggs till i ett arkiv.

  1. I appkonfigurationsarkivet går du till Inställningar och väljer Geo-replikering.

  2. Under Repliker väljer du Skapa. Välj platsen för den nya repliken i listrutan och tilldela sedan repliken ett namn. Det här repliknamnet måste vara unikt.

    Skärmbild av geo-replikeringsknappen som markeras samt knappen Skapa för en replik.

  3. Välj Skapa.

  4. Nu bör du se den nya repliken under Repliker. Kontrollera att statusen för repliken är "Lyckades", vilket anger att den har skapats.

    Skärmbild av listan över repliker som har skapats för konfigurationsarkivet.

Ta bort en replik

Följ stegen nedan om du vill ta bort en replik i portalen.

  1. I appkonfigurationsarkivet går du till Inställningar och väljer Geo-replikering.

  2. Under Repliker väljer du ... till höger om repliken som du vill ta bort. Välj Ta bort i listrutan.

    Skärmbild som visar de tre punkterna till höger om repliken som väljs, som visar borttagningsalternativet.

  3. Kontrollera namnet på repliken som ska tas bort och välj OK för att bekräfta.

  4. När processen är klar kontrollerar du listan över repliker som rätt replik har tagits bort.

Skala och redundans med repliker

Varje replik som du skapar har sin dedikerade slutpunkt. Om ditt program finns på flera geo-platser kan du uppdatera varje distribution av ditt program på en plats för att ansluta till repliken närmare den platsen, vilket hjälper till att minimera nätverksfördröjningen mellan programmet och appkonfigurationen. Eftersom varje replik har sin separata kvot för begäran hjälper den här konfigurationen även programmets skalbarhet när den växer till en distribuerad tjänst i flera regioner.

När geo-replikering är aktiverat och om en replik inte är tillgänglig kan du låta programmet redundansväxlara till en annan replik för bättre återhämtning. AppKonfigurationsproviderbibliotek har inbyggt stöd för redundans genom att acceptera flera replikslutpunkter. Du kan ange en lista över dina replikslutpunkter i den ordning som är mest prioriterad för den minst föredragna slutpunkten. När den aktuella slutpunkten inte är tillgänglig redundansväxlar providerbiblioteket till en mindre föredragen slutpunkt, men försöker ansluta till de mer föredragna slutpunkterna då och då. När en mer föredragen slutpunkt blir tillgänglig växlar den till den för framtida begäranden.

Förutsatt att du har ett program som använder Azure App Configuration kan du uppdatera det som följande exempelkod för att dra nytta av redundansfunktionen. Du kan antingen ange en lista över slutpunkter för Microsoft Entra-autentisering eller en lista över anslutningssträng för åtkomst till nyckelbaserad autentisering.

Redigera anropet AddAzureAppConfiguration till metoden, som ofta finns i filen i program.cs ditt program.

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

Anslut med Anslut ionssträng

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

Kommentar

Stöd för redundansväxling är tillgängligt om du använder version 6.0.0 eller senare av något av följande paket.

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

Redundansväxlingen kan inträffa om appkonfigurationsprovidern följer följande villkor.

  • Tar emot svar med statusen tjänsten är inte tillgänglig (HTTP-statuskod 500 eller senare).
  • Funktioner med problem med nätverksanslutning.
  • Begäranden begränsas (HTTP-statuskod 429).

Redundansväxlingen sker inte för klientfel som autentiseringsfel.

Automatisk replikidentifiering

Du kan ange en eller flera slutpunkter för ett geo-replikeringsaktiverat appkonfigurationsarkiv som du vill att programmet ska ansluta eller redundansväxlar till. Men om ingen av dessa slutpunkter är tillgängliga kan appkonfigurationsproviderbiblioteken automatiskt identifiera eventuella ytterligare repliker och försöka ansluta till dem. Med den här funktionen kan du dra nytta av geo-replikering utan att behöva ändra din kod eller distribuera om programmet. Det innebär att du kan aktivera geo-replikering eller lägga till extra repliker även efter att programmet har distribuerats.

De automatiskt identifierade replikerna väljs och används slumpmässigt. Om du har en inställning för specifika repliker kan du uttryckligen ange deras slutpunkter. Den här funktionen är aktiverad som standard, men du kan läsa följande exempelkod för att inaktivera den.

Redigera anropet AddAzureAppConfiguration till metoden, som ofta finns i filen i program.cs ditt program.

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

    // Other changes to options
});

Kommentar

Stöd för automatisk replikidentifiering är tillgängligt om du använder version 7.1.0 eller senare av något av följande paket.

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

Nästa steg

Geo-replikeringskoncept