Управление событиями предварительной и публикации (предварительная версия)

Область применения: ✔️ виртуальные машины ✔️ ✔️ Linux под управлением Windows на локальных серверах с ✔️ поддержкой Azure Arc.

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

Регистрация подписки для общедоступной предварительной версии

Чтобы самостоятельно зарегистрировать подписку для общедоступной предварительной версии в портал Azure:

1. Войдите в портал Azure и выберите "Другие службы".

2. На странице "Все службы" найдите функции предварительной версии.

3. На странице "Предварительный просмотр функций" выполните поиск и выберите "Предварительные и записи событий".

4. Выберите функцию и нажмите кнопку "Зарегистрировать", чтобы зарегистрировать подписку.

   

Временная шкала расписаний для предварительных и постовых событий

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

Например, если для расписания обслуживания задано значение 3:00, период обслуживания составляет 3 часа и 55 минут для обслуживания гостей область, ниже приведены сведения:

Time	Сведения
2:19 вечера	Вы можете изменять компьютеры и (или) динамически область компьютеров до 40 минут до запланированного выполнения исправления с соответствующим предварительным событием. Если все изменения вносятся в ресурсы, подключенные к расписанию после этого времени, ресурсы будут включены в последующий запуск расписания, а не текущий запуск. Обратите внимание , что если вы создаете новое расписание или редактируйте существующее расписание с предварительным событием, вам потребуется по крайней мере 40 минут до периода обслуживания для выполнения предварительного события. В этом примере, если вы установили расписание в 3:00 вечера, можно изменить область 40 минут до заданного времени в 2.19 вечера.
От 2:20 до 2:30 вечера	Предварительное событие активируется, предоставляя atleast 20 минут до начала установки исправлений. В этом примере предварительное событие инициируется от 2:20 до 2:30 вечера.
14:50	Предварительное событие имеет значение atleast 20 минут до начала установки исправлений. Примечание. Если предварительное событие продолжает выполняться за 20 минут, установка исправлений идет вперед независимо от состояния выполнения предварительного события. — Если вы решили отменить текущий запуск, можно отменить с помощью API отмены 10 минут до расписания. В этом примере к 2:50 вечера вы можете отменить сценарий или код функции Azure. Если API отмены не удалось вызвать или не было настроено, установка исправлений продолжает выполняться. В этом примере предварительное событие должно завершить задачи до 2:50. Если вы решили отменить текущий запуск, последнее время, которое можно вызвать API отмены, составляет 2:50 вечера.
15:00	Как определено в конфигурации обслуживания, расписание активируется в указанное время. В этом примере расписание активируется в 3:00.
6:55 вечера	Событие записи активируется после завершения определенного периода обслуживания. Если вы определили более короткий период обслуживания 2 часа, событие после обслуживания будет запускаться через 2 часа, и если расписание обслуживания будет завершено до указанного времени в 2 часа, то есть в 1 час 50 минут, событие после начала. В этом примере, если для периода обслуживания задано максимальное значение, то к 6:55 pm процесс установки исправлений завершен и если у вас есть более короткий период обслуживания, процесс установки исправлений завершается до 5:00 вечера.
19:15	После установки исправлений событие после выполнения выполняется в течение 20 минут. В этом примере событие публикации инициируется в 6:55 и завершается до 7:15 вечера и если у вас есть более короткий период обслуживания, событие после выполнения запускается в 5:00 и завершается до 5:20 вечера.

Рекомендуется следить за следующими параметрами:

• Если вы создаете новое расписание или редактируйте существующее расписание с предварительным событием, вам потребуется по крайней мере 40 минут до начала периода обслуживания (3PM в приведенном выше примере) для предварительного выполнения события в противном случае это приведет к автоматической отмене текущего запланированного запуска.
• Предварительное событие активируется 30 минут до запланированного выполнения исправления, предоставляющего предварительное событие atleast 20 минут.
• После завершения установки исправлений после выполнения события после завершения установки исправлений.
• Чтобы отменить текущий запуск исправления, используйте API отмены atleast 10 минут до времени обслуживания расписания.

Настройка событий предварительной и публикации в существующем расписании

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

1. Войдите в портал Azure и перейдите в Диспетчер обновлений Azure.

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

3. На странице "Конфигурация обслуживания" выберите конфигурацию обслуживания, в которую требуется добавить событие предварительного и последующего выполнения.

4. На выбранной странице конфигурации обслуживания в разделе Параметры выберите "События". Кроме того, в разделе "Обзор" выберите карта Создать событие обслуживания.

   

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

   

6. На странице "Создание подписки на события" введите следующие сведения:

   • В разделе "Сведения о подписке на события" укажите соответствующее имя.

   • Сохраните схему как схему сетки событий.

   • В разделе "Сведения о разделе разделов" укажите соответствующее имя имени системного раздела.

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

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

     

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

Примечание.

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

Просмотр событий предварительной и публикации

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

1. Войдите в портал Azure и перейдите в Диспетчер обновлений Azure.
2. В разделе "Управление" выберите компьютеры, конфигурации обслуживания.
3. На странице "Конфигурация обслуживания" выберите конфигурацию обслуживания, в которую требуется добавить событие предварительного и последующего выполнения.
4. Выберите обзор и проверка события обслуживания.

   • Выберите "Настроить", чтобы настроить его.

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

     

Удаление предварительного и последующего события

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

1. Войдите в портал Azure и перейдите в Диспетчер обновлений Azure.

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

3. На странице "Конфигурация обслуживания" выберите конфигурацию обслуживания, в которую требуется добавить событие предварительного и последующего выполнения.

4. На выбранной странице конфигурации обслуживания в разделе Параметры выберите "События". Кроме того, в разделе "Обзор" выберите карта Создать событие обслуживания.

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

6. На выбранной странице событий нажмите кнопку "Удалить".

   

Примечание.

• Если все события предварительной и последующей записи удаляются из конфигурации обслуживания, system Topic автоматически удаляется из EventGrid.
• Рекомендуется не удалять системный раздел вручную из службы EventGrid.

Отмена расписания из предварительного события

Чтобы отменить расписание, необходимо вызвать API отмены в предварительном событии, чтобы настроить процесс отмены, который находится в скрипте Runbook или коде функции Azure. Здесь необходимо определить критерии, начиная с момента отмены расписания. Система не будет отслеживать и не будет автоматически отменять расписание на основе состояния предварительного события.

Существует два типа отмены:

• Отмена пользователем — при вызове API отмены из скрипта или кода.
• Отмена по системе — когда система вызывает API отмены из-за внутренней ошибки. Это делается только в том случае, если система не может отправить предварительное событие в конечную точку клиента, которая составляет 30 минут до запланированного задания исправления.

Примечание.

Если отмена выполняется системой, предстоящее запланированное задание исправления будет отменено из-за сбоя выполнения предварительных событий с помощью sytem.

Внимание

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

Просмотр состояния отмены

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

1. На домашней странице Диспетчера обновлений Azure перейдите в журнал

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

   

Состояние отмены можно просмотреть из сообщения об ошибке в ФОРМАТЕ JSON. JSON можно получить из Azure Resource Graph (ARG). Соответствующая конфигурация обслуживания будет отменена с помощью API отмены.

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

maintenanceresources  
| where type =~ "microsoft.maintenance/maintenanceconfigurations/applyupdates"  
| where properties.correlationId has "/subscriptions/your-s-id/resourcegroups/your-rg-id/providers/microsoft.maintenance/maintenanceconfigurations/mc-name/providers/microsoft.maintenance/applyupdates/"  
| order by name desc

• your-s-id : идентификатор подписки, в которой создается конфигурация обслуживания с событием pre или post
• your-rg-id : имя группы ресурсов, в которой создается конфигурация обслуживания
• mc-name : имя конфигурации обслуживания в предварительном событии создается

Если задание обслуживания отменено системой из-за какой-либо причины, сообщение об ошибке в JSON получено из Azure Resource Graph для соответствующей конфигурации обслуживания, будет отменено расписание обслуживания из-за внутреннего сбоя платформы.

Вызов API отмены

 C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/<your-c-id-obtained-from-above>?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose 

Примечание.

Необходимо заменить идентификатор корреляции, полученный из приведенного выше запроса ARG, и заменить его в API отмены.

Пример

  C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/subscriptions/eee2cef4-bc47-4278-b4f8-cfc65f25dfd8/resourcegroups/fp02centraluseuap/providers/microsoft.maintenance/maintenanceconfigurations/prepostdemo7/providers/microsoft.maintenance/applyupdates/20230810085400?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose

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

• Сведения о проблемах и обходных решениях см. в статье об устранении неполадок
• Общие сведения о сценариях подготовки и публикации
• Узнайте о распространенных сценариях предварительных и опубликованных событий