Ansible 从入门到实战(4)-Ansible 常用模块 A 篇
前面已经初步接触了 Ansible 的模块,下面对一些常用的模块进行介绍
一、省点力气
下面的几点知识有助于我们学习和理解模块的使用
- 列出 ansible 所支持的模块。
ansible-doc -l
- 查看模块的详细帮助信息,比如查看 fetch 模块的帮助。
ansible-doc -s fetch
- 调用模块,比如调用 ping 模块。
ansible 192.168.128.83 -m ping
- 调用模块的同时传入模块所需要的参数,以 fetch 模块为例。
ansible 192.168.128.83 -m fetch -a "src=/testdir/testfile1 dest=/testdir/ansible/"
二、默认模块 commamd
- 作用:在目标主机上执行命令
- 使用例子:
chdir # 切换目录
creates # 如果存在,则不执行后面的命令
removes # 如果存在,则执行后面的命令
ansible web -a 'pwd'
ansible web -a 'ls /tmp'
ansible web -a 'creates=/tmp mdkir /data' #被忽略,因为/tmp存在
ansible web -a 'creates=/tmp2 mkdir /data' #被执行,因为/tmp2目录不存在
ansible web -a 'removes=/tmp2 mkdir /data2' #被忽略,因为/tmp2目录不存在
ansible web -a 'removes=/tmp mkdir /data2' # 被执行,因为/tmp存在
- 使用实例:
ansible apple -a 'creates=/tmp mdkir /data'
结果如下:
[root@localhost ~]# ansible apple -a 'creates=/tmp mdkir /data'
apple | SUCCESS | rc=0 >>
skipped, since /tmp exists
- 注意:
The command(s) will not be processed through the shell, so variables like $HOME and operations like "<", ">", "|", ";" and "&" will not work.
三、shell 模块
- 作用:在目标主机上执行 shell 命令
- 使用例子:
ansible apple -m shell -a 'echo "1234"|passwd --stdin alex'
ansible apple -m shell -a "bash a.sh" # 执行脚本
ansible apple -m shell -a "/root/a.sh"
ansible apple -m shell -a "/root/a.py" # 执行python文件
ansible apple -m shell -a "ps -ef | grep -E 'api|srv'"
ansible apple -m shell -a "chdir=/data/solution rsync -av --delete microsso1/ microsso2/"
ansible apple -m shell -a "ps -ef | grep api"
ansible apple -m shell -a "ps -ef | grep srv"
ansible apple -m shell -a "ps -ef | grep -E 'srv|api'"
ansible apple -m shell -a "netstat -lntp | grep -E 'srv|api|apple|consul'"
ansible apple -m shell -a "tail -n10 /data/solution/apple/log/console_output.log"
ansible apple -m shell -a "/data/solution/apple/bin/stop.sh"
ansible apple -m shell -a "tail -n10 /data/solution/apple/log/console_output.log"
ansible apple -m shell -a "df -hT"
ansible apple -m shell -a "ps -ef | grep -E 'srv|api'"
ansible apple -m shell -a "du -h --max-depth=1 /data/"
ansible apple -m shell -a "ls -al /data/solution/apple/page/"
- 使用实例:
ansible apple -m shell -a 'echo $TERM'
结果如下:
[root@localhost ~]# ansible apple -m shell -a 'echo $TERM'
apple | CHANGED | rc=0 >>
xterm
四、script 模块
-
作用:把本地的脚本传到远程目标主机并且执行
-
使用例子:
creates 远程主机存在该文件,则跳过
removes 远程主机不存在该文件,则跳过
ansible apple -m script -a "/root/b.sh"
ansible apple -m script -a "creates=/root/a.py /root/b.sh"
ansible apple -m script -a "removes=/root/a.py /root/b.sh"
- 使用实例:
创建/root/b.sh 脚本,内容为 ls -l /tmp
执行以下命令
ansible apple -m script -a "/root/b.sh"
结果如下:
[root@localhost ~]# ansible apple -m script -a "/root/b.sh"
apple | CHANGED => {
"changed": true,
"rc": 0,
"stderr": "Shared connection to 192.168.153.129 closed.\r\n",
"stderr_lines": [
"Shared connection to 192.168.153.129 closed."
],
"stdout": "total 0\r\ndrwx------ 3 root root 17 Oct 8 15:05 systemd-private-02641de9e2ea43eb93b950a2213414d1-chronyd.service-94nahM\r\ndrwxr-xr-x 2 root root 6 Oct 8 18:43 test\r\ndrwx------ 2 root root 6 Oct 8 15:05 vmware-root_6074-692815760\r\ndrwx------ 2 root root 6 Oct 5 01:03 vmware-root_6110-968930893\r\n",
"stdout_lines": [
"total 0",
"drwx------ 3 root root 17 Oct 8 15:05 systemd-private-02641de9e2ea43eb93b950a2213414d1-chronyd.service-94nahM",
"drwxr-xr-x 2 root root 6 Oct 8 18:43 test",
"drwx------ 2 root root 6 Oct 8 15:05 vmware-root_6074-692815760",
"drwx------ 2 root root 6 Oct 5 01:03 vmware-root_6110-968930893"
]
}
五、copy 模块
-
作用:将 ansible 管理主机上的文件拷贝到远程主机中
-
使用例子:
backup # 备份
content # 内容
dest # 目的地址
group # 文件的属组
mode #文件的权限 R 4 W 2 X 1
owner # 文件的属主
src #文件的源文件地址
ansible web -m copy -a "dest=/tmp/f src=/etc/fstab" #复制单独文件
ansible web -m copy -a "src=/etc/init.d dest=/tmp" #复制文件目录
ansible web -m copy -a "src=/etc/init.d/ dest=/tmp" # 复制文件夹内的所有的文件
ansible db -m copy -a "dest=/tmp/b.sh src=/root/b.sh mode=644 owner=alex" # 复制文件并修改权限和属主
ansible db -m copy -a "src=/etc/init.d dest=/tmp owner=alex" # 修改文件夹的权限或者属主属组时,文件夹内的所有文件的权限也会被修改
# 通过md5来做校验
ansible db -m copy -a "dest=/tmp/b.sh src=/root/b.sh mode=644 owner=alex backup=yes" # 复制文件并将原来的文件做备份
ansible db -m copy -a "dest=/tmp/c.txt content='大弦嘈嘈如急雨,小弦切切如私语'" # 直接往文件里面写入文件,是直接覆盖写入,慎用
- 使用实例:
执行以下命令,把目录 copy 到远程主机
ansible apple -m copy -a "src=/etc/init.d dest=/tmp"
结果如下:
[root@localhost ~]# ansible apple -m copy -a "src=/etc/init.d dest=/tmp"
apple | CHANGED => {
"changed": true,
"dest": "/tmp/",
"src": "/etc/init.d"
}
六、fetch 模块
-
作用:从远程主机中拉取文件到 ansible 管理主机
-
使用例子:
dest #目标地址
src # 源地址
ansible db -m fetch -a "dest=/tmp src=/var/log/cron" # 复制远程被管控机器的文件道管控机器上,以被管控机的ip为目录,并保留原来的目录结构
- 使用实例:
执行以下命令,把文件 fetch 到本地主机
ansible apple -m fetch -a "dest=/tmp src=/var/log/cron"
结果如下:
[root@localhost ~]# ansible apple -m fetch -a "dest=/tmp src=/var/log/cron"
apple | CHANGED => {
"changed": true,
"checksum": "f64864c44ef11f161332f5bb2aa7cde186ecebb8",
"dest": "/tmp/apple/var/log/cron",
"md5sum": "f6ff5ee1d2700ef7b9f517c83fa48d22",
"remote_checksum": "f64864c44ef11f161332f5bb2aa7cde186ecebb8",
"remote_md5sum": null
}
七、file 模块
-
作用:管理文件和文件属性
-
使用例子:
access_time # 创建时间
group # 属组
mode # 权限
owner # 属主
path # 文件的路径
src # 源地址,只有在软连接和硬链接的时候才会使用
state # directory 目录 touch 文件 link 软连接 hard 硬链接 absent 删除
ansible db -m file -a "path=/alex state=directory" # 创建一个目录
ansible db -m file -a "path=/root/alex.txt state=touch" # 创建一个文件
ansible db -m file -a "src=/root/q.txt path=/tmp/q state=link" # 创建软连接,源地址是本机上的文件地址
ansible db -m file -a "path=/tmp/q state=absent" # 删除文件或者文件夹
- 使用实例:
执行以下命令,把文件 fetch 到本地主机
``
结果如下:
八、yum 模块
-
作用:管理包工具
-
使用例子:
disable_gpg_check # 禁止检查gpgcheck
disablerepo # 禁用repo源
enablerepo # 启用repo源
name #包的名称
state remove 卸载 install 安装
ansible web -m yum -a 'name=python2-pip' # 安装python2-pip
ansible web -m yum -a 'name=python2-pip,redis' #用来安装多个包
ansible web -m yum -a 'name="@Development Tools"' # 用来安装包组
- 使用实例:
执行以下命令
ansible apple -m yum -a 'name=httpd state=absent'
结果如下:
[root@localhost ~]# ansible apple -m yum -a 'name=httpd state=absent'
apple | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"msg": "",
"rc": 0,
"results": [
"httpd is not installed"
]
}
从返回结果可以看出我的管理节点上并没有安装 httpd
九、service 模块
-
作用:管理服务
-
使用例子:
name # 包名
enabled # 开机自启动
state started|stopped|reloaded|restarted
ansible web -m service -a 'name=redis state=started enabled=yes' #启动redis,并设置开机自启动
ansible web -m service -a 'name=redis state=stopped' #关闭redis
- 使用实例:
执行以下命令
ansible apple -m service -a 'name=redis state=started enabled=yes'
结果如下:
[root@localhost ~]# ansible apple -m service -a 'name=redis state=started enabled=yes'
apple | FAILED! => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"msg": "Could not find the requested service redis: host"
}
十、user 模块
-
作用:管理用户和用户组
-
使用例子:
group #组名
groups # 附加组
home # 家目录位置
remove #删除用户的家目录
shell # 用户登录的shell
system # 系统用户
uid # 用户id
ansible db -m user -a "uid=500 system=yes groups=root name=mysql" # 创建mysql用户,指定用户为系统用户,并指定uid为500,指定附加组为root
ansible db -m user -a "uid=3000 groups=mysql name=canglaoshi home=/opt/canglaoshi shell=/sbin/nologin" # 创建普通用户,并制定用户的家目录和登录shell以及uid,附加组
ansible db -m user -a "name=canglaoshi remove=yes state=absent" # 删除用户
- 使用实例:
执行以下命令
ansible apple -m user -a "name=canglaoshi remove=yes state=absent"
结果如下:
[root@localhost ~]# ansible apple -m user -a "name=canglaoshi remove=yes state=absent"
apple | SUCCESS => {
"ansible_facts": {
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false,
"name": "canglaoshi",
"state": "absent"
}
十一、下一节是?
下一节继续介绍常用的 Ansible 模块
欢迎来到这里!
我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。
注册 关于