目录
Ansible模块（ad-hoc模式）
Ansible中常见的返回值
| 返回值 | 返回值含义 |
| 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 “具体命令”
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命令支持与否
shell 模块：远程执行命令，支持管道，重定向
输出信息到shell.txt
[root@web01 ~]# ansible web02 -m shell -a "echo "这是shell命令" >shell.txt"
192.168.143.162 | CHANGED | rc=0 >>
验证：
Shell使用removes参数
Raw模块：先登录，再执行，最后退出
它是支持一些shell命令的，因为它的本质就是ssh登录后再执行命令
输出信息到raw.sh文件中
[root@web01 ~]# ansible web02 -m raw -a "echo "这是raw模块" >raw.sh
Script模块：远程执行脚本
格式：
ansible 本地主机 -m script -a "script_file"
script_file填写你的目标主机脚本路径
再web01,web02主机上编写脚本
执行web02主机上的脚本
可以看出不能执行远程服务器的脚本
执行本地主机web01的脚本
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' "
查看设置的定时任务
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"
Group模块：管理用户组
group模块用于管理用户组的，相当于groupadd,groupdel等。
User模块的参数同样适用于group
设置用户组为mysql，组id为1001，设为系统用户组
[root@web01 ~]# ansible web02 -m group -a "name=mysql gid=1001 system=yes"
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
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"
File模块：设置文件属性
对文件操作，创建文件或目录、删除文件或目录、修改文件权限
常用参数：
path ：定义需要操作的文件或目录（必须参数）
src ：本地文件路径
recurse ：递归授权
owner ：指定属主
group ：指定属组
mode ：指定权限
state ：指定对文件的操作（必须参数）
directory ：在远端创建目录
touch：在远端创建文件
link ：创建软连接
hard ：创建硬连接
absent ：表示删除文件或目录
参数path指定路径必须存在
Service/systemd模块：控制服务运行状态
常用参数：
name 定义要启动服务的名称
state 指定服务状态
started 启动服务（具有幂等性）
stopped 停止服务（具有幂等性）
restarted 重启服务
reloaded 重载服务
enabled 开机自启
关闭防火墙服务
yum模块：远程安装软件
name=软件包的名，多个软件包逗号隔开
state=installed/present安装、removed/absent卸载 、lastest 更新、如果已安装，installed列出已安装的包
安装httpd服务
可以看到，installed没有安装服务时，会安装，安装了会列出包
Mount模块：管理设备下载和caish卸载
src ：指定挂载源
path：指定挂载点 (挂载点不存在会自动创建)
fstype：指定文件系统类型
opts：挂载参数，默认为defaults
dump：是否备份：0表示不进行备份
passno：文件系统检测：0表示不进行文件系统检测
state
present 写入fstab，但实际没有挂载，需要重启服务器
absent 取消临时挂载，并且删除fstab
mounted 写入fstab，并且直接挂载了（常用）
unmounted 临时取消挂载，但是没有删除fstab，重启服务器之后就会恢复（常用）
将镜像挂载到目录media下
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"
Archive模块：打包压缩
常用的参数：
path: （必须参数）远程主机上需要被打包压缩的源文件/目录
dest: 打包压缩后的包文件路径(包文件的父目录必须存在);如果包文件已存在，则会被覆盖
format: 指定压缩类型，包括: bz2、gz（默认）、tar、xz、zip
remove=yes / no: 是否删除源文件
将本地文件1.txt打包压缩为1.gz
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"
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" "
Setup模块：获取主机信息
facts 组件是用来收集节点信息的，使用 setup 模块可以获取这些信息
常用参数：
filter：对 setup 模块收集的系统信息进行筛选，只获取你指定的那些特定的信息子集
gather_subset：指定具体要收集哪些类别的系统信息以及排除哪些类别
gather_timeout ：设定了收集系统信息的超时时间限制（以秒为单位）
fact_path ：指定 Ansible 查找自定义事实（Custom 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"
