Ansible i Playbooks de Windows
Traducció de l’original en anglès. Llegeix-lo en: CastellanoEnglish
Primer de tot deixeu-me presentar un servei de Windows anomenat: "Windows Remote Manager" o "WinRM". Aquesta és la característica de Windows que permet el control remot de màquines Windows i moltes altres funcionalitats remotes. En el meu cas tinc un portàtil Windows 7 amb SP1 i PowerShell v3 instal·lat.
En segon lloc, no oblidis que Ansible està desenvolupat amb Python, així que una llibreria de Python ha de gestionar el protocol WinRM. Estic parlant de "pywinrm". Amb aquesta llibreria és fàcil crear scripts senzills com aquest:
#!/usr/bin/env python
import winrm
s = winrm.Session('10.2.0.42', auth=('the_username', 'the_password'))
r = s.run_cmd('ipconfig', ['/all'])
print r.status_code
print r.std_out
print r.std_err
Aquesta és una crida remota a l'ordre "ipconfig /all" per veure la configuració de xarxa de la màquina Windows. La sortida és una cosa semblant a:
$ ./winrm_ipconfig.py
0
Windows IP Configuration
Host Name . . . . . . . . . . . . : mini7w
Primary Dns Suffix . . . . . . . :
Node Type . . . . . . . . . . . . : Hybrid
IP Routing Enabled. . . . . . . . : No
WINS Proxy Enabled. . . . . . . . : No
DNS Suffix Search List. . . . . . : ymbi.net
Ethernet adapter GigaBit + HUB USB:
Connection-specific DNS Suffix . : ymbi.net
Description . . . . . . . . . . . : ASIX AX88179 USB 3.0 to Gigabit Ethernet Adapter
Physical Address. . . . . . . . . : 00-23-56-1C-XX-XX
DHCP Enabled. . . . . . . . . . . : Yes
Autoconfiguration Enabled . . . . : Yes
Link-local IPv6 Address . . . . . : fe80::47e:c2c:8c25:xxxx%103(Preferred)
IPv4 Address. . . . . . . . . . . : 10.2.0.42(Preferred)
Subnet Mask . . . . . . . . . . . : 255.255.255.192
Lease Obtained. . . . . . . . . . : mi�rcoles, 28 de enero de 2015 12:41:41
Lease Expires . . . . . . . . . . : mi�rcoles, 28 de enero de 2015 19:17:56
Default Gateway . . . . . . . . . : 10.2.0.1
DHCP Server . . . . . . . . . . . : 10.2.0.1
DHCPv6 IAID . . . . . . . . . . . : 2063606614
DHCPv6 Client DUID. . . . . . . . : 00-01-00-01-15-F7-BF-36-xx-C5-xx-03-xx-xx
DNS Servers . . . . . . . . . . . : 10.2.0.27
10.2.0.1
NetBIOS over Tcpip. . . . . . . . : Enabled
...
És clar, també és possible executar scripts de Powershell com el següent, que mostra la memòria del sistema:
$strComputer = $Host
Clear
$RAM = WmiObject Win32_ComputerSystem
$MB = 1048576
"Installed Memory: " + [int]($RAM.TotalPhysicalMemory /$MB) + " MB"
El codi de Python per executar aquest script és:
#!/usr/bin/env python
import winrm
ps_script = open('scripts/mem.ps1','r').read()
s = winrm.Session('10.2.0.42', auth=('the_username', 'the_password'))
r = s.run_ps(ps_script)
print r.status_code
print r.std_out
print r.std_err
i la sortida:
$ ./winrm_mem.py
0
Installed Memory: 2217 MB
Finalment és hora de parlar de com crear un Playbook d'Ansible per desplegar qualsevol cosa en una màquina Windows. Com sempre, el primer que necessitem és un fitxer hosts. En el següent exemple hi ha diverses variables d'ansible necessàries per executar mòduls de Windows d'Ansible sobre WinRM, totes elles són autoexplicatives:
[all]
10.2.0.42
[all:vars]
ansible_ssh_user=the_username ansible_ssh_pass=the_password ansible_ssh_port=5985 #winrm (non-ssl) port ansible_connection=winrm
El primer exemple bàsic podria ser un playbook senzill que executa l'ordre 'ipconfig' i registra la sortida en una variable d'Ansible per mostrar-la després com a informació de debug:
- name: test raw module
hosts: all
tasks:
- name: run ipconfig
raw: ipconfig
register: ipconfig
- debug: var=ipconfig
L'ordre i la sortida per executar l'últim exemple:
$ ansible-playbook -i hosts ipconfig.yml
PLAY [test raw module] ********************************************************
GATHERING FACTS ***************************************************************
ok: [10.2.0.42]
TASK: [run ipconfig] **********************************************************
ok: [10.2.0.42]
TASK: [debug var=ipconfig] ****************************************************
ok: [10.2.0.42] => {
"ipconfig": {
"invocation": {
"module_args": "ipconfig",
"module_name": "raw"
},
"rc": 0,
"stderr": "",
"stdout": "\r\nWindows IP Configuration\r\n\r\n\r\nEthernet adapter GigaBit
...
]
}
}
PLAY RECAP ********************************************************************
10.2.0.42 : ok=3 changed=0 unreachable=0 failed=0
Com sempre, Ansible té diversos mòduls, no només el mòdul 'raw'. He pujat dos exemples al meu compte de Github que fan servir un mòdul per baixar URL i un altre que executa scripts de Powershell.
Els meus exemples estan fets amb Ansible 1.8.2 instal·lat en un Fedora 20. Però els principals problemes que he trobat són configurar Windows 7 per acceptar connexions WinRM. A continuació adjunto algunes referències que em van ajudar molt:
-
Notes del projecte Github de pywinrm., més fàcil de traçar errors que amb Ansible.
-
Com habilitar WinRM via Group Policy per Alan Burchill
Si voleu fer servir el codi de les meves proves podeu connectar-vos al meu Github: Playbooks bàsics d'Ansible per a Windows.