Моментальные снимки

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

Краткий обзор доступен в этом видео, в котором рассматриваются три причины, по которым моментальные снимки могут быть полезны для вас.

Безопасное развертывание с помощью моментальных снимков

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

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

Сценарии использования моментальных снимков

  • Управляемое развертывание: моментальные снимки хорошо подходят для поддержки управляемого развертывания из-за их неизменяемой природы. Когда разработчики используют моментальные снимки для настройки, они могут быть уверены, что конфигурация остается неизменной по мере выполнения выпуска на различных этапах развертывания.

  • Последняя конфигурация "Известный хороший" (LKG): моментальные снимки можно использовать для поддержки безопасных методов развертывания для конфигурации. С помощью моментальных снимков разработчики могут убедиться, что конфигурация last known Good (LKG) доступна для отката, если во время развертывания возникла какая-либо проблема.

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

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

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

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

Операции моментального снимка

Так как моментальные снимки являются неизменяемыми сущностями, моментальные снимки можно создавать и архивировать. Удаление, очистка или редактирование невозможно.

  • Создание моментального снимка: моментальные снимки можно создать, определив фильтры ключей и меток для записи необходимых значений ключей из экземпляра Конфигурация приложений. Отфильтрованные значения ключей хранятся в виде моментального снимка с именем, указанным во время создания.

  • Архивный моментальный снимок: архивация моментального снимка помещает его в архивное состояние. Хотя моментальный снимок архивирован, он по-прежнему полностью функциональный. Когда моментальный снимок архивируется, срок действия устанавливается на основе периода хранения, настроенного во время создания моментального снимка. Если моментальный снимок остается в архивном состоянии до истечения срока действия, он автоматически исчезает из системы после истечения срока действия. Архивация используется для поэтапного удаления моментальных снимков, которые больше не используются.

  • Восстановление моментального снимка: восстановление моментального снимка помещает его обратно в активное состояние. На этом этапе момент моментальный снимок больше не подлежит истечению срока действия на основе настроенного срока хранения. Восстановление возможно только в период хранения после архивации.

Примечание.

Период хранения можно задать только во время создания моментального снимка. Значение по умолчанию для периода хранения — 30 дней для стандартных магазинов и 7 дней для бесплатных магазинов.

Требования к операциям моментального снимка

В следующих разделах описаны разрешения, необходимые для выполнения операций, связанных с моментальным снимком, с идентификатором Microsoft Entra и проверкой подлинности HMAC.

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

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

  • Microsoft.AppConfiguration/configurationStores/keyvalues/read
  • Microsoft.AppConfiguration/configurationStores/snapshots/write

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

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

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

  • Microsoft.AppConfiguration/configurationStores/snapshots/archive/action

Чтобы архивировать и/или восстановить моментальный снимок с помощью проверки подлинности HMAC, необходимо использовать ключ доступа для чтения и записи.

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

Для перечисления всех моментальных снимков или получения всех значений ключей в отдельном моментальном снимке по имени необходимо следующее разрешение для хранилищ, использующих проверку подлинности Microsoft Entra. Встроенные роли владельца данных и средства чтения данных уже имеют это разрешение.

  • Microsoft.AppConfiguration/configurationStores/snapshots/read

Для хранилищ, использующих проверку подлинности HMAC, операция "считывать моментальный снимок" (для чтения значений ключей из моментального снимка) и операции "моментальные снимки списка" можно выполнять с помощью ключей доступа для чтения и записи или ключей доступа только для чтения.

Рекомендации по выставлению счетов и ограничения

Конфигурация приложений имеет два уровня, "Бесплатный" и "Стандартный". Проверьте следующие сведения о квотах моментальных снимков на каждом уровне.

  • Бесплатный уровень: у этого уровня есть квота хранилища моментальных снимков 10 МБ. Можно создать максимальное количество моментальных снимков, если общий размер хранилища всех активных и архивных моментальных снимков меньше 10 МБ.

  • Стандартный уровень: этот уровень имеет квоту хранилища моментальных снимков размером 1 ГБ. Можно создать максимальное количество моментальных снимков, если общий размер хранилища всех активных и архивных моментальных снимков меньше 1 ГБ.

Максимальный размер моментального снимка составляет 1 МБ.

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