Управление моментальными снимками и использование

Из этой статьи вы узнаете, как создавать, использовать моментальные снимки и управлять ими в конфигурации приложений Azure. Моментальный снимок — это набор параметров конфигурации приложений, хранящихся в неизменяемом состоянии.

Предпосылки

• Хранилище конфигурации приложений, как показано в руководстве по созданию хранилища.
• Роль DataOwner в хранилище конфигурации приложений. Сведения о требуемой роли и разрешениях для моментальных снимков

Добавление ключевых значений в хранилище конфигураций приложений

В хранилищеконфигураций приложений перейдите в обозреватель > и добавьте следующие ключевые значения. Оставьте тип контента со значением по умолчанию. Дополнительные сведения о добавлении значений ключей в хранилище с помощью портал Azure или ИНТЕРФЕЙСА командной строки см. в разделе "Создание значения ключа".

Ключ	Ценность	Этикетка
app2/bgcolor	Светло-серый	label2
app1/color	черный	Нет метки
app1/color	Синий	label1
app1/color	Зеленый	label2
app1/color	Жёлтый	label3
app1/message	Привет	label1
app1/message	Привет!	label2
app2/message	Доброе утро!	label1

Создайте моментальный снимок

В разделе «Операции»>«Снимки» выберите «Создать новый снимок».

1. Введите имя моментального снимка и при необходимости добавьте теги.

2. В разделе "Выбор типа композиции" оставьте значение по умолчанию "Ключ (по умолчанию)".

   • С типом использования ключей Key, если в вашей системе хранения есть идентичные ключи с разными метками, в снимок состояния включается только значение ключа, указанное в последнем применимом фильтре. Идентичные значения ключей с другими метками остаются вне моментального снимка.
   • Если в Key-Label магазине есть идентичные ключи с различными метками, то все значения с одинаковыми ключами, но различными метками включаются в моментальный снимок в зависимости от заданных фильтров.

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

   1. Добавьте первый фильтр:
      • В разделе "Ключ" выберите "Начало работы с приложением1" и "Введите приложение1"
      • В разделе "Метка" выберите "Равно" и выберите метку2 в раскрывающемся меню.
   2. Добавьте второй фильтр:
      • В разделе "Ключ" выберите "Начало работы с приложением1" и "Введите приложение1"
      • В разделе "Метка" выберите "Равно" и выберите метку1 в раскрывающемся меню.

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

   Замечание

   Длительность периода хранения не может быть обновлена после создания моментального снимка.

5. Выберите "Создать", чтобы создать моментальный снимок. В этом примере созданный моментальный снимок имеет тип композиции Key и следующие фильтры:

   • Ключи, начинающиеся с app1, с меткой label2
   • Ключи, начинающиеся с app1, с меткой label1 .

   

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

   Ключ	Ценность	Этикетка	Включен в моментальный снимок
   app2/bgcolor	Светло-серый	label2	Нет: не начинается с app1.
   app1/color	черный	Нет метки	Нет: не имеет метки2 или метки1.
   app1/color	Синий	label1	Да: имеет правильную метку label1 из последнего применимого фильтра.
   app1/color	Зеленый	label2	Нет. Один и тот же ключ с меткой метки1 , выбранный вторым фильтром, переопределяет этот, хотя он имеет выбранную метку, метку2.
   app1/color	Жёлтый	label3	Нет: не имеет метки2 или метки1.
   app1/message	Привет	label1	Да: имеет правильную метку label1 из последнего применимого фильтра.
   app1/message	Привет!	label2	Нет. Один и тот же ключ с меткой метки1 , выбранный вторым фильтром, переопределяет этот, хотя он имеет выбранную метку, метку2.
   app2/message	Доброе утро!	label1	Нет: не начинается с app1.

Создайте образцы моментальных снимков

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

1. В разделе Операции>Моментальные снимки>Активные снимки, выберите Тестировать в песочнице.
2. Просмотрите примеры данных и потренируйтесь создавать моментальные снимки, заполнив форму типом композиции и одним или несколькими фильтрами.
3. Выберите Создать, чтобы создать образец снимка.
4. Ознакомьтесь с результатом создания моментального снимка, созданного в разделе "Созданный образец моментального снимка". Образец моментального снимка показывает все ключи, включенные в него, по вашему выбору.

Использование моментальных снимков

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

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

.СЕТЬ

Измените вызов AddAzureAppConfiguration метода, который часто находится в Program.cs файле приложения. Если у вас нет приложения, вы можете ссылаться на любое из кратких руководств по .NET, например создание ASP.NET основного приложения с помощью конфигурации приложений Azure.

Добавление моментальных снимков в конфигурацию

configurationBuilder.AddAzureAppConfiguration(options =>
{
    string endpoint = Environment.GetEnvironmentVariable("Endpoint"); 
    options.Connect(new Uri(endpoint), new DefaultAzureCredential());
    // 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
});

Замечание

Поддержка моментальных снимков доступна, если вы используете версию 7.0.0 или более позднюю версию любого из следующих пакетов.

• Microsoft.Extensions.Configuration.AzureAppConfiguration
• Microsoft.Azure.AppConfiguration.AspNetCore
• Microsoft.Azure.AppConfiguration.Functions.Worker

Весна

application.yml Обновите файл приложения с помощью следующих конфигураций.

spring:
  config:
    import: azureAppConfiguration
  cloud:
    azure:
      appconfiguration:
        stores:
         -
           endpoint: <your-endpoint>
           selects:
             -
              snapshot-name: <name-of-your-snapshot>
           trim-key-prefix: 
             - <prefix-to-trim>

Замечание

Например, любой префикс, такой как /application/, автоматически обрезанный при использовании фильтра ключей, необходимо указать при создании моментальных снимков, иначе они не будут правильно сопоставлены с @ConfigurationProperties классами. Поддержка моментальных снимков доступна, если вы используете версию 4.12.0-beta.1/5.6.0-beta.1 или более поздней версии любого из следующих пакетов.

• spring-cloud-azure-appconfiguration-config
• spring-cloud-azure-appconfiguration-config-web
• spring-cloud-azure-starter-appconfiguration-config

Замечание

Только моментальные снимки, созданные с типом составления Key, могут быть загружены с помощью приведенных выше примеров кода.

Управление активными снимками

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

Просмотр существующего моментального снимка

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

Архивация моментального снимка

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

Управление архивными моментальными снимками

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

Просмотр архивированного моментального снимка

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

Восстановление архивного моментального снимка

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

Дальнейшие шаги

Моментальные снимки в конфигурации приложений Azure