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"
上一篇:javascript深入理解js闭包(转载)


下一篇:【XP系统下载U盘装系统】用电脑店超级U盘装XP系统详细图文教程