Ansible学习之ad-hoc命令 、 Ansible常用模块

Ansible ad-hoc是一种通过命令行批量管理的方式，命令基本格式如下：
格式：ansible 主机集合 -m 模块名 -a "参数"

步骤一：测试环境

1）查看主机列表

cd  ~/ansible                            #非常重要
ansible  all  --list-hosts           #查看所有主机列表

--list-hosts是ansible这个命令的固定选项，如同ls -a一样（-a是ls命令的固定选项）
英语词汇：list（列表，清单）、host（主机、主办、主人）

2）测试远程主机是否能ping通，当需要远程多个主机或者多个组时，中间使用逗号分隔。

ansible  node1  -m  ping              #调用ping模块
ansible  node1,webserver  -m  ping

常见报错（有问题可以参考，没问题可以忽略）：

node1 | UNREACHABLE! => {
"changed": false, 
"msg": "Failed to connect to the host via ssh: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).", 
"unreachable": true
}

问题分析：
英语词汇：Failed（失败），connect（连接），to（到），host（主机），via（通过）
permission（权限），denied（被拒绝）
Failed to connect to host via ssh（通过ssh远程连接到主机失败）
Permission denied（因为无法连接，所以报错说权限被拒绝）
解决办法：
手动ssh其他主机（如node1），看看是否可以实现免密码登录。
Ansible的原理是基于ssh远程管理，如果无法实现免密码登录，后面的实验无法成功！

提示：该模块虽然叫ping，但是它不会发送任何ICMP协议的ping数据包，控制端主机仅仅是ssh远程被管理端主机，检查其是否有python环境，能顺利远程并且有Python环境就会返回正确的提示信息，否则报错。拓扑如图所示：

image

3）快速入门

模块就是脚本（多数为Python脚本），多数脚本都支持参数，默认模块为command

ansible  node1  -m  command  -a   "uptime"     #查看CPU负载
ansible  node1  -m command -a  "uname -r"      #查看内核版本
ansible  node1   -a   "ip a s"                  #查看网卡信息
ansible  all   -a   "date"                      #查看时间

拓扑图如下：

image

可以通过ansible-doc获取帮助。

ansible-doc  -l                      #列出所有模块
ansible-doc -l | grep yum            #在所有模块中过滤关键词
ansible-doc yum                         #查看模块帮助

4）Shell模块

command和shell模块的区别，command不支持bash的特性（bash有哪些特性可以参考Shell课程第一天的PPT），如管道和重定向等功能，但是shell模块可以支持。

不可以使用shell模块执行交互命令，如vim、top等。

ansible test -m command -a "ps | wc -l"         #报错
ansible test -m command -a  "ls &"               #报错

ansible test -m shell -a  "ps aux | wc -l"       #进程数量
ansible test -m shell -a  "who"                   #登陆信息
ansible test -m shell -a  "touch /tmp/txt.txt"  

使用shell模块创建文件会有Warning警告提示，正常！！！

5）script模块

script模块会把-a后面的脚本拷贝到被管理端主机，然后执行这个脚本。

vim  ~/ansible/test.sh  
#!/bin/bash
dnf -y install httpd
systemctl start httpd
ansible  test  -m script  -a  "./test.sh"    

test是主机组的名称，-m调用script模块，-a后面的./test.sh是上面创建脚本的相对路径和文件名
./是当前目录的意思，在当前目录下有个脚本叫test.sh

拓扑如图所示:

image

如何验证？

因为ansible远程的是node1，所以打开node1这台电脑，查看下是否安装了httpd软件、是否启动了服务。

rpm -q  httpd
systemctl  status  httpd

、#沿用上面的，续练习Ansible ad-hoc：

• 远程目标主机新建文件和目录、修改文件或目录的权限
• 在远程目标主机创建链接文件
• 删除远程目标主机上的文件或目录
• 将控制端本地的文件拷贝到被管理端
• 从被管理端下载文件到本地
• 修改远程目标主机上的文件内容

很多ansible模块都具有幂等性的特征。
幂等性：任意次执行所产生的影响均与一次执行的影响相同。

步骤一：file模块

file模块可以创建文件、目录、链接；修改权限与属性等（ansible-doc file）

ansible  test  -m  file  -a  "path=/tmp/file.txt state=touch"         #远程test组中所有主机，新建文件，path后面指定要创建的文件或目录的名称

state=touch是创建文件，state=directory是创建目录
验证： 到node1主机，使用ls /tmp/file.txt看看文件是否被创建成功 ##

拓扑如图所示：

image

常见报错（有问题可以参考，没问题可以忽略）：

node1 | FAILED! => {
… …
"changed": false,
"msg": "value of state must be one of: absent, directory, file, hard, link, touch, got: touc"
}

英语词汇：value（值），must（必须），be（是），of（…的），one（一个）
value of state must be one of:【state的值必须是后面给出的其中一个值】
解决办法：检查state的值是否有字母错误,上面报错例子中输入的是touc，不是touch。

常见错误（有问题可以参考，没问题可以忽略）：

node1 | FAILED! => {
… …
"msg": "Unsupported parameters for (file) module: nmae Supported parameters include: _diff_peek, _original_basename, access_time, 
access_time_format, attributes, backup, content, delimiter, directory_mode,
follow, force, group, mode, modification_time, modification_time_format, owner,
path, recurse, regexp, remote_src, selevel, serole, setype, seuser, src, state,
unsafe_writes"
}

英语词汇：unsupported（不支持的），parameters（参数），supported（支持的）include(包括)
问题分析：file模块不支持nmae这个参数，它支持的参数包括哪些，后面有提示.
解决办法：检查模块的参数是否有字母错误，上面错误案例将name错写为nmae。

更多file模块的案例：

ansible  test  -m  file  -a  "path=/tmp/mydir state=directory" 

远程test组中所有主机，创建目录，path后面指定要创建的文件或目录的名称
验证：到node1主机，使用ls /tmp/看看tmp目录下是否有mydir子目录

ansible  test  -m  file -a  "path=/tmp/file.txt owner=sshd group=adm mode=0777"  

修改文件或目录权限，path后面指定要修改的文件名或目录名称，owner后面指定用户，group后面指定组，mode后面指定要修改的权限（0777中第一个0代表的是无特殊权限，如SUID、SGID等）
验证：到node1主机，使用ls -l /tmp/file.txt查看文件的详细信息是否正确

ansible test -m file -a "path=/tmp/mydir state=absent"              #state=absent代表删除（删除目录）
ansible test -m file -a "path=/tmp/file.txt state=absent"            # state=absent代表删除（删除文件）

ansible test -m file -a "src=/etc/hosts  path=/tmp/host.txt state=link"  

给/etc/hosts文件创建一个链接文件/tmp/host.txt（src指定源文件，path是软链接文件名）
相当于执行命令 ln -s /etc/hosts /tmp/host.txt
验证：到node1主机使用ls -l /tmp/hosts查看文件是否为软链接

步骤二：copy模块

copy模块可以将文件拷贝到远程主机 (ansible-doc copy)。

echo AAA > ~/a3.txt                   #新建测试文件
ansible test -m copy -a "src=~/a3.txt dest=/root/"

把管理端本机的a3.txt文件，拷贝到test组中所有主机的/root/目录，src代表源文件，dest代表目标文件
验证：到node1主机使用ls /root/a3.txt查看是否有该文件

拓扑如图所示：

image

步骤三：fetch模块

fetch模块与copy类似，但是作用相反,可以将其他主机的文件拷贝到本地(ansible-doc fetch)。

ansible test -m fetch -a "src=/etc/hostname   dest=~/"    #将远程test组中所有主机的hostname文件下载到本地家目录  #src代表源文件，dest代表目标文件

ls  ~/          #使用ls查看下是否下载成功
不能下载目录，如果需要下载目录，可以先打包后再下载

拓扑如图所示:

image

步骤四：lineinfile|replace模块

在修改单个文件的单行内容时可以使用lineinfile模块(ansible-doc lineinfile)。

在/etc/issue文件中添加一行内容hello world，默认添加到最后，line后面跟的是需要添加的文件内容：

ansible test -m lineinfile  -a "path=/etc/issue line='hello world'"

验证：到node1主机执行命令cat /etc/issue查看文件内容是否正确

ansible test -m lineinfile -a "path=/etc/issue line='hello world'"   #基于幂等原则，重复执行，不会创建多行内容

验证：到node1主机执行命令cat /etc/issue查看文件内容是否正确

lineinfile会替换一整行，replace可以替换关键词(ansible-doc replace)。

将node1主机中/etc/issue.net文件全文所有的Kernel替换为Ocean：regexp后面是需要替换的旧内容；replace后面是需要替换的新内容

ansible test -m replace -a "path=/etc/issue.net regexp=Kernel replace=Ocean"

验证：到node1主机执行命令cat /etc/issue.net查看文件内容是否正确

沿用上面的练习，继续练习Ansible ad-hoc应用案例，具体要求如下：

• 远程目标主机创建、删除系统账户；设置系统账户属性、修改账户密码
• 为目标主机创建、删除yum源配置文件；远程目标主机安装、卸载软件包
• 使用service模块管理远程主机的服务
• 创建、删除逻辑卷

步骤一：user模块

user模块可以实现Linux系统账户管理(ansible-doc user)。

ansible test -m user -a "name=tuser1"   #远程test组中的所有主机并创建系统账户tuser1，默认state的值为present，代表创建用户

验证：到node1主机执行命令id tuser1查看是否有该用户

拓扑如图所示:

image

ansible test -m user -a  "name=tuser2 uid=1010 group=adm groups=daemon,root home=/home/tuser2"

创建账户并设置对应的账户属性，uid指定用户ID号，group指定用户属于哪个基本组
groups指定用户属于哪些附加组，home指定用户的家目录
验证： 到node1主机执行命令id tuser2查看是否有该用户

拓扑如图所示:

image

ansible test -m user -a "name=tuser1 password={{'abc'| password_hash('sha512')}}"

修改账户密码，用户名是tuser1，密码是abc，密码经过sha512加密

ansible test -m user  -a "name=tuser1 state=absent"

删除账户tuser1，state=absent代表删除账户的意思，name指定要删除的用户名是什么
账户的家目录不会被删除，相当于执行userdel tuser1

ansible test -m user -a "name=tuser2 state=absent remove=true"                 #删除tuser2账户同时删除家目录、邮箱，相当于执行userdel  -r  tuser2

步骤二：yum_repository模块

使用yum_repository可以创建或修改yum源配置文件（ansible-doc yum_repository）。

ansible test -m yum_repository  -a "name=myyum description=hello baseurl=ftp://192.168.4.254/centos gpgcheck=no"

新建一个yum源配置文件/etc/yum.repos.d/myyum.repo，yum源文件名为myyum，该文件的内容如下：

[myyum]
baseurl = ftp://192.168.4.254/centos
gpgcheck = 0
name = hello

验证：到node1主机ls /etc/yum.repos.d/查看该目录下是否有新的yum文件

ansible test -m yum_repository -a "name=myyum description=test baseurl=ftp://192.168.4.254/centos gpgcheck=yes gpgkey=…"

修改yum源文件内容

ansible test -m yum_repository -a "name=myyum state=absent"

删除yum源文件myyum

步骤三：yum模块

使用yum模块可以安装、卸载、升级软件包（ansible-doc yum），

state: present(安装)|absent(卸载)|latest(升级)。

ansible test -m yum -a "name=unzip state=present"     #安装unzip软件包，state默认为present，也可以不写

验证：到node1主机执行命令rpm -q unzip查看是否有该软件

ansible test -m yum -a "name=unzip state=latest"    #升级unzip软件包，软件名称可以是*，代表升级所有软件包

ansible test -m yum -a "name=unzip state=absent"    #调用yum模块，卸载unzip软件包，state=absent代表卸载软件

验证：到node1主机执行命令rpm -q unzip查看该软件是否已经被卸载

步骤四：service模块（ansible-doc service）

service为服务管理模块（启动、关闭、重启服务等），state:started|stopped|restarted，enabled:yes设置开机启动。

ansible test -m yum -a "name=httpd"      #调用yum模块，安装httpd软件包

验证：到node1主机执行命令rpm -q httpd查看该软件是否被安装

ansible test -m service -a "name=httpd state=started"     #调用service模块，启动httpd服务

验证：到node1主机执行命令systemctl status httpd查看服务状态

ansible test -m service -a "name=httpd state=stopped"  #调用service模块，关闭httpd服务

验证：到node1主机执行命令systemctl status httpd查看服务状态

ansible test -m service -a "name=httpd state=restarted" #调用service模块，重启httpd服务

ansible test -m service -a "name=httpd enabled=yes"       #调用service模块，设置httpd服务开机自启

步骤五：逻辑卷相关模块（ansible-doc lvg、ansible-doc lvol）

实验之前需要给对应的虚拟机添加额外磁盘，并创建磁盘2个分区，可使用parted或fdisk命令给磁盘创建区，这里的磁盘名称仅供参考！

lvg模块:创建、删除卷组(VG)，修改卷组大小，state:present(创建)|absent(删除)。

ansible test -m yum -a "name=lvm2"    #安装lvm2软件包，安装了lvm2软件后，才有pvcreate、vgcreate、lvcreate等命令
ansible test -m lvg -a "vg=myvg pvs=/dev/vdb1"           #创建名称为myvg的卷组，该卷组由/dev/vdb1组成

注意：这里的磁盘名称要根据实际情况填写

验证：到node1主机执行命令pvs和vgs查看是否有对应的PV和VG

ansible test -m lvg -a "vg=myvg pvs=/dev/vdb1,/dev/vdb2"                #修改卷组大小，往卷组中添加一个设备/dev/vdb2

lvol模块:创建、删除逻辑卷(LV)，修改逻辑卷大小，

state:present(创建)|absent(删除)。

ansible test -m lvol -a "lv=mylv vg=myvg size=2G"   #使用myvg这个卷组创建一个名称为mylv的逻辑卷，大小为2G

验证：到node1主机执行命令lvs查看是否有对应的LV逻辑卷

ansible test -m lvol -a "lv=mylv vg=myvg size=4G"          #修改LV逻辑卷大小
ansible test -m lvol -a "lv=mylv vg=myvg state=absent force=yes"   #删除逻辑卷，force=yes是强制删除
ansible test -m lvg -a "vg=myvg state=absent"    #删除卷组myvg