Comment utiliser Ansible pour gérer les machines Windows

Ansible est le système de gestion de configuration open source gratuit et populaire utilisé principalement pour gérer les hôtes Linux. Cet article décrit comment utiliser Ansible pour gérer à distance la configuration des serveurs Windows et des hôtes de postes de travail.

Configuration des hôtes Windows pour Ansible

Ansible vous permet de gérer à distance les hôtes Windows avec toutes les versions de système d’exploitation prises en charge, à partir de Windows 7/Windows Server 2008 jusqu’à la dernière version de Windows 11/Windows Server 2022. Sous Windows, vous devez disposer de PowerShell 3.0 (ou plus récent) et de .NET 4.0. + installé.

Ansible utilise WinRM pour se connecter au système d’exploitation Windows. Par conséquent, vous devez activer et configurer l’écouteur WinRM sur tous les hôtes Windows gérés.

Ansible 2.8 et versions ultérieures disposent d’une option expérimentale pour gérer à distance les clients Windows 10/11 et Windows Server 2019/2022 via le serveur OpenSSH intégré.

Si WinRM est activé et configuré sur les hôtes Windows, vérifiez que le port TCP/5985 ou TCP/5986 (si vous utilisez HTTPS) est accessible depuis le serveur de gestion Ansible :

$ nc -zv 192.168.13.122 5985

Ensuite, vous devez choisir la méthode d’authentification. Cela dépendra de l’environnement dans lequel vous utilisez Ansible.

Installez les packages requis pour l’authentification Kerberos :

  • Pour RHEL/Rocky Linux/CentOS via le gestionnaire de packages yum/dnf :
    $ sudo yum -y install python-devel krb5-devel krb5-libs krb5-workstation
  • Pour Ubuntu/Debian :
    $ sudo apt-get -y install python-dev libkrb5-dev krb5-user

Installez ensuite le package Python via pip :

$ sudo pip3 install requests-kerberos

Spécifiez les paramètres de connexion de votre domaine dans le fichier de configuration Kerberos :

$ sudo mcedit /etc/krb5.conf

[logging] default = FILE:/var/log/krb5libs.log kdc = FILE:/var/log/krb5kdc.log admin_server = FILE:/var/log/kadmind.log
[libdefaults] dns_lookup_realm = false ticket_lifetime = 24h renew_lifetime = 7d forwardable = true rdns = false
default_realm = WOSHUB.LOC
[realms] WOSHUB.LOC = { admin_server = dc01.woshub.loc kdc = dc01.woshub.loc }
[domain_realm] woshub.loc = WOSHUB.LOC .WOSHUB.LOC = WOSHUB.LOC

Vérifiez que vous pouvez vous authentifier auprès de votre domaine AD et obtenir un ticket Kerberos :

kinit -C [email protected]
Entrez votre mot de passe utilisateur AD et voyez si le ticket est reçu.

klist

kerberos ad auth avec kinit sous Linux

Gestion des hôtes Windows avec Ansible

Ensuite, ajoutez tous vos hôtes Windows au fichier d’inventaire Ansible :

$ sudo mcedit /etc/ansible/hosts

mun-rds1.woshub.loc
mun-dc02.woshub.loc
wks-test1.woshub.loc
[windows_all:vars]
ansible_port=5985
[email protected]
ansible_connection=winrm
ansible_winrm_transport=kerberos
ansible_winrm_scheme=http
ansible_winrm_server_cert_validation=ignore

Vérifiez que tous vos hôtes Windows (ma liste comprend deux machines Windows Server 2019 et une machine Windows 11) sont accessibles depuis Ansible :

$ ansible windows_all -m win_ping

Module Ansible win_ping

Les hôtes peuvent renvoyer une erreur :
"msg": "kerberos: Bad HTTP response returned from server. Code 500",
"unreachable": true

Ansible : Kerberos Mauvaise réponse HTTP 500

En effet, WinRM utilise dans cet exemple HTTP au lieu de HTTPS pour se connecter. Pour ignorer l’erreur, vous devez autoriser le trafic non chiffré sur les hôtes Windows

Set-Item -Path WSMan:localhostServiceAllowUnencrypted -Value true

Vous pouvez désormais utiliser Ansible pour exécuter une commande arbitraire sur tous vos hôtes Windows. Par exemple, je souhaite réinitialiser le cache DNS sur toutes mes machines Windows :

$ ansible windows_all -m win_shell -a "ipconfig /flushdns"

Ansible win_shell : exécutez des commandes shell sur les hôtes Windows cibles

Exemples de playbooks Ansible pour l’administration Windows

Vos hôtes Windows sont maintenant prêts à exécuter les playbooks Ansible.

Par exemple, vous devez exécuter un script PowerShell sur tous les hôtes utilisant Ansible (dans cet exemple, nous utiliserons PowerShell pour obtenir les paramètres IP ou DNS actuels sur les hôtes). Créez un fichier playbook :

$ sudo mcedit /etc/ansible/playbooks/win-exec-powershell.yml

---
- name: win_powershell_exec hosts: windows_all tasks: - name: check DNS win_shell: | Get-DnsClientServerAddress -InterfaceIndex (Get-NetAdapter|where Status -eq "Up").ifindex -ErrorAction SilentlyContinue register: command_output - name: command output ansible.builtin.debug:

Manuel de jeu Ansible pour Windows

Exécutez le playbook :

$ ansible-playbook /etc/ansible/playbooks/win-exec-powershell.yml

Dans cet exemple, le playbook a été exécuté avec succès sur tous les hôtes Windows et les paramètres DNS actuels ont été renvoyés.

exécuter un playbook ansible sur des hôtes Windows

Jetons un coup d’œil à quelques playbooks Ansible typiques pour les tâches standard de gestion d’hôte Windows.

Copier un fichier:

 - name: Copy a single file win_copy: src: /home/sysops/files/test.ps1" dest: C:Temptest.ps1

Créez un fichier :

- name: Create file win_file: path: C:Tempfile.txt state: touch

Supprimer un fichier :

- name: Delete file win_file: path: C:Tempfile.txt state: absent

Créer un paramètre de registre:

- name: Create reg dword win_regedit: path: HKLM:SOFTWAREMicrosoftWindowsCurrentVersionPoliciesDataCollection name: AllowTelemetry data: 0 type: dword

Installer un programme depuis MSI:

- name: Install MSI package win_package: path: C:Distradobereader.msi arguments: - /install - /passive - /norestart

Exécuter un service Windows:

- name: Run Windows Service win_service: name: wuauserv state: started

ansible : exécuter le service sous Windows

Installez un rôle Windows Server :

 - name: Install Windows Feature win_feature: name: SNMP-Service state: present

Ouvrez un port dans le pare-feu Windows Defender :

- name: Open SSH Port win_firewall_rule: name: port 22 localport: 22 action: allow direction: in protocol: tcp state: present enabled: yes

Exécutez un script PowerShell :

- name: Run PowerShell Script win_command: powershell.exe -ExecutionPolicy ByPass -File C:/temp/powershellscript.ps1

Tout au long de cet article, vous avez appris à gérer la configuration de vos hôtes Windows via Ansible. Si vos hôtes Windows ne sont pas joints à un domaine Active Directory (ils font partie d’un groupe de travail), la gestion de la configuration à distance des hôtes Windows à l’aide d’Ansible peut être une bonne alternative à la configuration à l’aide des stratégies de groupe de domaine.

Vous pouvez également installer Ansible dans le sous-système Windows pour Linux (WSL). Cela vous permettrait d’exécuter des playbooks sans avoir besoin de déployer un hôte Linux distinct pour Ansible.