Ansible使用介绍（二）YAML语法及Playbook

wangxcz • • Linux笔记

playbook是由一个或多个”play”组成的列表，play的主要功能在于将事先归并为一组的主机装扮成事先通过ansibe中的task定义好的角色。从根本上来讲，所谓task无非是调用ansible的module。将多个play组织在一个playbook中，即可让它们联同起来按事先编排的机制运行。

本节索引：

一、YAML语法简介

二、Ansible中的剧本Playbook用法

三、Playbook中handler的使用

四、Playbook中变量的使用

 

 

playbook是由一个或多个”play”组成的列表

play的主要功能在于将事先归并为一组的主机装扮成事先通过ansibe中的task定义好的角色。从根本上来

讲，所谓task无非是调用ansible的module。将多个play组织在一个playbook中，即可让它们联同起来按事

先编排的机制运行。

 

Playbook采用YAML语言编写每一个Ansible的Playbook都是一个YAML格式的文件，因此要学习编写剧

本(playbook)，我们先来了解YAML语法的基本用法

 

一、YAML介绍：

YAML是一个可读性高的用来表达资料序列的格式。YAML参考了其他多种语言，包括：XML、

C语言、Python、Perl以及电子邮件格式RFC2822等。Clark Evans在2001年在首次发表了这种

语言，另外Ingy döt Net与Oren Ben-Kiki也是这语言的共同设计者

 

YAML Ain’t Markup Language，即YAML不是XML。不过，在开发的这种语言时，YAML的意

思其实是：”Yet Another Markup Language”（仍是一种标记语言）

 

特性：

YAML的可读性好

YAML和脚本语言的交互性好

YAML使用实现语言的数据类型

YAML有一个一致的信息模型

YAML易于实现

YAML可以基于流来处理

YAML表达能力强，扩展性好

 

更多的内容及规范参见http://www.yaml.org

 

YAML语法格式：

1.在单一档案中，可用连续三个连字号(——)区分多个档案。另外，还有选择性的连续三个点号

( … )用来表示档案结尾

2.次行开始正常写Playbook的内容，一般建议写明该Playbook的功能

3.使用#号注释代码

4.缩进必须是统一的，不能空格和tab混用

5.缩进的级别也必须是一致的，同样的缩进代表同样的级别，程序判别配置的级别是通过缩进结

合换行来实现的

6.YAML文件内容和Linux系统大小写判断方式保持一致，是区别大小写的，k/v的值均需大小写敏

感

7.k/v的值可同行写也可换行写。同行使用:分隔

8.v可是个字符串，也可是另一个列表

9.一个完整的代码块功能需最少元素需包括 name: task

10.一个name只能包括一个task

11.YAML文件扩展名通常为yml或yaml

 

YAML语法简介：

[列表]

List：列表，其所有元素均使用“-”打头

示例：

# A list of tasty fruits

– Apple

– Orange

– Strawberry

– Mango

 

[字典]

Dictionary：字典，通常由多个key与value构成

示例：

—

# An employee record

name: Example Developer

job: Developer

skill: Elite

也可以将key:value放置于{}中进行表示，用,分隔多个key:value

示例：

—

# An employee record

{name: Example Developer, job: Developer, skill: Elite}

 

 

二、剧本Playbook

Playbook核心元素：

Hosts：执行的远程主机列表

Tasks：任务列表

Varniables：内置变量或自定义变量在playbook中调用

Templates：模板，可替换模板文件中的变量并实现一些简单逻辑的文件

Handlers：和notify结合使用，由特定条件触发的操作，满足条件方才执行，否则不执行

tags：标签，指定某条任务执行，用于选择运行playbook中的部分代码。ansible具有幂等性。因此

会自动跳过没有变化的部分。此时，如果确信其没有变化，就可以通过tags跳过此些代码片段

 

下图展示的是Playbook的工作机制：

playbook

 

Hosts：

作用：playbook中的每一个play的目的都是为了让某个或某些主机以某个指定的用户

身份执行任务。hosts用于指定要执行指定任务的主机，须事先定义在主机清单中

可以是如下形式：

one.example.com

one.example.com:two.example.com

192.168.1.50

192.168.1.*

websrvs:dbsrvs               两个组的并集

websrvs:&dbsrvs             两个组的交集

webservers:!dbsrvs 在websrvs组，但不在dbsrvs组

示例:

– hosts: websrvs：dbsrvs

 

remote_user：

作用：可用于Host和task中。也可以通过指定其通过sudo的方式在远程主机上执行任务，

其可用于play全局或某任务；此外，甚至可以在sudo时使用sudo_user指定sudo时切换的

用户

– hosts: websrvs

  remote_user: root

  tasks:

    – name: test connection

      ping:

      remote_user: magedu

      sudo: yes 默认sudo为root

      sudo_user:wang sudo为wang

 

 

tasks：

作用：任务列表

格式：module: arguments

注意：shell和command模块后面跟命令，而非key=value

 

 

检查playbook：

ansible-playbook -C file.yml

 

 

运行playbook的方式：

    ansible-playbook <filrname.yml> …[options]

    options：

–check                      只检测可能会发生的改变，但不真正的操作

–list-hosts                列出运行任务的主机

–limit       主机列表       只针对主机列表中的主机执行

-v,-vv,-vvv                 显示详细过程

 

 

一个最简单的Playbook需包含的基础组件有host、remote_user、tasks

示例1：

vim http.yml

—

– hosts: websrvs

  remote_user: root

 

  tasks:

    – name: create new file

      file: name=/data/newfile state=touch

    – name: create new file

      user: name=test2 system=yes shell=/sbin/nologin

    – name: install package

      yum: name=httpd

    – name: copy index

      copy: src=/var/www/html/index.html dest=/var/www/html/

    – name: start service

      service: name=httpd state=started enabled=yes

http.yml

 

tags标签

task任务也可以通过”tags”打标签，而后可在ansible-playbook命令上使用-t指定进行调用

 

示例2：使用tags

vim http.yml

—

– host: websrvs

  remote_user: root

 

  tasks:

    – name: install httpd package

      yum: name=httpd

      tags: inshttpd

    – name: copy conf file

      copy: src=files/httpd.conf dest=/etc/httpd/conf/  backup=yes

      tags: cphttpd

    – name: start service

      service: name=httpd state=startd enable=yes

      tags: rshttpd

 

ansible-playbook -t rshttpd httpd.yml            单独执行rshttp

注：多个动作可共用一个tags标签

tags2

 

 

三、Playbook中handler的使用

由于Ansible幂等性的特性，有时前一个task发生了变化，后续的task无变化并不会重新执行，

但后续的task却可能受前一个task变化而影响。使用hanlder和notify即可解决此问题，handler

用于当关注的资源发生变化时，才会采取一定的操作。在notify中列出的操作称为handler，

也即notify中调用handler中定义的操作

 

示例：

vim http.yml

—

– host: websrvs

  remote_user: root

 

  tasks:

    – name: install httpd package

      yum: name=httpd

    – name: copy conf file

      copy: src=files/httpd.conf dest=/etc/httpd/conf/  backup=yes

    – name: start service

      service: name=httpd state=startd enable=yes

 

vim /files/httpd.conf

Listen 8080

8080

ansible-playbook http.yml

此时无法重启服务，端口仍为80

 

vim http.yml

—

– host: websrvs

  remote_user: root

 

  tasks:

    – name: install httpd package

      yum: name=httpd

    – name: copy conf file

      copy: src=files/httpd.conf dest=/etc/httpd/conf/  backup=yes

      notify: restart service

    – name: start service

      service: name=httpd state=startd enable=yes

 

  handlers:

    – name: restart service

      service: name=httpd state=restarted

由于httpd.conf发生了变化，触发了notify，执行相应的handler操作，httpd服务重启后

监听端口变为8080

80802

 

四、Playbook中变量的使用

变量名：仅能由字母、数字和下划线组成，且只能以字母开头

变量来源：

1.ansible all -m setup  远程主机的所有变量都可直接调用

2.在/etc/ansible/hosts中定义

普通变量：主机组中主机单独定义，优先级高于公共变量

host分组变量：针对主机组中所有主机定义统一变量

3.通过命令行指定变量，优先级最高

例如：ansible-playbook –e varname=value

4.在playbook中定义

vars:

  – var1: value1

  – var2: value2

5.在role中定义

 

变量定义：key=value

示例：http_port=80

 

变量调用方式：

通过{{ variable_name }} 调用变量，且变量名前后必须有空格，有时用”{{ variable_name }}”才生效

 

变量调用优先级：

命令行-e > playbook定义 > hosts普通变量 > host分组变量

 

示例1：命令行变量赋值

vim app.yml

—

– hosts: appsrvs

  remote_user: root

 

  tasks:

    – name: install package

      yum: name={{ pkname }}

    – name: start service

      service: name={{ pkname }} state=started enabled=yes

 

变量赋值并执行：

ansible-playbook -e ‘pkname=vsftpd’ app.yml     

vsftpd

 

示例2：playbook中赋值变量

vim app.yml

—

– hosts: appsrvs

  remote_user: root

  vars:

    – pkname1: httpd

    – pkname2: vsftpd

 

  tasks:

    – name: install package

      yum: name={{ pkname1 }}

    – name: install package

      yum: name={{ pkname2 }}

 

ansible-playbook app.yml

palybook赋值变量

示例3：hosts文件中定义普通变量

vim /etc/ansible/hosts

192.168.30.101 httpd_port=81

192.168.30.102 httpd_port=82

 

vim hostname.yml

—

– hosts: websrvs

  remote_user: root

 

  tasks:

    – name: set hostname

      hostname: name=www{{httpd_port}}.magedu.com

 

ansible-playbook -C hostname.yml

分组变量

 

示例4：hosts文件中定义分组变量

vim /etc/ansible/hosts

[websrv:vars]

nodename=www

domainname=wxlinux.com

hostname2

vim hostname2.yml

—

– hosts: websrvs

  remote_user: root

 

  tasks:

    – name: set hostname

      hostname: name={{nodename}}{{http_port}}.{{domainname}}

 

ansible-playbook hostname.yml

hostname2 (3)

 

示例5：引用系统自带变量

ansible all -m setup |grep  ansible_fqdn     查看系统自带变量

系统变量

vim var.yml

—

– hosts: websrvs

  remote_user: root

 

  tasks:

    – name: create log file

      file: name=/data/{{ ansible_fqdn }}.log state=touch

系统变量2

 

示例6：定义变量到一个文件中

vim vars.yml

var1: httpd

var2: vsftpd

变量到文件中

vim testvar.yml

—

– hosts: websrvs

  remote_user: root

  vars_files:

    – vars.yml

 

  tasks:

    – name: install package

      yum: name={{ var1 }}

    – name: create file

      file: name=/data/{{ var2 }}.log state=touch

变量到文件中2

本文来自投稿，不代表Linux运维部落立场，如若转载，请注明出处：http://www.178linux.com/99817

赞 (5)
wangxczwangxcz
0
上一篇 2018-05-30 21:21
下一篇 2018-05-30 22:33

相关推荐

电话咨询
在线咨询