Gerenciar pré e pós-eventos (versão prévia)

Aplica-se a: ✔️ VMs do Windows ✔️ VMs do Linux ✔️ Ambiente local ✔️ Servidores habilitados para Azure Arc.

Os eventos pré e pós permitem que você execute ações definidas pelo usuário antes e depois da instalação agendada do patch. Esse artigo descreve como criar, visualizar e cancelar os eventos pré e pós no Azure Update Manager.

Registre sua assinatura para visualização pública

Para registar automaticamente a sua subscrição para pré-visualização pública no portal do Azure:

1. Entre no portal do Azure e selecione Mais serviços.

2. Na página Todos os serviços, pesquise Recursos de visualização.

3. Na página Recursos de visualização, pesquise e selecione Pré e Pós Eventos.

4. Selecione o recurso e selecione Registrar para registrar a assinatura.

   

Cronograma de programações para pré e pós eventos

Recomendamos que você consulte a tabela a seguir para entender o cronograma da programação pré e pós-eventos.

Por exemplo, se um cronograma de manutenção estiver definido para começar às 15h, com a janela de manutenção de 3 horas e 55 minutos para o escopo de manutenção Convidado, a seguir estão os detalhes:

Hora	Detalhes
14H19	Recomendamos que você consulte a tabela a seguir para entender o cronograma da programação pré e pós-eventos. Se quaisquer alterações forem feitas nos recursos anexados ao agendamento após esse período, os recursos serão incluídos na execução do agendamento subsequente e não na execução atual. Observação Se estiver criando uma nova programação ou editando uma programação existente com um pré-evento, você precisará de pelo menos 40 minutos antes da janela de manutenção para que o pré-evento seja executado. Nesse exemplo, se você definiu uma programação para 15h, poderá modificar o escopo 40 minutos antes do horário definido, que é 14h19.
Entre 14h20 e 14h30	O pré-evento é acionado dando pelo menos 20 minutos para ser concluído antes que a instalação do patch comece a ser executada. Nesse exemplo, o pré-evento é iniciado entre 14h20 e 14h30.
14:50	O pré-evento tem pelo menos 20 minutos para ser concluído antes que a instalação do patch comece a ser executada. Observação - Se o pré-evento continuar em execução além de 20 minutos, a instalação do patch prosseguirá independentemente do status de execução do pré-evento. - Se você optar por cancelar a execução atual, poderá cancelar usando a API de cancelamento 10 minutos antes do agendamento. Nesse exemplo, às 14h50 você pode cancelar a partir do seu script ou do código de função do Azure. Se a API de cancelamento não for invocada ou não tiver sido configurada, a instalação do patch continuará em execução. Nesse exemplo, o pré-evento deve concluir as tarefas até às 14h50. Se você optar por cancelar a execução atual, o último horário em que poderá invocar a API de cancelamento será às 14h50.
15:00	Conforme definido na configuração de manutenção, o agendamento é acionado no horário especificado. Nesse exemplo, a programação é acionada às 15h.
18H55	O pós-evento é acionado após a conclusão da janela de manutenção definida. Se você tiver definido uma janela de manutenção menor de 2 horas, o evento de pós-manutenção será acionado após 2 horas e se o cronograma de manutenção for concluído antes do tempo estipulado de 2 horas ou seja, em 1h50, o pós-evento terá início. Nesse exemplo, se a janela de manutenção estiver definida para o máximo, às 18h55 o processo de instalação do patch será concluído e se você tiver uma janela de manutenção mais curta, o processo de instalação do patch será concluído às 17h.
19:15	Após a instalação do patch, o pós-evento é executado por 20 minutos. Nesse exemplo, o pós-evento é iniciado às 18h55 e concluído às 19h15 e se você tiver uma janela de manutenção mais curta, o pós-evento é acionado às 17h e concluído às 17h20.

Recomendamos que você esteja atento ao seguinte:

• Se você estiver criando uma nova programação ou editando uma programação existente com um pré-evento, você precisará de pelo menos 40 minutos antes do início da janela de manutenção (15h no exemplo acima) para que o pré-evento seja executado, caso contrário, isso levará ao desligamento automático-cancelamento da execução agendada atual.
• O pré-evento é acionado 30 minutos antes da execução agendada do patch, dando ao pré-evento pelo menos 20 minutos para ser concluído.
• O pós-evento é executado imediatamente após a conclusão da instalação do patch.
• Para cancelar a execução do patch atual, use a API de cancelamento pelo menos 10 minutos antes do horário agendado de manutenção.

Configurar eventos pré e pós na programação existente

Você pode configurar eventos anteriores e posteriores em uma programação existente e adicionar vários eventos anteriores e posteriores a uma única programação. Para adicionar um evento pré e pós, siga essas etapas:

1. Entre no portal do Azure e vá para Azure Update Manager.

2. Em Gerenciar, selecione Máquinas, Configurações de Manutenção.

3. Na página Configuração de manutenção, selecione a configuração de manutenção à qual deseja adicionar um pré e pós-evento.

4. Na página Configuração de manutenção selecionada, em Configurações, selecione Eventos. Alternativamente, em Visão geral, selecione o cartão Criar um evento de manutenção.

   

5. Selecione +Assinatura de evento para criar um evento de pré/pós-manutenção.

   

6. Na página Criar assinatura de evento, insira os seguintes detalhes:

   • Na seção Detalhes da assinatura do evento, forneça um nome apropriado.

   • Mantenha o esquema como Esquema da Grade de Eventos.

   • Na seção Detalhes do tópico, forneça um nome apropriado para o Nome do tópico do sistema.

   • Na seção Tipos de eventos, Filtrar para tipos de eventos, selecione os tipos de eventos que você deseja enviar para o ponto de extremidade ou destino. Você pode selecionar entre Evento de Pré-Manutenção e Evento de Pós-Manutenção.

   • Na seção Detalhes do ponto de extremidade, selecione o ponto de extremidade de onde você deseja receber a resposta. Isso ajudaria os clientes a acionar seu pré ou pós-evento.

     

7. Selecione Criar para configurar os eventos pré e pós em uma programação existente.

Observação

• O evento anterior e posterior só pode ser criado em um nível de configuração de manutenção programada.
• O tópico do sistema é criado automaticamente por configuração de manutenção e todas as assinaturas de eventos são vinculadas ao tópico do sistema no EventGrid.
• A execução pré e pós-evento fica fora da janela de manutenção do cronograma.

Exibir eventos pré e pós

Para visualizar os eventos pré e pós, siga essas etapas:

1. Entre no portal do Azure e vá para Azure Update Manager.
2. Em Gerenciar, selecione Máquinas, Configurações de Manutenção.
3. Na página Configuração de manutenção, selecione a configuração de manutenção à qual deseja adicionar um pré e pós-evento.
4. Selecione Visão geral e verifique os Eventos de manutenção.

   • Selecione Configurar para configurar um.

   • Se a configuração já estiver feita, você poderá ver a contagem dos eventos pré e pós associados à configuração na página Eventos.

     

Excluir antes e depois do evento

Para excluir eventos anteriores e posteriores, siga essas etapas:

1. Entre no portal do Azure e vá para Azure Update Manager.

2. Em Gerenciar, selecione Máquinas, Configurações de Manutenção.

3. Na página Configuração de manutenção, selecione a configuração de manutenção à qual deseja adicionar um pré e pós-evento.

4. Na página Configuração de manutenção selecionada, em Configurações, selecione Eventos. Alternativamente, em Visão geral, selecione o cartão Criar um evento de manutenção.

5. Selecione o evento Nome que deseja excluir da grade.

6. Na página do evento selecionado, selecione Excluir.

   

Observação

• Se todos os eventos anteriores e posteriores forem excluídos da configuração de manutenção, o System Topic será excluído automaticamente do EventGrid.
• Recomendamos evitar excluir manualmente o Tópico do Sistema do serviço EventGrid.

Cancelar uma programação de um pré-evento

Para cancelar o agendamento, você deve chamar a API de cancelamento no pré-evento para configurar o processo de cancelamento que está no script do Runbook ou no código de função do Azure. Aqui você deve definir os critérios a partir de quando o agendamento deve ser cancelado. O sistema não monitorará e não cancelará automaticamente o agendamento com base no status do pré-evento.

Existem dois tipos de cancelamentos:

• Cancelamento por usuário - quando você invoca a API de cancelamento do seu script ou código.
• Cancelamento pelo sistema - quando o sistema invoca a API de cancelamento devido a um erro interno. Isso será feito somente se o sistema não conseguir enviar o pré-evento ao ponto final do cliente 30 minutos antes do trabalho de aplicação de patch agendado.

Observação

Se o cancelamento for feito pelo sistema, o próximo trabalho de patch agendado será cancelado devido à falha na execução dos pré-eventos pelo sistema.

Importante

Se o trabalho de manutenção agendado for cancelado pelo usuário usando a API de cancelamento ou pelo sistema devido a alguma falha interna, o pós-evento, se assinado, será enviado ao ponto de extremidade configurado pelo usuário.

Exibir o status do cancelamento

Para visualizar o status de cancelamento, siga essas etapas:

1. Na página inicial do Azure Update Manager, vá para Histórico

2. Selecione pelo ID de execução de manutenção e escolha o ID de execução cujo status você deseja visualizar.

   

Você pode visualizar o status de cancelamento na mensagem de erro no JSON. O JSON pode ser obtido no Azure Resource Graph (ARG). A configuração de manutenção correspondente seria cancelada usando a API de cancelamento.

A consulta a seguir permite visualizar a lista de VMs para um determinado agendamento ou configuração de manutenção:

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 da assinatura na qual a configuração de manutenção com pré ou pós-evento é criada
• your-rg-id : Nome do grupo de recursos no qual a configuração de manutenção é criada
• mc-name : O nome da configuração de manutenção no pré-evento é criado

Se o trabalho de manutenção for cancelado pelo sistema por qualquer motivo, a mensagem de erro no JSON é obtida do Azure Resource Graph para a configuração de manutenção correspondente seria Cronograma de manutenção cancelado devido a falha interna da plataforma.

Invocar a API de cancelamento

 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 

Observação

Você deve substituir o ID de Correlação recebido da consulta ARG acima e substituí-lo na API de cancelamento.

Exemplo

  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

Próximas etapas

• Para problemas e soluções alternativas, veja solução de problemas
• Para uma visão geral dos cenários pré e pós
• Aprenda sobre os cenários comuns de pré e pós eventos