23 ansible模块
Posted baim0的blog
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了23 ansible模块相关的知识,希望对你有一定的参考价值。
command模块
[root@m01 ~]# ansible \'web01\' -m command -a "df -h"
web01 | CHANGED | rc=0 >>
Filesystem Size Used Avail Use% Mounted on
devtmpfs 475M 0 475M 0% /dev
tmpfs 487M 0 487M 0% /dev/shm
tmpfs 487M 7.7M 479M 2% /run
tmpfs 487M 0 487M 0% /sys/fs/cgroup
/dev/mapper/centos-root 99G 3.6G 96G 4% /
/dev/sda1 1014M 177M 838M 18% /boot
tmpfs 98M 0 98M 0% /run/user/0
#不支持特殊符号
{}、$、|
[root@m01 ~]# ansible \'web01\' -m command -a "ifconfig eth0 | awk \'NR==2 {print $2}\'"
web01 | FAILED | rc=1 >>
|: Unknown host
ifconfig: `--help\' gives usage information.non-zero return code
#当ansible没有写模块的时候,默认使用的command模块
shell模块
#识别特殊符号,但是不支持$,需要转义\\
[root@m01 ~]# ansible \'web01\' -m shell -a "ifconfig eth0 | awk \'NR==2 {print $2}\'"
web01 | CHANGED | rc=0 >>
inet 192.168.15.7 netmask 255.255.255.0 broadcast 192.168.15.255
#加个\\解决
[root@m01 ~]# ansible \'web01\' -m shell -a "ifconfig eth0 | awk \'NR==2 {print \\$2}\'"
web01 | CHANGED | rc=0 >>
192.168.15.7
scripts模块
[root@m01 ~]# ansible \'web\' -m script -a \'~/sys.sh\'
[root@m01 ~]# ansible \'nfs,backup\' -m script -a \'~/sys.sh\'
yum_repository模块
创建源
#给web01,02,03配置php源
[root@m01 ~]# ansible \'web\' -m yum_repository -a \'description="php repo" name="PHP Repository" baseurl="http://us-east.repo.webtatic.com/yum/el7/x86_64/" gpgcheck="0" file=php\'
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"repo": "PHP Repository",
"state": "present"
}
web03 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"repo": "PHP Repository",
"state": "present"
}
web02 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"repo": "PHP Repository",
"state": "present"
}
添加源
#去掉file
[root@m01 ~]# ansible \'web\' -m yum_repository -a \'description="php repo" name="PHP Repository" baseurl="http://us-east.repo.webtatic.com/yum/el7/x86_64/" gpgcheck="0" \'
修改源
#不修改flie,和name,修改其他的内容都会修改源
copy
功能:从ansible服务器主控端复制文件到远程主机
参数
参数 | 解释 |
---|---|
src | 用于指定需要copy的文件或目录。 |
dest | 用于指定文件将被拷贝到远程主机的哪个目录中,dest为必须参数。 |
content | 当不使用src指定拷贝的文件时,可以使用content直接指定文件内容,src与content两个参数必有其一,否则会报错。 |
force | 当远程主机的目标路径中已经存在同名文件,并且与ansible主机中的文件内容不同时,是否强制覆盖,可选值有yes和no,默认值为yes,表示覆盖,如果设置为no,则不会执行覆盖拷贝操作,远程主机中的文件保持不变。 |
backup | 当远程主机的目标路径中已经存在同名文件,并且与ansible主机中的文件内容不同时,是否对远程主机的文件进行备份,可选值有yes和no,当设置为yes时,会先备份远程主机中的文件,然后再将ansible主机中的文件拷贝到远程主机。 |
owner | 指定文件拷贝到远程主机后的属主,但是远程主机上必须有对应的用户,否则会报错。 |
group | 指定文件拷贝到远程主机后的属组,但是远程主机上必须有对应的组,否则会报错。 |
mode | 指定文件拷贝到远程主机后的权限,如果你想将权限设置为”rw-r--r--“,则可以使用mode=0644表示,如果你想要在user对应的权限位上添加执行权限,则可以使用mode=u+x表示。 |
推
[root@m01 ~]# ll
-rw-r--r-- 1 root root 0 May 28 20:24 baim0.txt
#将本地的baim0.txt推到web01 /root/ 属主为www 权限为600
[root@m01 ~]# ansible web01 -m copy -a "src=/root/baim0.txt dest=/root/ owner=www mode=600"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
"dest": "/root/baim0.txt",
"gid": 0,
"group": "root",
"md5sum": "d41d8cd98f00b204e9800998ecf8427e",
"mode": "0600",
"owner": "www",
"size": 0,
"src": "/root/.ansible/tmp/ansible-tmp-1622204772.22-3550-122426624239125/source",
"state": "file",
"uid": 666
}
backup备份
功能比较鸡肋
[root@instance-gvpb80ao ~]# ansible 172* -m copy -a "src=test.sh dest=/tmp/push_ssh_key.sh backup=yes"
172.16.0.4 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"backup_file": "/tmp/push_ssh_key.sh.2054.2021-05-20@15:18:31~",
"changed": true,
"checksum": "488c35d2c33b1e4cef55ff0d85cab928e68f3330",
"dest": "/tmp/push_ssh_key.sh",
"gid": 0,
"group": "root",
"md5sum": "1adcefd1e3aea3dbd54f0da29e586732",
"mode": "0600",
"owner": "shanhe",
"size": 43,
"src": "/root/.ansible/tmp/ansible-tmp-1621495109.9-1879-108678135537148/source",
"state": "file",
"uid": 1001
}
[root@instance-gvpb80ao ~]# ll /tmp/
total 2844
-rw------- 1 shanhe root 43 May 20 15:18 push_ssh_key.sh
-rw------- 1 shanhe root 264 May 20 15:13 push_ssh_key.sh.2054.2021-05-20@15:18:31~
fetch
功能:从远程主机提取文件至ansible的主控端,copy相反,目前不支持目录
参数
参数 | 解释 |
---|---|
src | (必需)要获取的远程系统上的文件。 |
dest | (必需)要将文件保存到的目录。 |
fail_on_missing | 当设置为 True 或 yes ,如果由于不明因素导致从远程主机中不能读取到该文件,则会显示 fail |
validate_checksum | 当文件fetch之后进行md5检查 |
Flat | 允许覆盖默认行为从hostname/path到/file的,如果dest以/结尾,它将使用源文件的基础名称 |
pull
将刚刚copy过去的baim0.txt拉回来
[root@m01 ~]# ansible web01 -m fetch -a "src=/root/baim0.txt dest=/root Flat=yes"
web01 | CHANGED => {
"changed": true,
"checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
"dest": "/root/web01/root/baim0.txt",
"md5sum": "d41d8cd98f00b204e9800998ecf8427e",
"remote_checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
"remote_md5sum": null
}
[root@m01 ~]# ll
total 0
drwxr-xr-x 3 root root 18 May 28 20:37 web01
[root@m01 ~]# tree web01/
web01/
└── root
└── baim0.txt
1 directory, 1 file
file
功能:设置文件属性,创建软链接等。
- 参数
参数 | 解释 |
---|---|
path | 必须参数,用于指定要操作的文件或目录,在之前版本的ansible中,使用dest参数或者name参数指定要操作的文件或目录,为了兼容之前的版本,使用dest或name也可以。 |
recurse | 当要操作的文件为目录,将recurse设置为yes,可以递归的修改目录中文件的属性。 |
state | 此参数非常灵活,其对应的值需要根据情况设定。 directory:在远端创建目录 touch:在远端创建文件 link:创建链接文件 absent:表示删除文件或目录 mode:设置文件或目录权限 owner:设置文件或目录属主 group:设置文件或目录属组 |
src | 当state设置为link或者hard时,表示我们想要创建一个软链或者硬链,所以,我们必须指明软链或硬链链接的哪个文件,通过src参数即可指定链接源。 |
force | 当state=link的时候,可配合此参数强制创建链接文件,当force=yes时,表示强制创建链接文件。不过强制创建链接文件分为三种情况。情况一:当要创建的链接文件指向的源文件并不存在时,使用此参数,可以先强制创建出链接文件。情况二:当要创建链接文件的目录中已经存在与链接文件同名的文件时,将force设置为yes,会将同名文件覆盖为链接文件,相当于删除同名文件,创建链接文件。情况三:当要创建链接文件的目录中已经存在与链接文件同名的文件,并且链接文件指向的源文件也不存在,这时会强制替换同名文件为链接文件。 |
owner | 用于指定被操作文件的属主,属主对应的用户必须在远程主机中存在,否则会报错。 |
group | 用于指定被操作文件的属组,属组对应的组必须在远程主机中存在,否则会报错。 |
mode | 用于指定被操作文件的权限,比如,如果想要将文件权限设置为”rw-r-x--- “,则可以使用mode=650进行设置,或者使用mode=0650,效果也是相同的。如果想要设置特殊权限,比如为二进制文件设置suid,则可以使用mode=4700。 |
在web01上增删
#增
[root@m01 ~]# ansible web01 -m file -a "path=/root/baim0.txt state=touch"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"dest": "/root/baim0.txt",
"gid": 0,
"group": "root",
"mode": "0644",
"owner": "root",
"size": 0,
"state": "file",
"uid": 0
}
[root@web01 ~]# ll
total 0
-rw-r--r-- 1 root root 0 May 28 20:49 baim0.txt
#删
[root@m01 ~]# ansible web01 -m file -a "path=/root/baim0.txt state=absent"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"path": "/root/baim0.txt",
"state": "absent"
}
[root@web01 ~]# ll
total 0
创建目录并更改属主属组
[root@m01 ~]# ansible web01 -m file -a "path=/root/baim0 state=directory owner=www group=www"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"gid": 666,
"group": "www",
"mode": "0755",
"owner": "www",
"path": "/root/baim0",
"size": 6,
"state": "directory",
"uid": 666
}
[root@web01 ~]# ll
total 0
drwxr-xr-x 2 www www 6 May 28 20:54 baim0
做软连接
[root@m01 ~]# ansible web01 -m file -a "path=/root/test src=/root/baim0 state=link mode=600"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"dest": "/root/test",
"gid": 0,
"group": "root",
"mode": "0777",
"owner": "root",
"size": 11,
"src": "/root/baim0",
"state": "link",
"uid": 0
}
[root@web01 ~]# ll
total 0
drw------- 2 www www 6 May 28 20:54 baim0
lrwxrwxrwx 1 root root 11 May 28 20:57 test -> /root/baim0
#这里属组属主,权限的更改都是源文件
unarchive
功能:解压缩。
实现有两种用法:
1、将ansible主机上的压缩包传到远程主机后解压缩至特定目录,设置copy=yes
2、将远程主机上的某个压缩包解压缩到指定路径下,设置copy=no
- 参数
参数 | 解释 |
---|---|
copy | 默认为yes,当copy=yes,本地文件到远程解压,如果设置为no,则是解压远程主机上的文件 |
remote_src | 和copy功能一样且互斥,yes表示在远程主机,不在ansible主机,no表示文件在ansible主机上 |
src | 源路径,可以是ansible主机上的路径,也可以是远程主机(被管理端或者第三方主机)上的路径,如果是远程主机上的路径,则需要设copy=no |
dest | 远程主机上的目标路径 |
mode | 设置解压缩后的文件权限 |
将ansible端文件解压到远程
[root@m01 ~]# ansible web01 -m unarchive -a "src=/root/baim0.tar.gz dest=/root mode=600"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"dest": "/root",
"extract_results": {
"cmd": [
"/usr/bin/gtar",
"--extract",
"-C",
"/root",
"-z",
"-f",
"/root/.ansible/tmp/ansible-tmp-1622208438.2-4118-59021993680154/source"
],
"err": "",
"out": "",
"rc": 0
},
"gid": 0,
"group": "root",
"handler": "TgzArchive",
"mode": "0550",
"owner": "root",
"size": 235,
"src": "/root/.ansible/tmp/ansible-tmp-1622208438.2-4118-59021993680154/source",
"state": "directory",
"uid": 0
}
[root@web01 ~]# ll
drw------- 3 root root 18 May 28 20:37 web01
解压远程主机上的文件
[root@m01 ~]# ansible web01 -m unarchive -a "src=/root/baim0.tar.gz copy=0 dest=/root mode=600 owner=www group=www"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"dest": "/root",
"extract_results": {
"cmd": [
"/usr/bin/gtar",
"--extract",
"-C",
"/root",
"-z",
"--owner=www",
"--group=www",
"-f",
"/root/baim0.tar.gz"
],
"err": "",
"out": "",
"rc": 0
},
"gid": 0,
"group": "root",
"handler": "TgzArchive",
"mode": "0550",
"owner": "root",
"size": 248,
"src": "/root/baim0.tar.gz",
"state": "directory",
"uid": 0
}
[root@web01 ~]# ll
total 4
drw------- 2 www www 6 May 28 20:54 baim0
archive
功能:打包压缩保存在被管理节点。
- 参数
参数 | 解释 |
---|---|
path | 要压缩的文件或目录 |
dest | 压缩后的文件 |
format | 指定打包的类型 |
mode | 权限 |
group | 属组 |
owner | 属主 |
压缩web01机器
[root@m01 ~]# ansible web01 -m archive -a "dest=/root/web01.tar.gz path=/root/web01 format=gz mode=600 group=www owner=www"
web01 | CHANGED => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"archived": [
"/root/web01/root/baim0.txt"
],
"arcroot": "/root/",
"changed": true,
"dest": "/root/web01.tar.gz",
"expanded_exclude_paths": [],
"expanded_paths": [
"/root/web01"
],
"gid": 666,
"group": "www",
"missing": [],
"mode": "0600",
"owner": "www",
"size": 154,
"state": "file",
"uid": 666
}
[root@web01 ~]# ll
total 4
drw------- 3 root root 18 May 28 20:37 web01
-rw------- 1 www www 154 May 28 21:48 web01.tar.gz
Hostname模块
功能:管理主机名。
- 参数
参数 | 解释 |
---|---|
name | 主机名 |
案例
[root@m01 ~]# ansible web01 -m hostname -a "name=nmsl"
web01 | CHANGED => {
"ansible_facts": {
"ansible_domain": "",
"ansible_fqdn": "nmsl",
"ansible_hostname": "nmsl",
"ansible_nodename": "nmsl",
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": true,
"name": "nmsl"
}
[root@web01 ~]# bash
[root@nmsl ~]#
以上是关于23 ansible模块的主要内容,如果未能解决你的问题,请参考以下文章