Ansible常见模块介绍

本节内容：

• ansible命令基础
• 常见模块举例

一、ansible命令基础

语法：

ansible <host-pattern> [-f forks] [-m module_name] [-a args] [options] 

• host-pattern：这次的命令对哪些主机生效；
• -f forks：启动的并发线程数，就是一次并行处理多少主机；
• -m module_name：要使用的模块；
• -a args：模块特有的参数。

常见的模块：

• user
• yum
• copy
• cron
• command：这是默认的模块，表示在被管理主机上运行一个命令。对于command模块，-a不再是指定参数，而是命令本身。
• shell

二、常见模块举例

1. /etc/ansible/hosts配置文件内容

2. command模块

command模块是默认的模块，表示在被管理主机上运行一个命令。对于command模块，-a不再是指定参数，而是命令本身。所以这个模块有个缺陷，运行的命令中不能使用变量或者参数。

示例：

[root@node1 ~]# ansible nginx -m command -a "date"

[root@node1 ~]# ansible mysql -m command -a "tail -3 /etc/passwd"

3. cron模块

cron模块可以让每一个被管理节点能够自动生成一个定期任务计划。查看cron模块的用法：

[root@node1 ~]# ansible-doc -s cron

示例：

[root@node1 ~]# ansible mysql -m cron -a 'minute="*/10" job="/usr/bin/echo hello" name="test cron job"'

注意：

• 所有的参数可以用""包含起来
• day之类的参数没有指定，默认都是*
• 默认state参数的值为present

4. user模块

user模块实现用户账号管理。查看user模块的用法：

[root@node1 ~]# ansible-doc -s user

几个主要参数：

• name=：用户名
• uid：用户的uid
• group：所属组，即私有组
• groups：附加组。
• state：状态。

示例：

[root@node1 ~]# ansible mysql -m user -a 'name="jack"'

[root@node1 ~]# ansible mysql -m user -a 'name="jack" state=absent'

5. group模块

group模块：组管理。查看group模块的用法：

示例：

[root@node1 ~]# ansible-doc -s group

[root@node1 ~]# ansible mysql -m group -a 'name=mysql gid=306 system=yes'

6. copy模块

copy模块实现文件复制。查看copy模块的用法：

[root@node1 ~]# ansible-doc -s copy

几个主要参数：

• src=：指明源文件本地路径。可以是绝对路径，也可以是相对路径。可以不使用src，使用content。就是说用content内容来生成文件。
• dest=：定义远程目标文件路径，只能使用绝对路径。
• content=：可以不使用src，使用content。就是说用content内容来生成文件。

示例：

[root@node1 ~]# ansible mysql -m copy -a 'src=/etc/fstab dest=/tmp/fstab.ansible owner=root mode=640'

[root@node1 ~]# ansible mysql -m copy -a 'content="Hello World\nGood boy" dest=/tmp/test.txt owner=root mode=640'

7. file模块

file模块可以设定文件属性，还可以创建文件的符号链接。查看file模块的用法：

[root@node1 ~]# ansible-doc -s file

几个重要参数：

• path=：指明对哪个文件做管理。也可以使用dest和name。
• 创建文件的符号链接：src=：指明源文件，path=：指明符号链接文件路径

示例：

[root@node1 ~]# ansible mysql -m file -a 'owner=root group=mysql mode=644 path=/tmp/test.txt'

[root@node1 ~]# ansible mysql -m file -a 'path=/tmp/test.link src=/tmp/test.txt state=link'

8. ping模块

ping模块测试指定主机是否能连接。查看ping模块的用法：

[root@node1 ~]# ansible-doc -s ping

示例：

[root@node1 ~]# ansible nginx -m ping

9. service模块

service模块是管理服务的。查看service模块的用法：

[root@node1 ~]# ansible-doc -s service

几个重要参数：

• enabled=：是否开机自动启动，取值为true或false；
• name=：服务名字；
• state=：状态，取值有started，stoped，restarted。

示例：

[root@node1 ~]# ansible 172.16.7.151 -m service -a 'enabled=true name=httpd state=stopped'

10. shell模块

和command模块类似，但是可以使用变量。用于执行一些复杂的命令。查看shell模块的使用方法：

[root@node1 ~]# ansible-doc -s shell

示例：

[root@node1 ~]# ansible mysql -m user -a 'name="test"'
[root@node1 ~]# ansible mysql -m command -a 'echo wisedu | passwd --stdin test'
[root@node1 ~]# ansible mysql -m command -a 'tail -1 /etc/passwd'

[root@node1 ~]# ansible mysql -m shell -a 'echo wisedu | passwd --stdin user1'
[root@node1 ~]# ansible mysql -m command -a 'tail -1 /etc/shadow'

所以一旦有管道、变量之类的，你最好使用shell模块，而不要用command模块。

11. script模块

script模块将本地脚本复制到远程主机并运行之。查看script模块的用法：

[root@node1 ~]# ansible-doc -s script

示例：

[root@node1 ~]# vim test.sh
#/bin/bash
echo "hello world" >/tmp/nba.txt
[root@node1 ~]# chmod +x test.sh
[root@node1 ~]# ansible mysql -m script -a '/root/test.sh'

12. yum模块 

yum模块管理程序包。查看yum模块的用法：

[root@node1 ~]# ansible-doc -s yum  

几个重要参数：

• name=：指定要安装的程序包，可以带上版本号，否则安装最新版本；
• state=：present表示安装，absent表示卸载。

示例：

[root@node1 ~]# ansible mysql -m yum -a 'name=ksh'

13. setup模块

setup模块：收集远程主机的facts。ansbile在管理每一个主机时，这些主机在被运行管理命令之前，会首先向ansible节点报告自己主机当前的各种可能被ansible主机用到的状态信息，如操作系统版本、ip地址等信息，这些信息都是以变量的形式，ansible主机可以在jinjia2中调用，为不同的服务器生成不同的配置文件。

[root@node1 ~]# ansible mysql -m setup