ansible控制windows的官方翻译
Ansible控制windows
1、 Windows下如何工作
在ansible控制linux的时候，用的是ssh的方式，在windows中，使用的是power shell，在客户端机器上也是不用装任何客户端的。
在控制windows机器的时候，使用的模块为“winrm“。
2、 在控制机上安装
在linux控制机器上安装模块winrm：
|
pip install "pywinrm>=0.1.1"
|
3、 动态目录的支持
如果想连接动态目录下的domain账户，那么必须安装python-kerberos模块在控制机上，并且需要安装MIT krb5库。还需要在动态目录中配置正确的账户。
3.1 安装python-kerberos的依赖
# Via Yum
yum -y install python-devel krb5-devel krb5-libs krb5-workstation
# Via Apt (Ubuntu)
sudo apt-get install python-dev libkrb5-dev
# Via Portage (Gentoo)
emerge -av app-crypt/mit-krb5
emerge -av dev-python/setuptools
# Via pkg (FreeBSD)
sudo pkg install security/krb5
# Via OpenCSW (Solaris)
pkgadd -d http://get.opencsw.org/now
/opt/csw/bin/pkgutil -U
/opt/csw/bin/pkgutil -y -i libkrb5_3
# Via Pacman (Arch Linux)
pacman -S krb5
|
3.2 安装python-kerberos
安装的时候执行如下指令即可：
pip install kerberos
|
3.3 配置kerberos
编辑配置文件/etc/krb5.conf，在其中添加如下的信息，在每个想连接的domain中。
找到如下开头的节：
[realms]
|
添加domain的全称，并且添加主要和次要的动态目录域的全名称，如下例子：
[realms]
MY.DOMAIN.COM = {
kdc = domain-controller1.my.domain.com kdc = domain-controller2.my.domain.com }
|
并且在【domain_realm】节中添加每个你想连接的域：
[domain_realm] .my.domain.com = MY.DOMAIN.COM
|
3.4 测试kerberos连接
如果安装了krb5-workstation（yum）或者krb5-user（apt_get），那么可以用如下的命令测试是否被域控制器授权：
kinit user@MY.DOMAIN.COM
|
注意域的部分必须是全称，并且必须全部为大写。
查看获得的tickets，可以使用命令如下：
klist
|
3.5 解决kerberos连接问题
如果使用kerberos不能进行连接，那么检查下列问题：
确保正向和反向DNS在域中能正常解析，在做这个解析的时候，首先ping服务器的名称，然后nslookup服务器的ip地址，会返回服务器的名称
如果在返回的服务器名称和ping的服务器名称不一致，检查动态目录中的DNSScavenging 是开启的，并且DNS和DHCP是相互更新的；
确保ansible控制机在domain中配置了账户属性。
检查ansible控制机的在域控制器中是时钟异步的，kerberos是对时间敏感的，一点时间的偏差会导致tickets失效
确保用的是域全名称，可以使用下面的命令进行检查：
kinit -C user@MY.DOMAIN.COM
klist
|
当获取到不同的域名称的时候，必须更新配置文件krb5.conf，在其中使用域的全名称。
4、 inventory
ansible对windows的支持依赖于几个常用的变量来表示用户名，密码，连接类型（windows），如下所示：
[windows] winserver1.example.com
winserver2.example.com
|
在group_vars/windows.yml中，定义以下inventory变量：
# it is suggested that these be encrypted with ansible-vault:
# ansible-vault edit group_vars/windows.yml
ansible_user: Administrator ansible_password: SecretPasswordGoesHere ansible_port: 5986 ansible_connection: winrm # The following is necessary for Python 2.7.9+ when using default WinRM self-signed certificates:
ansible_winrm_server_cert_validation: ignore
|
5、 关于powershell版本
Powershell为3.0版本或者更高，只有windows7 sp1，windows server 2008 sp1,和以后的版本支持。
6、 哪些模块是可用的
Windows支持的模块在以下网址中可以找到：
|
http://docs.ansible.com/ansible/list_of_windows_modules.html |
可以使用script模块来运行powershell脚本，也可以在playbook中使用，如下：
- hosts: windows tasks:
- script: foo.ps1 --argument --other-argument
|
注意有的模块并不以win开头，如下：
|
“slurp”, “raw”, and “setup” |
7、 获得windows的fact
ansible winhost.example.com -m setup
|
8、 Windows的playbook例子
下面例子表示推送和运行powershell脚本的例子：
- name: test script module hosts: windows
tasks:
- name: run test script
script: files/test_script.ps1
|
运行单个命令的时候，使用raw模块，在linux中是使用command或者shell模块：
- name: test raw module hosts: windows
tasks:
- name: run ipconfig
raw: ipconfig
register: ipconfig
- debug: var=ipconfig
|
运行DOS命令的时候，可以使用CMD /C开头，并且用双引号进行包括，如下：
- name: another raw module example hosts: windows
tasks:
- name: Move file on remote Windows Server from one location to another
raw: CMD /C "MOVE /Y C:\teststuff\myfile.conf C:\builds\smtp.conf"
|
最后一个例子用win_stat模块测试文件是否存在，注意返回的日期和linux中稍有不同：
- name: test stat module hosts: windows
tasks:
- name: test stat module on file
win_stat: path="C:/Windows/win.ini"
register: stat_file
- debug: var=stat_file
- name: check stat_file result
assert:
that:
- "stat_file.stat.exists" - "notstat_file.stat.isdir" - "stat_file.stat.size>0" - "stat_file.stat.md5"
|
