目录
- YAML
- 含义
- Ansible的脚本—playbook剧本
- 执行playbook
- hosts和users介绍
- tasks列表和action
- Handlers介绍
- playbook变量
- 直接在yaml中定义变量
- 直接引用一些变量
- 条件测试
- 多条件判断
- 组条件判断
- 迭代
YAML
含义
- 是一种非标记语言。是用来写配置文件的语言，非常简洁和强大。YAML语法和其他语言类似，也可以表达散列表、标量等数据结构。
结构通过空格来展示；序列里配置项通过-来代表；Map里键值用:来分隔；YAML的扩展名为yaml
基本语法规则
- 大小写敏感
- 使用缩进表示层级关系
- 缩进时不允许使用Tab键，只允许使用空格。
- 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
YAML支持的数据结构
- 对象：键值对的集合，又称为映射(mapping)/哈希(hashes)/字典(dictionary)
例如：name: Example Developer
- 数组：一组按次序排列的值，又称为序列 (sequence)/列表(list)
例如:
Apple
Orange - 纯量（变量）：单个的、不可再分的值
例如:number: 12.30l
sure: true
yaml示例
name： zhangsan
age: 20
people:
- name: wangwu
age: 21
Ansible的脚本—playbook剧本
通过task调用ansible的模板将多个play组织在一个playbook中运行。
playbooks部分组成
- Tasks：任务，即调用模块完成的某操作
- Variables：变量
- Templates：模板
- Handlers：处理器，当某条件满足时，触发执行的操作
- Roles：角色
执行playbook
ansible-playbook [yaml文件名]例如：
ansible-playbook ttt.yaml参数：
-k（-ask-pass）用来交互输入密码
-K（-ask-become-pass）用来交互输入sudo密码
-u 指定用户补充命令：
ansible-playbook ttt.yaml --syntax-check #检查yaml文件的语法是否正确
ansible-playbook ttt.yaml --list-task #检查tasks任务
ansible-playbook ttt.yaml --list-hosts #检查生效的主机
ansible-playbook ttt.yaml --start-at-task='abc' #指定从某个task开始运行hosts和users介绍
- hosts: webserver #指定主机组，可以是一个或多个组
remote_user: root #指定远程主机执行的用户名可以为每个任务定义远程执行用户
[root@server1 opt]# vim ping.yaml
- hosts: mysql
remote_user: root
tasks:
- name: ping #name为给接下来运行的任务起个名字
ping: #调用ping模块
remote_user: mysql #指定远程主机执行tasks的运行用户为mysql执行playbook：
ansible-playbook ping.yaml -k #免密的情况下可省略-k[root@server1 ~]# ansible-playbook ping.yaml #此时发现运行tasks：ping不成功
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
ok: [20.0.0.13]
TASK [useradd mysql] **************************************************************************
ok: [20.0.0.13]
TASK [ping] ***********************************************************************************
fatal: [20.0.0.13]: UNREACHABLE! => {"changed": false, "msg": "Failed to connect to the host via ssh: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).", "unreachable": true}
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=2 changed=0 unreachable=1 failed=0 skipped=0 rescued=0 ignored=0分析错误原因：
"msg": "Failed to connect to the host via ssh: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password)." #没有权限去执行操作
解决
给mysql用户提权指定远程主机sudo切换用户：
[root@server1 opt]# vim ping.yaml
- hosts: mysql
remote_user: root
become:
tasks:
- name: ping
ping:
remote_user: mysql[root@server1 ~]# ansible-playbook ping.yaml
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
fatal: [20.0.0.13]: FAILED! => {"ansible_facts": {}, "changed": false, "failed_modules": {"setup": {"ansible_facts": {"discovered_interpreter_python": "/usr/bin/python"}, "failed": true, "module_stderr": "Shared connection to 20.0.0.13 closed.\r\n", "module_stdout": ">>> /etc/sudoers: 语法错误 near line 1 <<<\r\nsudo: /etc/sudoers 中第 1 行附近有解析错误\r\nsudo: 没有找到有效的 sudoers 资源，退出\r\nsudo: 无法初始化策略插件\r\n", "msg": "MODULE FAILURE\nSee stdout/stderr for the exact error", "rc": 1}}, "msg": "The following modules failed to execute: setup\n"}
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=0 changed=0 unreachable=0 failed=1 skipped=0 rescued=0 ignored=0分析原因：
没有找到有效的 sudoers 资源
解决：
在被控制端的主机/etc/sudoers中添加mysql
[root@server1 ~]# vim ping.yaml
- hosts: mysql
remote_user: root
tasks:
- name: useradd mysql
user: name=mysql #创建一个mysql用户
- name: sudoers
shell: /usr/bin/echo "mysql ALL=(root) ALL" >> /etc/sudoers
- name: ping
become: yes #允许进行提权
become_user: mysql #提权账号
ping:
[root@server1 ~]# ansible-playbook ping.yaml
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
ok: [20.0.0.13]
TASK [useradd mysql] **************************************************************************
ok: [20.0.0.13]
TASK [sudoers] ********************************************************************************
changed: [20.0.0.13]
TASK [ping] ***********************************************************************************
ok: [20.0.0.13]
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=4 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0tasks列表和action
- Play的主体部分是task列表，task列表中的各任务按次序逐个在hosts中指定的主机上执行，即在所有主机上完成第一个任务后再开始第二个任务
在运行playbook时(从上到下执行)，如果一个host执行task失败，整个tasks都会回滚，请修正playbook
中的错误，然后重新执行即可。Task的目的是使用指定的参数执行模块，而在模块参数中可以使用变量，模块执行时幂等的，这意味着多次执行是安全的，因为其结果一致。 - 每一个task必须有一个名称name，这样在运行playbook时，从其输出的任务执行信息中可以很好的辨别出是属于哪一个task的。
- 定义一个task，常见的格式:"module: options”例如: yum: name=httpd
- ansible的自带模块中，command模块和shell模块无需使用key=value格式
例如：
[root@server1 ~]# vim demo.yaml
- hosts: mysql
remote_user: root
tasks:
- name: useradd mysql
user: name=mysql
- name: sudoers
shell: usr/bin/echo "mysql ALL=(root) ALL" >> /etc/sudoers #这里去掉一个/，模拟运行失败
- name: ping
ping:
[root@server1 ~]# ansible-playbook demo.yaml
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
ok: [20.0.0.13]
TASK [useradd mysql] **************************************************************************
ok: [20.0.0.13]
TASK [sudoers] ********************************************************************************
fatal: [20.0.0.13]: FAILED! => {"changed": true, "cmd": "usr/bin/echo \"mysql ALL=(root) ALL\" >> /etc/sudoers", "delta": "0:00:00.002690", "end": "2021-01-14 21:59:18.256832", "msg": "non-zero return code", "rc": 127, "start": "2021-01-14 21:59:18.254142", "stderr": "/bin/sh: usr/bin/echo: 没有那个文件或目录", "stderr_lines": ["/bin/sh: usr/bin/echo: 没有那个文件或目录"], "stdout": "", "stdout_lines": []}
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=2 changed=0 unreachable=0 failed=1 skipped=0 rescued=0 ignored=0只要执行命令的返回值不为0，就为报错，tasks停止，此次任务回滚
修改
[root@server1 ~]# vim demo.yaml
- hosts: mysql
remote_user: root
tasks:
- name: useradd mysql
user: name=mysql
- name: sudoers
shell: usr/bin/echo "mysql ALL=(root) ALL" >> /etc/sudoers
ignore_errors: True #忽略错误，强制返回成功
- name: ping
ping:
[root@server1 ~]# ansible-playbook demo.yaml
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
ok: [20.0.0.13]
TASK [useradd mysql] **************************************************************************
ok: [20.0.0.13]
TASK [sudoers] ********************************************************************************
fatal: [20.0.0.13]: FAILED! => {"changed": true, "cmd": "usr/bin/echo \"mysql ALL=(root) ALL\" >> /etc/sudoers", "delta": "0:00:00.002509", "end": "2021-01-14 22:03:43.033818", "msg": "non-zero return code", "rc": 127, "start": "2021-01-14 22:03:43.031309", "stderr": "/bin/sh: usr/bin/echo: 没有那个文件或目录", "stderr_lines": ["/bin/sh: usr/bin/echo: 没有那个文件或目录"], "stdout": "", "stdout_lines": []}
...ignoring
TASK [ping] ***********************************************************************************
ok: [20.0.0.13]
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=4 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=1Handlers介绍
Handlers也是一些task的列表，和一般的task并没有什么区别。
由通知者进行的notify,如果没有被notify，则Handlers不会执行，假如被notify了，则Handlers被执行
不管有多少个通知者进行了notify，等到play中的所有task执行完成之后，handlers也只会被执行一次
[root@server1 ~]# vim demo.yaml
- hosts: mysql
remote_user: root
tasks:
- name: useradd mysql
user: name=mysql
- name: install apache
yum: name=httpd
notify:
- restart httpd
- name: restart httpd
service: name=httpd state=started
handlers:
- name: restart httpd
service: name=httpd state=restarted
[root@server1 ~]# ansible-playbook demo.yaml
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
ok: [20.0.0.13]
TASK [useradd mysql] **************************************************************************
ok: [20.0.0.13]
TASK [install apache] *************************************************************************
changed: [20.0.0.13]
TASK [restart httpd] **************************************************************************
changed: [20.0.0.13]
RUNNING HANDLER [restart httpd] ***************************************************************
changed: [20.0.0.13]
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=5 changed=3 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0playbook变量
通过ansible命令传递
[root@server1 ~]# vim demo.yaml
- hosts: mysql
remote_user: root
vars:
- user:
tasks:
- name: useradd mysql
user: name={{user}}
[root@server1 opt]# ansible-playbook demo.yaml -e user=mysql #使用-e给变量赋值
PLAY [mysql] ********************************************************************
TASK [Gathering Facts] **********************************************************
ok: [20.0.0.13]
TASK [useradd mysql] ************************************************************
changed: [20.0.0.13]
PLAY RECAP **********************************************************************
20.0.0.13 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
[root@server1 opt]# ansible mysql -m command -a 'tail /etc/passwd' #查看
20.0.0.13 | CHANGED | rc=0 >>
………………
mysql:x:1001:1001::/home/mysql:/bin/bash直接在yaml中定义变量
[root@server1 ~]# vim demo.yaml
- hosts: mysql
remote_user: root
vars:
services: httpd
tasks:
- name: useradd mysql
user: name=mysql
- name: install apache
yum: name={{services}}
notify:
- restart httpd
- name: restart httpd
service: name={{services}} state=started
handlers:
- name: restart httpd
service: name={{services}} state=restarted
[root@server1 ~]# ansible-playbook demo.yaml
PLAY [mysql] **********************************************************************************
TASK [Gathering Facts] ************************************************************************
ok: [20.0.0.13]
TASK [useradd mysql] **************************************************************************
ok: [20.0.0.13]
TASK [install apache] *************************************************************************
ok: [20.0.0.13]
TASK [restart httpd] **************************************************************************
ok: [20.0.0.13]
PLAY RECAP ************************************************************************************
20.0.0.13 : ok=4 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0直接引用一些变量
引用ansible的固定变量
[root@server1 opt]# vi demo.yaml
- hosts: mysql
remote_user: root
tasks:
- name: copy ipv4
copy: content="{{ansible_all_ipv4_addresses}}" dest=/opt/ipv4.txt
[root@server1 opt]# ansible-playbook demo.yaml
PLAY [mysql] ********************************************************************
TASK [Gathering Facts] **********************************************************
ok: [20.0.0.13]
TASK [copy ipv4] ****************************************************************
changed: [20.0.0.13]
PLAY RECAP **********************************************************************
20.0.0.13 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0mysql主机查看
[root@server1 opt]# cat ipv4.txt
["192.168.122.1", "20.0.0.13"]条件测试
如果需要根据变量、facts（setup）或此前任务的执行结果来作为某task执行与否的前提时要用到条件测试，在playbook中条件测试使用when子句，在task后台添加when子句即可使用条件测试：when子句支持jinjia2表达式或语法（jinjia2：基于python语言，格式为{{}}，是一种特殊的占位符）
[root@server1 opt]# vi when.yaml
- hosts: webserver
remote_user: root
tasks:
- name: shutdown
command: /sbin/shutdown -r now
when: #当系统版本为CentOS时，关闭webserver主机
- ansible_distribution == "CentOS"多条件判断
[root@server1 opt]# vi when.yaml
- hosts: webserver
remote_user: root
tasks:
- name: shutdown
command: /sbin/shutdown -r now
when: #当系统版本为CentOS7时，关闭webserver主机
- ansible_distribution == "CentOS"
- ansible_distribution_major_version == "7"组条件判断
[root@server1 opt]# vi when.yaml
- hosts: webserver
remote_user: root
tasks:
- name: shutdown CentOS6 and CentOS7
command: /sbin/shutdown -r now
when: #当系统版本为CentOS7时，关闭webserver主机
- ansible_distribution == "CentOS" and ansible_distribution_major_version == "6"
- ansible_distribution == "Debian" and ansible_distribution_major_version == "7"迭代
当有需要重复性执行的任务时，可以使用迭代机制。其使用格式为item变量引用，并通过with_items语句指明迭代的元素
[root@server1 opt]# vi demo.yaml
hosts: mysql
remote_user: root
tasks:
- name: install
yum: name={{ item }} state=latest
with_items:
- httpd
- php
- tree
[root@server1 opt]# ansible-playbook demo.yaml
PLAY [mysql] ********************************************************************
TASK [Gathering Facts] **********************************************************
ok: [20.0.0.13]
TASK [install] ******************************************************************
[DEPRECATION WARNING]: Invoking "yum" only once while using a loop via
squash_actions is deprecated. Instead of using a loop to supply multiple items
and specifying `name: "{{ item }}"`, please use `name: ['httpd', 'php']` and
remove the loop. This feature will be removed in version 2.11. Deprecation
warnings can be disabled by setting deprecation_warnings=False in ansible.cfg.
changed: [20.0.0.13] => (item=[u'httpd', u'php'])
PLAY RECAP **********************************************************************
20.0.0.13 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0也可以自己定义
[root@server1 ~]# vim demo.yaml
- hosts: mysql
remote_user: root
tasks:
- name: useradd
user: name={{item.name}} state=present group={{item.groups}}
with_items:
- { name: test1, groups: wheel}
- { name: test2, groups: root}
[root@server1 opt]# ansible-playbook demo.yaml
PLAY [mysql] ********************************************************************
TASK [Gathering Facts] **********************************************************
ok: [20.0.0.13]
TASK [useradd] ******************************************************************
changed: [20.0.0.13] => (item={u'name': u'test1', u'groups': u'wheel'})
changed: [20.0.0.13] => (item={u'name': u'test2', u'groups': u'root'})
PLAY RECAP **********************************************************************
20.0.0.13 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
[root@server1 opt]# ansible mysql -a " tail /etc/passwd"
20.0.0.13 | CHANGED | rc=0 >>
…………………………
test1:x:1002:10::/home/test1:/bin/bash
test2:x:1003:0::/home/test2:/bin/bash