ansible基础(模块)
Ansible-playbook（剧本）
注意：编写yaml文件时，一定要注意文件的格式，必须严格按照以下格式执行，错一个都不行
此工具用于执行编写好的 playbook 任务
[root@instance-gvpb80ao ~]# cat hello.yaml
- hosts: public（public代表分组名）
remote_user: root
gather_facts: no
tasks:
- name: hello world
shell: echo "Hello world" > /root/1.txt
[root@instance-gvpb80ao ~]# ansible-playbook hello.yaml
PLAY [web] *********************************************************************************************************
TASK [hello world] *************************************************************************************************
changed: [172.16.1.9]
PLAY RECAP *********************************************************************************************************
172.16.1.9 : ok=1 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
ansible-vault
此工具可以用于加密解密yml文件。
格式
ansible-vault [create|decrypt|edit|encrypt|rekey|view]
范例
ansible-vault encrypt hello.yml #加密
[root@instance-gvpb80ao ~]# ansible-vault encrypt hello.yaml
New Vault password:
Confirm New Vault password:
Encryption successful
[root@instance-gvpb80ao ~]# cat hello.yaml
$ANSIBLE_VAULT;1.1;AES256
32613137393965313332353065366264303763323230323766366261636430376661373038626432
3732623762313131316565386338633635613530653736640a363462373930396562343565653936
34333035633365343063303966386264343366383839333439643961383438316537616666353931
3234323937363565660a303931313032346134393534653662363266613563386633613537313664
37313434333764656637623761346662656238393631323230326366396364613138623430663063
34396532646266336136333566313164656232366336653932396634643565366266666464623631
65366163343764613166336430613564306633333331343166343236323834343631613438333865
30346430363465356562643932653766636230383137346332323064636236616532333432353432
62373435386162613961376134643237366461653734626664353737363432323761366263336461
36323537633837316664306439303534343536373162333537646462303864323233303436643839
336130356436613230633231623035633536
ansible-vault decrypt hello.yml #解密
[root@instance-gvpb80ao ~]# ansible-vault decrypt hello.yaml
Vault password:
Decryption successful
[root@instance-gvpb80ao ~]# cat hello.yaml
- hosts: public
remote_user: root
gather_facts: no
tasks:
- name: hello world
command: echo "Hello Chenyang" > /root/123456
ansible-vault view hello.yml #查看
[root@instance-gvpb80ao ~]# ansible-vault view hello.yaml
Vault password:
- hosts: public
remote_user: root
gather_facts: no
tasks:
- name: hello world
command: echo "Hello Chenyang" > /root/123456
ansible-vault edit hello.yml #编辑加密文件
[root@instance-gvpb80ao ~]# ansible-vault edit hello.yaml
Vault password:
[root@instance-gvpb80ao ~]# cat hello.yaml
$ANSIBLE_VAULT;1.1;AES256
32623539636538376665373330626334643538306161613462393334656633613030663634396334
6266386165643361323137343161313536643038393661650a623861366330343135623365623336
37323064623562316162613034636232333535366637613461396434363938643532616133643836
3766343533616637650a313737316262366233396433353030393262633366333939636537316165
65623861643233353939653430623334323138366435326234353638666635373132616162666332
36643834313263393237323232323537633933313430323530343032313637643332653862326465
66333438303737663463386363383034343135643431316634363737376265336366363764656437
66666333316466313161333061383930376562366631643962386462353535363535333461353035
62376463663630383465666662616139636631626334373564346131363531636439386431623666
3933393266353638346232366666313137653962356130373739
ansible-vault rekey hello.yml #修改口令
[root@instance-gvpb80ao ~]# ansible-vault rekey hello.yaml
Vault password:
New Vault password:
Confirm New Vault password:
Rekey successful
ansible-vault create new.yml #创建新文件
[root@instance-gvpb80ao ~]# ansible-vault create abc.yaml
New Vault password:
Confirm New Vault password:
[root@instance-gvpb80ao ~]# cat abc.yaml
$ANSIBLE_VAULT;1.1;AES256
32653230653437313566623734666166346632613366373732346533396130396132323433653238
6139333135386637303939306437306637303837663361650a653466663938313032613330653636
66346639613937333939393036336334396234616139633066386330343831333439643039353436
6134313033616235390a353362643562633763303063313264633435306635643965356636303964
6430
ansible-console
此工具可交互执行命令，支持tab，ansible 2.0+新增
提示符格式
执行用户@当前操作的主机组 (当前组的主机数量)[f:并发数]$
常用子命令
设置并发数： forks n 例如： forks 10
切换组： cd 主机组 例如： cd web
列出当前组主机列表： list
列出所有的内置命令： ?或help
范例：
[root@instance-gvpb80ao ~]# ansible-console
Welcome to the ansible console.
Type help or ? to list commands.
root@all (2)[f:5]$ ping
172.16.0.4 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
106.13.81.75 | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"ping": "pong"
}
root@all (2)[f:5]$ list
106.13.81.75
172.16.0.4
ansible-galaxy
此工具会连接 https://galaxy.ansible.com 下载相应的roles
#查看列表
[root@instance-gvpb80ao ~]# ansible-galaxy list
#/root/.ansible/roles
- geerlingguy.nginx, 3.0.0
#/usr/share/ansible/roles
#/etc/ansible/roles
#下载nginx roles
[root@instance-gvpb80ao ~]# ansible-galaxy install geerlingguy.nginx
- downloading role 'nginx', owned by geerlingguy
- downloading role from https://github.com/geerlingguy/ansible-role-nginx/archive/3.0.0.tar.gz
- extracting geerlingguy.nginx to /root/.ansible/roles/geerlingguy.nginx
- geerlingguy.nginx (3.0.0) was installed successfully
#删除
[root@instance-gvpb80ao ~]# ansible-galaxy remove geerlingguy.nginx
- successfully removed geerlingguy.nginx
Ansible模块（一）
2015年底270多个模块，2016年达到540个，2018年01月12日有1378个模块，2018年07月15日1852个模块,2019年05月25日（ansible 2.7.10）时2080个模块，2020年03月02日有3387个模块。虽然模块众多，但最常用的模块也就20~30个而已，针对特定业务只用10几个模块。
常用模块帮助文档参考：
https://docs.ansible.com/ansible/2.9/modules/modules_by_category.html
https://docs.ansible.com/ansible/2.9/modules/list_of_all_modules.html
https://docs.ansible.com/ansible/latest/modules/list_of_all_modules.html
https://docs.ansible.com/ansible/latest/modules/modules_by_category.html
Command 模块
command模块是Ansible中的默认模块，
功能：在远程主机执行命令，此为默认模块，可忽略-m选项
注意：此命令不支持 $VARNAME < > | ; &（特殊字符，变量） 等，用shell模块实现
[root@instance-gvpb80ao ~]# ansible all -a 'hostname'
106.13.81.75 | CHANGED | rc=0 >>
instance-gvpb80ao.novalocal
172.16.0.4 | CHANGED | rc=0 >>
instance-gvpb80ao.novalocal
[root@instance-gvpb80ao ~]# ansible public -m command -a 'ls /root'
106.13.81.75 | CHANGED | rc=0 >>
abc.yaml
hello.yaml
hosts.list
open-user-crt.sh
push_ssh_key.sh
Shell模块
功能：和command相似，用shell执行命令,支持各种符号，变量等,比如:*,$, >
范例：
[root@instance-gvpb80ao ~]# ansible all -m shell -a "echo $HOSTNAME"
106.13.81.75 | CHANGED | rc=0 >>
instance-gvpb80ao.novalocal
172.16.0.4 | CHANGED | rc=0 >>
instance-gvpb80ao.novalocal
注意：调用bash执行命令 类似 cat /tmp/test.md | awk -F'|' '{print $1,$2}' &> /tmp/example.txt 这些复杂命令，即使使用shell也可能会失败。
解决办法：将复杂命令写到脚本中，copy到远程，再在自己主机上操作远端的机器执行脚本，就能得到结果。
将shell模块代替command，设为默认模块
[root@instance-gvpb80ao ~]# vim /etc/ansible/ansible.cfg
module_name = shell
Script 模块
功能：远程主机执行ansible服务器上的脚本(无需执行权限)
注意：脚本必须必须必须在本地ansible机器上
[root@instance-gvpb80ao ~]# ansible public -m script -a /root/test.sh
106.13.81.75 | CHANGED => {
"changed": true,
"rc": 0,
"stderr": "Shared connection to 106.13.81.75 closed.\r\n",
"stderr_lines": [
"Shared connection to 106.13.81.75 closed."
],
"stdout": "",
"stdout_lines": []
}
[root@instance-gvpb80ao ~]# cat date.txt
Wed May 19 16:05:10 CST 2021
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表示。 |
范例1：将本机的push_ssh_key.sh复制到远程的/tmp目录，用户为shanhe，权限为600
[root@instance-gvpb80ao ~]# ansible public -m copy -a “src=push_ssh_key.sh dest=/tmp owner=shanhe mode=600”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“checksum”: “0b836bbe30e61896040525bee00ffee867f4a08c”,
“dest”: “/tmp/push_ssh_key.sh”,
“gid”: 0,
“group”: “root”,
“md5sum”: “410a687367c54811ff9ce34791319e0c”,
“mode”: “0600”,
“owner”: “shanhe”,
“size”: 264,
“src”: “/root/.ansible/tmp/ansible-tmp-1621494824.72-317-250283194147221/source”,
“state”: “file”,
“uid”: 1001
}
[root@instance-gvpb80ao ~]# ll /tmp/push_ssh_key.sh
-rw------- 1 shanhe root 264 May 20 15:13 /tmp/push_ssh_
范例2：将本机test.sh复制到远程，并备份。
[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 pus
Fetch 模块
功能：从远程主机提取文件至ansible的主控端，copy相反，目前不支持目录
参数 解释
| 参数 | 解释 |
|---|---|
| src | （必需）要获取的远程系统上的文件。 |
| dest | （必需）要将文件保存到的目录。 |
| fail_on_missing | 当设置为 True 或 yes，如果由于不明因素导致从远程主机中不能读取到该文件，则会显示 fail |
| validate_checksum | 当文件fetch之后进行md5检查 |
| Flat | 允许覆盖默认行为从hostname/path到/file的，如果dest以/结尾，它将使用源文件的基础名称 |
范例1
[root@instance-gvpb80ao ~]# ansible public -m fetch -a "src=/tmp/push_ssh_key.sh dest=shanhe.sh "
106.13.81.75 | CHANGED => {
“changed”: true,
“checksum”: “488c35d2c33b1e4cef55ff0d85cab928e68f3330”,
“dest”: “/root/shanhe.sh/106.13.81.75/tmp/push_ssh_key.sh”,
“md5sum”: “1adcefd1e3aea3dbd54f0da29e586732”,
“remote_checksum”: “488c35d2c33b1e4cef55ff0d85cab928e68f3330”,
“remote_md5sum”: null
}
[root@instance-gvpb80ao ~]# tree shanhe.sh
/root/shanhe.sh/
└── 106.13.81.75
└── tmp
└── push_ssh_key.sh
2 directories, 1 file
范例2
[root@instance-gvpb80ao /]# ansible public -m fetch -a “src=/tmp/push_ssh_key.sh dest=/opt validate_checksum=yes”
106.13.81.75 | CHANGED => {
“changed”: true,
“checksum”: “488c35d2c33b1e4cef55ff0d85cab928e68f3330”,
“dest”: “/opt/106.13.81.75/tmp/push_ssh_key.sh”,
“md5sum”: “1adcefd1e3aea3dbd54f0da29e586732”,
“remote_checksum”: “488c35d2c33b1e4cef55ff0d85cab928e68f3330”,
“remote_md5sum”: null
}
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。 |
范例1
[root@instance-gvpb80ao opt]# ansible public -m file -a “path=/root/1.txt state=touch”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“dest”: “/root/1.txt”,
“gid”: 0,
“group”: “root”,
“mode”: “0644”,
“owner”: “root”,
“size”: 0,
“state”: “file”,
“uid”: 0
}
[root@instance-gvpb80ao opt]# ll /root/
total 28
-rw-r–r-- 1 root root 0 May 20 15:55 1.txt
#删除文件
ansible public -m file -a “path=/root/1.txt state=absent”
范例2
[root@instance-gvpb80ao ~]# ansible public -m file -a “path=/root/txt state=directory owner=shanhe group=chenyang”
106.13.81.75 | SUCCESS => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: false,
“gid”: 1002,
“group”: “chenyang”,
“mode”: “0755”,
“owner”: “shanhe”,
“path”: “/root/txt”,
“size”: 4096,
“state”: “directory”,
“uid”: 1001
}
[root@instance-gvpb80ao ~]# ll
total 36
drwxr-xr-x 2 shanhe chenyang 4096 May 20 16:08 txt
Copy to clipboardErrorCopied
范例3
[root@instance-gvpb80ao ~]# ansible public -m file -a “path=/root/test src=/root/txt state=link owner=shanhe group=chenyang”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“dest”: “/root/test”,
“gid”: 0,
“group”: “root”,
“mode”: “0777”,
“owner”: “root”,
“size”: 9,
“src”: “/root/txt”,
“state”: “link”,
“uid”: 0
}
[root@instance-gvpb80ao ~]# ll
total 36
lrwxrwxrwx 1 root root 9 May 20 16:11 test -> /root/txt
unarchive模块
功能：解压缩。
实现有两种用法：
1、将ansible主机上的压缩包传到远程主机后解压缩至特定目录，设置copy=yes
2、将远程主机上的某个压缩包解压缩到指定路径下，设置copy=no
参数
| 参数 | 解释 |
|---|---|
| copy | 默认为yes，当copy=yes，拷贝的文件是从ansible主机复制到远程主机上，如果设置为no，则是在远程主机上直接解压文件 |
| remote_src | 和copy功能一样且互斥，yes表示在远程主机，不在ansible主机，no表示文件在ansible主机上 |
| src | 源路径，可以是ansible主机上的路径，也可以是远程主机(被管理端或者第三方主机)上的路径，如果是远程主机上的路径，则需要设copy=no |
| dest | 远程主机上的目标路径 |
| mode | 设置解压缩后的文件权限 |
范例
[root@instance-gvpb80ao ~]# ansible all -m unarchive -a "src=/root/test.tar.gz dest=/opt "
172.16.0.4 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“dest”: “/opt”,
“extract_results”: {
“cmd”: [
“/usr/bin/gtar”,
“–extract”,
“-C”,
“/opt”,
“-z”,
“-f”,
“/root/.ansible/tmp/ansible-tmp-1621499907.17-5491-141851802518117/source”
],
“err”: “”,
“out”: “”,
“rc”: 0
},
“gid”: 0,
“group”: “root”,
“handler”: “TgzArchive”,
“mode”: “0755”,
“owner”: “root”,
“size”: 4096,
“src”: “/root/.ansible/tmp/ansible-tmp-1621499907.17-5491-141851802518117/source”,
“state”: “directory”,
“uid”: 0
}
106.13.81.75 | SUCCESS => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: false,
“dest”: “/opt”,
“gid”: 0,
“group”: “root”,
“handler”: “TgzArchive”,
“mode”: “0755”,
“owner”: “root”,
“size”: 4096,
“src”: “/root/.ansible/tmp/ansible-tmp-1621499906.94-5490-71573166890415/source”,
“state”: “directory”,
“uid”: 0
}
[root@instance-gvpb80ao ~]# ll /opt/
total 1448
-rw------- 1 root root 808 May 19 15:09 hello.yaml
范例2
[root@instance-gvpb80ao ~]# ansible public -m unarchive -a “src=https://repo.huaweicloud.com/etcd/v3.2.24/etcd-v3.2.24-linux-arm64.tar.gz dest=/opt copy=no owner=shanhe group=chenyang”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“dest”: “/opt”,
“extract_results”: {
“cmd”: [
“/usr/bin/gtar”,
“–extract”,
“-C”,
“/opt”,
“-z”,
“–owner=shanhe”,
“–group=chenyang”,
“-f”,
“/root/.ansible/tmp/ansible-tmp-1621500444.96-6522-191985417198936/etcd-v3.2.24-linux-arm64.tarsHzxWS.gz”
],
“err”: “”,
“out”: “”,
“rc”: 0
},
“gid”: 0,
“group”: “root”,
“handler”: “TgzArchive”,
“mode”: “0755”,
“owner”: “root”,
“size”: 4096,
“src”: “/root/.ansible/tmp/ansible-tmp-1621500444.96-6522-191985417198936/etcd-v3.2.24-linux-arm64.tarsHzxWS.gz”,
“state”: “directory”,
“uid”: 0
}
[root@instance-gvpb80ao ~]# ll /opt/
total 1452
drwxr-xr-x 3 shanhe chenyang 4096 Jul 25 2018 etcd-v3.2.24-linux-arm64
Archive模块
功能：打包压缩保存在被管理节点。
参数
| 参数 | 解释 |
|---|---|
| path | 要压缩的文件或目录 |
| dest | 压缩后的文件 |
| format | 指定打包的类型 |
| mode | 权限 |
| group | 属组 |
| owner | 属主 |
范例
[root@instance-gvpb80ao ~]# ansible public -m archive -a “path=/root dest=/opt/root.tar.gz format=gz”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“archived”: [
“/root/.tcshrc”,
“/root/.cshrc”,
“/root/.bash_history”,
“/root/.bash_profile”,
“/root/.mysql_history”,
“/root/.viminfo”,
“/root/hello.yaml”,
“/root/test.tar.gz”,
“/root/abc.yaml”,
“/root/.ansible-console_history”,
“/root/hosts.list”,
“/root/open-user-crt.sh”,
“/root/date.txt”,
“/root/push_ssh_key.sh”,
“/root/.bash_logout”,
“/root/test.sh”,
“/root/.rnd”,
“/root/.bashrc”,
“/root/.ansible/galaxy_token”,
“/root/.ansible/tmp/ansible-local-7657zoXLcU/ansiballz_cache/archive-ZIP_DEFLATED”,
“/root/.ansible/tmp/ansible-tmp-1621502833.44-7666-63618490609724/AnsiballZ_archive.py”,
“/root/.ansible/cp/4e1832b56d”,
“/root/.cache/abrt/lastnotification”,
“/root/.ssh/authorized_keys”,
“/root/.ssh/id_rsa”,
“/root/.ssh/id_rsa.pub”,
“/root/.ssh/known_hosts”
],
“arcroot”: “//”,
“changed”: true,
“dest”: “/opt/root.tar.gz”,
“expanded_exclude_paths”: [],
“expanded_paths”: [
“/root”
],
“gid”: 0,
“group”: “root”,
“missing”: [],
“mode”: “0644”,
“owner”: “root”,
“size”: 188991,
“state”: “file”,
“uid”: 0
}
[root@instance-gvpb80ao ~]# ll /opt/
total 1640
-rw-r–r-- 1 root root 188991 May 20 17:27 root.tar.gz
[root@instance-gvpb80ao ~]#
Hostname模块
功能：管理主机名。
参数
范例
[root@instance-gvpb80ao ~]# ansible public -m hostname -a ‘name=kubernetes’
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“ansible_domain”: “”,
“ansible_fqdn”: “kubernetes”,
“ansible_hostname”: “kubernetes”,
“ansible_nodename”: “kubernetes”,
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“name”: “kubernetes”
}
[root@instance-gvpb80ao ~]# bash
[root@kubernetes ~]#
Cron模块
功能：计划任务
支持时间：minute，hour，day，month，weekday
参数
| 参数 | 解释 |
|---|---|
| minute | 分钟 |
| hour | 小时 |
| day | 天 |
| month | 月 |
| weekday | 星期 |
| job | 脚本路径 |
| name | 定时任务名称 |
| disabled | 是否启用 |
| state | 状态：absent删除 |
范例1
[root@instance-gvpb80ao ~]# ansible public -m cron -a “minute=* job=‘echo date >> /root/ttt.log’ name=test disabled=yes”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“envs”: [],
“jobs”: [
“test”
]
}
[root@instance-gvpb80ao ~]# crontab -l
#Ansible: test
#* * * * * echo date >> /root/ttt.log
范例2
[root@instance-gvpb80ao ~]# ansible public -m cron -a “minute=* job=‘echo date >> /root/ttt.log’ name=test disabled=yes state=absent”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“envs”: [],
“jobs”: []
}
[root@instance-gvpb80ao ~]# crontab -l
Yum和Apt模块
yum 管理软件包，只支持RHEL，CentOS，fedora，不支持Ubuntu其它版本。
apt 模块管理 Debian 相关版本的软件包。
参数
| 参数 | 解释 |
|---|---|
| name | 安装的服务的名字 |
| state | 执行命令 present installed removed latest absent 其中installed and present等效 latest标志安装yum中最新版本，absent and removed 等效 表示删除安装包 |
| disable_gpg_check | 用于禁用rmp包的公钥gpg验证，默认值no 表示不做验证 |
| enablerepo | 用于指定安装软件包是临时启用的yum元 |
| disablerepo | 用于指定安装软件包是临时禁止用的yum元 |
范例1
[root@instance-gvpb80ao ~]# ansible public -m yum -a “name=httpd state=present”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“changes”: {
“installed”: [
“httpd”
]
},
“msg”: “”,
“rc”: 0,
“results”: [
“Loaded plugins: langpacks, versionlock\nExcluding 1 update due to versionlock (use “yum versionlock status” to show it)\nResolving Dependencies\n–> Running transaction check\n—> Package httpd.x86_64 0:2.4.6-97.el7.centos will be installed\n–> Processing Dependency: httpd-tools = 2.4.6-97.el7.centos for package: httpd-2.4.6-97.el7.centos.x86_64\n–> Processing Dependency: /etc/mime.types for package: httpd-2.4.6-97.el7.centos.x86_64\n–> Processing Dependency: libaprutil-1.so.0()(64bit) for package: httpd-2.4.6-97.el7.centos.x86_64\n–> Processing Dependency: libapr-1.so.0()(64bit) for package: httpd-2.4.6-97.el7.centos.x86_64\n–> Running transaction check\n—> Package apr.x86_64 0:1.4.8-7.el7 will be installed\n—> Package apr-util.x86_64 0:1.5.2-6.el7 will be installed\n—> Package httpd-tools.x86_64 0:2.4.6-97.el7.centos 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 updates 2.7 M\nInstalling for dependencies:\n apr x86_64 1.4.8-7.el7 base 104 k\n apr-util x86_64 1.5.2-6.el7 base 92 k\n httpd-tools x86_64 2.4.6-97.el7.centos updates 93 k\n mailcap noarch 2.1.41-2.el7 base 31 k\n\nTransaction Summary\n================================================================================\nInstall 1 Package (+4 Dependent packages)\n\nTotal download size: 3.0 M\nInstalled size: 10 M\nDownloading packages:\n--------------------------------------------------------------------------------\nTotal 14 MB/s | 3.0 MB 00:00 \nRunning transaction check\nRunning transaction test\nTransaction test succeeded\nRunning transaction\n Installing : apr-1.4.8-7.el7.x86_64 1/5 \n Installing : apr-util-1.5.2-6.el7.x86_64 2/5 \n Installing : httpd-tools-2.4.6-97.el7.centos.x86_64 3/5 \n Installing : mailcap-2.1.41-2.el7.noarch 4/5 \n Installing : httpd-2.4.6-97.el7.centos.x86_64 5/5 \n Verifying : httpd-2.4.6-97.el7.centos.x86_64 1/5 \n Verifying : apr-1.4.8-7.el7.x86_64 2/5 \n Verifying : mailcap-2.1.41-2.el7.noarch 3/5 \n Verifying : httpd-tools-2.4.6-97.el7.centos.x86_64 4/5 \n Verifying : apr-util-1.5.2-6.el7.x86_64 5/5 \n\nInstalled:\n httpd.x86_64 0:2.4.6-97.el7.centos \n\nDependency Installed:\n apr.x86_64 0:1.4.8-7.el7 apr-util.x86_64 0:1.5.2-6.el7 \n httpd-tools.x86_64 0:2.4.6-97.el7.centos mailcap.noarch 0:2.1.41-2.el7 \n\nComplete!\n”
]
}
[root@instance-gvpb80ao ~]# systemctl status httpd
● httpd.service - The Apache HTTP Server
Loaded: loaded (/usr/lib/systemd/system/httpd.service; disabled; vendor preset: disabled)
Active: inactive (dead)
Docs: man:httpd(8)
man:apachectl(8)
[root@instance-gvpb80ao ~]#
Service模块
功能：管理服务。
参数
| 参数 | 解释 |
|---|---|
| name | 定义要启动服务的名称 |
| state | started #启动服务 stopped #停止服务 restarted #重启服务 reloaded #重载服务 |
| enabled | 开机自启 |
范例
#1.启动crond服务，并加入开机自启
[root@m01 ~]# ansible webservers -m service -a “name=crond state=started enabled=yes”
#2.停止crond服务，并删除开机自启
[root@m01 ~]# ansible webservers -m service -a “name=crond state=stopped enabled=no”
#3.重启crond服务
[root@m01 ~]# ansible webservers -m service -a “name=crond state=restarted”
#4.重载crond服务
[root@m01 ~]# ansible webservers -m service -a “name=crond state=reloaded”
User模块
功能：管理用户。
参数
| 参数 | 解释 |
|---|---|
| uid | 指定用户的uid |
| group | 指定用户组名称 |
| groups | 指定附加组名称 |
| password | 给用户添加密码（记得单引号） |
| shell | 指定用户登录shell |
| create_home | 是否创建家目录 |
| state | 用户状态：absent（删除） |
| home | 家目录路径 |
| system | 是否是系统用户 |
| remove | 是否删除家目录数据：yes（删除） |
范例
[root@instance-gvpb80ao ~]# ansible public -m user -a “name=www uid=1200”
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“comment”: “”,
“create_home”: true,
“group”: 1200,
“home”: “/home/www”,
“name”: “www”,
“shell”: “/bin/bash”,
“state”: “present”,
“system”: false,
“uid”: 1200
}
[root@instance-gvpb80ao ~]# id www
uid=1200(www) gid=1200(www) groups=1200(www)
Group模块
功能：管理组。
#创建组
ansible public -m group -a 'name=nginx gid=88 system=yes'
#删除组
ansible public -m group -a 'name=nginx state=absent'
get_url模块
功能：下载模块（类似于wget）。
参数
| 参数 | 解释 |
|---|---|
| url | 下载的URL |
| mode | 权限 |
| dest | 下载的路径 |
| checksum | md5值 |
| timeout | 下载文件的超时时间 |
| url_password | URL密码 |
| url_username | URL用户 |
范例
[root@instance-gvpb80ao ~]# ansible public -m get_url -a ‘url=https://repo.huaweicloud.com/etcd/v3.4.0-rc.4/etcd-v3.4.0-rc.4-linux-arm64.tar.gz mode=777 dest=/opt’
106.13.81.75 | CHANGED => {
“ansible_facts”: {
“discovered_interpreter_python”: “/usr/bin/python”
},
“changed”: true,
“checksum_dest”: null,
“checksum_src”: “c721f9904ff9c47cb34f304ee7d48eb99253e13a”,
“dest”: “/opt/etcd-v3.4.0-rc.4-linux-arm64.tar.gz”,
“elapsed”: 6,
“gid”: 0,
“group”: “root”,
“md5sum”: “0372460bbdf457166391e5e71c074f1c”,
“mode”: “0777”,
“msg”: “OK (15997556 bytes)”,
“owner”: “root”,
“size”: 15997556,
“src”: “/root/.ansible/tmp/ansible-tmp-1621516877.39-15455-75914400512400/tmpbxzrIQ”,
“state”: “file”,
“status_code”: 200,
“uid”: 0,
“url”: “https://repo.huaweicloud.com/etcd/v3.4.0-rc.4/etcd-v3.4.0-rc.4-linux-arm64.tar.gz”
}
mount模块
功能：挂载目录。
参数
| 参数 | 解释 |
|---|---|
| src | 挂载IP及目录 |
| path | 挂载的路径 |
| fstype | 挂载的类型 |
| opts | 默认的类型 |
| state | 挂载的状态 |
state参数
| 参数 | 解释 |
|---|---|
| present | 开机挂载，仅将挂载配置写入/etc/fstab |
| mounted | 挂载设备，并将配置写入/etc/fstab |
| unmounted | 卸载设备，不会清除/etc/fstab写入的配置 |
| absent | 卸载设备，会清理/etc/fstab写入的配置 |
范例
[root@m01 ~]# ansible web02 -m mount -a “src=172.16.1.7:/data path=/data fstype=nfs opts=defaults state=present”
[root@m01 ~]# ansible web02 -m mount -a “src=172.16.1.7:/data path=/data fstype=nfs opts=defaults state=mounted”
[root@m01 ~]# ansible web02 -m mount -a “src=172.16.1.7:/data path=/data fstype=nfs opts=defaults state=unmounted”
[root@m01 ~]# ansible web02 -m mount -a “src=172.16.1.7:/data path=/data fstype=nfs opts=defaults state=absent”
Setup模块
功能： setup 模块来收集主机的系统信息，这些 facts 信息可以直接以变量的形式使用，但是如果主机较多，会影响执行速度，可以使用 gather_facts: no 来禁止 Ansible 收集 facts 信息。
范例
ansible all -m setup -a “filter=ansible_nodename”
ansible all -m setup -a “filter=ansible_hostname”
ansible all -m setup -a “filter=ansible_domain”
ansible all -m setup -a “filter=ansible_memtotal_mb”
ansible all -m setup -a “filter=ansible_memory_mb”
ansible all -m setup -a “filter=ansible_memfree_mb”
ansible all -m setup -a “filter=ansible_os_family”
ansible all -m setup -a “filter=ansible_distribution_major_version”
ansible all -m setup -a “filter=ansible_distribution_version”
ansible all -m setup -a “filter=ansible_processor_vcpus”
ansible all -m setup -a “filter=ansible_all_ipv4_addresses”
ansible all -m setup -a “filter=ansible_architecture”
ansible all -m setup -a “filter=ansible_processor*”