Значения ключей в точке во времени

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

Восстановление пар "ключ-значение"

Для извлечения прошлых пар "ключ-значение" можно использовать портал Azure или интерфейс командной строки Azure.

Портал

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

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

   

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

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

   

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

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

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

   

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

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

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

   

Azure CLI

Для получения и восстановления предыдущих пар "ключ-значение" можно использовать интерфейс командной строки (CLI) Azure, как показано ниже. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

В CLI используйте команду 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"

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

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

Для получения и восстановления одной пары "ключ-значение" можно использовать интерфейс командной строки (CLI) Azure, как показано ниже. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

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

Вывод журнала изменений для ключа "color" с любыми метками.

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