Abilitare la replica geografica
Questo articolo illustra la replica degli archivi di configurazione di app Azure. Si apprenderà come creare, usare ed eliminare una replica nell'archivio di configurazione.
Per altre informazioni sul concetto di replica geografica, vedere Replica geografica in configurazione app Azure.
Prerequisiti
- Sottoscrizione di Azure: creare un account gratuitamente
- Si supponga di avere già un negozio Configurazione app. Se si vuole crearne uno, creare un archivio Configurazione app.
Creare ed elencare una replica
Per creare una replica dell'archivio di configurazione nel portale, seguire questa procedura.
Nota
La creazione di una replica per un archivio Configurazione app con endpoint privati configurati con IP statico non è supportata. Se si preferisce un endpoint privato con configurazione IP statica, è necessario creare repliche prima dell'aggiunta di qualsiasi endpoint privato a un archivio.
Nell'archivio Configurazione app, in Impostazioni selezionare Replica geografica.
In Repliche selezionare Crea. Scegliere il percorso della nuova replica nell'elenco a discesa, quindi assegnare alla replica un nome. Questo nome di replica deve essere univoco.
Seleziona Crea.
Verrà ora visualizzata la nuova replica elencata in Repliche.You should now see your new replica listed under Replica/s. Verificare che lo stato della replica sia "Succeeded", che indica che è stato creato correttamente.
Eliminare una replica
Per eliminare una replica nel portale, seguire questa procedura.
Nell'archivio Configurazione app, in Impostazioni selezionare Replica geografica.
In Repliche selezionare ... a destra della replica da eliminare. Selezionare Elimina dall'elenco a discesa.
Verificare il nome della replica da eliminare e selezionare OK per confermare.
Al termine del processo, controllare l'elenco delle repliche eliminate dalla replica corretta.
Ridimensionare e eseguire il failover con repliche
Ogni replica creata ha il relativo endpoint dedicato. Se l'applicazione si trova in più posizioni geografiche, è possibile aggiornare ogni distribuzione dell'applicazione in un percorso per connettersi alla replica più vicina a tale posizione, riducendo al minimo la latenza di rete tra l'applicazione e Configurazione app. Poiché ogni replica ha una quota di richiesta separata, questa configurazione consente anche la scalabilità dell'applicazione mentre aumenta fino a un servizio distribuito in più aree.
Quando la replica geografica è abilitata e se una replica non è accessibile, è possibile consentire il failover dell'applicazione a un'altra replica per migliorare la resilienza. Configurazione app librerie di provider dispongono del supporto predefinito per il failover accettando più endpoint di replica. È possibile fornire un elenco degli endpoint di replica nell'ordine preferito all'endpoint meno preferito. Quando l'endpoint corrente non è accessibile, la libreria del provider eseguirà il failover in un endpoint meno preferito, ma tenterà di connettersi agli endpoint più preferiti di volta in volta. Quando diventa disponibile un endpoint più preferito, passerà a esso per le richieste future.
Supponendo di avere un'applicazione che usa app Azure Configuration, è possibile aggiornarla come codice di esempio seguente per sfruttare la funzionalità di failover. È possibile fornire un elenco di endpoint per l'autenticazione di Microsoft Entra o un elenco di stringa di connessione per l'autenticazione basata su chiave di accesso.
Modificare la chiamata al AddAzureAppConfiguration metodo, spesso presente nel program.cs file dell'applicazione.
Connettersi con 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
});
Connessione con stringa di Connessione ion
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
});
Nota
Il supporto per il failover è disponibile se si usa la versione 6.0.0 o successiva di uno dei pacchetti seguenti.
Microsoft.Extensions.Configuration.AzureAppConfigurationMicrosoft.Azure.AppConfiguration.AspNetCoreMicrosoft.Azure.AppConfiguration.Functions.Worker
Il failover può verificarsi se il provider di Configurazione app osserva le condizioni seguenti.
- Riceve risposte con stato del servizio non disponibile (codice di stato HTTP 500 o versione successiva).
- Esperienze con i problemi di connettività di rete.
- Le richieste vengono limitate (codice di stato HTTP 429).
Il failover non si verificherà per errori del client, ad esempio errori di autenticazione.
Individuazione automatica delle repliche
È possibile specificare uno o più endpoint di un archivio Configurazione app abilitato per la replica geografica a cui si vuole connettere o eseguire il failover dell'applicazione. Tuttavia, se nessuno di questi endpoint è accessibile, le librerie del provider Configurazione app possono individuare automaticamente eventuali repliche aggiuntive e tentare di connettersi a tali endpoint. Questa funzionalità consente di trarre vantaggio dalla replica geografica senza dover modificare il codice o ridistribuire l'applicazione. Ciò significa che è possibile abilitare la replica geografica o aggiungere repliche aggiuntive anche dopo la distribuzione dell'applicazione.
Le repliche individuate automaticamente verranno selezionate e usate in modo casuale. Se si ha una preferenza per repliche specifiche, è possibile specificare in modo esplicito i relativi endpoint. Questa funzionalità è abilitata per impostazione predefinita, ma è possibile fare riferimento al codice di esempio seguente per disabilitarla.
Modificare la chiamata al AddAzureAppConfiguration metodo, spesso presente nel program.cs file dell'applicazione.
configurationBuilder.AddAzureAppConfiguration(options =>
{
// Disable automatic replica discovery
options.ReplicaDiscoveryEnabled = false;
// Other changes to options
});
Nota
Il supporto per l'individuazione automatica delle repliche è disponibile se si usa la versione 7.1.0 o successiva di uno dei pacchetti seguenti.
Microsoft.Extensions.Configuration.AzureAppConfigurationMicrosoft.Azure.AppConfiguration.AspNetCoreMicrosoft.Azure.AppConfiguration.Functions.Worker