Ansible y Playbooks de Windows

Traducción del original en inglés. Léela en: CatalàEnglish

Primero de todo dejadme presentar un servicio de Windows llamado: "Windows Remote Manager" o "WinRM". Esta es la característica de Windows que permite el control remoto de máquinas Windows y muchas otras funcionalidades remotas. En mi caso tengo un portátil Windows 7 con SP1 y PowerShell v3 instalado.

En segundo lugar, no olvides que Ansible está desarrollado con Python, así que una librería de Python tiene que gestionar el protocolo WinRM. Estoy hablando de "pywinrm". Con esta librería es fácil crear scripts sencillos como ese:

#!/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

Esta es una llamada remota al comando "ipconfig /all" para ver la configuración de red de la máquina Windows. La salida es algo parecido 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
...

Por supuesto, también es posible ejecutar scripts de Powershell como el siguiente, que muestra la memoria del sistema:

$strComputer = $Host
Clear
$RAM = WmiObject Win32_ComputerSystem
$MB = 1048576

"Installed Memory: " + [int]($RAM.TotalPhysicalMemory /$MB) + " MB"

El código de Python para ejecutar ese script es:

#!/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

y la salida:

$ ./winrm_mem.py 
0
Installed Memory: 2217 MB

Finalmente es hora de hablar de cómo crear un Playbook de Ansible para desplegar cualquier cosa en una máquina Windows. Como siempre, lo primero que necesitamos es un archivo hosts. En el siguiente ejemplo hay varias variables de ansible necesarias para ejecutar módulos de Windows de Ansible sobre WinRM, todas ellas son autoexplicativas:

[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 ejemplo básico podría ser un playbook sencillo que ejecuta el comando 'ipconfig' y registra la salida en una variable de Ansible para mostrarla después como información de debug:

- name: test raw module
  hosts: all
  tasks:
    - name: run ipconfig
      raw: ipconfig
      register: ipconfig
    - debug: var=ipconfig

El comando y la salida para ejecutar el último ejemplo:

$ 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 

Como siempre, Ansible tiene varios módulos, no solo el módulo 'raw'. He subido dos ejemplos a mi cuenta de Github usando un módulo para descargar URLs y otro que ejecuta scripts de Powershell.

Mis ejemplos están hechos con Ansible 1.8.2 instalado en un Fedora 20. Pero los principales problemas que me he encontrado son configurar Windows 7 para aceptar conexiones WinRM. A continuación adjunto algunas referencias que me ayudaron mucho:

Si queréis usar el código de mis pruebas podéis conectaros a mi Github: Playbooks básicos de Ansible para Windows.