当前位置：首页 > news >正文

ansible常用模块

news 来源：原创 2025/7/27 18:35:54

一.ansible常用模块
ansible [主机or组列表] -m 模块 -a "参数"1.shell:类似于在终端上直接输入命令,支持bash特性2.command(默认模块):使用的变量需要事先定义好,不支持bash特性，如管道、重定向3.script: 执行脚本,支持python,shell脚本4.file:用于在被控节点创建文件、目录、链接文件等,还可以修改权限、归属state：状态。touch表示创建文件，directory表示创建目录，link表示创建软链接，absent表示删除5.copy:上传操作,用于将控制节点指定文件或者"内容"发送被被控节点# 常用参数src：源。控制端的文件路径dest：目标。被控制端的文件路径content：内容。指定内容写入文件6.fetch:下载操作,用于将被控节点指定文件发送到控制节点src: dest: flat: yes   #只获取文件7.lineinfile:一行一行改,在文件中添加、删除或替换行,支持正则# 常用参数path：待修改的文件路径line：写入文件的一行内容regexp：正则表达式，用于查找文件中的内容8.replace:使用正则,用于关键词匹配替换9.user:用于实现Linux用户管理# 常用参数name：待创建的用户名uid：用户IDgroup：设置主组groups：设置附加组home：设置家目录password：设置用户密码state：状态。present表示创建，它是默认选项。absent表示删除remove：删除家目录、邮箱等。值为yes或true都可以设置密码:{{}}是固定格式，表示执行命令password_hash()是函数，sha512是加密算法ansible webservers -m user -a "name=tom password={{'123456'|password_hash('sha512')}}"10.group:用于实现Linux组管理name：待创建的组名gid：组的ID号state：present表示创建，它是默认选项。absent表示删除11.yum_repository:yum软件包仓库name：包名state：状态 (present表示安装，如果已安装则忽略,latest表示安装或升级到最新版本,absent表示卸载)清理指定文件中的源(如果清理指定name的源文件内还有其他源则文件保留，如果无其他源则同时删除文件)ansible webservers -m yum_repository -a "file=myrepo name=AppStream state=absent"12.yum	:装包使用yum模块安装多个包，包名之间使用,分隔ansible webservers -m yum -a "name=wget,net-tools state=present"name：包名state：状态(present表示安装，如果已安装则忽略,latest表示安装或升级到最新版本,absent表示卸)13.service:管理Linux系统服务，如启动、关闭、重启、是否开机自启动name：控制的服务名state：started表示启动；stopped表示关闭；restarted表示重启enabled：yes表示设置开机自启；no表示设置开机不要自启# 验证被控节点nginx服务是否启动且设置为开机自启动# ansible webservers -a "systemctl is-active nginx"# ansible webservers -a "systemctl is-enabled nginx"14.parted:磁盘分区#不指定part_start则从0%开始ansible web1 -m parted -a "device=/dev/vdb number=1 part_end=5GiB label=gpt state=present"        #不指定part_end则到100%为止ansible web1 -m parted -a "device=/dev/vdb number=2 part_start=5GiB label=gpt state=present"      device：待分区的设备number：分区编号vd1,vd2state：present表示创建，absent表示删除part_start：分区的起始位置，不写表示从开头GiBpart_end：表示分区的结束位置，不写表示到结尾label：表示标签，要使用的磁盘标签类型，分区表15.lvg:用于管理卷组，包括创建、删除等vg：定义卷组名。vg：volume grouppvs：由哪些物理卷构成。pvs：physical volumespesize：指定物理区块大小，默认4M。pe：physical extent(PE大小)state：present创建卷组；absent删除卷组# 扩容时需要指定所有物理卷ansible web1 -m lvg -a "vg=myvg pvs=/dev/vdb1,/dev/vdb2"# 使用lvg模块删除myvg卷组ansible web1 -m lvg -a "vg=myvg state=absent"16.lvol:管理逻辑卷，包括创建、删除、修改逻辑卷大小vg：指定在哪个卷组上创建逻辑卷lv：创建的逻辑卷名。lv：logical volumesize：逻辑卷的大小，不写单位，以M为单位state：present创建逻辑卷；absent删除逻辑卷# 使用lvol模块删除mylv逻辑卷，force=yes：这个参数用于强制执行，ansible web1 -m lvol -a "vg=myvg lv=mylv state=absent force=yes"17.filesystem:创建文件系统，支持ext2、ext4、xfs等类型，并能传递额外选项给mkfs命令fstype：指定文件系统类型dev：指定要格式化的设备，可以是分区，可以是逻辑卷state：present用于创建文件系统；absent用于擦除文件系统force：用于强制操作(重新更改文件类型)18.mount:用于挂载指定分区path：挂载点。如果挂载点不存在，自动创建。src：待挂载的设备fstype：文件系统类型state：mounted表示永久挂载；unmounted表示临时卸载；present表示临时挂载；absent表示永久卸载# 使用mount模块实现mylv逻辑卷永久卸载ansible web1 -m mount -a "path=/data state=absent"19.get_url:从指定的URL下载文件到目标主机常用参数url: url网站dest: 目标位置20.setup:用于获取所有facts信息## 常用参数filter：用于过滤指定信息ansible webservers -m setup -a "filter=ansible_all_ipv4_addresses"21.debug:用于打印信息## 常用参数msg：打印变量值，格式为：{{ 变量名 }}var：打印变量值，格式为：变量名- name: test debughosts: webserverstasks:- name: test debug msgdebug:msg: "hostname: {{ ansible_hostname }}; mem: {{ ansible_memtotal_mb }}"22.fail:用于报错和中断任务执行23.Firewalld:防火墙(报错信息:没有到主机的路由)## 常用参数port：声明端口permanent：永久生效，但不会立即生效immediate：立即生效，临时生效state：enabled，放行；disabled拒绝24.Template:将".j2"结尾文件(的内容)上传到"相应主机"的某个文件中,并将变量替换为显示"相应主机"的值,也可以将普通文件上传(也可以传递文件里面的变量),相比于copy模块更加灵活## 常用参数src：要上传的文件dest：目标文件路径

一.ansible常用模块
ansible [主机or组列表] -m 模块 -a "参数"

1.shell:类似于在终端上直接输入命令,支持bash特性

2.command(默认模块):使用的变量需要事先定义好,不支持bash特性，如管道、重定向

3.script: 执行脚本,支持python,shell脚本

4.file:用于在被控节点创建文件、目录、链接文件等,还可以修改权限、归属

state：状态。touch表示创建文件，directory表示创建目录，link表示创建软链接，absent表示删除

5.copy:上传操作,用于将控制节点指定文件或者"内容"发送被被控节点
   # 常用参数
    src：源。控制端的文件路径
   dest：目标。被控制端的文件路径
   content：内容。指定内容写入文件

6.fetch:下载操作,用于将被控节点指定文件发送到控制节点
src:
dest:
flat: yes #只获取文件

7.lineinfile:一行一行改,在文件中添加、删除或替换行,支持正则
   # 常用参数
   path：待修改的文件路径
   line：写入文件的一行内容
   regexp：正则表达式，用于查找文件中的内容

8.replace:使用正则,用于关键词匹配替换

9.user:用于实现Linux用户管理
# 常用参数
name：待创建的用户名
uid：用户ID
group：设置主组
groups：设置附加组
home：设置家目录
password：设置用户密码
state：状态。present表示创建，它是默认选项。absent表示删除
remove：删除家目录、邮箱等。值为yes或true都可以
设置密码:
{{}}是固定格式，表示执行命令
password_hash()是函数，sha512是加密算法
ansible webservers -m user -a "name=tom password={{'123456'|password_hash('sha512')}}"

10.group:用于实现Linux组管理

name：待创建的组名
gid：组的ID号
state：present表示创建，它是默认选项。absent表示删除

11.yum_repository:yum软件包仓库

name：包名
state：状态 (present表示安装，如果已安装则忽略,latest表示安装或升级到最新版本,absent表示卸载)

清理指定文件中的源(如果清理指定name的源文件内还有其他源则文件保留，如果无其他源则同时删除文件)
ansible webservers -m yum_repository -a "file=myrepo name=AppStream state=absent"

12.yum :装包

使用yum模块安装多个包，包名之间使用,分隔
ansible webservers -m yum -a "name=wget,net-tools state=present"

name：包名
state：状态(present表示安装，如果已安装则忽略,latest表示安装或升级到最新版本,absent表示卸)

13.service:管理Linux系统服务，如启动、关闭、重启、是否开机自启动
name：控制的服务名
state：started表示启动；stopped表示关闭；restarted表示重启
enabled：yes表示设置开机自启；no表示设置开机不要自启

# 验证被控节点nginx服务是否启动且设置为开机自启动
# ansible webservers -a "systemctl is-active nginx"
# ansible webservers -a "systemctl is-enabled nginx"

14.parted:磁盘分区
#不指定part_start则从0%开始
ansible web1 -m parted -a "device=/dev/vdb number=1 part_end=5GiB label=gpt state=present"
#不指定part_end则到100%为止
ansible web1 -m parted -a "device=/dev/vdb number=2 part_start=5GiB label=gpt state=present"
device：待分区的设备
number：分区编号vd1,vd2
state：present表示创建，absent表示删除
part_start：分区的起始位置，不写表示从开头GiB
part_end：表示分区的结束位置，不写表示到结尾
label：表示标签，要使用的磁盘标签类型，分区表

15.lvg:用于管理卷组，包括创建、删除等

vg：定义卷组名。vg：volume group
pvs：由哪些物理卷构成。pvs：physical volumes
pesize：指定物理区块大小，默认4M。pe：physical extent(PE大小)
state：present创建卷组；absent删除卷组

# 扩容时需要指定所有物理卷
ansible web1 -m lvg -a "vg=myvg pvs=/dev/vdb1,/dev/vdb2"
# 使用lvg模块删除myvg卷组
ansible web1 -m lvg -a "vg=myvg state=absent"

16.lvol:管理逻辑卷，包括创建、删除、修改逻辑卷大小

vg：指定在哪个卷组上创建逻辑卷
lv：创建的逻辑卷名。lv：logical volume
size：逻辑卷的大小，不写单位，以M为单位
state：present创建逻辑卷；absent删除逻辑卷

# 使用lvol模块删除mylv逻辑卷，force=yes：这个参数用于强制执行，
ansible web1 -m lvol -a "vg=myvg lv=mylv state=absent force=yes"

17.filesystem:创建文件系统，支持ext2、ext4、xfs等类型，并能传递额外选项给mkfs命令
fstype：指定文件系统类型
dev：指定要格式化的设备，可以是分区，可以是逻辑卷
state：present用于创建文件系统；absent用于擦除文件系统
force：用于强制操作(重新更改文件类型)

18.mount:用于挂载指定分区

path：挂载点。如果挂载点不存在，自动创建。
src：待挂载的设备
fstype：文件系统类型
state：mounted表示永久挂载；unmounted表示临时卸载；present表示临时挂载；absent表示永久卸载

# 使用mount模块实现mylv逻辑卷永久卸载
ansible web1 -m mount -a "path=/data state=absent"

19.get_url:从指定的URL下载文件到目标主机
   常用参数
   url: url网站
   dest: 目标位置

20.setup:用于获取所有facts信息
   ## 常用参数
   filter：用于过滤指定信息
   ansible webservers -m setup -a "filter=ansible_all_ipv4_addresses"

21.debug:用于打印信息
## 常用参数
msg：打印变量值，格式为：{{ 变量名 }}
var：打印变量值，格式为：变量名
   - name: test debug
   hosts: webservers
   tasks:
   - name: test debug msg
   debug:
   msg: "hostname: {{ ansible_hostname }}; mem: {{ ansible_memtotal_mb }}"

22.fail:用于报错和中断任务执行

23.Firewalld:防火墙(报错信息:没有到主机的路由)
## 常用参数
port：声明端口
permanent：永久生效，但不会立即生效
immediate：立即生效，临时生效
state：enabled，放行；disabled拒绝

24.Template:将".j2"结尾文件(的内容)上传到"相应主机"的某个文件中,并将变量替换为显示"相应主机"的值,
也可以将普通文件上传(也可以传递文件里面的变量),相比于copy模块更加灵活
## 常用参数
src：要上传的文件
dest：目标文件路径

相关文章：