|-------------|------------------------------------------|
| 返回值 | 返回值含义 |
| changed | 几乎所有的Ansible模块都会返回该变量，表示模块是否对远程主机执行了修改操作 |
| failed | 如果模块未能执行完成，将返回failed为true |
| msg | 模块执行失败的原因，常见的错误如ssh连接失败 |
| rc | 与命令行工具相关的模块会返回rc,表示执行Linux命令的状态码 |
| stdout | 与rc类似，返回的是标准输出的结果 |
| stderr | 与rc类似，返回的是标准错误的结果 |
| backup_file | 所有存在backup选项的模块，用来返回备份文件的路径 |
| results | 应用在playbook中存在循环的情况，返回多个结果 |

模块的格式：

默认为command模块

ansible 主机 / 组名称 -m 模块 -a "具体命令"

ansible 主机 / 组名称 -a "具体命令"

1.command模块：远程执行命令

在远程主机执行命令，不支持管道，重定向等shell的特性。【默认模块】

常用的参数：（command 和shell 可用）

chdir：在远程主机上运行命令前提前进入目录

creates：判断指定文件或目录是否存在，如果存在，不执行后面的操作

removes：判断指定文件或目录是否存在，如果存在，执行后面的操作

正常用法：

切换到指定目录在执行命令

[root@web01 ~]# ansible web02 -m command -a "chdir=/home ls"

192.168.143.162 | CHANGED | rc=0 >>

456.txt

判断指定文件或目录是否存在，如果存在，该怎么办

执行命令：

不执行命令：

参数可结合使用

与shell的区别，对管道及重定向等shell命令支持与否

2.shell 模块：远程执行命令，支持管道，重定向

输出信息到shell.txt

[root@web01 ~]# ansible web02 -m shell -a "echo "这是shell命令" >shell.txt"

192.168.143.162 | CHANGED | rc=0 >>

验证：

Shell使用removes参数

3.Raw模块：先登录，再执行，最后退出

它是支持一些shell命令的，因为它的本质就是ssh登录后再执行命令

输出信息到raw.sh文件中

[root@web01 ~]# ansible web02 -m raw -a "echo "这是raw模块" >raw.sh

4.Script模块：远程执行脚本

格式：

ansible 本地主机 -m script -a "script_file"

script_file填写你的目标主机脚本路径

再web01,web02主机上编写脚本

执行web02主机上的脚本

可以看出不能执行远程服务器的脚本

执行本地主机web01的脚本

5.cron 模块：远程定义任务计划

其中有两种状态（state ）：present 表示添加（可以省略），absent 表示移除。

Cron模块常用的参数：

minute/hour/day/month/weekday：分/时/日/月/周

job：任务计划要执行的命令

name：任务计划的名称

user：指定计划任务属于哪个用户，默认是root用户

state

present：创建

absent：删除

（不写执行时间，默认就是每分钟一次；不写name默认为None)

主题为test，输出hello

[root@web01 ~]# ansible web02 -m cron -a "job='/bin/echo hello' name='test' "

查看设置的定时任务

6.User模块：管理用户的模块

user用于管理用户的创建与删除，相当于useradd,userdel,usermod;

常用的参数：

name：用户名，必选参数

state=present|absent：创建账号或者删除账号，present表示创建，absent表示删除

system=yes/no：是否为系统账号

uid：用户uid

group：用户基本组

groups: 用户所属附加组

shell：默认使用的shell

create_home=yse/no: 是否创建家目录

password：用户的密码，建议使用加密后的字符串

remove=yes/no：是否删除用户的家目录

user模块更多参数可使用ansible -doc user查看

用户名要用引号包裹，创建用户test01，不删除家目录

[root@web01 ~]# ansible web02 -m user -a "name="test01" remove=no"

7.Group模块：管理用户组

group模块用于管理用户组的，相当于groupadd,groupdel等。

User模块的参数同样适用于group

设置用户组为mysql，组id为1001，设为系统用户组

[root@web01 ~]# ansible web02 -m group -a "name=mysql gid=1001 system=yes"

8.Copy模块：指定本地文件复制到远程主机

常用参数：

src= 本地文件路径（可根据当前位置决定使用相对路径还是绝对路径）

dest= 目标文件路径（只能使用绝对路径）

content= 指定文件内容，写入到目标文件；如果文件不存在会创建

owner= 指定属主

group= 指定组

mode= 指定权限

copy 模块的更多使用可使用ansible-doc copy查看。

复制本地文件222.sh到远程服务器的root下

[root@web01 ~]# touch 222.sh

[root@web01 ~]# ansible web02 -m copy -a "src=222.sh dest=/root/"

将123写入远程服务器的1.txt文件中

[root@web01 ~]# ansible web02 -m copy -a "content="123" dest=/root/1.txt

9.Fetch模块：从远程主机获取文件

一般用于收集远程主机上的配置文件、日志文件等数据进行备份或检查

常用参数：

src：指定远程主机上要获取的文件的路径。（必需参数）

dest：指定在本地主机保存文件的目标目录，目录不存在会自行创建。（必须参数）

flat：这是一个可选参数。默认值为no。当flat设置为yes时，文件将直接保存到dest指定的文件下；当flat设置为no时，文件将按照远程主机的主机名 / IP地址和文件路径结构保存在dest目录下。

在远程主机web02上创建fetch.sh文件

把远程主机的fetch.sh传到本地fetch目录下

[root@web01 ~]# ansible web02 -m fetch -a "src=fetch.sh dest=fetch"

可以看到没有使用flat参数默认为no，文件会以ip地址+文件的形式保存到dest所给目录下。

设置flat=yes时，dest参数只能为文件，不能为目录，执行的操作是将src文件内容，写入dest文件中。

[root@web01 ~]#rm -rf fetch

[root@web01 ~]# ansible web02 -m fetch -a "src=fetch.sh dest=fetch flat=yes"

10.File模块：设置文件属性

对文件操作，创建文件或目录、删除文件或目录、修改文件权限

常用参数：

path ：定义需要操作的文件或目录（必须参数）

src ：本地文件路径

recurse ：递归授权

owner ：指定属主

group ：指定属组

mode ：指定权限

state ：指定对文件的操作（必须参数）

directory ：在远端创建目录

touch：在远端创建文件

link ：创建软连接

hard ：创建硬连接

absent ：表示删除文件或目录

参数path指定路径必须存在

11.Service/systemd模块：控制服务运行状态

常用参数：

name 定义要启动服务的名称

state 指定服务状态

started 启动服务（具有幂等性）

stopped 停止服务（具有幂等性）

restarted 重启服务

reloaded 重载服务

enabled 开机自启

关闭防火墙服务

12.yum模块：远程安装软件

name=软件包的名，多个软件包逗号隔开

state=installed/present安装、removed/absent卸载、lastest 更新、如果已安装，installed列出已安装的包

安装httpd服务

可以看到，installed没有安装服务时，会安装，安装了会列出包

13.Mount模块：管理设备下载和caish卸载

src ：指定挂载源

path：指定挂载点 (挂载点不存在会自动创建)

fstype：指定文件系统类型

opts：挂载参数，默认为defaults

dump：是否备份：0表示不进行备份

passno：文件系统检测：0表示不进行文件系统检测

state

present 写入fstab，但实际没有挂载，需要重启服务器

absent 取消临时挂载，并且删除fstab

mounted 写入fstab，并且直接挂载了（常用）

unmounted 临时取消挂载，但是没有删除fstab，重启服务器之后就会恢复（常用）

将镜像挂载到目录media下

14.Unarchive模块：解压缩模块

它支持tar，tar.gz,tar.bz2,.zip等压缩包格式

常用参数：

src 源路径，可以是ansible主机上的路径，也可以是远程主机上的路径，如果是远程主机上的路径，则需要设置 remote_src=yes

dest：指定了解压缩后文件的目标目录

mode：设置解压缩后的文件权限，可以使用数字或符号模式，例如 "644" 或 "u=rw,go=r"。

list_files：默认值为no,如果设置为yes，解压同时，返回压缩包的文件列表

remote_src：如果设置为 yes，则表示 src 参数是远程主机上的路径。

extra_opts: 允许您指定解压缩命令的额外选项。这对于一些特定格式的存档文件非常有用。

creates: 如果指定了此选项，只有在 creates 中指定的文件或目录不存在时，才会执行解压缩操作。

owner: 设置解压缩后文件的所有者。

group: 设置解压缩后文件的所属组。

这个模块有两种模式：

当参数copy=no（默认为no），为本地解压，本地指定目录接收；远程解压，远程目录接收。即不会出现本地文件传输到远程或远程文件被本地接收的情况

本地解压:

远程主机解压：远程主机src路径必须写绝对路径

当参数copy=yes，具有copy模块的属性，可以把文件传输到远程主机。

将本地解压后的文件传入远程主机的/home下

ansible web02 -m unarchive -a "src=openjdk-8u44-linux-x64.tar.gz dest=/home/ copy=yes"

15.Archive模块：打包压缩

常用的参数：

path: （必须参数）远程主机上需要被打包压缩的源文件/目录

dest: 打包压缩后的包文件路径(包文件的父目录必须存在);如果包文件已存在，则会被覆盖

format: 指定压缩类型，包括: bz2、gz（默认）、tar、xz、zip

remove=yes / no: 是否删除源文件

将本地文件1.txt打包压缩为1.gz

16.Get_url模块：下载文件

常用参数：

url (必需): 指定要下载文件的URL。

dest (必需): 指定文件将保存到本地目标主机上的目标路径。

force (可选): 如果设置为 yes，将强制下载文件，即使文件已经存在。默认为 no。

checksum (可选): 提供要下载文件的校验和，以确保文件完整性。

backup (可选): 如果设置为 yes，将在下载之前备份现有文件。默认为 no。

timeout (可选): 设置下载文件的超时时间（秒）。

url_username (可选): 如果目标URL需要身份验证，可以提供用户名。

url_password (可选): 如果目标URL需要身份验证，可以提供密码。

owner (可选): 设置下载后文件的所有者。

group (可选): 设置下载后文件的所属组。

mode (可选): 设置下载后文件的权限模式。

把文件下载到远程主机web02的root/下

[root@web01 ~]# ansible web02 -m get_url -a "url=https://blog.csdn.net/LCL_18?type=blog dest=/root"

17.Replace模块：类似于sed命令

主要的操作也是基于正则进行匹配和替换

常用参数：

path：（必须参数）指定要修改的文件

regexp：（必须参数），指定一个文本内容，也可以使用正则表达式

replace：替换regexp参数匹配到的字符串

backup=yes /no: 修改源文件前创建一个包含时间戳信息的备份文件

before：如果指定，则仅替换/删除此匹配之前的内容，可以和after参数结合使用

after：如果指定，则仅替换/删除此匹配之后的内容，可以和before参数结合使用

owner：修改文件用户名

group：修改文件组名

mode：修改文件权限

实现关闭selinux

[root@web01 ~]# ansible web01 -m replace -a "path=/etc/selinux/config regexp="SELINUX=e.*" replace="SELINUX=disabled" "

18.Setup模块：获取主机信息

facts 组件是用来收集节点信息的，使用 setup 模块可以获取这些信息

常用参数：

filter：对 setup 模块收集的系统信息进行筛选，只获取你指定的那些特定的信息子集

gather_subset：指定具体要收集哪些类别的系统信息以及排除哪些类别

gather_timeout ：设定了收集系统信息的超时时间限制（以秒为单位）

fact_path ：指定 Ansible 查找自定义事实（Custom Facts）文件的本地路径。

一些facts组件的内置变量：

|------------------------------------|--------------------------|
| ansible_all_ipv4_addresses | ipv4的所有地址 |
| ansible_all_ipv6_addresses | ipv6的所有地址 |
| ansible_date_time | 获取到控制节点时间 |
| ansible_default_ipv4 | 默认的ipv4地址 |
| ansible_distribution | 系统 |
| ansible_distribution_major_version | 系统的大版本 |
| ansible_distribution_version | 系统的版本号 |
| ansible_domain | 系统所在的域 |
| ansible_env | 系统的环境变量 |
| ansible_hostname | 系统的主机名 |
| ansible_fqdn | 系统的全名 |
| ansible_machine | 系统的架构 |
| ansible_memory_mb | 系统的内存信息 |
| ansible_os_family | 系统的家族 |
| ansible_pkg_mgr | 系统的包管理工具 |
| ansible_processor_cores | 系统的cpu的核数(每颗) |
| ansible_processor_count | 系统cpu的颗数 |
| ansible_processor_vcpus | 系统cpu的总个数=cpu的颗数*CPU的核数 |
| ansible_python | 系统上的python |

查看主机web02的ipv4地址

[root@web01 ~]# ansible web02 -m setup -a "filter=ansible_all_ipv4_addresses"

ansible自动化运维（二）ad-hoc模式

Ansible模块（ad-hoc模式）