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:
-
Notas del proyecto Github de pywinrm., más fácil de rastrear errores que con Ansible.
-
Cómo habilitar WinRM vía Group Policy por Alan Burchill
Si queréis usar el código de mis pruebas podéis conectaros a mi Github: Playbooks básicos de Ansible para Windows.