ansible-playbook用法
一、playbook用法
1、playbook的执行文件为YAML语言编写,所以文件名为xxx.yml。YAML语法可以参考https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html#id1
2、下面以安装httpd软件来作讲解
示例playbook:
[root@localhost test]# cat httpd.yml
--- #文件起始行,也可以省略。但是不建议省略
- hosts: docker #docker表示远程执行这个yml文件的主机组,这里也可以指定对应的主机ip,或者正则表达
remote_user: root #远程执行命令的用户
vars: # vars以下为参数,可根据架构来选择是否有参数
pkg: httpd # 定义变量名为pkg,值为httpd,后续可以使用{{ pkg }}来引用
tasks: # tasks后续跟执行的任务
- name: uninstall httpd # 自定义任务名
yum: name={{ pkg }} state=absent # 任务执行命令, 这里表示用yum模块来卸载 httpd软件, {{ pkg }}引用vars中已经定义的变量,state表示对软件的操作,这里表示卸载
tags: unhttpd # tags为标签,任务都可以加上标签名,通过tags我们可以执行特定的任务,例如:ansible-playbook -t unhttpd httpd.yml 表示执行http.yml中tags为unhttpd的任务
- name: install http
yum: name={{ pkg }} state=installed #这里表示用yum模块来安装 httpd软件
tags: httpd
- name: copy cfg
copy: src=/opt/test/httpd.conf dest=/etc/httpd/conf/ #这里表示调用copy模块来将src的文件copy到目的地dest指定的位置
notify: restart service # notify 可以理解为触发器,与handlers配合起来使用。 当notify标注的任务被成功执行后,就会触发对应的handlers任务执行
tags: copy
- name: start service
service: name=httpd state=started enabled=yes
tags: httpd
handlers: #handlers和notify配合使用
- name: restart service # 任务名需要和notify名称一致,多个相同的任务可以使用同一个notify名称来触发同一个handlers任务,handlers任务可以为多个
service: name=httpd state=restarted
3、执行playbook
-C表示执行检查,不会对系统做改变,会完整的运行所有任务,检查playbook任务是否正确:
#ansible-playbook -C httpd.yml
执行playbook,根据任务顺序执行,系统会根据任务有所变化:
# ansible-playbook httpd.yml
执行结果说明:
绿色: 执行成功,不需要做改变(这里好像并不是一定不改变)
红色: 执行失败
黄色: 执行成功,并且系统有变化
执行结果颜色可以通过ansible的配置文件进行私人定制。
4、关于模块的使用
ansible-doc --list #可以列出所有可使用模块,核心模块:http://ansible.com.cn/docs/modules_core.html 额外模块:http://github.com/ansible/ansible-modules-extras
ansible-doc -s Module_Name #查询模块的使用方法 ,如: ansible-doc -s yum 查询yum模块的使用方法
ansible-doc Module_Name #更详细的展示模块的使用,和linux中的man手册类似
5、关于参数的定义
参数优先级: 命令行>局部>全局
♦ 通过命令指定,优先级最高
ansible-playbook -e varname=value xxx.yml
♦ ansilbe setup facts远程主机的多有变量都可以直接使用可以在执行ansible命令的时候给与变量值
ansible hostip -m setup #可以查询到ansible系统的一些信息,其中就包括可以直接使用的变量
♦ 在/etc/ansible/hosts中定义
普通变量;主机组中单独定义,优先级高于公共变量
公共(组)变量:针对主机组中所有主机定义统一变量
[docker]
172.17.0.2 http_port=80 #普通变量
172.17.0.3 http_port=90
[docker:vars]
http_port=100 #公共变量
♦ 在playbook中定义
vars:
- var1: value1
- var2: value2
♦ 在role中定义
需要一个固定的vars目录来存放编辑变量的文件,后续roles的使用中会讲到