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.
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.LOCVé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
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
"msg": "kerberos: Bad HTTP response returned from server. Code 500", "unreachable": true
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"
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:
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.
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
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.






