ansible模块超全解析，拿下ansible常用模块（一）

ansible模块

• 模块基本信息查看

# 列出ansible的所有模块数量
[root@control ansible]# ansible-doc -l | wc -l
2834
# 列出ansible的所有模块
[root@control ansible]# ansible-doc -l 
# 查看与yum相关的模块
[root@control ansible]# ansible-doc -l | grep yum

# 查看yum模块的使用说明，主要查看下方的EXAMPLE示例
[root@control ansible]# ansible-doc yum

• 学习模块，主要知道实现某种功能，需要哪个模块。
• 模块的使用方式都一样。主要是查看该模块有哪些参数。

command模块

• ansible默认模块，用于在远程主机上执行任意命令
• command不支持shell特性，如管道、重定向。

# 在所有被管主机上创建目录/tmp/demo
[root@control ansible]# ansible all -a "mkdir /tmp/demo"

# 查看node1的ip地址
[root@control ansible]# ansible node1 -a "ip a s"
[root@control ansible]# ansible node1 -a "ip a s | head"   # 报错

shell模块

• 与command模块类似，但是支持shell特性，如管道、重定向。

# 查看node1的ip地址，只显示前10行
[root@control ansible]# ansible node1 -m shell -a "ip a s | head"

script模块

• 用于在远程主机上执行脚本

# 在控制端创建脚本即可
[root@control ansible]# vim test.sh
#!/bin/bash

yum install -y httpd
systemctl start httpd

# 在test组的主机上执行脚本
[root@control ansible]# ansible test -m script -a "test.sh"

file模块

• 可以创建文件、目录、链接等，还可以修改权限、属性等
• 常用的选项：
  • path：指定文件路径
  • owner：设置文件所有者
  • group：设置文件所属组
  • state：状态。touch表示创建文件，directory表示创建目录，link表示创建软链接，absent表示删除
  • mode：设置权限
  • src：source的简写，源
  • dest：destination的简写，目标

# 查看使用帮助
[root@control ansible]# ansible-doc file
... ...
EXAMPLES:

- name: Change file ownership, group and permissions  # 忽略
  file:                           # 模块名。以下是它的各种参数
    path: /etc/foo.conf           # 要修改的文件的路径
    owner: foo                    # 文件所有者
    group: foo                    # 文件的所有组
    mode: '0644'                  # 权限
... ...
# 根据上面的example，-m file -a的内容就是doc中把各参数的冒号换成=号

# 在test主机上创建/tmp/file.txt
[root@control ansible]# ansible test -m file -a "path=/tmp/file.txt state=touch"   # touch是指如果文件不存在，则创建

# 在test主机上创建/tmp/demo目录
[root@control ansible]# ansible test -m file -a "path=/tmp/demo state=directory"

# 将test主机上/tmp/file.txt的属主改为sshd，属组改为adm，权限改为0777
[root@control ansible]# ansible test -m file -a "path=/tmp/file.txt owner=sshd group=adm mode='0777'"
[root@control ansible]# ansible test -a "ls -l /tmp/file.txt"

# 删除test主机上/tmp/file.txt
[root@control ansible]# ansible test -m file -a "path=/tmp/file.txt state=absent"    # absent英文缺席的、不存在的

# 删除test主机上/tmp/demo
[root@control ansible]# ansible test -m file -a "path=/tmp/demo state=absent"

# 在test主机上创建/etc/hosts的软链接，目标是/tmp/hosts.txt
[root@control ansible]# ansible test -m file -a "src=/etc/hosts dest=/tmp/hosts.txt state=link"

copy模块

• 用于将文件从控制端拷贝到被控端
• 常用选项：
  • src：源。控制端的文件路径
  • dest：目标。被控制端的文件路径
  • content：内容。需要写到文件中的内容

[root@control ansible]# echo "AAA" > a3.txt
# 将a3.txt拷贝到test主机的/root/
[root@control ansible]# ansible test -m copy -a "src=a3.txt dest=/root/"

# 在目标主机上创建/tmp/mytest.txt，内容是Hello World
[root@control ansible]# ansible test -m copy -a "content='Hello World' dest=/tmp/mytest.txt"

fetch模块

• 与copy模块相反，copy是上传，fetch是下载
• 常用选项：
  • src：源。被控制端的文件路径
  • dest：目标。控制端的文件路径

# 将test主机上的/etc/hostname下载到本地用户的家目录下
[root@control ansible]# ansible test -m fetch -a "src=/etc/hostname dest=~/"
[root@control ansible]# ls ~/node1/etc/   # node1是test组中的主机
hostname

lineinfile模块

• 用于确保存目标文件中有某一行内容
• 常用选项：
  • path：待修改的文件路径
  • line：写入文件的一行内容
  • regexp：正则表达式，用于查找文件中的内容

# test组中的主机，/etc/issue中一定要有一行Hello World。如果该行不存在，则默认添加到文件结尾
[root@control ansible]# ansible test -m lineinfile -a "path=/etc/issue line='Hello World'"

# test组中的主机，把/etc/issue中有Hello的行，替换成chi le ma
[root@control ansible]# ansible test -m lineinfile -a "path=/etc/issue line='chi le ma' regexp='Hello'"

replace模块

• lineinfile会替换一行，replace可以替换关键词
• 常用选项：
  • path：待修改的文件路径
  • replace：将正则表达式查到的内容，替换成replace的内容
  • regexp：正则表达式，用于查找文件中的内容

# 把test组中主机上/etc/issue文件中的chi，替换成he
[root@control ansible]# ansible test -m replace -a "path=/etc/issue regexp='chi' replace='he'"

user模块

• 实现linux用户管理
• 常用选项：
  • name：待创建的用户名
  • uid：用户ID
  • group：设置主组
  • groups：设置附加组
  • home：设置家目录
  • password：设置用户密码
  • state：状态。present表示创建，它是默认选项。absent表示删除
  • remove：删除家目录、邮箱等。值为yes或true都可以。

# 在test组中的主机上，创建tom用户
[root@control ansible]# ansible test -m user -a "name=tom"

# 在test组中的主机上，创建jerry用户。设置其uid为1010，主组是adm，附加组是daemon和root，家目录是/home/jerry
[root@control ansible]# ansible test -m user -a "name=jerry uid=1010 group=adm groups=daemon,root home=/home/jerry"

# 设置tom的密码是123456
# {{}}是固定格式，表示执行命令。password_hash是函数，sha512是加密算法，则password_hash函数将会把123456通过sha512加密变成tom的密码
[root@control ansible]# ansible test -m user -a "name=tom password={{'123456'|password_hash('sha512')}}"

# 删除tom用户，不删除家目录
[root@control ansible]# ansible test -m user -a "name=tom state=absent"

# 删除jerry用户，同时删除家目录
[root@control ansible]# ansible test -m user -a "name=jerry state=absent remove=yes"

group模块

• 创建、删除组
• 常用选项：
  • name：待创建的组名
  • gid：组的ID号
  • state：present表示创建，它是默认选项。absent表示删除

# 在test组中的主机上创建名为devops的组
[root@control ansible]# ansible test -m group -a "name=devops"

# 在test组中的主机上删除名为devops的组
[root@control ansible]# ansible test -m group -a "name=devops state=absent"