3 playbooks para reiniciar o Windows com o Ansible

Sumário

Olá a todos!

Já há alguns anos que utilizo o Ansible em produção para executar todas as tarefas agendadas nos vários servidores Windows.

Uma das ações mais comuns a realizar é o reinício dos servidores.

No meu caso, tenho 3 situações:

  • Reiniciar o servidor sem condições
  • Reinicie se for necessário reiniciar o sistema para aplicar atualizações, por exemplo
  • Forçar o reinício se o tempo de atividade for superior a X dias

Neste artigo, vou partilhar estes três manuais.

Guia 1: reiniciar o Windows

Vamos começar pelo playbook mais «simples», que consiste em reiniciar o Windows; este playbook baseia-se no win_reboot.

---
- name: Windows Reboot
  hosts: windows
  tasks:
    - name: Reboot
      ansible.windows.win_reboot:
        msg: Reboot by Ansible
        reboot_timeout: 600

Ao reiniciar, é exibida uma mensagem que ficará disponível no observador de eventos. A tarefa permanece em espera durante 600 segundos (10 minutos) até que o servidor volte a estar online, o que permite confirmar o bom desenrolar do playbook.

A aplicação de certas atualizações pode demorar mais de 10 minutos; nesse caso, a execução do playbook irá falhar.

Playbook 2: reiniciar o Windows, se necessário

O segundo playbook só irá reiniciar o Windows se for necessário; para verificar isso, verifica-se se existe uma chave no registo do Windows.

Se essa chave existir, reiniciamos o servidor.

---
- name: Windows Reboot if needed
  hosts: all
  tasks:
    - name: Check if reboot is required
      ansible.windows.win_reg_stat:
        path: HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired
        name: RebootRequiredSince
      register: reboot_required

    #- name: Debug Message
    #  ansible.builtin.debug:
    #    msg: Reboot is required for host
    #  when: reboot_required.exists == true

    - name: Reboot
      ansible.windows.win_reboot:
        msg: Reboot by Ansible
        reboot_timeout: 600
      when: reboot_required.exists == true

Playbook 3: reiniciar o Windows se o tempo de funcionamento for superior a X dias

O último playbook deu-me mais trabalho, pois não existe uma solução direta com o Ansible para obter o tempo de atividade do servidor.

Aqui está o manual; depois explico-vos:

---
- name: Windows Reboot if needed
  hosts: all
  tasks:
    - name: Check if reboot is required
      ansible.windows.win_reg_stat:
        path: HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired
        name: RebootRequiredSince
      register: reboot_required

    #- name: Debug Message
    #  ansible.builtin.debug:
    #    msg: Reboot is required for host
    #  when: reboot_required.exists == true

    - name: Reboot
      ansible.windows.win_reboot:
        msg: Reboot by Ansible
        reboot_timeout: 600
      when: reboot_required.exists == true

O mais «difícil» foi obter o tempo de atividade do servidor Windows; para isso, utilizei o PowerShell e executei-o com [win_shell]https://docs.ansible.com/ansible/latest/collections/ansible/windows/win_shell_module.html.

Para obter o tempo de atividade, recolo a saída da consola, de modo a poder utilizar o resultado com o Ansible; a variável que contém o tempo de atividade é convertida para o formato JSON.

Em seguida, no Ansible, processei a saída no formato JSON para a colocar numa variável que posso utilizar no Playbook.

A partir daí, posso analisar o tempo de atividade do servidor Windows para decidir se o reinicio ou não.


Pode encontrar todos os meus playbooks do Ansible aqui: Ficheiros · principal · Ansible / Playbook Windows

Romain Drouche

Romain Drouche

Especialista em infraestruturas de TI com mais de 15 anos de experiência na área. Atualmente, como Gestor de Projetos de Sistemas e Redes e especialista em Segurança de Sistemas de Informação (SSI), utilizo a minha expertise para garantir a fiabilidade e a segurança dos ambientes tecnológicos.

GHinM▶