Настройте параметры обновления службы для экземпляров API Management.

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Стандартный | Премия

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

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

Обновление группы

Группа обновлений (также называемая каналом выпуска) — это набор экземпляров, получающих обновления службы управления API во время внедрения в производственной среде, который может занять от нескольких дней до нескольких недель.

Обновление группы Description
Ранний доступ к ИИ (канал распространения GenAI) Получает ранний доступ к последним функциям и обновлениям шлюза ИИ , прежде чем они достигают других групп обновлений.

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

Замечание

  • Azure развертывает все обновления с помощью платформы safe deployment practices (SDP. Обновления, выпущенные в начале развертывания, могут быть менее стабильными и заменены позже стабильными выпусками. Все экземпляры в конечном итоге обновляются до самых стабильных сборок выпуска.
  • Все группы обновлений могут включать функции в предварительную версию. Предварительные версии функций четко отмечены на портале Azure и документации.
  • Функции распространяются через группы обновлений в этой последовательности: Шлюз ИИ (ранний доступ) (только функции ИИ) → РаннийСтандартныйПоздний.

Например, может потребоваться добавить тестовый экземпляр в группу ранних обновлений. Этот экземпляр получает обновления до ваших производственных экземпляров, которые помещают в группу обновлений по умолчанию или позднюю группу обновлений. Вы можете отслеживать тестовый экземпляр для любых проблем, вызванных обновлениями, прежде чем они достигают рабочих экземпляров. Узнайте больше о канареечных развертываниях с помощью API Management

Окно обслуживания

Период обслуживания — это 8-часовой ежедневный период, когда требуется, чтобы экземпляр получал обновления. По умолчанию окно обслуживания составляет с 22:00 до 6:00 по времени часовому поясу экземпляра.

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

Настройка параметров обновления службы

  1. Войдите на портал Azure и перейдите к экземпляру управления API.
  2. В меню слева выберитепараметры развертывания и обновления службы>.
  3. В разделе "Группа обновления" просмотрите текущий параметр и выберите "Изменить ", чтобы изменить его.
  4. В разделе "Период обслуживания" просмотрите текущие параметры и выберите "Изменить ", чтобы изменить их. Для каждого дня можно выбрать окно по умолчанию, другое стандартное окно или пользовательское окно по дням.

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

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

  • Обновления управления API объявляются в репозитории API Management GitHub. Подпишитесь на получение уведомлений из этого репозитория, чтобы узнать, когда начинается развертывание обновлений.

  • Используйте журнал Azure Activity для мониторинга обновлений служб, происходящих в экземпляре службы управления API. Событие "Запланированное обслуживание" создается при запуске обновления.

    Событие запланированного обслуживания в журнале активности на портале.

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

  • По умолчанию обновления развертываются в регионах следующими этапами: регионы Azure EUAP, затем Западно-Центральный регион США, а затем оставшиеся регионы в несколько последующих этапов. Последовательность регионов, обновленных на последующих этапах развертывания, отличается от службы к службе. Вы можете ожидать по крайней мере 24 часа между каждым этапом внедрения.

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

Подсказка

Если экземпляр управления API развертывается в нескольких расположениях (регионах), время обновления определяется основным расположением экземпляра.

Стратегии канареечного развертывания

Вы можете использовать экземпляр управления API, назначенный определенной группе обновлений (если этот параметр доступен), или развернуть его в определенном регионе Azure в качестве канарейки. Это развертывание получает обновления раньше, чем ваши рабочие экземпляры.

  • Добавление экземпляра в группу ранних обновлений. Используйте экземпляр службы управления API в группе ранних обновлений для проверки обновлений на раннем этапе развертывания в рабочей среде. Этот экземпляр фактически является вашим пробным развертыванием.

  • Deploy в канарском регионе — если у вас есть доступ к Azure региону EUAP, используйте экземпляр, чтобы проверить обновления сразу после их выпуска в рабочем конвейере. Узнайте о процессе запроса на доступ к региону Azure.

    Замечание

    Из-за ограничений емкости в регионах EUAP возможно, вы не сможете масштабировать экземпляры управления API по мере необходимости.

  • Развертывание в пилотном регионе . Используйте экземпляр в Западной части США для имитации рабочей среды или его использования в рабочей среде для некритического трафика API. Хотя этот регион получает обновления после регионов EUAP, развертывание здесь более вероятно выявит регрессии, относящиеся к конфигурации вашей службы.

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