Sobre pré e pós-eventos
Aplica-se a: ✔️ VMs do Windows ✔️ VMs do Linux ✔️ Ambiente local ✔️ Servidores habilitados para Azure Arc.
Os pré e pós-eventos no Azure Update Manager permitem que você execute determinadas tarefas automaticamente antes e depois de uma configuração de manutenção agendada. Para obter mais informações sobre como criar configurações de manutenção agendada, consulte Agendar atualizações recorrentes para computadores usando o portal do Azure e o Azure Policy. Por exemplo, usando pré e pós-eventos, você pode executar as seguintes tarefas em computadores que fazem parte de um agendamento. A lista a seguir não é exaustiva e você pode criar pré e pós-eventos de acordo com suas necessidades.
Tarefas de exemplo
Veja a seguir os cenários em que você pode definir pré e pós-eventos:
| Cenário | Descrição |
|---|---|
| Ligar computadores | Ligue o computador para aplicar as atualizações. |
| Create snapshot | Snaps de disco usados para recuperar dados. |
| Email de notificação | Envie um alerta de notificação antes de disparar um patch. |
| Interromper serviços | Interromper serviços como serviços de Gateway, NPExServices, serviços SQL, etc. |
Agendar a ordem de execução com pré e pós-eventos
Para uma determinada agenda, você pode incluir um pré-evento, pós-evento ou ambos. Além disso, você pode ter vários pré e/ou pós-eventos. A sequência de execução de um agendamento com pré e pós-eventos é a seguinte:
Pré-evento – Tarefas executadas antes do início da janela de manutenção agendada. Por exemplo: ligue os computadores antes da aplicação de patch.
Cancelamento – Nesta etapa, você pode iniciar o cancelamento da execução do agendamento. Alguns cenários em que você pode optar por cancelar uma execução de agendamento incluem falhas no pré-evento ou pré-evento que não concluiu a execução.
Observação
Você deve iniciar o cancelamento como parte do pré-evento. O Gerenciador de Atualizações do Azure ou a configuração de manutenção não cancelarão automaticamente o agendamento. Se você não cancelar, a execução do agendamento continuará com a instalação de atualizações durante a janela de manutenção definida pelo usuário.
Instalação de atualizações – As atualizações são instaladas como parte da janela de manutenção de agendamento definida pelo usuário.
Pós-evento – O pós-evento é executado imediatamente após a instalação das atualizações. Ele ocorrerá dentro da janela de manutenção se a instalação da atualização for concluída e houver uma janela esquerda ou fora da janela se a janela de manutenção tiver terminado. Por exemplo: desligue as VMs após a conclusão da aplicação de patch.
Observação
No Gerenciador de Atualizações do Azure, os pré-eventos executados fora da janela de manutenção e pós-eventos podem ser executados fora da janela de manutenção. Você deve planejar esse tempo adicional necessário para concluir a execução do agendamento em seus computadores.
Status de agendamento - O status de êxito ou falha de uma execução de agendamento refere-se apenas à instalação de atualização nos computadores que fazem parte do agendamento. O status de execução de agendamento não inclui o status pré e pós-evento. Se o pré-evento falhou e você chamou a API de cancelamento, o status de execução do agendamento será exibido como cancelado.
O Gerenciador de Atualizações do Azure usa a Grade de Eventos para criar e gerenciar pré e pós-eventos em configurações de manutenção agendadas. Na Grade de Eventos, você pode escolher entre manipuladores de eventos, como Webhooks do Azure, Azure Functions etc., para disparar sua pré e pós-atividade.
Observação
Se você estiver usando Runbooks em pré e pós-eventos no gerenciamento de Atualizações de Automação do Azure e planeja reutilizá-los no Gerenciador de Atualizações do Azure, recomendamos que você use webhooks do Azure vinculados aos Runbooks de Automação. Saiba mais.
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 agenda tem um pré-evento e um pós-evento e a seguir estão os detalhes:
| Hora | Detalhes |
|---|---|
| 14H19 | Como a execução do agendamento começa às 15h, você pode modificar os computadores ou escopos 40 minutos antes da hora de início (ou seja, às 14h19). Observação Isso se aplica se você estiver criando uma nova agenda ou editando uma agenda existente com um pré-evento. |
| 14h20 - 14h30 | Como o pré-evento é disparado pelo menos 30 minutos antes, ele pode ser disparado a qualquer momento entre 14h20 e 14h30. |
| 14h30 - 14h50 | O pré-evento é executado das 14h30 às 14h50. O pré-evento deve concluir as tarefas até 14h50. Observação Se você tiver mais de um pré-evento configurado, todos os eventos deverão ser executados em até 20 minutos. No caso de vários pré-eventos, todos eles serão executados de maneira independente. Você pode personalizar de acordo com suas necessidades definindo a lógica nos pré-eventos. Por exemplo, se você quiser que dois pré-eventos sejam executados em sequência, você poderá incluir uma hora de início atrasada na lógica do segundo pré-evento. Se o pré-evento continuar sendo executado além de 20 minutos ou falhar, você poderá optar por cancelar a execução do agendamento. Caso contrário, a instalação do patch continuará independentemente do status da execução do pré-evento. |
| 14:50 | A hora mais recente que pode invocar a API de cancelamento é 14h50. Observação Se a API de cancelamento não for invocada ou não tiver sido configurada, a instalação do patch continuará em execução. |
| 15:00 | A execução do agendamento é disparada às 15h. |
| 18H55 | Às 18h55, o agendamento conclui a instalação das atualizações durante a janela de manutenção de 3 horas e 55 minutos. O pós-evento é disparado às 18h55, quando as atualizações são instaladas. Observação Se você tiver definido uma janela de manutenção mais curta de 2 horas, o evento pós-manutenção será acionado após 2 horas e, se a instalação da atualização for concluída antes do horário estipulado de 2 horas (ou seja) 1 hora e 50 minutos, o pós-evento será iniciado imediatamente. |
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.
- A invocação de uma API de cancelamento de seu script ou código cancela a execução do agendamento e não todo o agendamento.
- O status da execução pré e pós-evento pode ser verificado no manipulador de eventos escolhido.
Próximas etapas
- Para saber como criar os pré e pós-eventos, confira eventos de configuração de pré e pós-manutenção.
- Para saber mais sobre como configurar pré e pós-eventos ou cancelar uma execução de agendamento, consulte Eventos de configuração pré e pós-manutenção.
- Para saber como usar pré e pós-eventos para ativar e desativar suas VMs usando Webhooks, consulte aqui.
- Para saber como usar pré e pós-eventos para ativar e desativar suas VMs usando o Azure Functions, consulte aqui.