Снимки

Снимок — это именованное неизменяемое подмножество пар «ключ-значение» хранилища App Configuration. Значения ключей, составляющие моментальный снимок, выбираются во время создания с помощью фильтров ключей и меток. После создания снимка пары «ключ-значение», содержащиеся в нём, гарантированно остаются неизменными.

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

Развертывайте безопасно с помощью снимков

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

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

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

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

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

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

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

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

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

Операции со снимками

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

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

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

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

Требования к операциям со снимками

В следующих разделах описаны разрешения, необходимые для выполнения операций со снимками с использованием Microsoft Entra ID и аутентификации 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, как операцию «чтение моментального снимка» (для чтения пар «ключ-значение» из моментального снимка), так и операцию «получение списка моментальных снимков» можно выполнять с использованием либо ключей доступа на чтение и запись, либо ключей доступа только на чтение.

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

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

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

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