Gerenciar e usar snapshots
Neste artigo, saiba como criar, usar e gerenciar instantâneos na Configuração do Aplicativo do Azure. Instantâneo é um conjunto de definições de Configuração do Aplicativo armazenadas em um estado imutável.
Pré-requisitos
- Uma loja de configuração de aplicativos. Crie uma loja.
- Função "DataOwner" na loja de configuração de aplicativos. Detalhes sobre a função necessária e as permissões para instantâneos
Adicionar valores-chave à loja de configuração de aplicativos
Na sua loja de Configuração de Aplicações, aceda ao explorador de Configuração de Operações>e adicione os seguintes valores-chave. Deixe Content Type com seu valor padrão. Para obter mais informações sobre como adicionar valores-chave a uma loja usando o portal do Azure ou a CLI, vá para Criar um valor-chave.
Key | valor | Etiqueta |
---|---|---|
app2/bgcolor | Cinzento claro | rótulo2 |
app1/cor | Preto | Sem rótulo |
app1/cor | Blue | rótulo1 |
app1/cor | Verde | rótulo2 |
app1/cor | Amarelo | rótulo3 |
app1/mensagem | Hello (Olá) | rótulo1 |
app1/mensagem | Olá! | rótulo2 |
app2/mensagem | Bom dia! | rótulo1 |
Criar um instantâneo
Em Instantâneos de Operações>, selecione Criar um novo instantâneo.
Insira um nome de instantâneo e, opcionalmente, também adicione Tags.
Em Escolha o tipo de composição, mantenha o valor padrão Chave (padrão).
- Com o tipo de composição de chaves, se sua loja tiver chaves idênticas com rótulos diferentes, somente o valor-chave especificado no último filtro aplicável será incluído no instantâneo. Valores-chave idênticos com outros rótulos são deixados de fora do instantâneo.
- Com o tipo de composição Key-Label, se a sua loja tiver chaves idênticas com etiquetas diferentes, todos os valores-chave com chaves idênticas, mas etiquetas diferentes, serão incluídos no instantâneo, dependendo dos filtros especificados.
Selecione Adicionar filtros para selecionar os valores-chave para seu instantâneo. A filtragem é feita selecionando filtros: Igual, Começa com, Qualquer um e Todos para chaves e etiquetas. Pode introduzir entre um e três filtros.
- Adicione o primeiro filtro:
- Em Chave, selecione Começa com e insira app1
- Em Rótulo, selecione Igual e selecione rótulo2 no menu suspenso.
- Adicione o segundo filtro:
- Em Chave, selecione Começa com e insira app1
- Em Rótulo, selecione Igual e selecione rótulo1 no menu suspenso.
- Adicione o primeiro filtro:
Se você arquivar um snapshot, por padrão, ele será retido por 30 dias após o arquivamento. Opcionalmente, em Opções de recuperação, diminua o número de dias de retenção em que o snapshot estará disponível após o arquivamento.
Nota
A duração do período de retenção não pode ser atualizada depois que o snapshot for criado.
Selecione Criar para gerar o instantâneo. Neste exemplo, o instantâneo criado tem o tipo de composição de chave e os filtros abaixo:
- Teclas que começam com app1, com label2 label
- Chaves que começam com app1, com label1 label.
Verifique a tabela para entender quais valores-chave do repositório de configuração acabam no instantâneo com base nos parâmetros fornecidos.
Key valor Etiqueta Incluído no snapshot app2/bgcolor Cinzento claro rótulo2 Não: não começa com app1. app1/cor Preto Sem rótulo Não: não tem o rótulo label2 ou label1. app1/cor Blue rótulo1 Sim: Tem o rótulo correto1 do último dos filtros aplicáveis. app1/cor Verde rótulo2 Não: A mesma chave com rótulo label1 selecionado pelo segundo filtro substitui este, embora tenha o rótulo selecionado, label2. app1/cor Amarelo rótulo3 Não: não tem o rótulo label2 ou label1. app1/mensagem Hello (Olá) rótulo1 Sim: Tem o rótulo correto1 do último dos filtros aplicáveis. app1/mensagem Olá! rótulo2 Não: A mesma chave com rótulo label1 selecionado pelo segundo filtro substitui este, embora tenha o rótulo selecionado, label2. app2/mensagem Bom dia! rótulo1 Não: não começa com app1.
Criar instantâneos de exemplo
Para criar instantâneos de exemplo e verificar como o recurso de instantâneos funciona, use a área restrita de instantâneos. Esta sandbox contém dados de exemplo com os quais você pode jogar para entender melhor como o tipo de composição e os filtros do instantâneo funcionam.
- Em Instantâneos de Operações>Instantâneos> ativos, selecione Testar na área restrita.
- Analise os dados de exemplo e pratique a criação de instantâneos preenchendo o formulário com um tipo de composição e um ou mais filtros.
- Selecione Criar para gerar o instantâneo de exemplo.
- Confira o resultado do snapshot gerado em Snapshot de amostra gerado. O instantâneo de exemplo exibe todas as chaves incluídas no instantâneo de exemplo, de acordo com sua seleção.
Usar instantâneos
Você pode selecionar qualquer número de instantâneos para a configuração do aplicativo. A seleção de um instantâneo adiciona todos os seus valores-chave. Uma vez adicionados a uma configuração, os valores-chave dos snapshots são tratados da mesma forma que qualquer outro valor-chave.
Se você tiver um aplicativo usando a Configuração de Aplicativo do Azure, poderá atualizá-lo com o código de exemplo a seguir para usar instantâneos. Você só precisa fornecer o nome do instantâneo, que diferencia maiúsculas de minúsculas.
Edite a chamada para o AddAzureAppConfiguration
método, que geralmente é encontrado no Program.cs
arquivo do seu aplicativo. Se você não tiver um aplicativo, poderá fazer referência a qualquer um dos guias de início rápido do .NET, como criar um aplicativo ASP.NET núcleo com a Configuração de Aplicativo do Azure.
Adicionar instantâneos à sua configuração
configurationBuilder.AddAzureAppConfiguration(options =>
{
options.Connect(Environment.GetEnvironmentVariable("ConnectionString"));
// Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
options.SelectSnapshot("SnapshotName");
// Other changes to options
});
Nota
O suporte a instantâneos está disponível se você usar a versão 7.0.0 ou posterior de qualquer um dos pacotes a seguir.
Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.Azure.AppConfiguration.AspNetCore
Microsoft.Azure.AppConfiguration.Functions.Worker
Nota
Somente instantâneos criados com tipo Key
de composição podem ser carregados usando os exemplos de código mostrados acima.
Gerenciar snapshots ativos
A página em Instantâneos de Operações exibe duas guias: Instantâneos ativos e Instantâneos> arquivados. Selecione Instantâneos ativos para exibir a lista de todos os instantâneos ativos em uma loja de configuração de aplicativos.
Visualizar instantâneo existente
Na guia Instantâneos ativos, selecione as reticências ... à direita de um instantâneo existente e selecione Exibir para exibir um instantâneo. Esta ação abre uma página de detalhes do instantâneo que exibe as configurações do instantâneo e os valores-chave incluídos no instantâneo.
Arquivar um instantâneo
Na guia Instantâneos ativos, selecione as reticências ... à direita de um instantâneo existente e selecione Arquivar para arquivar um instantâneo. Confirme o arquivamento selecionando Sim ou cancelar com Não. Depois que um instantâneo é arquivado, uma notificação é exibida para confirmar a operação e a lista de instantâneos ativos é atualizada.
Gerenciar snapshots arquivados
Vá para Instantâneos de Operações Instantâneos> arquivados para exibir a lista de todos os instantâneos arquivados em uma loja de Configuração de>Aplicativos. Os instantâneos arquivados permanecem acessíveis durante o período de retenção selecionado durante a criação.
Ver instantâneo arquivado
A visualização detalhada do snapshot também está disponível no estado de arquivamento. Na guia Instantâneos arquivados, selecione as reticências ... à direita de um instantâneo existente e selecione Exibir para exibir um instantâneo. Esta ação abre uma página de detalhes do instantâneo que exibe as configurações do instantâneo e os valores-chave incluídos no instantâneo.
Recuperar um snapshot arquivado
Na guia Snapshots arquivados, selecione as reticências ... à direita de um snapshot arquivado e selecione Recover para recuperar um snapshot. Depois que um snapshot é recuperado, uma notificação é exibida para confirmar a operação e a lista de snapshots arquivados é atualizada.