linux上ansidle常用模块的使用（一）

本章主要介绍ansible中最常见模块的使用。

• 文件管理模块
• 软件包管理模块
• 服务管理模块
• 磁盘管理模块

ansible的基本用法如下。

1 ansible 机器名 ‐m 模块× ‐a "模块的参数”

对被管理机器执行不同的操作，只需要调用不同的模块就可以了。ansible中内置了很多

的模块,可以通过ansible-doc -l查看系统中所有的模块。

[root@pp ~]# ansible-doc -l
a10_server                                                    Manage A10 Networks AX/...
a10_server_axapi3                                             Manage A10 Networks AX/...
a10_service_group                                             Manage A10 Networks AX/...
a10_virtual_server                                            Manage A10 Networks AX/...
aci_aaa_user                                                  Manage AAA users (aaa:U...
aci_aaa_user_certificate                                      Manage AAA user certifi...
aci_access_port_block_to_access_port                          Manage port blocks of F...
aci_access_port_to_interface_policy_leaf

按【Enter】键会一行一行地往下显示，按空格键会一页一页地往下显示，按【q】键退

出。

不同的模块有不同的参数，如果要查看某个模块的参数，可以通过如下语法来查看。

1 ansible‐doc 模块名

ansible中有很多模块，每个模块也有很多参数，我们是不可能把所有的模块、每个模块

的所有参数都掌握的。所以，下面我们只讲解最常见的模块及这些模块中最常见的参数的使

用方法。

29.1 shell模块

shell模块可以在远端执行操作系统命令，具体用法如下。

1 ansible 主机组 ‐m shell ‐a "系统命令"

练习1：在up上执行hostname命令，命令如下。

[root@pp ~]# ansible up -m shell -a "hostname"
up | CHANGED | rc=0 >>
up
[root@pp ~]# 

这里rc=0的意思是执行此命令之后的返回值为0，rc的意思是returm code(返回值)，为0

说明正确执行了,非零说明没有正确执行。

练习2：在 server2上执行一个错误的命令，命令如下。

[root@pp ~]# ansible up -m shell -a "hostnamexx"
up | FAILED | rc=127 >>
/bin/sh: hostnamexx: 未找到命令non-zero return code
[root@pp ~]# 

这里rc=127的意思是执行此命令之后的返回值为127，非零说明没有正确执行。

29.2 文件管理的file模块

file模块用于创建和删除文件/目录，修改文件/目录属性，其常见的参数包括以下几个。

（1）path：用于指定文件/目录的路径，此选项可以用name或dest替代。

（2）state：指定行为。

（3）touch：创建文件。

（4）directory：创建目录。

（5）file：对已存文件进行修改。

（6）absent：删除。

（7）link：软链接。

（8）hard：硬链接。

（9）其他参数:owner指定所有者，group指定所属组，mode指定权限，setype指定上下

文。

练习1：在server2上创建一个文件/opt/hosts，并设置所有者为root，所属组为tom，权

限为444，命令如下。

[root@pp ~]# ansible up -m file -a "path=/opt/hosts owner=root group=tom mode=444 state=touch"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "dest": "/opt/hosts",
    "gid": 1002,
    "group": "tom",
    "mode": "0444",
    "owner": "root",
    "secontext": "unconfined_u:object_r:usr_t:s0",
    "size": 0,
    "state": "file",
    "uid": 0
}

需要注意的是，此处用path指定的文件，替换成name也是可以的，即

name=/opt/hosts。查看文件的属性,命令如下。

[root@pp ~]# ansible up -m shell -a "ls -l /opt/hosts"
up | CHANGED | rc=0 >>
-r--r--r--. 1 root tom 0 12月 18 10:43 /opt/hosts
[root@pp ~]# 

练习2：为/opt/hosts创建一个软链接/opt/hosts123，命令如下。

[root@pp ~]# ansible up -m file -a "src=/opt/hosts dest=/opt/hosts123 state=link"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "dest": "/opt/hosts123",
    "gid": 0,
    "group": "root",
    "mode": "0777",
    "owner": "root",
    "secontext": "unconfined_u:object_r:usr_t:s0",
    "size": 10,
    "src": "/opt/hosts",
    "state": "link",
    "uid": 0
}
[root@pp ~]# 

验证，命令如下

[root@pp ~]# ansible up -m file -a 'name=/opt/xx state=directory setype=default_t'
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "gid": 0,
    "group": "root",
    "mode": "0755",
    "owner": "root",
    "path": "/opt/xx",
    "secontext": "unconfined_u:object_r:default_t:s0",
    "size": 6,
    "state": "directory",
    "uid": 0
}
[root@pp ~]# 

29.3 copy和 fetch模块 copy用于把本地的文件拷贝到被管理机器，语法如下。

copy用于把本地的文件拷贝到被管理机器，语法如下。

1 ansible 主机组 ‐m copy ‐a "src=/path1/file1 dest=path2/"

作用是把本地的/path1/file1拷贝到目的主机的/path2中。

copy模块常见的参数包括以下几个。

（1） src：源文件。

（2）dest：目的地，即拷贝到哪里。

（3）owner：所有者。

（4）group：所属组。(5）mode:权限。

练习1：把本地的文件/etc/ansible/hosts拷贝到目标机器的/opt目录中，并设置权限为

000,所有者为blab,命令如下。

[root@pp ~]# ansible up -m copy -a "src=/etc/ansible/hosts mode=000 owner=blab dest=/opt"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "checksum": "da996f1a52dbae3b6b43a6c50d761e4ed5ec9a9f",
    "dest": "/opt/hosts",
    "gid": 1002,
    "group": "tom",
    "mode": "0000",
    "owner": "blab",
    "path": "/opt/hosts",
    "secontext": "unconfined_u:object_r:usr_t:s0",
    "size": 1016,
    "state": "file",
    "uid": 1001
}
[root@pp ~]# 

验证，命令如下

[root@pp ~]# ansible up -m shell -a "ls -l /opt/hosts"
up | CHANGED | rc=0 >>
----------. 1 blab tom 1016 12月 18 11:04 /opt/hosts

copy模块也可以利用content参数往某个文件中写内容，如果此文件不存在则会创建出

来。

练习2：在被管理机器的/opt目录中创建11.txt，内容为123123，命令如下。

[root@pp ~]# ansible up -m copy -a 'content="123123" dest=/opt/11.txt'
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "checksum": "601f1889667efaebb33b8c12572835da3f027f78",
    "dest": "/opt/11.txt",
    "gid": 0,
    "group": "root",
    "md5sum": "4297f44b13955235245b2497399d7a93",
    "mode": "0644",
    "owner": "root",
    "secontext": "system_u:object_r:usr_t:s0",
    "size": 6,
    "src": "/home/blab/.ansible/tmp/ansible-tmp-1702868819.2795806-77717-16766204555196/source",
    "state": "file",
    "uid": 0
}
[root@pp ~]# 

验证/opt/11.txt的内容，命令如下。

[root@pp ~]# ansible up -m shell -a "cat /opt/11.txt"
up | CHANGED | rc=0 >>
123123
[root@pp ~]# 

fetch用于把文件从被管理机器拷贝到本机当前目录中,命令如下。

[root@pp ~]# ansible up -m fetch -a "src=/opt/hosts dest=."
up | CHANGED => {
    "changed": true,
    "checksum": "da996f1a52dbae3b6b43a6c50d761e4ed5ec9a9f",
    "dest": "/root/up/opt/hosts",
    "md5sum": "1564b951dc7c8511c6f9ee842653c541",
    "remote_checksum": "da996f1a52dbae3b6b43a6c50d761e4ed5ec9a9f",
    "remote_md5sum": null
}
[root@pp ~]# 

29.4 yum_repository模块

利用yum_repository设置yum 源，一个标准的repo配置文件如下所示。

[root@pp ~]# cat /etc/yum.repos.d/aa.repo 
[aa]
name=aa
baseurl=file:///mnt/AppStream
enabled=1
gpgcheck=0
gpgkey=ftp://192.168.26.101/dvd/RPM‐GPG‐KEY‐redhat‐release

name=bb
baseurl=file:///mnt/BaseOS
enabled=1
gpgcheck=0

[root@pp ~]# 

其中门中的名称用于区分不同的yum 源。这里参数的含义如下。

（1）name：此 yum 源的描述信息。

（2） baseurl：用于指定yum源的具体地址。

（3）enabled：用于指定是否启用此 yum 源。

（4）gpgcheck：用于指定在安装软件包时，是否要进行数字签名的验证，一般设置为0

即可。

（5）gpgkey：在gpgcheck设置为1的情况下，用于指定公钥的位置。

对于yum_repository模块来说，常见的参数包括以下几个。

（1）name：repo配置文件里 [] 中的名称。

（2）description：repo配置文件里name字段的描述信息。

（3）baseurl :用于指定yum源的位置。

（4）enabled :是否启用源，值为true 或false。

（5）gpgcheck:是否启用数字签名验证，值为true或falsc。(6） gpgkey:用于指定公钥的

位置。

练习：给server2配置yum源，地址是ftp://192.168.8.11/dvd/AppStream，所需要的密

钥文件为ftp://192.168.8.11/dvd/RPM-GPG-KEY-redhat-release，命令如下。

[root@pp ~]# ansible up -m yum_repository -a "name=app description='this is appstream' baseurl=ftp://192.168.248.45/dvd/AppStream gpgcheck=yes gpgkey=ftp://192.168.248.45/dvd/RPM-GPG-KEY-redhat-release"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "repo": "app",
    "state": "present"
}
[root@pp ~]# 

执行之后的效果如下

[root@pp ~]# ansible up -m shell -a "ls /etc/yum.repos.d/"
up | CHANGED | rc=0 >>
aa.repo
app.repo
redhat.repo
[root@pp ~]# ansible up -m shell -a "cat /etc/yum.repos.d/app.repo"
up | CHANGED | rc=0 >>
[app]
baseurl = ftp://192.168.248.45/dvd/AppStream
gpgcheck = 1
gpgkey = ftp://192.168.248.45/dvd/RPM-GPG-KEY-redhat-release
name = this is appstream
[root@pp ~]# 

29.5 使用yum模块管理软件包

yum模块常见的参数包括以下几个。

（1）name：用于指定软件包的名称。

（2）state：此参数的值如下。

①present或installed：用于安装软件包，没有指定state时的默认值就是installed。

②absent或removed：用于卸载软件包。

③latest：用于更新。

注意

yum模块可以用package模块替代，用于在 Ubuntu等其他系统上管理软件包。

练习1：在server2上安装vsftpd，命令如下。

[root@pp ~]# ansible up -m yum -a "name=vsftpd state=installed"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "msg": "",
    "rc": 0,
    "results": [
        "Installed: vsftpd-3.0.3-34.el8.x86_64"
    ]
}
[root@pp ~]# 

验证，命令如下。

[root@pp ~]# ansible up -m shell -a "rpm -qa | grep vsftpd"
up | CHANGED | rc=0 >>
vsftpd-3.0.3-34.el8.x86_64

练习2：在server2上卸载vsftpd，命令如下。

[root@pp ~]# ansible up -m yum -a "name=vsftpd state=absent"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "msg": "",
    "rc": 0,
    "results": [
        "Removed: vsftpd-3.0.3-34.el8.x86_64"
    ]
}
[root@pp ~]# 

如果本机没有安装vsftpd，下面的命令就是安装，如果已经安装则更新到最新版。

1 ansible server2 ‐m yum ‐a "name=vsftpd state=latest"

如果要安装组或模块，需要在组名或模块名前加@，这个模块要使用引号引起来。

29.6 使用service模块管理服务

可以通过systemctl对服务进行启动、重启、关闭等操作，在ansible中可以调用service模

块来实现对服务的管理，service模块常见的参数包括以下几个。

（1）name :指定对哪个服务进行管理。

（2）enabled :用于设置此服务是否开机自动启动，值为yes或no，默认值为空。

（3）state:用于启动或关闭服务，其值包括started、stopped、restarted等。

首先判断server2上的vsftpd是否启动，命令如下。

[root@pp ~]# ansible up -m shell -a "systemctl is-active vsftpd"
up | FAILED | rc=3 >>
inactivenon-zero return code
[root@pp ~]# 

这里返回值为3(rc=3)，说明server2上的vsftpd没有启动。

练习：启动vsftpd并设置开机自动启动，命令如下。

[root@pp ~]# ansible up -m yum -a "name=vsftpd state=latest"
up | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "msg": "Nothing to do",
    "rc": 0,
    "results": []
}
[root@pp ~]# 

验证命令如下

[root@pp ~]# ansible up -m shell -a "systemctl is-active vsftpd"
up | CHANGED | rc=0 >>
active
[root@pp ~]# 

29.7 使用parted模块对硬盘分区

在 ansible中如果对分区进行管理，使用的是parted模块，parted模块常见的参数包括以

下几个。

（1）device：指的是哪块磁盘。

（2）number：第几个分区。

（3）part_start：指的是从硬盘的什么位置开始划分，不写默认为从头开始（0%)。

（4）part_end：指的是到硬盘的什么位置作为分区的结束点。

（5）state：用于指定操作，present是创建，absent是删除。

自行在server2上新添加一块类型为SCSI、大小为20G的硬盘，命令如下。

[root@up ~]# lsblk
NAME          MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
sr0            11:0    1 10.2G  0 rom  /mnt
nvme0n1       259:0    0  100G  0 disk 
├─nvme0n1p1   259:1    0    1G  0 part /boot
└─nvme0n1p2   259:2    0   99G  0 part 
  ├─rhel-root 253:0    0   98G  0 lvm  /
  └─rhel-swap 253:1    0    1G  0 lvm  [SWAP]
[root@up ~]# 

练习1：在up上对/dev/nvme0np1创建一个大小为2GiB的分区/dev/nvme0n2p1，命令如下。

[root@pp ~]# ansible up -m parted -a "device=/dev/nvme0n2 number=1 part_end=2GiB state=present"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,

29.8 使用filesystem模块格式化

分区创建好之后，需要对分区进行格式化操作，格式化的模块为filesystem，filesystem

模块常见的参数包括以下几个。

（1）dev：用于指定对哪个设备进行格式化。

（2）fstype：用于指定用什么文件系统进行格式化。

（3）force：是否强制格式化，默认为no。

练习：把 up上的/dev/nvmeon2p3格式化为XFS文件系统，命令如下。

[root@pp ~]# ansible up -m filesystem -a "dev=/dev/nvme0n2p3 fstype=xfs"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true
}
[root@pp ~]# 

如果想重新格式化，需要加上 force选项，命令如下。

[root@pp ~]# ansible up -m filesystem -a "dev=/dev/nvme0n2p3 fstype=xfs force=yes"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true
}
[root@pp ~]# 

29.9 使用mount 模块挂载文件系统

格式化之后就需要挂载分区，挂载用的是mount模块，mount模块常见的参数包括以下

几个。

（1）src：用于指定挂载哪个设备。

（2）path：用于指定挂载点。

（3）fstype：用于指定挂载的文件系统,这个选项一定要指定。

（4）opts：用于指定挂载选项,如果不指定则为defaults。

（5）state：此参数的值如下。

①mounted：挂载的同时，也会写入/etc/fstab。

②present：只是写入/etc/fstab，但当前并没有挂载。

③unmounted：只卸载，并不会把条目从/etc/fstab中删除。

④absent：卸载并从/etc/fstab中删除。

练习1：把server2上的/dev/sdb3挂载到/123目录上，挂载选项为只读，命令如下

[root@pp ~]# ansible up -m shell -a "mkdir /123"
up | CHANGED | rc=0 >>
[root@pp ~]# ansible up -m mount -a "src=/dev/nvme0n2p3 path=/123 state=mounted fstype=xfs opts=defaults,ro"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "dump": "0",
    "fstab": "/etc/fstab",
    "fstype": "xfs",
    "name": "/123",
    "opts": "defaults,ro",
    "passno": "0",
    "src": "/dev/nvme0n2p3"
}
[root@pp ~]# 

这里指定了挂载选项为defaults,ro，多个选项用逗号隔开。

验证，命令如下。

[root@pp ~]# ansible up -m shell -a "df -Th | grep nvme0n2p3"
up | CHANGED | rc=0 >>
/dev/nvme0n2p3        xfs       2.8G  256K  2.8G    1% /123
[root@pp ~]# ansible up -m shell -a "grep nvme0n2p3 /etc/fstab"
up | CHANGED | rc=0 >>
/dev/nvme0n2p3 /123 xfs defaults,ro 0 0
[root@pp ~]# 

为挂载时state的值是mounted，所以不仅把/dev/sdb3挂载了，也写人/etc/fstab

了。

练习2：在server2上卸载并从/etc/fstab中删除/dev/sdb3，命令如下。

[root@pp ~]# ansible up -m mount -a "src=/dev/nvme0n2p3 path=/123 state=absent"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "dump": "0",
    "fstab": "/etc/fstab",
    "name": "/123",
    "opts": "defaults",
    "passno": "0",
    "src": "/dev/nvme0n2p3"
}
[root@pp ~]# 

注意

如果卸载，path是一定要指定的，src指定不指定都无所谓。

29.10 使用lvg模块对卷组进行管理

使用lvg模块管理卷组，此模块常见的参数包括以下几个。

（1）pvs：用于指定物理卷，如果有多个PV则用逗号隔开，不需要提前创建PV，此命令

会自动创建PV。

（2）vg：用于指定卷组的名称。

（3）pesize：用于指定PE的大小。

（4）state：此参数的值如下。present :用于创建卷组，默认。absent :用于删除卷组。

练习1：在server2上创建名称为vg0的卷组，所使用的分区为/dev/sdb1

和/dev/sdb2/pesize指定为16M。

先确认server2上不存在任何PV 和VG,命令如下。

[root@pp ~]# ansible up -m shell -a "vgs"
up | CHANGED | rc=0 >>

[root@pp ~]# 

开始创建vg0，命令如下。

[root@pp ~]# ansible up -m lvg -a "pvs=/dev/nvme0n2p1,/dev/nvme0n2p2 vg=vg0 pesize=16 state=present"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true
}
[root@pp ~]# 

这里如果不指定pesize选项，则默认为4。

验证，命令如下。

[root@pp ~]# ansible up -m shell -a "vgs"
up | CHANGED | rc=0 >>
  VG   #PV #LV #SN Attr   VSize   VFree 
  rhel   1   2   0 wz--n- <99.00g     0 
  vg0    2   0   0 wz--n-  <3.72g <3.72g
[root@pp ~]# 

练习2：删除卷组 vg0，命令如下。

[root@pp ~]# ansible up -m lvg -a "vg=vg0 pesize=16 state=absent"
up | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true
}
[root@pp ~]# 

验证，命令如下。

[root@pp ~]# ansible up -m shell -a "vgs"
up | CHANGED | rc=0 >>
  VG   #PV #LV #SN Attr   VSize   VFree
  rhel   1   2   0 wz--n- <99.00g    0 
[root@pp ~]# 

可以看到，vg0已经没有了。

请使用ansible server2 -m lvg -a "pvs=ldev/sdb1,/dev/sdb2 vg-vg0 pesize=16

state-present"命令再次把vg0创建出来。