Ключевые значения на момент времени

Конфигурация приложений Azure сохраняет запись изменений, внесенных в значения ключей. Эта запись предоставляет временную шкалу изменений ключевого значения. Вы можете восстановить историю любого ключа и указать его прошлое значение в любой момент в течение периода журнала ключей (7 дней для магазинов уровня "Бесплатный" и "Разработчик" или "30 дней" для хранилищ уровня "Стандартный" и "Премиум"). Используя эту функцию, вы можете "перемещаться во времени" назад и восстановить старое значение ключа. Например, можно восстановить параметры конфигурации, используемые до последнего развертывания, чтобы откатить приложение к предыдущей конфигурации.

Восстановление значений ключей

Вы можете использовать портал Azure или Azure CLI для получения прошлых значений ключей.

Портал

1. Войдите на портал Azure. Выберите все ресурсы и выберите экземпляр сервиса конфигурации приложений, где хранятся ваши ключи и значения.

2. В меню "Операции " выберите "Восстановить".

   

3. Выбор даты. Выберите дату, чтобы выбрать дату и время, в которое вы хотите вернуться.

4. Щелкните за пределами полей даты и времени или нажмите клавишу TAB , чтобы проверить выбор. Теперь можно увидеть, какие значения ключей изменились между выбранной датой и временем и текущим временем. На этом шаге вы поймете, какие ключи и значения вы готовитесь восстановить.

   

   На портале отображается таблица ключевых значений. Первый столбец содержит символы, указывающие, что произойдет при восстановлении данных для выбранной даты и времени:

   • Красный знак минуса (–) означает, что значение ключа не существовало в выбранной дате и времени и будет удалено.
   • Зеленый знак плюса (+) означает, что значение ключа существовало в выбранной дате и времени и сейчас не существует. Если вернуться к выбранной дате и времени, она будет добавлена обратно в конфигурацию.
   • Оранжевый знак маркера (•) означает, что значение ключа было изменено с выбранной даты и времени. Ключ вернется к значению, которое оно было в выбранной дате и времени.

5. Установите флажок в строке, чтобы выбрать или отменить выбор значения ключа для выполнения действий. При выборе будет отображаться разница для ключевого значения между текущей и выбранной датой и временем.

   

   В приведенном выше примере в предварительной версии показан ключ TestApp:Settings:BackgroundColor, который в настоящее время имеет значение #FFF. Это значение будет изменено на #45288E, если мы перейдем к восстановлению данных.

   Вы можете выбрать один или несколько флажков в таблице, чтобы принять меры по выбранному значению ключа. Вы также можете установить флажок select-all в верхней части списка, чтобы выбрать или отменить выбор всех значений ключей.

6. Выберите "Восстановить ", чтобы восстановить выбранные значения ключа до выбранных данных и времени.

   

Azure CLI

Используйте Azure CLI, как описано ниже, для получения и восстановления прошлых значений ключей. Если у вас нет локальной версии Azure CLI, можно использовать Azure Cloud Shell.

В интерфейсе командной строки можно az appconfig revision list просматривать изменения или az appconfig kv restore восстанавливать значения ключей, добавляя соответствующие параметры. Укажите экземпляр конфигурации приложений Azure, определив имя хранилища (--name <app-config-store-name>) или используя строку подключения (--connection-string <your-connection-string>). Ограничить выходные данные путем указания определенной точки во времени (), метки (--datetime--label) и максимального количества возвращаемых элементов (--top). и задав максимальное количество возвращаемых элементов (--top).

Извлеките все записанные изменения в значения ключей.

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

Восстановите все значения ключей до определенной точки во времени.

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

Восстановление для любой метки, начиная с версии 1. до определенной точки во времени.

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

Дополнительные примеры команд CLI и необязательных параметров для восстановления ключа-значения см. в документации по Azure CLI.

Вы также можете получить доступ к истории определенного ключа-значения. Эта функция позволяет проверить значение определенного ключа в выбранной точке времени и вернуться к прошлому значению, не обновляя другое значение ключа.

Представление "Историческая/временная шкала" для ключевых значений

Подсказка

Этот метод удобен, если у вас не более пары изменений, так как конфигурационный обозреватель позволяет вносить изменения по одному ключу за раз. Если необходимо восстановить несколько значений ключей одновременно, используйте меню "Восстановить ".

Портал

Вы также можете открыть историю изменений определенного ключевого значения на портале.

1. В меню "Операции " выберите обозреватель конфигурации.

2. Выберите дополнительные действия для ключа, который вы хотите исследовать, а затем история

   

   Теперь вы можете просмотреть журнал редакций для выбранного ключа и сведения об изменениях.

3. Выберите "Восстановить ", чтобы восстановить ключ и значение до этого момента времени.

   

Azure CLI

Используйте Azure CLI, как описано ниже, чтобы получить и восстановить одно значение ключа. Если у вас нет локальной версии Azure CLI, можно использовать Azure Cloud Shell.

В интерфейсе командной строки используйте az appconfig revision list для просмотра изменений в паре ключ-значение или az appconfig kv restore для восстановления пары ключ-значение, добавляя соответствующие параметры. Укажите экземпляр конфигурации приложений Azure, определив имя хранилища (--name <app-config-store-name>) или используя строку подключения (--connection-string <your-connection-string>). Ограничить выходные данные путем указания определенного ключа (--key). При необходимости укажите метку (--label), точку во времени (--datetime) и максимальное количество возвращаемых элементов (--top).

Список истории изменений для ключа "цвет" с любыми метками.

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

История изменений конкретной пары ключ-значение с меткой.

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

История изменений ключа-значения с несколькими метками.

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

Извлеките все записанные изменения ключа color в определенный момент времени.

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

Извлеките последние 10 записанных изменений для ключа color в определенный момент времени.

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

Дополнительные примеры и необязательные параметры см. в документации по Azure CLI.

Следующий шаг

Создание веб-приложения ASP.NET Core