사전 및 사후 이벤트 관리(미리 보기)

적용 대상: ✔️ Windows VM ✔️ Linux VM ✔️ 온-프레미스 환경 ✔️ Azure Arc 지원 서버.

사전 및 사후 이벤트를 사용하면 패치 설치 예약 전후에 사용자 정의 작업을 실행할 수 있습니다. 이 문서에서는 Azure 업데이트 관리자에서 사전 및 사후 이벤트를 만들고 보고 취소하는 방법을 설명합니다.

공개 미리 보기에 대한 구독 등록

Azure Portal에서 공개 미리 보기에 대한 구독을 자체 등록하려면 다음을 수행합니다.

1. Azure Portal에 로그인하고 추가 서비스를 선택합니다.

2. 전체 서비스 페이지에서 미리 보기 기능을 검색합니다.

3. 미리 보기 기능 페이지에서 사전 및 사후 이벤트를 검색하고 선택합니다.

4. 기능을 선택한 다음 등록을 선택하여 구독을 등록합니다.

   

사전 및 사후 이벤트 일정 타임라인

다음 표를 통해 사전 및 사후 이벤트 일정의 타임라인을 파악하는 것이 좋습니다.

예를 들어, 유지 관리 일정이 오후 3시에 시작하도록 설정되어 있고 게스트 유지 관리 범위에 대한 유지 관리 기간이 3시간 55분인 경우 세부 정보는 다음과 같습니다.

Time	세부 정보
오후 2:19	연결된 사전 이벤트를 통해 예약된 패치가 실행되기 최대 40분 전에 컴퓨터를 편집하거나 동적으로 컴퓨터 범위를 지정할 수 있습니다. 이 시간 이후에 일정에 연결된 리소스가 변경되면 리소스는 현재 실행이 아닌 후속 일정 실행에 포함됩니다. 참고 사전 이벤트가 포함된 새 일정을 만들거나 기존 일정을 편집하는 경우 유지 관리 기간이 시작되기 최소 40분 전에 사전 이벤트가 실행되어야 합니다. 이 예에서 일정을 오후 3시로 설정한 경우 설정된 시간인 오후 2시 19분보다 40분 전에 범위를 수정할 수 있습니다.
오후 2시 20분~오후 2시 30분	사전 이벤트는 패치 설치가 실행되기 전에 최대 20분 동안 완료되도록 트리거됩니다. 이 예제에서는 오후 2시 20분에서 오후 2시 30분 사이에 사전 이벤트가 시작됩니다.
오후 2:50	사전 이벤트는 패치 설치가 실행되기 전에 완료되는 데 최대 20분이 걸립니다. 참고 - 사전 이벤트가 20분 이상 계속 실행되면 사전 이벤트 실행 상태에 관계없이 패치 설치가 진행됩니다. - 현재 실행을 취소하기로 선택한 경우 일정 10분 전에 취소 API를 사용하여 취소할 수 있습니다. 이 예에서는 오후 2시 50분까지 스크립트 또는 Azure 함수 코드에서 취소할 수 있습니다. 취소 API가 호출되지 않거나 설정되지 않은 경우 패치 설치가 계속 실행됩니다. 이 예에서 사전 이벤트는 오후 2시 50분까지 작업을 완료해야 합니다. 현재 실행을 취소하기로 선택한 경우 취소 API를 호출할 수 있는 마지막 시간은 오후 2시 50분입니다.
오후 3:00	유지 관리 구성에 정의된 대로 일정은 지정된 시간에 트리거됩니다. 이 예에서는 일정이 오후 3시에 트리거됩니다.
오후 6:55	정의된 유지 관리 기간이 완료된 후 게시 이벤트가 트리거됩니다. 더 짧은 유지 관리 기간을 2시간으로 정의한 경우 사후 유지 관리 이벤트는 2시간 후에 실행되고, 유지 관리 일정이 규정된 2시간 이전, 즉 1시간 50분 전에 완료되면 사후 이벤트가 시작됩니다. 이 예에서 유지 관리 기간이 최대로 설정된 경우 오후 6시 55분까지 패치 설치 프로세스가 완료되고, 유지 관리 기간이 더 짧은 경우 패치 설치 프로세스는 오후 5시에 완료됩니다.
오후 7:15	패치 설치 후 20분간 포스트 이벤트가 진행됩니다. 이 예에서 게시물 이벤트는 오후 6시 55분에 시작되어 오후 7시 15분에 완료됩니다. 유지 관리 기간이 더 짧은 경우 게시물 이벤트는 오후 5시에 트리거되어 오후 5시 20분에 완료됩니다.

다음 사항을 주의하는 것이 좋습니다.

• 사전 이벤트가 포함된 새 일정을 만들거나 기존 일정을 수정하는 경우 사전 이벤트를 실행하려면 유지 관리 기간 시작(위 예의 경우 오후 3시) 최소 40분 전에 사전 이벤트를 실행해야 하며, 그렇지 않으면 현재 예약된 실행이 자동으로 취소됩니다.
• 사전 이벤트는 예약된 패치가 실행되기 30분 전에 트리거되어 사전 이벤트를 완료하는 데 최대 20분이 걸립니다.
• 사후 이벤트는 패치 설치가 완료된 직후에 실행됩니다.
• 현재 패치 실행을 취소하려면 일정 유지 관리 시간 10분 전에 취소 API를 사용합니다.

기존 일정에 따라 사전 및 사후 이벤트 구성

기존 일정에 따라 사전 및 사후 이벤트를 구성할 수 있으며 단일 일정에 여러 사전 및 사후 이벤트를 추가할 수 있습니다. 사전 및 사후 이벤트를 추가하려면 다음 단계를 따릅니다.

1. Azure Portal에 로그인하고 Azure 업데이트 관리자로 이동합니다.

2. 관리에서 컴퓨터, 유지 관리 구성을 선택합니다.

3. 유지 관리 구성 페이지에서 사전 및 사후 이벤트를 추가할 유지 관리 구성을 선택합니다.

4. 선택한 유지 관리 구성 페이지의 설정에서 이벤트를 선택합니다. 또는 개요에서 유지 관리 이벤트 만들기 카드를 선택합니다.

   

5. 사전/사후 유지 관리 이벤트를 만들려면 +이벤트 구독을 선택합니다.

   

6. 이벤트 구독 만들기 페이지에서 다음 세부 정보를 입력합니다.

   • 이벤트 구독 세부 정보 섹션에 적절한 이름을 입력합니다.

   • 스키마를 Event Grid 스키마로 유지합니다.

   • 항목 세부 정보 섹션에서 시스템 토픽 이름에 적절한 이름을 제공합니다.

   • 이벤트 유형 섹션인 이벤트 유형으로 필터링에서 엔드포인트나 대상으로 푸시할 이벤트 유형을 선택합니다. 사전 유지 관리 이벤트와 사후 유지 관리 이벤트 중에서 선택할 수 있습니다.

   • 엔드포인트 세부 정보 섹션에서 응답을 수신하려는 엔드포인트를 선택합니다. 고객이 사전 또는 사후 이벤트를 트리거하는 데 도움이 됩니다.

     

7. 기존 일정에 따라 사전 및 사후 이벤트를 구성하려면 만들기를 선택합니다.

참고 항목

• 사전 및 사후 이벤트는 예약된 유지 관리 구성 수준에서만 만들 수 있습니다.
• 시스템 토픽은 유지 관리 구성별로 자동으로 생성되고 모든 이벤트 구독은 EventGrid의 시스템 토픽에 연결됩니다.
• 사전 및 사후 이벤트 실행이 일정 유지 관리 기간을 벗어납니다.

사전 및 사후 이벤트 보기

사전 및 사후 이벤트를 보려면 다음 단계를 따릅니다.

1. Azure Portal에 로그인하고 Azure 업데이트 관리자로 이동합니다.
2. 관리에서 컴퓨터, 유지 관리 구성을 선택합니다.
3. 유지 관리 구성 페이지에서 사전 및 사후 이벤트를 추가할 유지 관리 구성을 선택합니다.
4. 개요를 선택하고 유지 관리 이벤트를 확인합니다.

   • 구성을 선택하여 설정합니다.

   • 설정이 이미 완료된 경우 이벤트 페이지에서 구성과 관련된 사전 및 사후 이벤트 수를 확인할 수 있습니다.

     

사전 및 사후 이벤트 삭제

사전 및 사후 이벤트를 삭제하려면 다음 단계를 따릅니다.

1. Azure Portal에 로그인하고 Azure 업데이트 관리자로 이동합니다.

2. 관리에서 컴퓨터, 유지 관리 구성을 선택합니다.

3. 유지 관리 구성 페이지에서 사전 및 사후 이벤트를 추가할 유지 관리 구성을 선택합니다.

4. 선택한 유지 관리 구성 페이지의 설정에서 이벤트를 선택합니다. 또는 개요에서 유지 관리 이벤트 만들기 카드를 선택합니다.

5. 그리드에서 삭제하려는 이벤트 이름을 선택합니다.

6. 선택한 이벤트 페이지에서 삭제를 선택합니다.

   

참고 항목

• 모든 사전 및 사후 이벤트가 유지 관리 구성에서 삭제되면 System Topic은 EventGrid에서 자동으로 삭제됩니다.
• EventGrid 서비스에서 시스템 토픽을 수동으로 삭제하지 않는 것이 좋습니다.

사전 이벤트 일정 취소

일정을 취소하려면 사전 이벤트에서 취소 API를 호출하여 Runbook 스크립트 또는 Azure 함수 코드에 있는 취소 프로세스를 설정해야 합니다. 여기에서는 일정을 취소해야 하는 시점부터 기준을 정의해야 합니다. 시스템은 사전 이벤트 상태에 따라 일정을 모니터링하거나 자동으로 취소하지 않습니다.

취소에는 두 가지 형식이 있습니다.

• 사용자에 의한 취소 - 스크립트나 코드에서 취소 API를 호출하는 경우.
• 시스템에 의한 취소 - 내부 오류로 인해 시스템이 취소 API를 호출하는 경우. 이는 시스템이 예약된 패치 작업 30분 전인 고객의 엔드포인트에 사전 이벤트를 보낼 수 없는 경우에만 수행됩니다.

참고 항목

시스템에 의해 취소가 이루어지면 시스템에 의한 사전 이벤트 실행 실패로 인해 예정된 패치 작업이 취소됩니다.

Important

사용자가 취소 API를 사용하거나 시스템 내부 장애로 인해 예약된 유지 관리 작업이 취소된 경우 사후 이벤트가 구독되면 사용자가 구성한 엔드포인트로 전송됩니다.

취소 상태 보기

취소 상태를 보려면 다음 단계를 따릅니다.

1. Azure 업데이트 관리자 홈페이지에서 기록으로 이동합니다.

2. 유지 관리 실행 ID를 선택하고 상태를 보려는 실행 ID를 선택합니다.

   

JSON의 오류 메시지에서 취소 상태를 볼 수 있습니다. JSON은 ARG(Azure Resource Graph)에서 가져올 수 있습니다. 해당 유지 관리 구성은 취소 API를 사용하여 취소됩니다.

다음 쿼리를 사용하면 지정된 일정 또는 유지 관리 구성에 대한 VM 목록을 볼 수 있습니다.

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 : 사전 또는 사후 이벤트를 사용하여 유지 관리 구성을 만드는 구독 ID
• your-rg-id : 유지 관리 구성이 만들어지는 리소스 그룹 이름
• mc-name : 사전 이벤트의 유지 관리 구성 이름이 만들어짐

시스템에서 유지 관리 작업이 어떤 이유로든 취소된 경우 해당 유지 관리 구성에 대해 Azure Resource Graph에서 가져온 JSON의 오류 메시지는 내부 플랫폼 오류로 인해 유지 관리 일정이 취소됨입니다.

취소 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 쿼리에서 받은 상관 관계 ID를 취소 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

다음 단계

• 문제 및 해결 방법은 문제 해결을 참조하세요.
• 사전 및 사후 시나리오에 대한 개요
• 사전 및 사후 이벤트의 일반적인 시나리오에 대해 알아봅니다.