运维自动化之ansible工具

前言

一、Ansible 工具概述

1、Ansible 功能

2、Ansible 特性

3、Ansible 优缺点

4、Ansible 架构

4.1 Ansible 组成

4.2 Ansible 命令执行来源

二、Ansible 安装和基础用法

1、Ansible 安装

1.1 yum源安装

1.2 使用python编译安装

1.3 Git方式安装

2、Ansible 相关文件

2.1 ansible 主配置文件

2.2 inventory 主机清单文件

3、Ansible 免密操作

4、Ansible相关工具

4.1 Ansible基础用法

4.2 Ansible-doc用法

4.3 Ansible-console

4.4 playbook

三、Ansible 模块

1、Command 模块

2、Shell 模块

3、Script 模块

4、Copy 模块

5、Fetch 模块

6、Get_url 模块

7、 File 模块

7.1 新建空文件

7.2 新建目录

7.3 递归创建目录

7.4 删除文件或目录

8、Stat 模块

9、Unarchive 模块

9.1 将ansible端的压缩包解压到远端主机

9.2 将远端主机的压缩包解压到指定目录

9.3 将远端主机的压缩包解压至指定目录

10、Archive 模块

11、Hostname 模块

12、Cron 模块

12.1 创建远端主机的启用的计划任务

12.2 创建远端主机不启用的计划任务

12.3 删除远端主机的计划任务

13、Yum和Apt模块

13.1 在远端主机上安装软件

13.2 在远端主机上卸载软件

14、Yum_repository 模块

15、Service 模块

16、Mount 挂载和卸载

17、User 模块

18、Group 模块

19、Reboot 模块

20、Lineinfile 模块

21、Replace 模块

22、Setup 模块

前言

云计算核心职能：

搭建平台架构
日常运营保障
性能效率优化

运维自动化的相关工具：

代码管理（SCM）：GitHub、GitLab、BitBucket、SubVersion
构建工具：maven、Ant、Gradle
自动部署：Capistrano、CodeDeploy
持续集成（CI）：Jenkins、Travis
配置管理：Ansible、SaltStack、Chef、Puppet
容器：Docker、Podman、LXC、第三方厂商如AWS
编排：Kubernetes、Core、Apache Mesos
服务注册与发现：Zookeeper、etcd、Consul
脚本语言：python、ruby、shell、go
日志管理：ELK、Logentries
系统监控：Prometheus、Zabbix、Datadog、Graphite、Ganglia、Nagios
性能监控：AppDynamics、New Relic、Splunk
压力测试：JMeter、Blaze Meter、loader.io
应用服务器：Tomcat、JBoss、IIS
Web服务器：Apache、Nginx
数据库：MySQL、Oracle、PostgreSQL等关系型数据库；mongoDB、redis等NoSQL数据库
项目管理（PM）：Jira、Asana、Taiga、Trello、Basecamp、Pivotal Tracker

一、Ansible 工具概述

官网：https://www.ansible.com/
官方文档：https://docs.ansible.com/

1、Ansible 功能

Ansible 是一种自动化工具，用于配置管理、应用部署和任务自动化。它基于 Python 开发，旨在简化复杂的IT任务，例如配置管理、云部署、网络自动化等

批量执行远程命令,可以对远程的多台主机同时进行命令的执行
批量安装和配置软件服务，可以对远程的多台主机进行自动化的方式配置和管理各种服务
编排高级的企业级复杂的IT架构任务, Ansible的Playbook和role可以轻松实现大型的IT复杂架构
提供自动化运维工具的开发API, 有很多运维工具,如jumpserver（堡垒机）就是基于 ansible 实现自动化管理功能

2、Ansible 特性

模块化：调用特定的模块完成特定任务，支持自定义模块，可使用任何编程语言写模块（账号，软件等）
Paramiko（python对ssh的实现），PyYAML，Jinja2（模板语言）三个关键模块
基于Python语言实现
部署简单，基于python和SSH(默认已安装)，agentless，无需代理不依赖PKI（无需ssl）
安全，基于OpenSSH
幂等性：一个任务执行1遍和执行n遍效果一样，不因重复执行带来意外情况,此特性非绝对
支持playbook编排任务，YAML格式，编排任务，支持丰富的数据结构剧本演员要按照系统按照你规定的方式去执行命令
较强大的多层解决方案 role

3、Ansible 优缺点

优点：

简单易用：相对于其他自动化工具，入门门槛较低
基于代理：不需要在被管理的节点上安装代理
扩展性：支持自定义模块和插件，方便扩展功能
基于文本：使用 YAML 语法编写剧本，易于版本控制和分享

缺点：

性能：在大规模部署时，性能可能不如其他一些工具
复杂性：某些复杂任务可能需要编写自定义模块或插件
Windows支持：相对于 Linux，对 Windows 系统的支持略显不足

4、Ansible 架构

4.1 Ansible 组成

INVENTORY：Ansible管理主机的清单 /etc/anaible/hosts 需要管理的服务清单
MODULES：Ansible执行命令的功能模块，多数为内置核心模块，也可自定义
PLUGINS：模块功能的补充，如连接类型插件、循环插件、变量插件、过滤插件等，该功能不常用
API：供第三方程序调用的应用程序编程接口

4.2 Ansible 命令执行来源

USER 普通用户，即SYSTEM ADMINISTRATOR
PLAYBOOKS：任务剧本（任务集），编排定义Ansible任务集的配置文件，由Ansible顺序依次执行，通常是JSON格式的YML文件
CMDB（配置管理数据库） API 调用
PUBLIC/PRIVATE CLOUD API调用

二、Ansible 安装和基础用法

1、Ansible 安装

1.1 yum源安装

[root@localhost ~]#yum install epel-release.noarch  -y
[root@localhost ~]#yum install ansible -y

[root@localhost ~]#ansible --version

1.2 使用python编译安装

yum -y install python-jinja2 PyYAML python-paramiko python-babel python-crypto
wget https://releases.ansible.com/ansible/ansible-1.5.4.tar.gz
tar xf ansible-1.5.4.tar.gz
cd ansible-1.5.4
python setup.py build
python setup.py install
mkdir /etc/ansible
cp -r examples/* /etc/ansible

1.3 Git方式安装

yum install git
git clone git://github.com/ansible/ansible.git --recursive
cd ./ansible
source ./hacking/env-setup

2、Ansible 相关文件

/etc/ansible/ansible.cfg：主配置文件，配置ansible工作特性,也可以在项目的目录中创建此文件，当前目录下如果也有ansible.cfg，则此文件优先生效,建议每个项目目录下，创建独有的ansible.cfg文件
/etc/ansible/hosts：主机清单
/etc/ansible/roles/：存放角色的目录

2.1 ansible 主配置文件

Ansible 的配置文件可以放在多个不同地方，优先级从高到低顺序如下

ANSIBLE_CONFIG    #环境变量,注意此项用ansible --version看不到,但可以生效
./ansible.cfg     #当前目录下的ansible.cfg
~/.ansible.cfg    #当前用户家目录下的.ansible.cfg
/etc/ansible/ansible.cfg    #系统默认配置文件

Ansible 的默认配置文件：/etc/ansible/ansible.cfg ，其中大部分的配置内容无需进行修改

[defaults]
#inventory     = /etc/ansible/hosts 	#主机列表配置文件
#library = /usr/share/my_modules/ 		#库文件存放目录
#remote_tmp = $HOME/.ansible/tmp 		#临时py命令文件存放在远程主机目录
#local_tmp     = $HOME/.ansible/tmp 	#本机的临时命令执行目录
#forks         = 5   					#默认并发数
#sudo_user     = root 					#默认sudo 用户
#ask_sudo_pass = True 					#每次执行ansible命令是否询问ssh密码
#ask_pass     = True   
#remote_port   = 22
#host_key_checking = False     			#检查对应服务器的host_key，建议取消此行注释,实现第一次连接自动信任目标主机
#log_path=/var/log/ansible.log 			#日志文件，建议启用
#module_name = command   		    	#默认模块，可以修改为shell模块
[privilege_escalation] 					#普通用户提权配置
#become=True
#become_method=sudo
#become_user=root
#become_ask_pass=False

2.2 inventory 主机清单文件

ansible的主要功用在于批量主机操作，为了便捷地使用其中的部分主机，可以在inventory 主机清单文件中将其分组组织

官方文档：https://docs.ansible.com/ansible/latest/user_guide/intro_inventory.html

默认的inventory file 位置在： /etc/ansible/hosts

参数详细说明：

ansible_ssh_host 
#将要连接的远程主机名.与你想要设定的主机的别名不同的话,可通过此变量设置.
ansible_ssh_port 
#ssh端口号.如果不是默认的端口号,通过此变量设置.这种可以使用 ip:端口
172.16.12.10:2222

ansible_ssh_user 
#默认的 ssh 用户名

ansible_ssh_pass 
#ssh 密码(这种方式并不安全,我们强烈建议使用 --ask-pass 或 SSH 密钥)

ansible_sudo_pass 
#sudo 密码(这种方式并不安全,我们强烈建议使用 --ask-sudo-pass)

ansible_sudo_exe (new in version 1.8)
#sudo 命令路径(适用于1.8及以上版本)

ansible_connection 
#与主机的连接类型.比如:local, ssh 或者 paramiko. Ansible 1.2 以前默认使用 paramiko.1.2 以后默认使用 'smart','smart' 方式会根据是否支持 ControlPersist, 来判断'ssh' 方式是否可行.

ansible_ssh_private_key_file
#ssh 使用的私钥文件.适用于有多个密钥,而你不想使用 SSH 代理的情况.

ansible_shell_type 
#目标系统的shell类型.默认情况下,命令的执行使用 'sh' 语法,可设置为'csh' 或 'fish'.

ansible_python_interpreter 
#目标主机的 python 路径.适用于的情况: 系统中有多个 Python, 或者命令路径不是"/usr/bin/python",比如 \*BSD, 或者 /usr/bin/python 不是 2.X 版本的Python.之所以不使用 "/usr/bin/env" 机制,因为这要求远程用户的路径设置正确,且要求 "python" 可执行程序名不可为 python以外的名字(实际有可能名为python26).与ansible_python_interpreter 的工作方式相同,可设定如 ruby 或 perl 的路径....

如：

（1）指定多个被管理的主机地址

[web]
172.16.12.12
172.16.12.13
……

（2）指定ssh端口为非默认的端口

[server]
172.16.12.12:777
172.16.12.13:666
……

（3）指定连续的主机地址

[web]
172.16.12.[10:20]

（4）指定可嵌套组

[server:web]
server
web

（5）指定本地连接，无需ssh配置

[local]
172.16.12.10 ansible_connection=local

（6）指定远程管理的用户和密码

[web]
172.16.12.10  ansible_connection=ssh  ansible_ssh_port=2222  ansible_ssh_user=root ansible_ssh_password=123
172.16.12.20  ansible_connection=ssh  ansible_ssh_port=3333  ansible_ssh_user=root ansible_ssh_password=123

（7）执行ansible命令时显示别名

[websrvs]
host1 ansible_ssh_host=172.16.12.12
host2 ansible_ssh_host=172.16.12.13

3、Ansible 免密操作

[root@localhost ~]#vim /etc/ansible/hosts
[web]
172.16.12.12
172.16.12.13

[root@localhost ~]#ansible web -m ping -k
#-m代表使用的模块、ping代表ping模块、-k代表输入ssh连接密码

注：

-k指定输入ssh登录密码，只有一次密码输入的机会，如果所有机器密码不同就无法一起管理，所以建议ssh免密登录

方法一：修改ssh配置文件

[root@localhost ~]#vim /etc/ssh/ssh_config
StrictHostKeyChecking no     #在35行

方法二：修改ansible配置文件

[root@localhost ~]#vim /etc/ansible/ansible.cfg
host_key_checking = False

免密登录：

[root@localhost ~]#ssh-keygen
[root@localhost ~]#ssh-copy-id -i /root/.ssh/id_rsa.pub 172.16.12.12
[root@localhost ~]#ssh-copy-id -i /root/.ssh/id_rsa.pub 172.16.12.13

4、Ansible相关工具

/usr/bin/ansible：主程序，临时命令执行工具
/usr/bin/ansible-doc：查看配置文档，模块功能查看工具,相当于man ansible-doc -l |grep 关键字具体模块名字
/usr/bin/ansible-playbook：定制自动化任务，编排剧本工具,相当于脚本
/usr/bin/ansible-pull：远程执行命令的工具
/usr/bin/ansible-vault：文件加密工具
/usr/bin/ansible-console 基于Console界面与用户交互的执行工具
/usr/bin/ansible-galaxy 下载/上传优秀代码或Roles模块的官网平台

4.1 Ansible基础用法

执行临时任务一次性任务

ansible    <host-pattern>     [-m module_name]    [-a args]
命令     主机或者清单中的组      -m 指定模块       -a 执行的任务

选项	说明
--version	显示版本
-m module	指定模块，默认为command
-v	详细过程 -vv -vvv更详细
--list-hosts，--list	显示主机列表
-C, --check	检查，并不执行
-T, --timeout=TIMEOUT	执行命令的超时时间，默认10s
-k, --ask-pass	提示输入ssh连接密码，默认Key验证
-u, --user=REMOTE_USER	执行远程执行的用户，默认root
-b, --become	代替旧版的sudo 切换
--become-user=USERNAME	指定sudo的runas用户，默认为root vim /etc/sudoers 用户权限
-K, --ask-become-pass	提示输入sudo时的口令
-f FORKS, --forks FORKS	指定并发同时执行ansible任务的主机数

案例：

（1）显示主机列表

[root@localhost ~]#ansible web --list

（2）-m module默认command用法

[root@localhost ~]#ansible web -a "touch /opt/abc" -vv

（3）-f 并行执行

（4）提权操作

#远程主机172.16.12.12操作
[root@localhost ~]#visudo
dh      ALL=(ALL)       NOPASSWD: ALL

[root@localhost ~]#ansible 172.16.12.12 -m shell -a 'whoami' -u dh -k -b --become-user=dh

（5）主机列表相关操作
①支持通配符

ansible  all  -m  ping             
#执行一次计划任务  对all组内的主机执行ping命令
ansible  "*"  -m  ping 
#执行一次计划任务  对所有主机进行ping命令
ansible  172.16.12.* -m ping
#对172.16.12网段的主机执行ping
ansible  "srvs" -m ping
#指定srvs组的主机执行ping
ansible  "172.16.12.12 172.16.12.13" -m ping
#执行特定主机执行ping

②或关系

[root@localhost ~]#ansible 'web:accp' --list-hosts

③且关系

[root@localhost ~]#ansible "web:&accp" --list-hosts

④逻辑非

[root@localhost ~]#ansible 'web:!accp' --list-hosts

⑤正则表达式匹配

[root@localhost ~]#ansible "~(k|a).*" -m ping
#对Inventory中所有以 "k" 或 "a" 开头的主机执行 ping 模块，用以检查这些主机是否可达以及Ansible连接是否正常。
#波浪线 ~ 是用来做通配符扩展的标志

（6）ansible将模块或命令生成对应的临时py文件

[root@localhost ~]#ansible web -a "sleep 300" -f1
#在ansible执行命令的过程中，对面的远端主机上会生成对应的临时py文件，ansible命令执行完成，此临时py文件会被删除

注：

如果是在ansible命令执行的过程中强行中断，那么py临时文件就不会被删除，而是一直存在在远端主机上

Ansible命令执行过程

加载自己的配置文件,默认/etc/ansible/ansible.cfg
加载自己对应的模块文件，如：command
通过ansible将模块或命令生成对应的临时py文件，并将该文件传输至远程服务器的对应执行用户（$HOME/.ansible/tmp/ansible-tmp-数字/XXX.PY文件）
给文件+x执行
执行并返回结果
删除临时py文件，退出

执行返回结果：

可在/etc/ansible/ansible.cfg配置文件修改返回结果的颜色，一般默认即可

绿色：执行成功并且不需要做改变的操作
黄色：执行成功并且对目标主机做变更
红色：执行失败

4.2 Ansible-doc用法

用于查看 Ansible 模块的文档。它使得用户能够快速查看任何 Ansible 模块的详细信息，包括模块的参数、选项、示例以及用法说明

[root@localhost ~]#ansible-doc
#可查看ansible-doc用法和选项

[root@localhost ~]#ansible-doc -l
#查询所有的模块

[root@localhost ~]#ansible-doc -l | wc -l
#统计共有多少模块

[root@localhost ~]#ansible-doc -l | grep ^ping
#过滤以ping开头的模块

[root@localhost ~]#ansible-doc ping
#查询ping模块的详细信息及用法

[root@localhost ~]#ansible-doc -s ping
#查询ping模块的简单信息

4.3 Ansible-console

用于提供一个交互式的控制台界面，方便用户与远程主机进行交互和管理，支持tab，ansible 2.0+新增

执行用户@当前操作的主机组 (当前组的主机数量)[f:并发数]$

#如：
root@all (4)[f:5]$ cd web
root@web (2)[f:5]$ 
root@web (2)[f:5]$ forks 1
root@web (2)[f:1]$

命令	说明
forks n（forks 10）	设置并发数
cd 主机组（cd web）	切换组
list	列出当前组主机列表
?或help	列出所有的内置命令

[root@localhost ~]#ansible-console
cd web
list
ping

4.4 playbook

#此工具用于执行编写好的 playbook 任务
#示例
ansible-playbook hello.yml
cat hello.yml
---
#hello world yml file
- hosts: websrvs
 remote_user: root
 gather_facts: no
  
 tasks:
    - name: hello world
      command: /usr/bin/wall hello world

三、Ansible 模块

2015年底270多个模块，2016年达到540个，2018年01月12日有1378个模块，2018年07月15日1852个模块,2019年05月25日（ansible 2.7.10）时2080个模块，2020年03月02日有3387个模块虽然模块众多，但最常用的模块也就2，30个而已，针对特定业务只用10几个模块

常用模块帮助文档参考：
https://docs.ansible.com/ansible/2.9/modules/modules_by_category.html
https://docs.ansible.com/ansible/2.9/modules/list_of_all_modules.html
https://docs.ansible.com/ansible/latest/modules/list_of_all_modules.html
https://docs.ansible.com/ansible/latest/modules/modules_by_category.html

1、Command 模块

功能：在远程主机执行命令，此为默认模块，可忽略 -m 选项

注：

此命令不支持 $VARNAME < >(重定向) |(管道符) ; (并行) &(后台) 等，可能用shell模块实现
此模块不具有幂等性（幂等性：指一个操作被多次执行，结果和仅执行一次的情况相同。换句话说，无论操作被执行多少次，结果都保持一致）

[root@localhost ~]#ansible web -a "cp /etc/fstab /opt"
#将web组内主机各自的/etc/fstab文件拷贝到各自的/opt目录下

[root@localhost ~]#ansible web -a "echo $PATH"
#打印web组内所有主机的环境变量

[root@localhost ~]#ansible web -a "echo hello > /opt/abc"

[root@localhost ~]#ansible web -m shell -a "echo hello > /opt/abc"

2、Shell 模块

功能：和command相似，用shell执行命令，支持各种符号，比如:*,$, >

注：

此模块不具有幂等性（幂等性：指一个操作被多次执行，结果和仅执行一次的情况相同。换句话说，无论操作被执行多少次，结果都保持一致）

[root@localhost ~]#ansible web -m shell -a "echo hello > aaa"

原来默认的是command模块，但可以通过修改默认模块，来支持shell模块

[root@localhost ~]#vim /etc/ansible/ansible.cfg
module_name shell

3、Script 模块

功能：在远程主机上运行ansible服务器上的脚本(无需执行权限)

注：

此模块不具有幂等性（幂等性：指一个操作被多次执行，结果和仅执行一次的情况相同。换句话说，无论操作被执行多少次，结果都保持一致）

[root@localhost ~]#cd /mnt
[root@localhost mnt]#vim test.sh
#!/bin/bash
mkdir -p /opt/a/b/c    #递归建立文件夹

[root@localhost mnt]#ansible web -m script -a "/mnt/test.sh"

4、Copy 模块

功能：从ansible服务器主控端复制文件到远程主机

注:

src=file 如果是没指明路径，则为当前目录或当前目录下的files目录下的file文件

关键字：

src       #代表源文件路径
dest      #代表文件落地路径
owner     #属主
group     #属组
mode      #代表权限
backup    #如果复制时有同名文件会先备份再复制（源文件要有改动，才会备份）

[root@localhost mnt]#ansible web -m copy -a "src=/etc/fstab dest=/opt/ owner=dh group=dh mode=644"
#将ansible服务器上的/etc/fstab文件拷贝到web组的所有远端主机的/opt目录下，且属主为dh，属组为dh，文件权限为644

backup 的应用：

要先为已存在的fstab修改内容，只有变动才会有备份，没有变动会默认直接覆盖

[root@localhost mnt]#ansible web -m copy -a "src=/etc/fstab dest=/opt/ owner=dh group=dh mode=777 backup=yes"
#开启备份文件

拓展：

不加 / 与加 / 的区别

（1）不加 / 时
[root@localhost mnt]#ansible web -m copy -a "src=/mnt dest=/opt"
（2）加 / 时
[root@localhost mnt]#ansible web -m copy -a "src=/mnt/ dest=/opt"
注：/mnt后不加 / 连mnt一起拷贝

/mnt后加 / 只复制mnt下的文件

5、Fetch 模块

功能：从远程主机提取文件至ansible的主控端，copy相反，目前不支持目录，如果要传目录，只能将该目录打包成压缩包传送

[root@localhost mnt]#ansible web -m fetch -a 'src=/opt/test dest=/mnt'

[root@localhost mnt]#ansible 172.16.12.12 -m fetch -a "src=/opt/data.tar.gz dest=/mnt"

6、Get_url 模块

功能: 用于将文件从http、https 或 ftp 下载到被管理机节点上

#常用参数如下
url: 下载文件的URL,支持HTTP，HTTPS或FTP协议
 
dest:下载到目标路径（绝对路径），如果目标是一个目录，就用服务器上面文件的名称，如果目标设置了名称就用目标设置的名称
 
owner：指定属主
group：指定属组
mode：指定权限
 
force:如果yes，dest不是目录，将每次下载文件，如果内容改变，替换文件。如果否，则只有在目标不存在时才会下载该文件
 
checksum:对目标文件在下载后计算摘要，以确保其完整性
#checksum后面不要忘记加md5： ###
 
url_username：用于HTTP基本认证的用户名。对于允许空密码的站点，此参数可以不使用`url_password'
url_password：用于HTTP基本认证的密码。如果未指定`url_username'参数，则不会使用`url_password'参数
validate_certs：如果“no”，SSL证书将不会被验证。适用于自签名证书在私有网站上使用
timeout: URL请求的超时时间,秒为单位

[root@localhost mnt]#ansible web -m get_url -a 'url=https://nginx.org/download/nginx-1.18.0.tar.gz dest=/opt'

[root@localhost opt]#md5sum nginx-1.18.0.tar.gz
#根据md5sum值来对比下载的软件包是否被修改过源码，或者是否植入了病毒

7、 File 模块

功能：设置文件属性，创建软链接等

关键字：

path   	#指定文件路径
state  	#文件状态 有：新建(touch) 删除(absent) 文件夹(directory)  连接文件(link)等
src    	#源文件
mode   	#权限
owner  	#属主
group  	#属组
recurse	#递归（修改属性时生效）

7.1 新建空文件

[root@localhost mnt]#ansible web -m file -a 'path=/opt/abc.txt state=touch owner=dh group=dh mode=644'
#在ansible服务器上集中管理web组远端主机，即在这些远端主机上的opt目录下创建abc.txt文件，且属主为dh，属组为dh，文件权限为644

7.2 新建目录

[root@localhost mnt]#ansible web -m file -a 'path=/opt/data state=directory'

7.3 递归创建目录

[root@localhost mnt]#ansible web -m file -a 'path=/opt/aa/bb/cc state=directory'

7.4 删除文件或目录

删除文件：

[root@localhost mnt]#ansible web -m file -a 'path=/opt/abc.txt state=absent'

删除目录：

8、Stat 模块

功能：检查文件或文件系统的状态

注：

对于Windows目标，请改用win_stat模块

选项：

path：文件/对象的完整路径（必须）

常用的返回值判断：

exists： 判断是否存在
isuid：  调用用户的ID与所有者ID是否匹配

[root@localhost mnt]#ansible web -m stat -a 'path=/opt/data'

[root@localhost mnt]#ansible web -m stat -a 'path=/opt/abc.txt'

9、Unarchive 模块

功能：解压缩包

实现有两种用法：

1、将ansible主机上的压缩包传到远程主机后解压缩至特定目录，设置copy=yes，此为默认值，可省略

2、将远程主机上的某个压缩包解压缩到指定路径下，设置copy=no

常见参数：

copy：默认为yes，当copy=yes，拷贝的文件是从ansible主机复制到远程主机上，如果设置为copy=no，会在远程主机上寻找src源文件
 
remote_src：和copy功能一样且互斥，yes表示在远程主机，不在ansible主机，no表示文件在ansible主机上
 
src：源路径，可以是ansible主机上的路径，也可以是远程主机(被管理端或者第三方主机)上的路径，如果是远程主机上的路径，则需要设置copy=no
 
dest：远程主机上的目标路径
 
mode：设置解压缩后的文件权限

9.1 将ansible端的压缩包解压到远端主机

[root@localhost mnt]#ansible web -m unarchive -a "src=/mnt/test.tar.gz dest=/opt"

9.2 将远端主机的压缩包解压到指定目录

[root@localhost mnt]#ansible web -m unarchive -a "src=/opt/usr.tar.gz dest=/mnt copy=no"

9.3 将远端主机的压缩包解压至指定目录

[root@localhost mnt]#ansible web -m unarchive -a 'src=https://nginx.org/download/nginx-1.18.0.tar.gz dest=/mnt copy=no'

10、Archive 模块

功能：打包压缩保存在被管理节点

压缩远端主机上的指定内容到远端主机上（只对远端有效）

[root@localhost mnt]#ansible web -m archive -a "path=/opt dest=/mnt/all.tar.bz2 format=bz2 owner=dh mode=0600"

11、Hostname 模块

功能：管理主机名

ansible 172.16.12.12 -m hostname -a 'name=dhxz1'

12、Cron 模块

功能：计划任务

支持时间：minute，hour，day，month，weekday

关键字：

name  #会生成一行注释，显示标题如下显示
job   #执行的命令

12.1 创建远端主机的启用的计划任务

[root@localhost mnt]#ansible web -m cron -a 'hour=*/2 weekday=1-5 name="backup mysql" job=/root/mysql_backup.sh'

12.2 创建远端主机不启用的计划任务

disabled=yes：表示不启用

[root@localhost mnt]#ansible web -m cron -a 'hour=*/2 weekday=1-5 name="backup mysql" job=/root/mysql_backup.sh disabled=yes'

12.3 删除远端主机的计划任务

[root@localhost mnt]#ansible web -m cron -a "name='backup mysql' state=absent"

13、Yum和Apt模块

功能：yum 管理软件包，只支持RHEL，CentOS，fedora，不支持Ubuntu其它版本；apt 模块管理 Debian 相关版本的软件包

关键字：

name参数：必须参数，用于指定需要管理的软件包
state参数：用于指定软件包的状态 ，默认值为。present，表示确保软件包已经安装，除了。present，其他可用值有 installed、latest、absent、removed，其中 installed 与present 等效，latest 表示安装 yum 中最新的版本，absent和removed 等效，表示删除对应的软件包。
disable_gpg_check参数：	用于禁用对 rpm 包的公钥 gpg 验证。默认值为 no，表示不禁用验证，设置为 yes 表示禁用验证，即不验证包，直接安装。在对应的 yum 源没有开启 gpg 验证的情况下，需要将此参数的值设置为 yes，否则会报错而无法进行安装。
enablerepo参数：用于指定安装软件包时临时启用的 yum 源。假如你想要从A源中安装软件，但是你不确定A源是否启用了，你可以在安装软件包时，将此参数的值设置为 yes，即使A源的设置是未启用，也可以在安装软件包时临时启用A源。
disablerepo参数：用于指定安装软件包时临时禁用的 yum 源。某些场景下需要此参数，比如，当多个 yum 源中同时存在要安装的软件包时，你可以使用此参数临时禁用某个源，这样设置后，在安装软件包时则不会从对应的源中选择安装包。
#其中enablerepo 参数和 disablerepo 参数可以同时使用
 
#如
name			 　　所安装的包的名称
state         　　   present--->安装， latest--->安装最新的, absent---> 卸载软件
update_cache　　     强制更新yum的缓存
conf_file　　        指定远程yum安装时所依赖的配置文件（安装本地已有的包）
disable_pgp_check　　是否禁止GPG checking，只用于presentor latest
disablerepo　　      临时禁止使用yum库。 只用于安装或更新时
enablerepo　　       临时使用的yum库。只用于安装或更新时

13.1 在远端主机上安装软件

[root@localhost mnt]#ansible web -m yum -a 'name=httpd state=present'

13.2 在远端主机上卸载软件

[root@localhost mnt]#ansible web -m yum -a 'name=httpd state=absent'

#其他用法
ansible web -m yum -a 'name=nginx state=present enablerepo=epel'  
#启用epel源进行安装nginx
 
ansible web -m yum -a 'name=* state=lastest exclude=kernel*,foo*' 
#升级除kernel和foo开头以外的所有包，建议不要

14、Yum_repository 模块

功能：建立yum仓库模块

关键字：

name参数：必须参数，用于指定要操作的唯一的仓库ID，也就是”.repo”配置文件中每个仓库对应的”中括号”内的仓库ID
baseurl参数：此参数用于设置 yum 仓库的 baseurl
description参数：此参数用于设置仓库的注释信息，也就是”.repo”配置文件中每个仓库对应的”name字段”对应的内容
file参数：此参数用于设置仓库的配置文件名称，即设置”.repo”配置文件的文件名前缀，在不使用此参数的情况下，默认以 name 参数的仓库ID作为”.repo”配置文件的文件名前缀，同一个”.repo” 配置文件中 可以存在多个 yum 源
enabled参数：此参数用于设置是否激活对应的 yum 源，此参数默认值为 yes，表示启用对应的 yum 源，设置为 no 表示不启用对应的 yum 源
gpgcheck参数：此参数用于设置是否开启 rpm 包验证功能，默认值为 no，表示不启用包验证，设置为 yes 表示开启包验证功能
gpgcakey参数：当 gpgcheck 参数设置为 yes 时，需要使用此参数指定验证包所需的公钥
state参数：默认值为 present，当值设置为 absent 时，表示删除对应的 yum 源

为yum仓库添加epel额外源：

[root@localhost ~]#ansible web -m yum_repository -a 'name=epel description=epel  baseurl=https://download.fedoraproject.org/pub/epel/$releasever/$basearch/ gpgcheck=no file=epel'

安装nginx软件，测试添加的epel源是否有问题：

15、Service 模块

功能：管理服务

关键字：

name参数：此参数用于指定需要操作的服务名称，比如 nginx
state参数：此参数用于指定服务的状态，比如，我们想要启动远程主机中的 nginx，则可以将 state 的值设置为 started；如果想要停止远程主机中的服务，则可以将 state 的值设置为 stopped。此参数的可用值有 started、stopped、restarted、reloaded
enabled参数：此参数用于指定是否将服务设置为开机 启动项，设置为 yes 表示将对应服务设置为开机启动，设置为 no 表示不会开机启动

#如：
ansible web -m service -a 'name=httpd state=started enabled=yes'
#管理httpd服务 ，让其开机启动
ansible web -m service -a 'name=httpd state=stopped'
#管理httpd服务 ，让其停止服务
ansible web -m service -a 'name=httpd state=reloaded'
#管理httpd服务 ，让其重新加载配置
ansible web -m service -a 'name=httpd state=restarted'
#管理httpd服务 ，让其重启

16、Mount 挂载和卸载

功能: 挂载和卸载文件系统

#如：
#临时挂载
mount web  -m mount -a 'src="UUID=b3e48f45-f933-4c8e-a700-22a159ec9077" path=/home fstype=xfs opts=noatime state=present'

#临时取消挂载
mount web  -m mount -a 'path=/home fstype=xfs opts=noatime state=unmounted'

#永久挂载
ansible web  -m mount -a 'src=172.16.12.12:/data/wordpress path=/var/www/html/wp-content/uploads opts="_netdev" state=mounted'

#永久取消挂载
ansible web -m mount -a 'src=1172.16.12.12:/data/wordpress path=/var/www/html/wp-content/uploads state=absent'

[root@localhost ~]#ansible web -a 'blkid'

17、User 模块

功能：管理用户

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

[root@localhost ~]#ansible web -m user -a "name=mimi comment='test user' uid=5000 group=root"
#创建用户

18、Group 模块

功能：管理组

[root@localhost ~]#ansible web -m group  -a 'name=user gid=88 system=yes'
#新建组

[root@localhost ~]#ansible web -m group -a "name=user state=absent"
#删除组

19、Reboot 模块

[root@ansible ~]#ansible web  -m reboot
#web组内所有远端主机都重启

20、Lineinfile 模块

ansible在使用sed进行替换时，经常会遇到需要转义的问题，而且ansible在遇到特殊符号进行替换时，存在问题，无法正常进行替换。其实在ansible自身提供了两个模块：lineinfile模块和replace模块，可以方便的进行替换一般在ansible当中去修改某个文件的单行进行替换的时候需要使用lineinfile模块

regexp参数：使用正则表达式匹配对应的行，当替换文本时，如果有多行文本都能被匹配，则只有最后面被匹配到的那行文本才会被替换，当删除文本时，如果有多行文本都能被匹配，这么这些行都会被删除

如果想进行多行匹配进行替换需要使用replace模块

功能：相当于sed，可以修改文件内容

关键字：

path	        指定要操作的文件
regexp	        使用正则表达式匹配对应的行
line	        修改为新的内容
insertafter	    将文本插入到“指定的行”之后
insertbefore	将文本插入到“指定的行”之前
state	        删除对应的文本时，需要state=absent
backrefs	    1.支持后向引用、2.当未匹配到内容则不操作文件
backup	        是否在修改文件之前对文件进行备份
create	        当要操作的文件并不存在时，是否创建对应的文件

[root@localhost ~]#ansible web -m lineinfile  -a 'dest=/etc/fstab state=absent regexp="^#"'
#将远端主机/etc/fstab中，所有以#开头的行全部删除

[root@localhost ~]#ansible web -m lineinfile -a "path=/etc/httpd/conf/httpd.conf regexp='^Listen' line='Listen 80'"

[root@localhost ~]#ansible web -m lineinfile -a "path=/etc/selinux/config regexp='^SELINUX=' line='SELINUX=disabled'"

21、Replace 模块

该模块有点类似于sed命令，主要也是基于正则进行匹配和替换，建议使用

[root@localhost ~]#ansible web -m replace -a "path=/etc/fstab regexp='^(UUID.*)' replace='#\1'" 
#在远端主机注释/etc/fstab文件中以UUID开头的行

[root@localhost ~]#ansible web -m replace -a "path=/etc/fstab regexp='^#(UUID.*)' replace='\1'"
#在远程主机的/etc/fstab文件中，查找以#开头且紧跟UUID的行，并去掉这些行开头的#符号，使原本被注释掉的挂载点配置恢复生效

[root@localhost ~]#ansible web -m replace -a "path=/etc/httpd/conf/httpd.conf regexp='^Listen.*' replace='Listen 80'"
#将远端主机/etc/httpd/conf/httpd.conf中Listen开头的行，修改为Listen 80

22、Setup 模块

功能： setup 模块用于收集有关主机的信息。这个命令会在主机上运行 setup 模块，这个模块会收集有关主机的各种信息，如操作系统、内存、CPU、网络、磁盘等

这些 facts 信息可以直接以变量的形式使用，但是如果主机较多，会影响执行速度

可以使用 gather_facts: no 来禁止 Ansible 收集 facts 信息

案例：

ansible all -m setup
#获取远程主机所有信息
ansible all -m setup -a "filter=ansible_nodename"
#获取远程主机的nodename（节点名称）信息
ansible all -m setup -a "filter=ansible_hostname"
#输出每个主机的hostname（主机名）
ansible all -m setup -a "filter=ansible_domain"
#获取远程主机的域名（domain）信息
ansible all -m setup -a "filter=ansible_memtotal_mb"
#为了获取远程主机的总内存大小（以MB为单位）
ansible all -m setup -a "filter=ansible_memory_mb"
#获取远程主机的内存信息（以MB为单位）
ansible all -m setup -a "filter=ansible_memfree_mb"
#为了获取远程主机的可用内存大小（以MB为单位）
ansible all -m setup -a "filter=ansible_os_family"
#为了获取远程主机的操作系统家族信息
ansible all -m setup -a 'filter=ansible_distribution'
#为了获取远程主机是什么系统，如centos,suse等
ansible all -m setup -a "filter=ansible_distribution_major_version"
#为了获取远程主机操作系统的主要版本号
ansible all -m setup -a "filter=ansible_distribution_version"
#为了获取远程主机操作系统的完整版本号
ansible all -m setup -a "filter=ansible_processor_vcpus"
#为了获取远程主机的逻辑CPU核心数（包括超线程虚拟的核心）
ansible all -m setup -a "filter=ansible_all_ipv4_addresses"
#为了获取远程主机的所有IPv4地址
ansible all -m setup -a "filter=ansible_architecture"
#为了获取远程主机的架构类型信息
ansible all -m setup -a "filter=ansible_uptime_seconds"
#为了获取远程主机的运行时间（以秒为单位）
ansible all -m setup -a "filter=ansible_processor*"
#为了获取远程主机处理器（CPU）相关的所有信息
ansible all -m setup -a 'filter=ansible_env'
#为了获取远程主机的环境变量信息
ansible all -m setup -a 'filter=ansible_devices'
#为了获取远程主机的磁盘设备信息
ansible all -m setup -a 'filter=ansible_machine'
#为了获取远程主机的系统类型，例:32位，还是64位
ansible all -m setup -a 'filter=ansible_eth0'
#为了获取远程主机的eth0的信息
ansible all -m setup -a 'filter=ansible_kernel'
#为了获取远程主机的内核版本
ansible all -m setup -a 'filter=ansible_lvm'
#为了获取远程主机的Ivm相关信息
ansible all -m setup -a 'filter=ansible_swaptotal_mb'
#为了获取远程主机总的swap内存
ansible all -m setup -a 'filter=ansible_swapfree_mb'
#为了获取远程主机swap内存的可用内存
ansible all -m setup -a 'filter=ansible_ansible_mounts'
#为了获取远程主机系统磁盘的挂载情况
ansible all -m setup -a 'filter=ansible_python_version'
#为了获取远程主机的python版本