Habilite a replicação geográfica
Este artigo aborda a replicação de repositórios de Configuração de Aplicativos do Azure. Você aprenderá sobre como criar, usar e excluir uma réplica em seu repositório de configuração.
Para saber mais sobre o conceito de replicação geográfica, consulte Replicação geográfica na Configuração de Aplicativo do Azure.
Pré-requisitos
- Uma subscrição do Azure - crie uma gratuitamente
- Assumimos que já tem uma loja de Configuração de Aplicações. Se você quiser criar um, crie uma loja de configuração de aplicativo.
Criar e listar uma réplica
Para criar uma réplica do seu repositório de configuração no portal, siga as etapas abaixo.
Nota
Não há suporte para a criação de uma réplica para uma loja de Configuração de Aplicativo com pontos de extremidade privados configurados com IP estático. Se você preferir um ponto de extremidade privado com configuração de IP estático, as réplicas devem ser criadas antes que qualquer ponto de extremidade privado seja adicionado a um armazenamento.
Na sua loja de Configuração de Aplicações, em Definições, selecione Replicação geográfica.
Em Réplica(s), selecione Criar. Escolha o local da nova réplica na lista suspensa e atribua um nome à réplica. Esse nome de réplica deve ser exclusivo.
Selecione Criar.
Agora você deve ver sua nova réplica listada em Réplica(s). Verifique se o status da réplica é "Bem-sucedido", o que indica que ela foi criada com êxito.
Eliminar réplicas
Para excluir uma réplica no portal, siga as etapas abaixo.
Na sua loja de Configuração de Aplicações, em Definições, selecione Replicação geográfica.
Em Réplica(s), selecione o ... à direita da réplica que deseja excluir. Selecione Excluir na lista suspensa.
Verifique o nome da réplica a ser excluída e selecione OK para confirmar.
Quando o processo estiver concluído, verifique na lista de réplicas que a réplica correta foi excluída.
Dimensionamento e failover com réplicas
Cada réplica que você cria tem seu ponto de extremidade dedicado. Se seu aplicativo reside em vários locais geográficos, você pode atualizar cada implantação de seu aplicativo em um local para se conectar à réplica mais próxima desse local, o que ajuda a minimizar a latência de rede entre seu aplicativo e a Configuração do aplicativo. Como cada réplica tem sua cota de solicitação separada, essa configuração também ajuda a escalabilidade do seu aplicativo enquanto ele cresce para um serviço distribuído de várias regiões.
Quando a replicação geográfica está habilitada e se uma réplica não estiver acessível, você pode permitir que seu aplicativo faça failover para outra réplica para melhorar a resiliência. As bibliotecas do provedor de Configuração de Aplicativo têm suporte interno a failover aceitando vários pontos de extremidade de réplica. Você pode fornecer uma lista de seus pontos de extremidade de réplica na ordem do ponto de extremidade mais preferido para o menos preferido. Quando o ponto de extremidade atual não estiver acessível, a biblioteca do provedor fará failover para um ponto de extremidade menos preferido, mas tentará se conectar aos pontos de extremidade mais preferidos de tempos em tempos. Quando um ponto de extremidade mais preferido estiver disponível, ele mudará para ele para solicitações futuras.
Supondo que você tenha um aplicativo usando a Configuração de Aplicativo do Azure, você pode atualizá-lo como o código de exemplo a seguir para aproveitar o recurso de failover. Você pode fornecer uma lista de pontos de extremidade para autenticação do Microsoft Entra ou uma lista de cadeias de conexão para autenticação baseada em chave de acesso.
Edite a chamada para o AddAzureAppConfiguration método, que geralmente é encontrado no program.cs arquivo do seu aplicativo.
Conecte-se com o 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
});
Conectar-se com a cadeia de conexão
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
O suporte a failover estará disponível se você usar a versão 6.0.0 ou posterior de qualquer um dos seguintes pacotes.
Microsoft.Extensions.Configuration.AzureAppConfigurationMicrosoft.Azure.AppConfiguration.AspNetCoreMicrosoft.Azure.AppConfiguration.Functions.Worker
O failover pode ocorrer se o provedor de Configuração do Aplicativo observar as seguintes condições.
- Recebe respostas com status de serviço indisponível (código de status HTTP 500 ou superior).
- Experiências com problemas de conectividade de rede.
- As solicitações são limitadas (código de status HTTP 429).
O failover não acontecerá para erros de cliente, como falhas de autenticação.
Descoberta automática de réplicas
Você pode especificar um ou mais pontos de extremidade de uma loja de Configuração de Aplicativo habilitada para replicação geográfica para a qual deseja que seu aplicativo se conecte ou faça failover. No entanto, se nenhum desses pontos de extremidade estiver acessível, as bibliotecas do provedor de Configuração de Aplicativo poderão descobrir automaticamente quaisquer réplicas adicionais e tentar se conectar a elas. Esse recurso permite que você se beneficie da replicação geográfica sem ter que alterar seu código ou reimplantar seu aplicativo. Isso significa que você pode habilitar a replicação geográfica ou adicionar réplicas extras mesmo depois que seu aplicativo for implantado.
As réplicas descobertas automaticamente serão selecionadas e usadas aleatoriamente. Se você tiver preferência por réplicas específicas, poderá especificar explicitamente seus pontos de extremidade. Esse recurso é habilitado por padrão, mas você pode consultar o código de exemplo a seguir para desativá-lo.
Edite a chamada para o AddAzureAppConfiguration método, que geralmente é encontrado no program.cs arquivo do seu aplicativo.
configurationBuilder.AddAzureAppConfiguration(options =>
{
// Disable automatic replica discovery
options.ReplicaDiscoveryEnabled = false;
// Other changes to options
});
Nota
O suporte à descoberta automática de réplicas estará disponível se você usar a versão 7.1.0 ou posterior de qualquer um dos pacotes a seguir.
Microsoft.Extensions.Configuration.AzureAppConfigurationMicrosoft.Azure.AppConfiguration.AspNetCoreMicrosoft.Azure.AppConfiguration.Functions.Worker