Partilhar via

Gerenciar e usar snapshots

  • Artigo

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

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.

  1. Insira um nome de instantâneo e, opcionalmente, também adicione Tags.

  2. 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.

  3. 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.

    1. 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.
    2. 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.

  4. 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.

  5. 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.

    Screenshot of the Create form with data filled as above steps and Create button highlighted.

  6. 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.

  1. Em Instantâneos de Operações>Instantâneos> ativos, selecione Testar na área restrita.
  2. 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.
  3. Selecione Criar para gerar o instantâneo de exemplo.
  4. 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.

Screenshot of the list of active snapshots.

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.

Screenshot of the detailed view of an active snapshot.

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.

Screenshot of the archive option in the active snapshots.

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.

Screenshot of the list of archived snapshots.

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.

Screenshot of the detailed view of an archived snapshot.

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.

Screenshot of the recover option in the archived snapshots.

Próximos passos

Instantâneos na Configuração do Aplicativo do Azure