条件

when

可用于task，role和include，在满足条件时task才会被执行。至于when指令后跟的逻辑表达式也是标准的逻辑表达式，示例如下：

tasks:
  - shell: echo "only on Red Hat 6, derivatives, and later"
    when: ansible_os_family == "RedHat" and ansible_lsb.major_release|int >= 6
  - shell: echo "This certainly is epic!"
    when: epic is defined

循环

标准遍历

用with_items可以遍历一个列表，注意这里只会遍历一层。示例如下：

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

嵌套遍历

用with_nested可以遍历一个列表，注意这里会遍历多层，直到最内层。示例如下：

-  name: give users access to multiple databases  
    mysql_user: name={{ item[0] }} priv={{ item[1] }}.*:ALL append_privs=yes password=foo  
    with_nested:    
    - [ 'alice', 'bob', 'eve' ]    
    - [ 'clientdb', 'employeedb', 'providerdb' ]

遍历字典

用with_dict可以遍历一个字典，用key和value来表示。示例如下：

变量文件

---
users:
  alice:
    name: Alice Appleworth
    telephone: 123-456-7890
  bob:
    name: Bob Bananarama
    telephone: 987-654-3210

playbook文件

tasks:  
     -  name: Print phone records    
        debug: msg="User {{ item.key }} is {{ item.value.name }} ({{ item.value.telephone }})"    
        with_dict: users

文件通配符循环

用with_fileglob可以获取本地文件列表。示例如下：

    # copy each file over that matches the given pattern    
    - copy: src={{ item }} dest=/etc/fooapp/ owner=root mode=600      
      with_fileglob:        
        - /playbooks/files/fooapp/*

对齐的列表

用with_together可以达到类似python里的zip函数的功能。示例如下：

变量文件：

---
alpha: [ 'a', 'b', 'c', 'd' ]
numbers:  [ 1, 2, 3, 4 ]

playbook文件

tasks:    
- debug: msg="{{ item.0 }} and {{ item.1 }}"      
    with_together:        
    - alpha        
    - numbers

子元素循环

with_subelements这个比较费解。

数字序列循环

可以通过with_sequence来生成一个数字序列，其参数包括：

  • start起始数字

  • end结束数字

  • stride步长

  • count个数

  • format输出的字符串

示例如下：

---- hosts: all  tasks:    # create groups    
- group: name=evens state=present    
- group: name=odds state=present    # create some test users    
- user: name={{ item }} state=present groups=evens      
with_sequence: start=0 end=32 format=testuser%02x    # create a series of directories with even numbers for some reason    
- file: dest=/var/stuff/{{ item }} state=directory      
with_sequence: start=4 end=16 stride=2    # a simpler way to use the sequence plugin    # create 4 groups    
- group: name=group{{ item }} state=present      
with_sequence: count=4

随机循环

通过with_random_choice从一个序列里随机取一个元素。示例如下：

- debug: msg={{ item }}  
    with_random_choice:     
        - "go through the door"     
        - "drink from the goblet"     
        - "press the red button"     
        - "do nothing"

until循环

这种循环由三个指令完成：
* until是一个条件表达式，如果满足条件循环结束
* retry是重试的次数
* delay是延迟时间

示例如下：

- action: shell /usr/bin/foo
  register: result
  until: result.stdout.find("all systems go") != -1
  retries: 5
  delay: 10

循环直到找到文件

与with_items类似，只是with_first_found找到列表里的第一个文件就会终止循环。示例如下：

- name: INTERFACES | Create Ansible header for /etc/network/interfaces  
    template: src={{ item }} dest=/etc/foo.conf  
    with_first_found:    
        - "{{ansible_virtualization_type}}_foo.conf"   
        - "default_foo.conf"

循环一个task的输出

with_lines指令后跟一个命令，ansible会遍历命令的输出。示例如下：

- name: Example of looping over a command result  
    shell: /usr/bin/frobnicate {{ item }}  
    with_lines: /usr/bin/frobnications_per_host --param {{ inventory_hostname }}

带索引地循环列表

与with_items类似，with_indexed_items会把列表索引和对应元素放到一个列表里。示例如下：

- name: indexed loop demo  
    debug: msg="at array position {{ item.0 }} there is a value {{ item.1 }}"  
    with_indexed_items: some_list

扁平化循环列表

with_flattened会先拍扁一个列表，然后执行with_items。示例如下：

- name: flattened loop demo 
     yum: name={{ item }} state=installed  
     with_flattened:  
     - ['nc','git', ['nmap', 'vim']]

配合register循环列表

register注册一个变量后，可以配合with_items来遍历变量结果。示例如下：

- shell: echo "{{ item }}"  
    with_items:    
    - one    
    - two  
    register: echo
- name: Fail if return code is not 0  
    fail:    
    msg: "The command ({{ item.cmd }}) did not have a 0 return code"  
    when: item.rc != 0  
    with_items: echo.results