Valores-chave pontuais

A Configuração de Aplicativos do Azure mantém um registro das alterações executadas nas chaves-valor. Esse registro fornece uma linha do tempo das alterações de chave-valor. É possível reconstruir o histórico de uma chave e fornecer o respectivo valor anterior a qualquer momento dentro do período do histórico da chave (sete dias para repositórios da camada Gratuita ou 30 dias para repositórios da camada Standard). Com esse recurso, é possível retroceder a "viagem no tempo" e recuperar uma chave-valor anterior. Por exemplo, é possível recuperar as definições de configuração usadas antes da implantação mais recente a fim de reverter o aplicativo para a configuração anterior.

Restaurar chaves-valor

É possível usar o portal ou a CLI do Azure para recuperar chaves-valor anteriores.

Portal

1. Entre no portal do Azure. Selecione Todos os recursos e selecione a instância do repositório de configuração do aplicativo em que seu valor de chave está armazenado.

2. No menu Operações, selecione Restaurar.

   

3. Selecionar Data: selecione a data para selecionar uma data e hora para a qual você deseja reverter.

4. Clique fora dos campos de data e hora ou pressione Guia para validar sua escolha. Agora você pode ver quais valores-chave foram alterados entre a data e a hora selecionadas e a hora atual. Esta etapa ajuda você a entender quais chaves e valores você está preparando para reverter.

   

   O portal exibe uma tabela de chaves-valor. A primeira coluna inclui símbolos que indicam o que acontecerá se você restaurar os dados para a data e a hora escolhidas:

   • O sinal de menos vermelho (–) significa que o valor-chave não existia na data e hora selecionadas e será excluído.
   • O sinal de adição verde (+) significa que o valor-chave existiu na data e hora selecionadas e não existe agora. Se você reverter para a data e hora selecionadas, ela será adicionada de volta à sua configuração.
   • O sinal de marcador laranja (•) significa que o valor-chave foi modificado desde a data e hora selecionadas. A chave será revertida para o valor que tinha na data e hora selecionadas.

5. Marque a caixa de seleção na linha para selecionar/desmarcar o valor da chave a ser tomada. Quando selecionado, ele exibirá a diferença para o valor de chave entre a data e a hora atuais e selecionadas.

   

   No exemplo acima, a visualização mostra a chave TestApp: Configurações: BackgroundColor, que atualmente tem um valor de #FFF. Esse valor será modificado para #45288E se passarmos pela restauração dos dados.

   Você pode selecionar uma ou mais caixas de seleção na tabela para executar uma ação na chave-valor de sua escolha. Você também pode usar a caixa de seleção selecionar-tudo na parte superior da lista para selecionar/desmarcar todos as chaves-valor.

6. Selecione Restaurar para restaurar os valores de chave selecionados para os dados e a hora selecionados.

   

CLI do Azure

Use o CLI do Azure conforme explicado abaixo para recuperar e restaurar valores de chave passados. Caso não tenha a CLI do Azure instalada localmente, será possível usar o Azure Cloud Shell como alternativa.

Na CLI, use az appconfig revision list para exibir as alterações ou az appconfig kv restore para restaurar valores de chave, adicionando os parâmetros apropriados. Especifique a instância da Configuração de Aplicativos do Azure fornecendo o nome do repositório (--name <app-config-store-name>) ou usando uma cadeia de conexão (--connection-string <your-connection-string>). Restrinja a saída especificando um ponto no tempo (--datetime), um rótulo (--label) e o número máximo de itens a serem retornados (--top). e especificando o número máximo de itens a serem retornados ( --top ).

Recupere todas as alterações gravadas nas chaves-valor.

az appconfig revision list --name <your-app-config-store-name>

Restaurar todas as chaves-valor em um momento específico.

az appconfig kv restore --name <app-config-store-name> --datetime "2019-05-01T11:24:12Z"

Restaurar para qualquer rótulo que comece com v1. em um ponto específico no tempo.

az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"

Para obter mais exemplos de comandos da CLI e parâmetros opcionais para restaurar a chave-valor, acesse a documentação do CLI do Azure.

Você também pode acessar o histórico de uma chave-valor específica. Esse recurso permite que você verifique o valor de uma chave específica em um momento determinado e reverta para um valor passado sem Atualizar nenhum outra chave-valor.

Exibição histórica/de linha do tempo da chave-valor

Dica

Esse método é conveniente se você não tiver mais do que algumas alterações a serem feitas, pois o Gerenciador de configurações só permitirá que você altere a chave por chave. Se você precisar restaurar vários valores de chave de uma só vez, use o menu Restaurar em vez disso.

Portal

Você também pode acessar o histórico de revisão de uma chave-valor específica no portal.

1. No menu Operações, selecione Gerenciador de configurações.

2. Selecione Mais ações para a chave que você deseja explorar e, em seguida, Histórico

   

   Agora você pode ver o histórico de revisão para a chave selecionada e informações sobre as alterações.

3. Selecione Restaurar para restaurar a chave e o valor para esse ponto no tempo.

   

CLI do Azure

Use o CLI do Azure conforme explicado abaixo para recuperar e restaurar chaves-valor individuais. Caso não tenha a CLI do Azure instalada localmente, será possível usar o Azure Cloud Shell como alternativa.

Na CLI, use az appconfig revision list para exibir as alterações em um valor de chave ou use az appconfig kv restore para restaurar um valor de chave, adicionando os parâmetros apropriados. Especifique a instância da Configuração de Aplicativos do Azure fornecendo o nome do repositório (--name <app-config-store-name>) ou usando uma cadeia de conexão (--connection-string <your-connection-string>). Restrinja a saída especificando uma chave específica (--key). Opcionalmente, especifique um rótulo (--label), um ponto no tempo (--datetime) e o número máximo de itens a serem retornados (--top).

Listar o histórico de revisão para a chave "Cor" com quaisquer rótulos.

az appconfig revision list --name <app-config-store-name> --key color

Listar o histórico de revisão de uma chave-valor específica com um rótulo.

az appconfig revision list --name <app-config-store-name> --key color --label test

Listar o histórico de revisão de uma chave-valor com vários rótulos.

az appconfig revision list --name <app-config-store-name> --key color --label test,prod,\0

Recupere todas as alterações gravadas na chave color em um ponto no tempo específico.

az appconfig revision list --name <app-config-store-name> --key color --datetime "2019-05-01T11:24:12Z" 

Recupere as últimas 10 alterações gravadas na chave color em um ponto no tempo específico.

az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z" 

Para obter mais exemplos e parâmetros opcionais, acesse a documentação do CLI do Azure.

Próximas etapas

Criar um aplicativo Web ASP.NET Core