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:

Si voleu fer servir el codi de les meves proves podeu connectar-vos al meu Github: Playbooks bàsics d'Ansible per a Windows.