运维自动化之ansible工具

目录

前言

[一、Ansible 工具概述](#一、Ansible 工具概述)

[1、Ansible 功能](#1、Ansible 功能)

[2、Ansible 特性](#2、Ansible 特性)

[3、Ansible 优缺点](#3、Ansible 优缺点)

[4、Ansible 架构](#4、Ansible 架构)

[4.1 Ansible 组成](#4.1 Ansible 组成)

[4.2 Ansible 命令执行来源](#4.2 Ansible 命令执行来源)

[二、Ansible 安装和基础用法](#二、Ansible 安装和基础用法)

[1、Ansible 安装](#1、Ansible 安装)

[1.1 yum源安装](#1.1 yum源安装)

[1.2 使用python编译安装](#1.2 使用python编译安装)

[1.3 Git方式安装](#1.3 Git方式安装)

[2、Ansible 相关文件](#2、Ansible 相关文件)

[2.1 ansible 主配置文件](#2.1 ansible 主配置文件)

[2.2 inventory 主机清单文件](#2.2 inventory 主机清单文件)

[3、Ansible 免密操作](#3、Ansible 免密操作)

4、Ansible相关工具

[4.1 Ansible基础用法](#4.1 Ansible基础用法)

[4.2 Ansible-doc用法](#4.2 Ansible-doc用法)

[4.3 Ansible-console](#4.3 Ansible-console)

[4.4 playbook](#4.4 playbook)

[三、Ansible 模块](#三、Ansible 模块)

[1、Command 模块](#1、Command 模块)

[2、Shell 模块](#2、Shell 模块)

[3、Script 模块](#3、Script 模块)

[4、Copy 模块](#4、Copy 模块)

[5、Fetch 模块](#5、Fetch 模块)

[6、Get_url 模块](#6、Get_url 模块)

[7、 File 模块](#7、 File 模块)

[7.1 新建空文件](#7.1 新建空文件)

[7.2 新建目录](#7.2 新建目录)

[7.3 递归创建目录](#7.3 递归创建目录)

[7.4 删除文件或目录](#7.4 删除文件或目录)

[8、Stat 模块](#8、Stat 模块)

[9、Unarchive 模块](#9、Unarchive 模块)

[9.1 将ansible端的压缩包解压到远端主机](#9.1 将ansible端的压缩包解压到远端主机)

[9.2 将远端主机的压缩包解压到指定目录](#9.2 将远端主机的压缩包解压到指定目录)

[9.3 将远端主机的压缩包解压至指定目录](#9.3 将远端主机的压缩包解压至指定目录)

[10、Archive 模块](#10、Archive 模块)

[11、Hostname 模块](#11、Hostname 模块)

[12、Cron 模块](#12、Cron 模块)

[12.1 创建远端主机的启用的计划任务](#12.1 创建远端主机的启用的计划任务)

[12.2 创建远端主机不启用的计划任务](#12.2 创建远端主机不启用的计划任务)

[12.3 删除远端主机的计划任务](#12.3 删除远端主机的计划任务)

13、Yum和Apt模块

[13.1 在远端主机上安装软件](#13.1 在远端主机上安装软件)

[13.2 在远端主机上卸载软件](#13.2 在远端主机上卸载软件)

[14、Yum_repository 模块](#14、Yum_repository 模块)

[15、Service 模块](#15、Service 模块)

[16、Mount 挂载和卸载](#16、Mount 挂载和卸载)

[17、User 模块](#17、User 模块)

[18、Group 模块](#18、Group 模块)

[19、Reboot 模块](#19、Reboot 模块)

[20、Lineinfile 模块](#20、Lineinfile 模块)

[21、Replace 模块](#21、Replace 模块)

[22、Setup 模块](#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版本