本文最后更新于 1220 天前，其中的信息可能已经有所发展或是发生改变。

Linux-Ansible学习手杂

Ansible 介绍

Ansible是一个配置管理和配置工具，使用SSH连接到服务器并运行配置好的任务，服务器上不需要安装任何其他软件，只需要开启SSH，客户端的ansible会完成所有其他的工作。

上图为ansible的基本架构，从上图可以了解到其由以下部分组成：

核心：ansible
核心模块（Core Modules）：这些都是ansible自带的模块
扩展模块（Custom Modules）：如果核心模块不足以完成某种功能，可以添加扩展模块
插件（Plugins）：完成模块功能的补充
剧本（Playbooks）：ansible的任务配置文件，将多个任务定义在剧本中，由ansible自动执行
连接插件（Connectior Plugins）：ansible基于连接插件连接到各个主机上，虽然ansible是使用ssh连接到各个主机的，但是它还支持其他的连接方法，所以需要有连接插件
主机群（Host Inventory）：定义ansible管理的主机

Ansible 部署

YUM方式安装

# debian & Ubuntu
sudo apt-get install ansible

# mac os 
brew install ansible

# Centos 
yum install ansible

# pip
sudo pip install ansible

Centos-安装信息:

# 添加Ansible源
cat <<EOF> /etc/yum.repos.d/tsinghua.repo
[ansible]
name=ansible
baseurl=https://mirror.tuna.tsinghua.edu.cn/epel/7/x86_64/
gpgcheck=0
EOF

# 安装Ansible
yum -y install ansible

正在安装:
 ansible noarch 2.9.25-1.el7
为依赖而安装:
 python-babel noarch 0.9.6-8.el7
 python-jinja2 noarc2.7.2-4.el7
 python-markupsafe x86_64 0.11-10.el7  
 python-paramiko noarch2.1.1-9.el7        
 python2-httplib2 noarch    0.18.1-3.el7                                             
 python2-jmespath noarch 0.9.4-2.el7                                               
 sshpass x86_64 1.06-2.el7  

 # 验证Ansible
ansible --version

源码方式安装

# 安装git客户端/gcc编译包
yum install git gcc-c++ 

# 拉取源码
git clone https://github.com/ansible/ansible.git /usr/local/ansible

# 执行安装文件
source /usr/local/ansible/hacking/env-setup

# 验证Ansible
ansible --version

安装好 Ansible 后，我们可以在 /etc/ansible/ 的目录底下找到 Ansible 的一些配置文件.

公司通常把 ansible.cfg 和 hosts 这两个配置文件与其它的 Playbooks 放在同个目录下，然后通过git把它们一起管理起来防止出现不必要的问题.

Ansible 配置文件介绍

目录结构介绍

通过如下命令我们可以获取Ansible所有文件存放目录：

# 查看ansible 安装目录结构
rpm -ql ansible

该命令输出内容较多，大致分为如下几类：

描述	路径
配置文件目录	/etc/ansible/
执行文件目录	/usr/bin/
Lib库依赖目录	/usr/lib/pythonX.X/site-packages/ansible/
Help 文档目录	/usr/share/doc/ansible-X.X.X/
Man文档目录	/usr/share/man/manl/

Ansible配置文件解析（ansible.cfg）

Inventory 用于定义 Ansible 的主机列表配置， Ansible 的自身配置文件只有一个，即ansible.cfg, Ansible 安装好后它默认存放于/etc/ansible/ 目录下。

ansible.cfg 配置文件可以存在于多个地方， Ansible 读取配置文件的顺序依次是当前命令执行目录→用户家目录下的。ansible.cfg→ /etc/ansible.cfg, 先找到哪个就使用哪个的配置。其 ansible.cfg 配置的所有内容均可在命令行通过参数的形式传递或定义在 Playbooks 中。目前ansible 配置文件有四种，如下显示：

使用/etc/ansible/ansible.cfg

ansible 软件包提供一个基本的配置文件，它位于/etc/ansible/ansible.cfg如果找不到其他配置文件，则使用此文件。

使用～/ansible.cfg

Ansible 在用户的主目录中查找 .ansible.cfg 文件。如果存在此配萱并且当前工作目录中也没有ansible.cfg 文件，则使用此配置取代/etc/ansible/ansible.cfg。

使用./ansible.cfg

如果执行ansible 命令的目录中存在ansible.cfg 文件，则使用它，而不使用全局文件或用户的个入文件。这样，管理员可以创建一种目录结构，将不同的环境或项目存储在单独的目录中，并且每一目录包含为独特的一组设置而定制的配置文件。

使用ANSIBLE_CONFIG 环境变量

通过ANSIBLE_CONFIG 环境变量定义配萱文件的位置。定义了此变量时，Ansible 将使用变量所指定的配置文件，而不用上文中提及的任何配置文件。

这四种文件的优先级为

ANSIBLE_CONFIG环境变量 > ./ansible.cfg > ～/ansible.cfg > /etc/ansible/ansible.cfg

配置文件 ansible.cfg 约有 500 行语句，大多数为注释行默认配置项。该文件遵循 INI 格式，主要常修改配置如下:

inventory      = /etc/ansible/hosts # 定义的inventory文件
library        = /usr/share/my_modules/ # 自定义lib库存放目录
forks          = 5 # 默认并发数
poll_interval  = 15 # 默认轮询时间间隔
sudo_user      = root # 默认sudo用户
remote_port    = 22 # 默认远程ssh 端口
host_key_checking = False  #第一次交互目标主机，需要输入yes/no,改成False不用输入
timeout = 10 # 设置SSH连接的超时时间，单位为秒
log_path = /var/log/ansible.log    #设置日志路径

Ansible 管理主机配置文件解析（Inventory）

Inventory 是 Ansible 管理主机信息的配置文件，相当于系统 HOSTS 文件的功能，默认存放在/etc/ansible/hosts。为方便批量管理主机，便捷使用其中的主机分组.

内置变量清单

主机连接配置

ansible_connection：与主机的连接类型。可以是ansible的连接插件的名称。SSH协议类型为smart、ssh或paramiko。默认值是smart。

所有连接配置

ansible_host：要连接到远程主机的名称。

ansible_port：要连接到远程主机的端口，默认为22。

ansible_user：连接到远程主机的用户名。

ansible_password：连接到远程主机的用户名密码。

SSH连接配置

ansible_ssh_private_key_file：ssh使用的私有文件，适用于有多个秘钥，但不想使用ssh agent情况。

ansible_ssh_common_args：该设置附加到默认的sftp、scp和ssh命令行上。

ansible_sftp_extra_args：该设置总是附加到默认的sftp命令行上。

ansible_scp_extra_args：该设置总是附加到默认的scp命令行上。

ansible_ssh_extra_args：该设置总是附加到默认的ssh命令行上。

ansible_ssh_pipelining：确定是否使用SSH pipelining，该参数会覆盖ansible.cfg中的pipelining设置。

ansible_ssh_executable：此设置会覆盖使用系统ssh的默认行为，会覆盖ansible.cfg中的ssh_executable参数。

如果只有一个 Inventory 时可不用指定路径，默认读取/etc/ansible/hosts,Inventory 可以同时存在多个.

参考示例：

## 直接指明主机地址或主机名：
192.168.1.88
192.168.1.34
192.168.1.33

## 定义一个主机组[组名]把地址或主机名加进去
[docker]
192.168.1.88
## 192.168.1.33,192.168.1.34
192.168.1.3[3:4]

[docker:vars]
## 加上这个就不用输入密码，也不用密钥,但是真心不建议密码明文写在这里
ansible_password='密码'
## 端口
ansible_port=22
## 可设置登录用户
ansible_user='test'

[ansible:children]
docker

Ansible 通过Inventory 来定义其主机和组，在使用时通过－i 或 –inventory-file 指定读取，与 Ansible 命令结合使用时组合如下：

ansible -i /etc/ansible/hosts docker -m ping

Ansible 常用命令

Ansible 命令集

/usr/bin/ansible　　# Ansibe AD-Hoc 临时命令执行工具，常用于临时命令的执行
/usr/bin/ansible-doc 　　# Ansible 模块功能查看工具
/usr/bin/ansible-galaxy　　# 下载/上传优秀代码或Roles模块 的官网平台，基于网络的
/usr/bin/ansible-playbook　　# Ansible 定制自动化的任务集编排工具
/usr/bin/ansible-pull　　# Ansible远程执行命令的工具，拉取配置而非推送配置（使用较少，海量机器时使用，对运维的架构能力要求较高）
/usr/bin/ansible-vault　　# Ansible 文件加密工具
/usr/bin/ansible-console　　# Ansible基于Linux Consoble界面可与用户交互的命令执行工具

其中，我们比较常用的是/usr/bin/ansible和/usr/bin/ansible-playbook

Ansible 命令详解

命令的具体格式如下：

ansible <host-pattern> [-f forks] [-m module_name] [-a args]

也可以通过ansible -h来查看帮助，下面我们列出一些比较常用的选项，并解释其含义：

-a MODULE_ARGS #模块的参数，如果执行默认COMMAND的模块，即是命令参数，如： “date”，“pwd”等等
-k，--ask-pass #ask for SSH password。登录密码，提示输入SSH密码而不是假设基于密钥的验证
--ask-su-pass #ask for su password。su切换密码
-K，--ask-sudo-pass #ask for sudo password。提示密码使用sudo，sudo表示提权操作
--ask-vault-pass #ask for vault password。假设我们设定了加密的密码，则用该选项进行访问
-B SECONDS #后台运行超时时间
-C #模拟运行环境并进行预运行，可以进行查错测试
-c CONNECTION #连接类型使用
-f FORKS #并行任务数，默认为5
-i INVENTORY #指定主机清单的路径，默认为/etc/ansible/hosts
--list-hosts #查看有哪些主机组
-m MODULE_NAME #执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数
-o #压缩输出，尝试将所有结果在一行输出，一般针对收集工具使用
-S #用 su 命令
-R SU_USER #指定 su 的用户，默认为 root 用户
-s #用 sudo 命令
-U SUDO_USER #指定 sudo 到哪个用户，默认为 root 用户
-T TIMEOUT #指定 ssh 默认超时时间，默认为10s，也可在配置文件中修改
-u REMOTE_USER #远程用户，默认为 root 用户
-v #查看详细信息，同时支持-vvv，-vvvv可查看更详细信息

Ansible 配置公私钥

上面我们已经提到过 ansible 是基于 ssh 协议实现的，所以其配置公私钥的方式与 ssh 协议的方式相同，具体操作步骤如下：

ssh-keygen -t rsa
ssh-copy-id root@192.168.1.88
ssh-copy-id root@192.168.1.33
ssh-copy-id root@192.168.1.34

Ansible 常用模块

1. 主机连通性测试(ping模块)

我们使用ansible docker -m ping命令来进行主机连通性测试，效果如下：

[root@app31 .ssh]# ansible docker -m ping
192.168.1.34 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
192.168.1.33 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
192.168.1.88 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

这样就说明我们的主机是连通状态的

2. command 模块

这个模块可以直接在远程主机上执行命令，并将结果返回本主机。如:ansible docker -m command -a 'df -h'

# 查询磁盘
[root@app31 .ssh]# ansible docker -m command -a 'df -h'
192.168.1.34 | SUCCESS | rc=0 >>
文件系统                 容量  已用  可用 已用% 挂载点
/dev/mapper/centos-root   50G  6.0G   45G   12% /
devtmpfs                  16G     0   16G    0% /dev
192.168.1.33 | SUCCESS | rc=0 >>
文件系统                 容量  已用  可用 已用% 挂载点
/dev/mapper/centos-root   50G   13G   38G   25% /
devtmpfs                  16G     0   16G    0% /dev
192.168.1.88 | SUCCESS | rc=0 >>
文件系统                 容量  已用  可用 已用% 挂载点
devtmpfs                  48G     0   48G    0% /dev
tmpfs                     48G     0   48G    0% /dev/shm

# #先切换到/data/ 目录在ls查看信息
[root@app31 .ssh]# ansible docker -m command -a 'chdir=/data ls'
192.168.1.34 | SUCCESS | rc=0 >>
es
mysql
192.168.1.88 | SUCCESS | rc=0 >>
20210415
yarn
192.168.1.33 | SUCCESS | rc=0 >>

命令模块接受命令名称，后面是空格分隔的列表参数。给定的命令将在所有选定的节点上执行。它不会通过shell进行处理，比如$HOME和操作如”<“，”>”，”|”，”;”，”&” 工作（需要使用（shell）模块实现这些功能）。

注意，该命令不支持| 管道命令。

3. shell 模块

shell模块可以在远程主机上调用shell解释器运行命令，支持shell的各种功能，例如管道等。如:ansible docker -m shell -a 'cat /etc/passwd | grep root'

[root@app31 home]# ansible docker -m shell -a 'cat /etc/passwd | grep root'
192.168.1.34 | SUCCESS | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin
192.168.1.88 | SUCCESS | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin
192.168.1.33 | SUCCESS | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin

[root@app31 home]# ansible docker -m shell -a 'echo $USER'
192.168.1.34 | SUCCESS | rc=0 >>
root
192.168.1.88 | SUCCESS | rc=0 >>
root
192.168.1.33 | SUCCESS | rc=0 >>
root

只要是我们的shell命令，都可以通过这个模块在远程主机上运行.

4. copy 模块

这个模块用于将文件复制到远程主机，同时支持给定内容生成文件和修改权限等。其相关选项如下：

src　　　　# 被复制到远程主机的本地文件。可以是绝对路径，也可以是相对路径。如果路径是一个目录，则会递归复制，用法类似于"rsync"
content　　　# 当不使用src指定拷贝的文件时，可以使用content直接指定文件内容，src与content两个参数必有其一，否则会报错
dest　　　　# 必选项，将源文件复制到的远程主机的绝对路径
backup=yes # 表示将受控主机存在文件时，将源文件备份
mode　　　　# 递归设定目录的权限，默认为系统默认权限,如果你想将权限设置为”rw-r--r--“，则可以使用mode=0644表示，如果你想要在user对应的权限位上添加执行权限，则可以使用mode=u+x表示
owner # 指定目的地文件所有人
group # 指定目的地文件所有组
force # 当目标主机包含该文件，但内容不同时，设为"yes"，表示强制覆盖；设为"no"，表示目标主机的目标位置不存在该文件才复制。默认为"yes"

4.1 复制文件：

[root@app31 home]# ansible docker -m copy -a 'src=/home/test2.sh dest=/data/'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "checksum": "b4f51832b152e08b304b1c682ba05adece71c045", 
    "dest": "/data/test2.sh", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "ffc3725f409617864c817447685a4eda", 
    "mode": "0644", 
    "owner": "root", 
    "size": 15, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638782767.44-93562767670664/source", 
    "state": "file", 
    "uid": 0
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "checksum": "b4f51832b152e08b304b1c682ba05adece71c045", 
    "dest": "/data/test2.sh", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "ffc3725f409617864c817447685a4eda", 
    "mode": "0644", 
    "owner": "root", 
    "size": 15, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638782767.43-213537548213422/source", 
    "state": "file", 
    "uid": 0
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "checksum": "b4f51832b152e08b304b1c682ba05adece71c045", 
    "dest": "/data/test2.sh", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "ffc3725f409617864c817447685a4eda", 
    "mode": "0644", 
    "owner": "root", 
    "size": 15, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638782767.44-117162678116772/source", 
    "state": "file", 
    "uid": 0
}

4.2.给定内容生成文件，并赋予权限:

[root@app31 home]# ansible docker -m copy -a 'content="this is test" dest=/data/test.txt mode=755'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "checksum": "b6794b2000d94d348203d0279c2e7322b922cb16", 
    "dest": "/data/test.txt", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "8c6d115258631625b625486f81b09532", 
    "mode": "0755", 
    "owner": "root", 
    "size": 12, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638783198.51-187666865731240/source", 
    "state": "file", 
    "uid": 0
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "checksum": "b6794b2000d94d348203d0279c2e7322b922cb16", 
    "dest": "/data/test.txt", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "8c6d115258631625b625486f81b09532", 
    "mode": "0755", 
    "owner": "root", 
    "size": 12, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638783198.5-100956289999740/source", 
    "state": "file", 
    "uid": 0
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "checksum": "b6794b2000d94d348203d0279c2e7322b922cb16", 
    "dest": "/data/test.txt", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "8c6d115258631625b625486f81b09532", 
    "mode": "0755", 
    "owner": "root", 
    "size": 12, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638783198.5-15493567640531/source", 
    "state": "file", 
    "uid": 0
}

4.3. 文件存在,覆盖备份

[root@app31 home]# ansible docker -m copy -a 'content="this is test2" dest=/data/test.txt mode=755 backup=yes'
192.168.1.34 | SUCCESS => {
    "backup_file": "/data/test.txt.32304.2021-12-06@17:35:41~", 
    "changed": true, 
    "checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "dest": "/data/test.txt", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "fc30b9256da0d4d40c2e6ad176dd835a", 
    "mode": "0755", 
    "owner": "root", 
    "size": 13, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638783339.75-149812909314543/source", 
    "state": "file", 
    "uid": 0
}
192.168.1.33 | SUCCESS => {
    "backup_file": "/data/test.txt.31756.2021-12-06@17:35:42~", 
    "changed": true, 
    "checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "dest": "/data/test.txt", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "fc30b9256da0d4d40c2e6ad176dd835a", 
    "mode": "0755", 
    "owner": "root", 
    "size": 13, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638783339.75-5933564884918/source", 
    "state": "file", 
    "uid": 0
}
192.168.1.88 | SUCCESS => {
    "backup_file": "/data/test.txt.20905.2021-12-06@17:35:42~", 
    "changed": true, 
    "checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "dest": "/data/test.txt", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "fc30b9256da0d4d40c2e6ad176dd835a", 
    "mode": "0755", 
    "owner": "root", 
    "size": 13, 
    "src": "/root/.ansible/tmp/ansible-tmp-1638783339.74-85375342208580/source", 
    "state": "file", 
    "uid": 0
}

5. file 模块

该模块主要用于设置文件的属性，比如创建文件、创建链接文件、删除文件等。下面是一些常见的命令：

force  # 需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no
dest   # 被链接到的路径，只应用于state=link的情况
group  # 定义文件/目录的属组。后面可以加上mode：定义文件/目录的权限 默认为root
owner  # 定义文件/目录的属主。后面必须跟上path：定义文件/目录的路径 默认为root
recurse# 递归设置文件的属性，只对目录有效，后面跟上src：被链接的源文件路径，只应用于state=link的情况
mode   # 文件复制到远程并设定权限，默认file=644，directory=755
path   # 指定远程服务器的路径，也可以写成‘dest’，‘name’
state  # 状态，有以下选项：
    directory # 如果目录不存在，就创建目录
    file # 即使文件不存在，也不会被创建
    link # 创建软链接
    hard # 创建硬链接
    touch# 如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
    absent#删除目录、文件或者取消链接文件

5.1. 创建一个文件并且赋值

[root@app31 data]# ansible docker -m file -a 'path=/data/test_file.txt owner=root group=root mode=755 state=touch'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "dest": "/data/test_file.txt", 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "dest": "/data/test_file.txt", 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "dest": "/data/test_file.txt", 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}

5.2. 创建目录

[root@app31 data]# ansible docker -m file -a 'path=/data/test_file_dir state=directory'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "path": "/data/test_file_dir", 
    "size": 6, 
    "state": "directory", 
    "uid": 0
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "path": "/data/test_file_dir", 
    "size": 6, 
    "state": "directory", 
    "uid": 0
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "path": "/data/test_file_dir", 
    "size": 6, 
    "state": "directory", 
    "uid": 0
}

5.3. 创建软链

[root@app31 data]# ansible docker -m file -a 'src=/data/test2.sh dest=/data/test2.sh.link state=link' 
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "dest": "/data/test2.sh.link", 
    "gid": 0, 
    "group": "root", 
    "mode": "0777", 
    "owner": "root", 
    "size": 14, 
    "src": "/data/test2.sh", 
    "state": "link", 
    "uid": 0
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "dest": "/data/test2.sh.link", 
    "gid": 0, 
    "group": "root", 
    "mode": "0777", 
    "owner": "root", 
    "size": 14, 
    "src": "/data/test2.sh", 
    "state": "link", 
    "uid": 0
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "dest": "/data/test2.sh.link", 
    "gid": 0, 
    "group": "root", 
    "mode": "0777", 
    "owner": "root", 
    "size": 14, 
    "src": "/data/test2.sh", 
    "state": "link", 
    "uid": 0
}

5.4.删除目录和文件：

[root@app31 data]# ansible docker -m file -a 'path=/data/test2.sh.link state=absent' 
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "path": "/data/test2.sh.link", 
    "state": "absent"
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "path": "/data/test2.sh.link", 
    "state": "absent"
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "path": "/data/test2.sh.link", 
    "state": "absent"
}

[root@app31 data]# ansible docker -m file -a 'path=/data/test2.sh state=absent' 
[root@app31 data]# ansible docker -m file -a 'path=/data/test_file_dir state=absent'

6. fetch 模块

该模块用于从远程某主机获取（复制）文件到本地。

src # 复制的源文件路径，源文件只能是文件
dest#目标绝对路径

6.1. 远程复制文件

把被控主机/data/test.txt复制到ansible主机/tmp目录下

[root@app31 tmp]# ansible docker -m fetch -a 'src=/data/test.txt dest=/tmp'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "dest": "/tmp/192.168.1.34/data/test.txt", 
    "md5sum": "fc30b9256da0d4d40c2e6ad176dd835a", 
    "remote_checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "remote_md5sum": null
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "dest": "/tmp/192.168.1.33/data/test.txt", 
    "md5sum": "fc30b9256da0d4d40c2e6ad176dd835a", 
    "remote_checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "remote_md5sum": null
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "dest": "/tmp/192.168.1.88/data/test.txt", 
    "md5sum": "fc30b9256da0d4d40c2e6ad176dd835a", 
    "remote_checksum": "ef6ea4aa3e5d645f0138cbce096dd551a26dad5d", 
    "remote_md5sum": null
}

[root@app31 tmp]# tree
.
├── 192.168.1.33
│   └── data
│       └── test.txt
├── 192.168.1.34
│   └── data
│       └── test.txt
├── 192.168.1.88
│   └── data
│       └── test.txt

6.2. 拷贝远程主机的目录到本机

#1.首先需要把远程主机的目录打包，默认打包到远程主机的家目录下（/root）
[root@tmp ~]# ansible docker -m shell -a 'tar -czvf log.tar /var/log/nginx/access*'

#2.把打包文件取回本机：
[root@tmp ~]# ansible docker -m fetch -a 'src=/root/log.tar dest=/root/nginx'

7. cron 模块

功能：管理被控端计划任务；

主要参数如下：

name #定时任务基本描述
job #定时任务要执行的命令
minute #分
hour #小时
day #日
month #月
weekday #周，0-6
disabled #yes:禁用计划任务，no：启用计划任务,
state #absent: 删除计划任务

7.1 创建时间同步定时任务

[root@app31 home]# ansible docker -m cron -a 'name="synctime" job="ntpq -p> /dev/null" minute=*/10'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "synctime"
    ]
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "synctime"
    ]
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "synctime"
    ]
}

7.2 取消时间同步定时任务

[root@app31 home]# ansible docker -m cron -a 'name="synctime" job="ntpq -p> /dev/null" minute=*/10 disabled=yes'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "synctime"
    ]
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "synctime"
    ]
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "synctime"
    ]
}

7.3 删除时间同步定时任务

[root@app31 home]# ansible docker -m cron -a 'name="synctime" job="ntpq -p> /dev/null" minute=*/10 state=absent'
192.168.1.34 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": []
}
192.168.1.33 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": []
}
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "envs": [], 
    "jobs": []
}

8.yum 模块

管理软件包，需要确认被管理端为红帽系列的，并且需要被管理端配置好yum源。主要的参数如下：

name    # 指定安装软件包名或软件包URL
state   # 指定yum对应的方法，present(Defaults)表示安装；absent表示卸载；latest表示安装最新版本软件包，支持多程序一起安装，用逗号隔开
enablerepo  # 允许从哪些仓库获取软件
disablerepo # 禁止从哪些仓库获取软件
exclude # 排除某些软件包，例如kernel
download_only   # 仅下载软件包，不安装
disable_gpg_check   # 不进行gpg检测
update_cache    # 可以在安装包的同时更新yum缓存

安装一个`httpd`包

[root@app31 ansible]# ansible 192.168.1.88 -m yum -a 'name=httpd state=present'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "msg": "http://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\nhttp://mirror.centos.org/centos/7/dotnet/x86_64/repodata/repomd.xml: [Errno 14] curl#7 - \"Failed to connect to 2604:1380:3000:2800::1: Network is unreachable\"\nTrying other mirror.\n", 
    "rc": 0, 
    "results": [
        "Loaded plugins: fastestmirror, langpacks\nLoading mirror speeds from cached hostfile\n * base: mirrors.tuna.tsinghua.edu.cn\n * centos-sclo-rh: mirrors.tuna.tsinghua.edu.cn\n * centos-sclo-sclo: mirrors.tuna.tsinghua.edu.cn\n * epel: mirrors.tuna.tsinghua.edu.cn\n * extras: mirrors.tuna.tsinghua.edu.cn\n * updates: mirrors.tuna.tsinghua.edu.cn\nResolving Dependencies\n--> Running transaction check\n---> Package httpd.x86_64 0:2.4.6-97.el7.centos.2 will be installed\n--> Processing Dependency: httpd-tools = 2.4.6-97.el7.centos.2 for package: httpd-2.4.6-97.el7.centos.2.x86_64\n--> Processing Dependency: /etc/mime.types for package: httpd-2.4.6-97.el7.centos.2.x86_64\n--> Running transaction check\n---> Package httpd-tools.x86_64 0:2.4.6-97.el7.centos.2 will be installed\n---> Package mailcap.noarch 0:2.1.41-2.el7 will be installed\n--> Finished Dependency Resolution\n\nDependencies Resolved\n\n================================================================================\n Package           Arch         Version                     Repository     Size\n================================================================================\nInstalling:\n httpd             x86_64       2.4.6-97.el7.centos.2       updates       2.7 M\nInstalling for dependencies:\n httpd-tools       x86_64       2.4.6-97.el7.centos.2       updates        94 k\n mailcap           noarch       2.1.41-2.el7                base           31 k\n\nTransaction Summary\n================================================================================\nInstall  1 Package (+2 Dependent packages)\n\nTotal download size: 2.8 M\nInstalled size: 9.6 M\nDownloading packages:\n--------------------------------------------------------------------------------\nTotal                                              6.5 MB/s | 2.8 MB  00:00     \nRunning transaction check\nRunning transaction test\nTransaction test succeeded\nRunning transaction\n  Installing : httpd-tools-2.4.6-97.el7.centos.2.x86_64                     1/3 \n  Installing : mailcap-2.1.41-2.el7.noarch                                  2/3 \n  Installing : httpd-2.4.6-97.el7.centos.2.x86_64                           3/3 \n  Verifying  : httpd-2.4.6-97.el7.centos.2.x86_64                           1/3 \n  Verifying  : mailcap-2.1.41-2.el7.noarch                                  2/3 \n  Verifying  : httpd-tools-2.4.6-97.el7.centos.2.x86_64                     3/3 \n\nInstalled:\n  httpd.x86_64 0:2.4.6-97.el7.centos.2                                          \n\nDependency Installed:\n  httpd-tools.x86_64 0:2.4.6-97.el7.centos.2    mailcap.noarch 0:2.1.41-2.el7   \n\nComplete!\n"
    ]
}

卸载`apache`软件包

[root@app31 ansible]# ansible 192.168.1.88 -m yum -a 'name=httpd state=absent'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "msg": "", 
    "rc": 0, 
    "results": [
        "已加载插件：fastestmirror, langpacks\n正在解决依赖关系\n--> 正在检查事务\n---> 软件包 httpd.x86_64.0.2.4.6-97.el7.centos.2 将被 删除\n--> 解决依赖关系完成\n\n依赖关系解决\n\n================================================================================\n Package      架构          版本                          源               大小\n================================================================================\n正在删除:\n httpd        x86_64        2.4.6-97.el7.centos.2         @updates        9.4 M\n\n事务概要\n================================================================================\n移除  1 软件包\n\n安装大小：9.4 M\nDownloading packages:\nRunning transaction check\nRunning transaction test\nTransaction test succeeded\nRunning transaction\n  正在删除    : httpd-2.4.6-97.el7.centos.2.x86_64                          1/1 \n  验证中      : httpd-2.4.6-97.el7.centos.2.x86_64                          1/1 \n\n删除:\n  httpd.x86_64 0:2.4.6-97.el7.centos.2                                          \n\n完毕！\n"
    ]
}

9. systemd 模块 or systemd模块

该模块用于服务程序的管理。

name    # 指定需要控制的服务名称
state   # 指定服务状态，其值可以为stopped、started、reloaded、restarted、running
enabled # 指定服务是否为开机启动，yes为启动，no为不启动
daemon_reload   # yes：重启systemd服务，让unit文件生效 systemd才有

启动nginx服务，并设置为开机自启：

ansible 192.168.1.88 -m service -a 'name=nginx state=started enabled=yes'
ansible 192.168.1.88 -m systemd -a 'name=nginx state=started enabled=yes'

10. ansible user 模块和 group 模块

group模块

管理被控端用户组

name    # 指定创建的组名
gid # 为组设置gid
state   # 是否将组创建在远程主机上，创建：present(Default)、删除：absent
system  # 是否创建系统组，创建系统组：yes、不创建系统组：no(Default)

创建组`tester`，`gid`为`8888`：

[root@app31 ~]# ansible 192.168.1.88 -m group -a 'name=tester state=present gid=8888'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "gid": 8888, 
    "name": "tester", 
    "state": "present", 
    "system": false
}

[root@sdw88 ~]# getent group tester
tester:x:8888:

删除组`tester`：

[root@app31 ~]# ansible 192.168.1.88 -m group -a 'name=tester state=absent'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "name": "tester", 
    "state": "absent"
}

user模块

管理被控端用户

name    # 创建或删除的用户名
uid # 为用户设置uid
group   # 设置用户的主组
groups  # 设置用户的附加组
shell   # 为用户设置登陆时的Shell
create_home # 是否为用户创建主目录，yes(Default)、no
state   # 创建或删除用户，创建：present(Default)、删除：absent
remove  # 是否删除与用户关联的目录，例如家目录和邮箱目录，只有当state=absent 时生效，删除：yes、不删除：no(Default)
system  #是否添加为系统用户，yes：为系统用户，no：不是系统用户
generate_ssh_key    # 为相关用户生成ssh密钥。不会覆盖现有的ssh密钥
ssh_key_bits    # 创建用户ssh密钥中位数
ssh_key_file    # 可以实现ssh密钥改名，或变更存放ssh密钥位置，默认为.ssh/id_rsa
append  # yes：表示追加附加组

添加一个系统用户，用户名为test1，uid=2222，创建家目录，主组为root，附加组为bin，默认shell为nologin

[root@app31 ~]# ansible 192.168.1.88 -m user -a 'name=test1 uid=2222 group=root groups=bin shell=/sbin/nologin system=yes home=/home/test1'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "comment": "", 
    "createhome": true, 
    "group": 0, 
    "groups": "bin", 
    "home": "/home/test1", 
    "name": "test1", 
    "shell": "/sbin/nologin", 
    "state": "present", 
    "system": true, 
    "uid": 2222
}

删除test1用户：

[root@app31 ~]# ansible 192.168.1.88 -m user -a 'name=test1 state=absent'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "force": false, 
    "name": "test1", 
    "remove": false, 
    "state": "absent"
}

11.script 模块

在远程主机运行本地的脚本,实例:

[root@app31 ~]# vi /tmp/df.sh
#!/bin/bash

df -lh >> /tmp/disk_total.log


# 我们直接运行命令来实现在被管理端执行该脚本：
[root@app31 ~]# ansible 192.168.1.88 -m script -a '/tmp/df.sh'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "rc": 0, 
    "stderr": "Shared connection to 192.168.1.88 closed.\r\n", 
    "stdout": "", 
    "stdout_lines": []
}

12.get_url 模块

通过互联网下载软件至被控端本地

url # 资源文件在互联网上的具体url地址
dest    #文件下载位置的绝对路径
mode    #文件下载位置的绝对路径
checksum    #对下载的资源进行校验
timeout #URL请求超时时间，默认10s

下载互联网的软件至本地

[root@app31 ~]# ansible 192.168.1.88 -m get_url -a "url=https://199604.com/wp-content/uploads/2021/03/20190921090433354.gif dest=/tmp"
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "checksum_dest": null, 
    "checksum_src": "2f6ba1d4fd455893895d5b1daec75cfe06f4d4b0", 
    "dest": "/tmp/20190921090433354.gif", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "8af3c72918267a47eaf8e7ec817473eb", 
    "mode": "0644", 
    "msg": "OK (1118661 bytes)", 
    "owner": "root", 
    "size": 1118661, 
    "src": "/tmp/tmpqgBY0k", 
    "state": "file", 
    "status_code": 200, 
    "uid": 0, 
    "url": "https://199604.com/wp-content/uploads/2021/03/20190921090433354.gif"
}

13.hostname 模块

管理远程主机的主机名

更改192.168.1.88的主机名为test88

[root@app31 ~]# ansible 192.168.1.88 -m hostname -a 'name=test88'
192.168.1.88 | SUCCESS => {
    "ansible_facts": {
        "ansible_domain": "", 
        "ansible_fqdn": "test88", 
        "ansible_hostname": "test88", 
        "ansible_nodename": "test88"
    }, 
    "changed": true, 
    "name": "test88"
}

[root@sdw88 tmp]# hostname
test88

14.archive 模块和 unarchive 模块

archive模块

在远端主机打包与压缩

path    # 要压缩的文件或目录
dest    # 压缩后的文件
format  # 指定打包压缩的类型：bz2、gz、tar、xz、zip

将 /var/log/nbdc 目录压缩为 tar.gz 格式，并存储至 /tmp 目录下

[root@app31 ~]# ansible 192.168.1.88 -m archive -a 'path=/var/log/nbdc dest=/tmp/nbdc.tar.gz format=gz'
192.168.1.88 | SUCCESS => {
    "archived": [
        "/var/log/nbdc/download/Main.log"
    ], 
    "arcroot": "/var/log/", 
    "changed": true, 
    "dest": "/tmp/nbdc.tar.gz", 
    "expanded_exclude_paths": [], 
    "expanded_paths": [
        "/var/log/nbdc"
    ], 
    "gid": 0, 
    "group": "root", 
    "missing": [], 
    "mode": "0644", 
    "owner": "root", 
    "size": 60423, 
    "state": "file", 
    "uid": 0
}

unarchive模块

在远端主机解包与解压缩

src # 要解压的软件包路径
dest    # 解压到目标位置，需要是一个目录
remote_src  # yes：要解压的包在被控端、no：要解压的包在控制端 默认no
owner   #文件复制到远程并设定属主，默认为root
group   #文件复制到远程并设定属组，默认为root
mode    #文件复制到远程并设定权限，默认file=644，directory=755

远程解压192.168.1.88下的/tmp/nbdc.tar.gz文件

[root@app31 ~]# ansible 192.168.1.88 -m unarchive -a 'src=/tmp/nbdc.tar.gz dest=/tmp/ remote_src=yes'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "dest": "/tmp/", 
    "extract_results": {
        "cmd": [
            "/usr/bin/gtar", 
            "--extract", 
            "-C", 
            "/tmp/", 
            "-z", 
            "-f", 
            "/tmp/nbdc.tar.gz"
        ], 
        "err": "", 
        "out": "", 
        "rc": 0
    }, 
    "gid": 0, 
    "group": "root", 
    "handler": "TgzArchive", 
    "mode": "01777", 
    "owner": "root", 
    "size": 4096, 
    "src": "/tmp/nbdc.tar.gz", 
    "state": "directory", 
    "uid": 0
}

15.selinux 模块

管理远端主机的 SELINUX 防火墙

state   #Selinux模式：enforcing、permissive、disabled
polocy  #targeted

设置 selinux 为 enforcing

[root@app31 selinux]# ansible 192.168.1.88 -m selinux -a 'state=enforcing policy=targeted'
 [WARNING]: Reboot is required to set SELinux state to enforcing
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "configfile": "/etc/selinux/config", 
    "msg": "Config SELinux state changed from 'disabled' to 'enforcing'", 
    "policy": "targeted", 
    "reboot_required": true, 
    "state": "enforcing"
}

设置 selinux 为 disabled

[root@app31 selinux]# ansible 192.168.1.88 -m selinux -a 'state=disabled'
192.168.1.88 | SUCCESS => {
    "changed": true, 
    "configfile": "/etc/selinux/config", 
    "msg": "Config SELinux state changed from 'enforcing' to 'disabled'", 
    "policy": "targeted", 
    "reboot_required": false, 
    "state": "disabled"
}

playbook–有空再深入学习….

Playbook语法简介

Ansible使用YAML语法描述配置文件，YAML语法以简洁明了、结构清晰著称。Ansible的任务配置文件被称为Playbook，我们可以称之为＂剧本”。

每一个剧本(Playbook)中都包含一系列的任务，这每个任务在Ansible中又被称为＂戏剧”(play)。一个剧本(Playbook)中包含多出戏剧(play)，这很容易理解。

具体可到:https://www.junmajinlong.com/ansible/4_ansible_soul_playbook/ 学习,文章系列也非常不错

以下是一个例子:

---
- name: this is demo
  hosts: yn
  tasks:
    - name: df shell
      shell: df -h
      register: df_data

    - name: debug
      debug:
        msg: "{{df_data}}"

命令行执行:ansible-playbook demo.yml

下面收Ansible-Linux巡检的一个例子:

1.编写自己的主机清单:/etc/ansible/hosts

2.编写check_server.yml的playbook的文件

---
- name: check_server_yn
  hosts: yn
  tasks:
    # 执行巡检脚本
    - name: run sh
      script: check_resources.sh
      register: run_data

    - name: debug
      debug:
        msg: "{{run_data.stdout_lines}}"

3.编写巡检脚本check_resources.sh

linux巡检：CPU、内存、磁盘。

#!/bin/bash

free -m | awk 'NR==2{printf "Memory Usage: %s/%sMB (%.2f%%)\n", $3,$2,$3*100/$2 }';

df -h | grep -vE '^Filesystem|tmpfs|cdrom|文件系统' | awk '{ print "Disk Usage:"" " $1 " " $3"/"$2" ""("$5")"}';
# 只看使用率>60%的磁盘
# df -hP | grep -vE '^Filesystem|tmpfs|cdrom|文件系统' |awk 'NR>1 && int($5) > 60'

top -bn1 | grep load | awk '{printf "CPU Load: %.2f\n", $(NF-2)}';

4.运行ansible-playbook check_server.yml结果:

[root@mdw193 shell]# ansible-playbook check_server.yml 
[WARNING]: Invalid characters were found in group names but not replaced, use -vvvv to see details

PLAY [check_server_yn] ********************************************************************************************

ok: [10.174.237.195] => {
    "msg": [
        "Memory Usage: 75052/257387MB (29.16%)", 
        "Disk Usage: /dev/mapper/centos-root 17G/50G (34%)", 
        "Disk Usage: /dev/sdb 4.5T/11T (42%)", 
        "Disk Usage: /dev/sda1 179M/1014M (18%)", 
        "Disk Usage: /dev/mapper/centos-home 636M/782G (1%)", 
        "Disk Usage: cm_processes 1.5G/126G (2%)", 
        "CPU Load: 0.53"
    ]
}

PLAY RECAP ********************************************************************************************
10.173.108.100             : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0