Ansible的安装、配置及常用模块介绍

本文承接本人的上一篇博文：Ansible介绍
有需要的可以前去查看！！

ansible安装方式

ansible安装常用两种方式，yum安装和pip程序安装

这里提供二种安装方式,任选一种即可：

1、使用yum安装

yum install epel-release -y
yum install ansible –y

2、 使用pip（python的包管理模块）安装

pip install ansible

#如果没pip,需先安装pip.yum可直接安装：
yum install python-pip
pip install ansible

ansible程序结构

安装目录

通过使用rpm -ql ansible指令可以查看ansible安装的所有文件位置！

配置文件目录：/etc/ansible/
执行文件目录：/usr/bin/
Lib库依赖目录：/usr/lib/pythonX.X/site-packages/ansible/
Help文档目录：/usr/share/doc/ansible-X.X.X/
Man文档目录：/usr/share/man/man1/

ansible配置文件的查找顺序

(1)、检查环境变量ANSIBLE_CONFIG指向的路径文件（export ANSIBLE_CONFIG=/etc/ansible.cfg ）
(2)、~/.ansible.cfg，检查当前目录（/etc/ansible）下的ansible.cfg配置文件
(3)、/etc/ansible.cfg 检查etc目录的配置文件

ansible配置文件

设置/etc/ansible/ansible.cfg配置参数，ansible有许多参数，下面列出常用的参数：

inventory：#这个参数表示资源清单inventory文件的位置，资源清单就是一些ansible需要连接管理的主 机列表。这个参数的配置实例如下：

inventory = /etc/ansible/hosts

library： ansible的操作动作，无论是本地或远程，都使用一小段代码来执行，这小段代码称为模块，这个library参数就是指向存放ansible模块的目录。配置实例如下：

library = /usr/share/ansible

ansible支持多个目录方式，只要用冒号“ : ”隔开就可以，同时也会检查当前执行playbook位置下的./library目录。

forks： 设置默认情况下ansible最多能有多少个进程同时工作， 从ansible 1.3开始,fork数量默认自动设置为主机数量或者潜在的主机数量,默认设置最多5个进程并行处理。具体需要设置多少个，可以根据控制主机的性能和被管节点的数量来确定，可能是 50或100。默认值5是非常保守的值，配置实例如下：

forks = 5

sudo_user： 这是设置默认执行命令的用户，也可以在playbook中重新设置这个参数。配置实例如下：

sudo_user = root

remote_port： 这是指定连接被管节点的管理端口，默认是22。除非设置了特殊的SSH端口，不然这个参数一般是不需要修改的。
配置实例如下：

remote_port = 22

host_key_checking： 这是设置是否检查SSH主机的密钥。可以设置为True或False，关闭后第一次连接没有提示配置实例

host_key_checking = False

timeout： 这是设置SSH连接的超时间隔，单位是秒。配置实例如下：

timeout = 60

log_path： ansible系统默认是不记录日志的，如果想把ansible系统的输出记录到日志文件中，需要设置log_path来指定一个存储ansible日志的文件。配置实例如下：

log_path = /var/log/ansible.log

另外需要注意，执行ansible的用户需要有写入日志的权限，模块将会调用被管节点的syslog来记录。

ansible主机清单

ansible主机清单设置
编辑/etc/ansible/hosts:

[root@CentOS7-master ~]# vim /etc/ansible/hosts  #定义方式：

### 1、直接指明主机地址或主机名：
green.example.com
blue.example.com
172.17.250.230
172.17.254.180
172.17.254.165

### 2、定义一个主机组[组名]把地址或主机名加进去
[webservers]
172.17.254.180
172.17.254.165
#组成员可以使用通配符来匹配，如下 172.17.254.[1:6] #表示匹配从172.17.254.1——172.17.254.6的主机

ansible配置公私钥

配置ansible使用公钥验证

配置这个的原因是为了方便ansible可以实现无秘访问控制其他机器，是实现自动化的前提。这一步可以再配置好ansible.cfg文件以及hosts主机清单后执行。

虽然ansible支持其他主机认证方式，但是我们最常用的的还是基于秘钥的认证：
1、首先生成秘钥

##执行下条指令后一路回车即可！
[root@CentOS7-master ~]# ssh-keygen -t rsa

2、然后向主机分发秘钥：

##所有添加到主机清单中的IP地址或者主机名，全部都要用下条指令执行一遍。
[root@CentOS7-master ~]# ssh-copy-id root@主机名或IP地址

3、如果出现以下情况：

ssh-copy-id -i ~/.ssh/id_rsa.pub root@10.1.6.72
-bash: ssh-copy-id: command not found

#请尝试：
yum -y install openssh-clientsansible

ansible常用命令

ansible命令集

/usr/bin/ansible	# Ansibe AD-Hoc 临时命令执行工具，常用于临时命令的执行

/usr/bin/ansible-doc	# ansible 模块功能查看工具

/usr/bin/ansible-galaxy		# 下载/上传优秀代码或Roles模块 的官网平台，基于网络的

/usr/bin/ansible-playbook 	# ansible 定制自动化的任务集编排工具

/usr/bin/ansible-pull # ansible远程执行命令的工具，拉取配置而非推送配置（使用较少，海量机器时使用，对运维的架构能力要求较高）

/usr/bin/ansible-vault # ansible 文件加密工具

/usr/bin/ansible-console # ansible基于Linux Consoble界面可与用户交互的命令执行工具

ansible命令详解

###命令格式：
ansible <host-pattern> [-f forks] [-m module_name] [-a args]

###我们可以通过 ansible -h查看帮助
###本段中所有以“**”开头的参数，均表示是重要的
[root@CentOS7-master ~]# ansible -h
Usage: ansible <host-pattern> [options] Options:

** -a MODULE_ARGS, --args=MODULE_ARGS
模块的参数,如果执行默认COMMAND的模块，即是命令参数,如：“date”,“pwd”等等 module arguments 模块参数

-k, --ask-pass 
	ask for SSH password 登录密码，提示输入SSH密码而不是假设基于密钥的验证

--ask-su-pass 
	ask for su password su切换密码

-K, --ask-sudo-pass 
	ask for sudo password 提示密码使用sudo,sudo表示提权操作

--ask-vault-pass 
	ask for vault password

-B SECONDS, --background=SECONDS 
	run asynchronously, failing after X seconds (default=N/A)后台运行超时时间

** -C, --check
	don‘t make any changes; instead, try to predict some of the changes that may occur #只是测试一下会改变什么内容，不会真正去执行;相反,试图预测一些可能发生的变化

-c CONNECTION, --connection=CONNECTION 
	connection type to use (default=smart) #连接类型使用

** -f FORKS, --forks=FORKS
	specify number of parallel processes to use (default=5) #并行任务数。NUM被指定为一个整数,默认是5 

-h, --help 
	show this help message and exit 打开帮助文档API

** -i INVENTORY, --inventory-file=INVENTORY
	specify inventory host file (default=/etc/ansible/hosts) #指定库存主机文件的路径,默认为/etc/ansible/hosts

** --list-hosts
	outputs a list of matching hosts; does not execute anything else

** -m MODULE_NAME, --module-name=MODULE_NAME
	module name to execute (default=command) #执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数

-M MODULE_PATH, --module-path=MODULE_PATH 	
	specify path(s) to module library (default=/usr/share/ansible/) #要执行的模块的路径，默认为/usr/share/ansible/

-o, --one-line 
	condense output #压缩输出，摘要输出.尝试一切都在一行上输出。

-P POLL_INTERVAL, --poll=POLL_INTERVAL 	
	set the poll interval if using -B (default=15) #调查背景工作每隔数秒。需要- b

--private-key=PRIVATE_KEY_FILE 
	use this file to authenticate the connection #私钥路径，使用这个文件来验证连接

** -S, --su
	run operations with su #用 su 命令

** -R SU_USER, --su-user=SU_USER
	run operations with su as this user (default=root) #指定SU的用户，默认是root用户

** -s, --sudo
	run operations with sudo (nopasswd)

** -U SUDO_USER, --sudo-user=SUDO_USER
	desired sudo user (default=root)(deprecated, use become) #sudo到哪个用户，默认为 root

** -T TIMEOUT, --timeout=TIMEOUT
	override the SSH timeout in seconds (default=10) #指定SSH默认超时时间， 默认是10S

-t TREE, --tree=TREE 
	log output to this directory #将日志内容保存在该输出目录,结果保存在一个文件中在每台主机上。

** -u REMOTE_USER, --user=REMOTE_USER
	connect as this user (default=root) #远程用户， 默认是root用户 

--vault-password-file=VAULT_PASSWORD_FILE 
	vault password file

** -v, --verbose
	verbose mode (-vvv for more, -vvvv to enable 详细信息connection debugging)

--version 
	show program's version number and exit  #输出ansible的版本

ansible-doc命令

ansible-doc指令是用来查看ansible所支持的模块的文件信息的，并且支持shell！

查看 ansible-doc 的使用说明：

###一般用法：（也是常用的用法）
ansible-doc -l 获取模块信息
ansible-doc -s MOD_NAME 获取指定模块的使用帮助

###ansible-doc
[root@CentOS7-master ~]# ansible-doc -h 
Usage: ansible-doc [options][module...]

Options:
	-h, --help show this help message and exit # 显示命令参数API文档

	-l, --list List available modules #列出可用的模块

	-M MODULE_PATH, --module-path=MODULE_PATH #指定模块的路径specify path(s) to module library (default=None)

	-s, --snippet Show playbook snippet for specified module(s) #显示playbook制定模块的用法

	--version show program's version number and exit # 显示ansible-doc的版本号查看模块

实例：

[root@CentOS7-master ~]# ansible-doc -l|grep mysql
mysql_db                           Add or remove MySQL databases from a remote host.   
mysql_replication                  Manage MySQL replication                            
mysql_user                         Adds or removes a user from a MySQL database.       
mysql_variables                    Manage MySQL global variables
[root@CentOS7-master ~]# 
[root@CentOS7-master ~]# ansible-doc -l mysql_replication 
a10_server                         Manage A10 Networks AX/SoftAX/Thunder/vThunder devic...
a10_service_group                  Manage A10 Networks devices' service groups         
......
......
......
quantum_router_interface           Attach/Detach a subnet's interface to a router      
quantum_subnet                     Add/remove subnet from a network                    
(END)

ansible常用模块

1、主机连通性测试：

ansible all -m ping

执行效果如下：

[root@CentOS7-master ~]# ansible all -m ping
172.17.254.165 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
172.17.254.180 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
172.17.250.230 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

若出现以下结果，则说明未配置主机列表，则需要在/etc/ansible/hosts 中添加主机列表：

[root@CentOS7-master ~]# ansible all -m ping
 [WARNING]: provided hosts list is empty, only localhost is available

 [WARNING]: No hosts matched, nothing to do

2、command：在远程主机执行命令；不支持|管道命令

命令模块接受命令名称，后面是空格分隔的列表参数。给定的命令将在所有选定的节点上执行。它不会通过shell进行处理，比如$HOME和操作如”小于”<“,”>”, “|”, “;”,”&”‘ 工作(需要使用(shell)模块实现这些功能)。

action: command

chdir 		#在执行命令之前，先切换到该目录

creates 	#一个文件名，当这个文件存在，则该命令不执行,可以用来做判断

executable 	#切换shell来执行命令，需要使用命令的绝对路径

free_form 	#要执行的Linux指令，一般使用ansible的-a参数代替。

removes 	#一个文件名，这个文件不存在，则该命令不执行,与creates相反的判断

[root@CentOS7-master ~]# ansible all -m command -a 'ifconfig'
172.17.250.230 | SUCCESS | rc=0 >>
ens32: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.17.250.230  netmask 255.255.0.0  broadcast 172.17.255.255
        inet6 fe80::20c:29ff:fefc:13f0  prefixlen 64  scopeid 0x20<link>
        ether 00:0c:29:fc:13:f0  txqueuelen 1000  (Ethernet)
        RX packets 15924367  bytes 1678705351 (1.5 GiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 8677333  bytes 1589494094 (1.4 GiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

ens33: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.73.130  netmask 255.255.255.0  broadcast 192.168.73.255
        inet6 fe80::20c:29ff:fefc:13fa  prefixlen 64  scopeid 0x20<link>
        ether 00:0c:29:fc:13:fa  txqueuelen 1000  (Ethernet)
        RX packets 8003  bytes 1375066 (1.3 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 78  bytes 5016 (4.8 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

172.17.254.165 | SUCCESS | rc=0 >>
ens32: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.17.254.165  netmask 255.255.0.0  broadcast 172.17.255.255
        inet6 fe80::20c:29ff:fe6a:1f0f  prefixlen 64  scopeid 0x20<link>
        ether 00:0c:29:6a:1f:0f  txqueuelen 1000  (Ethernet)
        RX packets 6028867  bytes 489629406 (466.9 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 322593  bytes 58991897 (56.2 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

ens33: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.73.137  netmask 255.255.255.0  broadcast 192.168.73.255
        inet6 fe80::20c:29ff:fe6a:1f19  prefixlen 64  scopeid 0x20<link>
        ether 00:0c:29:6a:1f:19  txqueuelen 1000  (Ethernet)
        RX packets 7859  bytes 1345936 (1.2 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 20  bytes 1536 (1.5 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

172.17.254.180 | SUCCESS | rc=0 >>
ens32: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.17.254.180  netmask 255.255.0.0  broadcast 172.17.255.255
        inet6 fe80::20c:29ff:fedb:9611  prefixlen 64  scopeid 0x20<link>
        ether 00:0c:29:db:96:11  txqueuelen 1000  (Ethernet)
        RX packets 8231638  bytes 3839144807 (3.5 GiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 2504227  bytes 177542489 (169.3 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

ens33: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.73.151  netmask 255.255.255.0  broadcast 192.168.73.255
        inet6 fe80::20c:29ff:fedb:961b  prefixlen 64  scopeid 0x20<link>
        ether 00:0c:29:db:96:1b  txqueuelen 1000  (Ethernet)
        RX packets 10665  bytes 1901294 (1.8 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 2600  bytes 521922 (509.6 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
        
        
[root@CentOS7-master ~]# ansible all -m command -a 'chdir=/tmp ls'                    
172.17.254.165 | SUCCESS | rc=0 >>
ansible_nDr_sW
systemd-private-6524f00099a646b28e1484e64e97f459-nginx.service-SDDItJ
systemd-private-6524f00099a646b28e1484e64e97f459-vmtoolsd.service-9zL9Z3

172.17.250.230 | SUCCESS | rc=0 >>
ansible_W9Cey7
systemd-private-cbd6ab787c1047f49bd164e1928bc50c-mariadb.service-ZWF9XI
systemd-private-cbd6ab787c1047f49bd164e1928bc50c-vmtoolsd.service-7NjwSi

172.17.254.180 | SUCCESS | rc=0 >>
ansible_p4DDLJ
hsperfdata_tomcat
systemd-private-e8fcbe84909942deb6ea742ed68dca4e-vmtoolsd.service-7sY3og

3、shell模块

shell模块在远程主机上调用shell解释器运行命令，支持shell的各种功能，例如管道等 :

[root@CentOS7-master ~]# ansible webservers -m shell -a 'cat /etc/passwd |grep "root"'
172.17.254.180 | SUCCESS | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin

172.17.254.165 | SUCCESS | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin

4、copy：复制文件到远程主机，可以改权限等

用法：
(1) 复制文件

-a "src= dest= "

(2) 给定内容生成文件

-a "content= dest= "

相关选项如下：
backup：在覆盖之前，将源文件备份，备份文件包含时间信息。有两个选项：yes|no

content：用于替代“src”，可以直接设定指定文件的值

dest：必选项。要将源文件复制到的远程主机的绝对路径，如果源文件是一个目录，那么该路径也必须是个目录

directory_mode：递归设定目录的权限，默认为系统默认权限

force：如果目标主机包含该文件，但内容不同，如果设置为yes，则强制覆盖，如果为no，则只有当目标主机的目标位置不存在该文件时，才复制。默认为yes

others：所有的file模块里的选项都可以在这里使用

src：被复制到远程主机的本地文件，可以是绝对路径，也可以是相对路径。如果路径是一个目录，它将递归复制。在这种情况下，如果路径使用“/”来结尾，则只复制目录里的内容，如果没有使用“/”来结尾，则包含目录在内的整个内容全部复制，类似于rsync。

[root@CentOS7-master ~]# ansible webservers -m copy -a 'content="hello\nworld" dest=/tmp/test.ansible mode=666'   
172.17.254.165 | SUCCESS => {
    "changed": true, 
    "checksum": "7db827c10afc1719863502cf95397731b23b8bae", 
    "dest": "/tmp/test.ansible", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "9195d0beb2a889e1be05ed6bb1954837", 
    "mode": "0666", 
    "owner": "root", 
    "secontext": "unconfined_u:object_r:admin_home_t:s0", 
    "size": 11, 
    "src": "/root/.ansible/tmp/ansible-tmp-1512465712.79-212682551827039/source", 
    "state": "file", 
    "uid": 0
}
172.17.254.180 | SUCCESS => {
    "changed": true, 
    "checksum": "7db827c10afc1719863502cf95397731b23b8bae", 
    "dest": "/tmp/test.ansible", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "9195d0beb2a889e1be05ed6bb1954837", 
    "mode": "0666", 
    "owner": "root", 
    "secontext": "unconfined_u:object_r:admin_home_t:s0", 
    "size": 11, 
    "src": "/root/.ansible/tmp/ansible-tmp-1512465712.87-100512759759497/source", 
    "state": "file", 
    "uid": 0
}

5、file 设置文件属性：

创建目录：-a "path= state=directory"
创建链接文件：-a "path= src= state=link"
删除文件：-a "path= state=absent"

force：需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no

group：定义文件/目录的属组 mode：定义文件/目录的权限

owner：定义文件/目录的属主 path：必选项，定义文件/目录的路径

recurse：递归设置文件的属性，只对目录有效 src：被链接的源文件路径，只应用于state=link的情况

dest：被链接到的路径，只应用于state=link的情况
	state：
		directory：如果目录不存在，就创建目录
		file：即使文件不存在，也不会被创建
		link：创建软链接
		hard：创建硬链接
		touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
		absent：删除目录、文件或者取消链接文件

[root@CentOS7-master ~]# ansible webservers -m file -a 'path=/tmp/test state=directory' 
172.17.254.165 | SUCCESS => {
    "changed": true, 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "path": "/tmp/test", 
    "secontext": "unconfined_u:object_r:user_tmp_t:s0", 
    "size": 6, 
    "state": "directory", 
    "uid": 0
}
172.17.254.180 | SUCCESS => {
    "changed": true, 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "path": "/tmp/test", 
    "secontext": "unconfined_u:object_r:user_tmp_t:s0", 
    "size": 6, 
    "state": "directory", 
    "uid": 0
}
[root@CentOS7-master ~]# 
[root@CentOS7-master ~]# 
[root@CentOS7-master ~]# ansible webservers -m file -a 'path=/data/web.sh state=touch'
172.17.254.165 | SUCCESS => {
    "changed": true, 
    "dest": "/data/web.sh", 
    "gid": 0, 
    "group": "root", 
    "mode": "0644", 
    "owner": "root", 
    "secontext": "unconfined_u:object_r:default_t:s0", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}
172.17.254.180 | SUCCESS => {
    "changed": true, 
    "dest": "/data/web.sh", 
    "gid": 0, 
    "group": "root", 
    "mode": "0644", 
    "owner": "root", 
    "secontext": "unconfined_u:object_r:default_t:s0", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}
[root@CentOS7-master ~]# 
[root@CentOS7-master ~]# ansible webservers -m file -a 'path=/data/web.sh state=file' 
172.17.254.165 | SUCCESS => {
    "changed": false, 
    "gid": 0, 
    "group": "root", 
    "mode": "0644", 
    "owner": "root", 
    "path": "/data/web.sh", 
    "secontext": "unconfined_u:object_r:default_t:s0", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}
172.17.254.180 | SUCCESS => {
    "changed": false, 
    "gid": 0, 
    "group": "root", 
    "mode": "0644", 
    "owner": "root", 
    "path": "/data/web.sh", 
    "secontext": "unconfined_u:object_r:default_t:s0", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}

6、fetch从远程某主机获取文件到本地：

dest： 用来存放文件的目录，例如存放目录为backup，源文件名称为/etc/profile在主机pythonserver中，那么保存为/backup/pythonserver/etc/profile；

src： 在远程拉取的文件，并且必须是一个file，不能是目录。

[root@CentOS7-master ~]# ansible webservers -m fetch -a 'src=/var/log/messages dest=/root'
172.17.254.165 | SUCCESS => {
    "changed": true, 
    "checksum": "8065eb47956eaa59d3ca64a2c69a38084ae7505d", 
    "dest": "/root/172.17.254.165/var/log/messages", 
    "md5sum": "c864d77846965436f8d7feb660c103a1", 
    "remote_checksum": "d7f2d4876e65962444963531e4ed10b319e7b277", 
    "remote_md5sum": null
}
172.17.254.180 | SUCCESS => {
    "changed": true, 
    "checksum": "0d0829396b7dfdc1951c3ec35fa266f3195c6763", 
    "dest": "/root/172.17.254.180/var/log/messages", 
    "md5sum": "7a3f75bb76aed49282bc7cbc3142448c", 
    "remote_checksum": "0d0829396b7dfdc1951c3ec35fa266f3195c6763", 
    "remote_md5sum": null
}

7、cron管理cron计划任务

ansible all -m cron -a “ ”: 设置管理节点生成定时任务

action: cron backup= 	#如果设置，创建一个crontab备份 [yes|no]
cron_file= 	#如果指定, 使用这个文件cron.d，而不是单个用户

crontab

day= 	#日应该运行的工作( 1-31, *, */2, )

hour= 	#小时 ( 0-23, *, */2, )

minute= 	#分钟( 0-59, *, */2, )

month= 	#月( 1-12, *, /2, )

weekday 	#周 ( 0-6 for Sunday-Saturday,, )

job= 	#指明运行的命令是什么

name= 	#定时任务描述

reboot 	#任务在重启时运行，不建议使用，建议使用special_time

special_time 	#特殊的时间范围，参数：reboot（重启时）,annually（每年）,monthly（每月）,weekly（每周）,daily（每天）,hourly（每小时）

state 	#指定状态，present表示添加定时任务，也是默认设置，absent表示删除定时任务

user 	#以哪个用户的身份执行

ansible webservers -m cron -a 'name="sync time from ntpserver" minute="*/10" job="/sbin/ntpdate asia.pool.ntp.org &>/dev/null" '

8、yum安装软件

conf_file 	#设定远程yum安装时所依赖的配置文件。如配置文件没有在默认的位置。
disable_gpg_check 	#是否禁止GPG checking，只用于‘present’ or `latest’。
disablerepo 	#临时禁止使用yum库。 只用于安装或更新时。
enablerepo 	#临时使用的yum库。只用于安装或更新时。

#下面带“**”的都是重点的
** name= 	#所安装的包的名称
** state=present|latest|absent 	#present安装，latest安装最新的,absent 卸载软件。
** update_cache 	#强制更新yum的缓存。

[root@CentOS7-master ~]# ansible 172.17.254.165 -m yum -a 'name=htop state=present'
172.17.254.165 | SUCCESS => {
    "changed": true, 
    "msg": "", 
    "rc": 0, 
    "results": [
        "Loaded plugins: fastestmirror\nLoading mirror speeds from cached hostfile\nResolving Dependencies\n--> Running transaction check\n---> Package htop.x86_64 0:2.0.2-1.el7 will be installed\n--> Finished Dependency Resolution\n\nDependencies Resolved\n\n================================================================================\n Package         Arch              Version                Repository       Size\n================================================================================\nInstalling:\n htop            x86_64            2.0.2-1.el7            epel             98 k\n\nTransaction Summary\n================================================================================\nInstall  1 Package\n\nTotal download size: 98 k\nInstalled size: 207 k\nDownloading packages:\nRunning transaction check\nRunning transaction test\nTransaction test succeeded\nRunning transaction\n  Installing : htop-2.0.2-1.el7.x86_64                                      1/1 \n  Verifying  : htop-2.0.2-1.el7.x86_64                                      1/1 \n\nInstalled:\n  htop.x86_64 0:2.0.2-1.el7                                                     \n\nComplete!\n"
    ]
}

9、service: 服务程序管理

arguments 	#命令行提供额外的参数
enabled=true|false 	#设置开机启动。
name= 	#服务名称
runlevel 	#开机启动的级别，一般不用指定。
sleep 	#在重启服务的过程中，是否等待。如在服务关闭以后等待2秒再启动。
state= 	#started启动服务， stopped停止服务， restarted重启服务， reloaded重载配置

ansible 172.17.254.165 -m service -a 'name=nginx state=stopped enabled=true' 

10、user模块管理

用户模块，管理用户帐号 action: user

comment 	#用户的描述信息
createhome 	#是否创建家目录
force 		#在使用state=absent是, 行为与userdel –force一致.
group 		#指定基本组
groups 		#指定附加组，如果指定为(groups=)表示删除所有组
home 		#指定用户家目录
move_home 	#如果设置为home=时, 试图将用户主目录移动到指定的目录
name 		#指定用户名
non_unique 	#该选项允许改变非唯一的用户ID值
password 	#指定用户密码
remove 		#在使用state=absent时, 行为是与userdel –remove一致
shell 		#指定默认shell
state 		#设置帐号状态，不指定为创建，指定值为absent表示删除
system 		#当创建一个用户，设置这个用户是系统用户。这个设置不能更改现有用户
uid 		#指定用户的uid
update_password 	#更新用户密码

#创建一个name为tom，uid为1006，shell为、bin/zshell，home为/home/tomhome的用户
[root@CentOS7-master ~]# ansible webservers -m user -a 'name=tom comment="tom is tom" uid=1066 shell=/bin/zshell home=/home/tomhome'           
172.17.254.165 | SUCCESS => {
    "changed": true, 
    "comment": "tom is tom", 
    "createhome": true, 
    "group": 1066, 
    "home": "/home/tomhome", 
    "name": "tom", 
    "shell": "/bin/zshell", 
    "state": "present", 
    "system": false, 
    "uid": 1066
}
172.17.254.180 | SUCCESS => {
    "changed": true, 
    "comment": "tom is tom", 
    "createhome": true, 
    "group": 1066, 
    "home": "/home/tomhome", 
    "name": "tom", 
    "shell": "/bin/zshell", 
    "state": "present", 
    "system": false, 
    "uid": 1066
}

11、group

用户组模块，添加或删除组：action: group

gid # 设置组的GID号
name= # 管理组的名称
state # 指定组状态，默认为创建，设置值为absent为删除
system # 设置值为yes，表示为创建系统组

[root@CentOS7-master ~]# ansible webservers -m group -a 'name=tom state=present'
172.17.254.165 | SUCCESS => {
    "changed": false, 
    "gid": 1066, 
    "name": "tom", 
    "state": "present", 
    "system": false
}
172.17.254.180 | SUCCESS => {
    "changed": false, 
    "gid": 1066, 
    "name": "tom", 
    "state": "present", 
    "system": false
}

12、script在指定节点运行服务端的脚本

[root@CentOS7-master ~]# vim test.sh
#/bin/bash

#创建/tmp/test.sh.log
touch /tmp/test.sh.log

#将date命令结果输出到/tmp/test.sh.log
echo “hello” >> /tmp/test.sh.log

在webservers组中所有主机执行/root/test.sh脚本

[root@CentOS7-master ~]# ansible webservers -m script -a '/root/test.sh'

13、setup模块

facts组件是ansible用于采集被管机器设备信息的一个功能，我们可以使用setup模块查机器的所有facts信息，可以使用filter来查看指定信息。整个facts信息被包装在一个JSON格式的数据结构中，ansible_facts是最上层的值。

facts就是变量，内建变量 。每个主机的各种信息，cpu颗数、内存大小等。会存在facts中的某个变量中。调用后返回很多对应主机的信息，在后面的操作中可以根据不同的信息来做不同的操作。如redhat系列用yum安装，而debian系列用apt来安装软件。

setup模块，主要用于获取主机信息，在playbooks里经常会用到的一个参数gather_facts就与该模块相关。

setup模块下经常使用的一个参数是filter参数，具体使用示例如下（由于输出结果较多，这里只列命令不写结果）：

ansible 172.17.254.165 -m setup -a 'filter=ansible*mb' //查看主机内存信息
ansible 172.17.254.180 -m setup -a 'filter=ansible_ens3[2-3]' //查看地接口为eth0-2的网卡信息

ansible all -m setup --tree /tmp/facts //将所有主机的信息输入到/tmp/facts目录下，每台主机的信息输入到主机名文件中（/etc/ansible/hosts里的主机名）