Ansible基础使用规则

条件测试

如果需要根据变量、facts或此前任务的执行结果来做为某task执行与否的前提时要用到条件
测试。

when语句

在task后添加when子句即可使用条件测试;when语句支持Jinja2表达式语法。例如:

tasks:
  - name: "shutdown Debian flavored systems"
    command: /sbin/shutdown -h now
    when: ansible_os_family == "Debian"

when语句中还可以使用Jinja2的大多“filter”,例如要忽略此前某语句的错误并基于
其结果(failed或者sucess)运行后面指定的语句,可使用类似如下形式:

tasks:
  - command: /bin/false
    register: result
    ignore_errors: True
  - command: /bin/something
    when: result|failed
  - command: /bin/something_else
    when: result|success
  - command: /bin/still/something_else
    when: result|skipped

此外,when语句中还可以使用facts或playbook中定义的变量。

迭代

当有需要重复性执行的任务时,可以使用迭代机制。其使用格式为将需要迭代的内
容定义为item变量引用,并通过with_items语句来指明迭代的元素列表即可。例如:

- name: add several users
  user: name={{ item }} state=present groups=wheel
  with_items:
     - testuser1
     - testuser2

上面语句的功能等同于下面的语句:

- name: add user testuser1
  user: name=testuser1 state=present groups=wheel
- name: add user testuser2
  user: name=testuser2 state=present groups=wheel

事实上,with_items中可以使用元素还可为hashes,例如:

- name: add several users
  user: name={{ item.name }} state=present groups={{ item.groups }}
  with_items:
    - { name: 'testuser1', groups: 'wheel' }
    - { name: 'testuser2', groups: 'root' }

ansible的循环机制还有更多的高级功能,具体请参见官方文档(http://docs.ansible.com/playbooks_loops.html)。

playbook基础组件

任务列表和action

play的主体部分是task list。task list中的各任务按次序逐个在hosts中指定的所有主机上执
行,即在所有主机上完成第一个任务后再开始第二个。在运行自下而下某playbook时,如
果中途发生错误,所有已执行任务都将回滚,因此,在更正playbook后重新执行一次即可。

task的目的是使用指定的参数执行模块,而在模块参数中可以使用变量。模块执行是幂等的,
这意味着多次执行是安全的,因为其结果均一致。

每个task都应该有其name,用于playbook的执行结果输出,建议其内容尽可能清晰地描述
任务执行步骤。如果未提供name,则action的结果将用于输出。

定义task的可以使用“action: module options”或“module: options”的格式,推荐使
用后者以实现向后兼容。如果action一行的内容过多,也中使用在行首使用几个空白字符进
行换行。

        tasks:
          - name: make sure apache is running
            service: name=httpd state=running

在众多模块中,只有command和shell模块仅需要给定一个列表而无需使用“
key=value”
格式,例如:

tasks:
      - name: disable selinux
        command: /sbin/setenforce 0

如果命令或脚本的退出码不为零,可以使用如下方式替代:

tasks:
      - name: run this command and ignore the result
        shell: /usr/bin/somecommand || /bin/true        

或者使用ignore_errors来忽略错误信息:

tasks:
      - name: run this command and ignore the result
        shell: /usr/bin/somecommand
        ignore_errors: True 

handlers
用于当关注的资源发生变化时采取一定的操作。
“notify”这个action可用于在每个play的最后被触发,这样可以避免多次有改变发生时每
次都执行指定的操作,取而代之,仅在所有的变化发生完成后一次性地执行指定操作。
在notify中列出的操作称为handler,也即notify中调用handler中定义的操作。

- name: template configuration file
  template: src=template.j2 dest=/etc/foo.conf
  notify:
     - restart memcached
     - restart apache   

handler是task列表,这些task与前述的task并没有本质上的不同。

handlers:
    - name: restart memcached
      service:  name=memcached state=restarted
    - name: restart apache
      service: name=apache state=restarted

案例:

heartbeat.yaml
- hosts: hbhosts
  remote_user: root
  tasks:
    - name: ensure heartbeat latest version
      yum: name=heartbeat state=present
    - name: authkeys configure file
      copy: src=/root/hb_conf/authkeys dest=/etc/ha.d/authkeys
    - name: authkeys mode 600
      file: path=/etc/ha.d/authkeys mode=600
      notify:
        - restart heartbeat
    - name: ha.cf configure file
      copy: src=/root/hb_conf/ha.cf dest=/etc/ha.d/ha.cf
      notify: 
        - restart heartbeat
  handlers:
    - name: restart heartbeat
      service: name=heartbeat state=restarted

roles

ansilbe自1.2版本引入的新特性,用于层次性、结构化地组织playbook。roles能够根据层次型结构自动装载变量文件、tasks以及handlers等。
要使用roles只需要在playbook中使用include指令即可。简单来讲,roles就是通过分别将变量、文件、任务、模板及处理器放置於单独的目录
中,并可以便捷地include它们的一种机制。角色一般用于基于主机构建服务的场景中,但也可以是用于构建守护进程等场景中。

一个roles的案例如下所示:
    site.yml
    webservers.yml
    dbservers.yml
    roles/
       common/
         files/
         templates/
         tasks/
         handlers/
         vars/
         meta/
       webservers/
         files/
         templates/
         tasks/
         handlers/
         vars/
         meta/

而在playbook中,可以这样使用roles:

- hosts: webservers
  roles:
     - common
     - webservers

也可以向roles传递参数,例如:

113.209.20.234
    - hosts: webservers
      roles:
        - common
        - { role: foo_app_instance, dir: '/opt/a',  port: 5000 }
        - { role: foo_app_instance, dir: '/opt/b',  port: 5001 }

甚至也可以条件式地使用roles,例如:

- hosts: webservers
      roles:
        - { role: some_role, when: "ansible_os_family == 'RedHat'" }

创建role的步骤

(1) 创建以roles命名的目录;
(2) 在roles目录中分别创建以各角色名称命名的目录,如webservers等;
(3) 在每个角色命名的目录中分别创建files、handlers、meta、tasks、templates
和vars目录;用不到的目录可以创建为空目录,也可以不创建;
(4) 在playbook文件中,调用各角色;

role内各目录中可用的文件

tasks目录:至少应该包含一个名为main.yml的文件,其定义了此角色的任务列表;
此文件可以使用include包含其它的位于此目录中的task文件;
files目录:存放由copy或script等模块调用的文件;
templates目录:template模块会自动在此目录中寻找Jinja2模板文件;
handlers目录:此目录中应当包含一个main.yml文件,用于定义此角色用到的各handler;
在handler中使用include包含的其它的handler文件也应该位于此目录中;
vars目录:应当包含一个main.yml文件,用于定义此角色用到的变量;
meta目录:应当包含一个main.yml文件,用于定义此角色的特殊设定及其依赖关系;
ansible 1.3及其以后的版本才支持;
default目录:为当前角色设定默认变量时使用此目录;应当包含一个main.yml文件;

Tags

tags用于让用户选择运行playbook中的部分代码。ansible具有幂等性,因此会
自动跳过没有变化的部分,即便如此,有些代码为测试其确实没有发生变化的时间依然会
非常地长。此时,如果确信其没有变化,就可以通过tags跳过此些代码片断。

Jinja2相关

字面量
表达式最简单的形式就是字面量。字面量表示诸如字符串和数值的 Python 对象。下面
的字面量是可用的:

“Hello World”:
双引号或单引号中间的一切都是字符串。无论何时你需要在模板中使用一个字 符串
(比如函数调用、过滤器或只是包含或继承一个模板的参数),它们都是 有用的。

42 / 42.23:
直接写下数值就可以创建整数和浮点数。如果有小数点,则为浮点数,否则为 整数。
记住在 Python 里, 42 和 42.0 是不一样的。

[‘list’, ‘of’, ‘objects’]:
一对中括号括起来的东西是一个列表。列表用于存储和迭代序列化的数据。例如 你可以
容易地在 for 循环中用列表和元组创建一个链接的列表:

<ul>
{% for href, caption in [('index.html', 'Index'), ('about.html', 'About'),
                         ('downloads.html', 'Downloads')] %}
    <li><a href="{{ href }}">{{ caption }}</a></li>
{% endfor %}
</ul>

(‘tuple’, ‘of’, ‘values’):

元组与列表类似,只是你不能修改元组。如果元组中只有一个项,你需要以逗号 结尾它。
元组通常用于表示两个或更多元素的项。更多细节见上面的例子。

{‘dict’: ‘of’, ‘key’: ‘and’, ‘value’: ‘pairs’}:
Python 中的字典是一种关联键和值的结构。键必须是唯一的,并且键必须只有一个 值。
字典在模板中很少使用,罕用于诸如 xmlattr() 过滤器之类。
    true / false:
    true 永远是 true ,而 false 始终是 false

10.2 算术运算

Jinja 允许你用计算值。这在模板中很少用到,但是为了完整性允许其存在。支持下面的
运算符:

    +
        把两个对象加到一起。通常对象是素质,但是如果两者是字符串或列表,你可以用这 
        种方式来衔接它们。无论如何这不是首选的连接字符串的方式!连接字符
        串见 ~ 运算符。 {{ 1 + 1 }} 等于 2 。
    -
        用第一个数减去第二个数。 {{ 3 - 2 }} 等于 1 。
    /
        对两个数做除法。返回值会是一个浮点数。 {{ 1 / 2 }} 等于 {{ 0.5 }} 。
    //
        对两个数做除法,返回整数商。 {{ 20 // 7 }} 等于 2 。
    %
        计算整数除法的余数。 {{ 11 % 7 }} 等于 4 。
    *
        用右边的数乘左边的操作数。 {{ 2 * 2 }} 会返回 4 。也可以用于重 复一个字符
        串多次。 {{ ‘=’ * 80 }} 会打印 80 个等号的横条。
    **
        取左操作数的右操作数次幂。 {{ 2**3 }} 会返回 8 。

10.3 比较操作符

==
        比较两个对象是否相等。
    !=
        比较两个对象是否不等。
    >
        如果左边大于右边,返回 true 。
    >=
        如果左边大于等于右边,返回 true 。
    <
        如果左边小于右边,返回 true 。
    <=
        如果左边小于等于右边,返回 true

10.4 逻辑运算符

对于 if 语句,在 for 过滤或 if 表达式中,它可以用于联合多个表达式:

    and
        如果左操作数和右操作数同为真,返回 trueor
        如果左操作数和右操作数有一个为真,返回 truenot
        对一个表达式取反(见下)。
    (expr)
        表达式组。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章