任务控制
使用循环迭代任务
通过使用循环,我们无需编写多个使用同一模块的任务。例如,他们不必编写五个任务来确保存在五个用户,而是只需编写一个任务来对含有五个用户的列表迭代,从而确保它们都存在。
Ansible支持使用loop关键字对一组项目迭代任务。可以配置循环以利用列表中的各个项目、列表中各个文件的内容、生成的数字序列或更为复杂的结构来重复任务。
简单循环
简单循环对一组项目迭代任务。loop关键字添加到任务中,将应对其迭代任务的项目列表取为值。循环变量item保存每个迭代过程中使用的值。
比较:
创建三个用户:
[root@localhost ansible]# cat vars/user.yml
---
- name: create user
hosts: "*"
gather_facts: no
tasks:
- name: create three user
user:
name: tom
state: present
- name: create harry
user:
name: harry
state: present
- name: create jarry
user:
name: jarry
state: present
创建三个用户可以重新编写为使用一个简单循环:
---
- name: create user
hosts: "*"
tasks:
- name: create user three
user:
name: "{{ item }}"
state: present
loop:
- ton
- jurry
- herry
可以通过一个变量提供loop所使用的列表。在以下示例:
---
- name: create user
hosts: "*"
vars:
users_1:
- tob
- jnrry
- horry
tasks:
- name: create user three
user:
name: "{{ item }}"
state: present
loop: "{{ users_1 }}"
循环散列或字典列表
loop列表不需要是简单值列表。在以下示例中,列表中的每个项实际上是散列或字典。示例中的每个散列或字典具有两个键,即name和groups,当前item循环变量中每个键的值可以分别通过item.name和item.groups变量来检索。
---
- name: create user
hosts: "*"
tasks:
- name: create user three
user:
name: "{{ item.name }}"
state: present
groups: "{{ item.groups }}"
loop:
- name: jone
groups: harry
- name: joun
groups: tom
这一示例中结果是用户jone存在且为组harry的成员,并且用户joun存在且为组tom的成员。
较早样式的循环关键字
在Ansible2.5之前,大多数playbook使用不同的循环语法。提供了多个循环关键字,前缀为whth_,后面跟Ansible查找插件的名称。这种循环语法在现有playbook中很常见,但在将来的某个时候可能会被弃用。
较早样式的Ansible循环
循环关键字 | 描述 |
---|---|
with_items | 行为与简单列表的loop关键字相同,例如字符串列表或散列/字典列表。 但与loop不同的是,如果为with_items提供了列表的列表, 它们将被扁平化为单级列表。循环变量item保存每次迭代过程中使用的列表项。 |
with_file | 此关键字需要控制节点文件名列表。循环变量item在每次迭代过程中保存文件列表中相应文件的内容。 |
with_sequence | 此关键字不需要列表,而是需要参数来根据数字序列生成值列表。 循环变量item在每次迭代过程中保存生成的序列中的一个生成项的值。 |
playbook中的with_items的示例如下所示:
---
- name: create user
hosts: "*"
vars:
qwq:
- user1
- user2
- user3
tasks:
- name: create user three
user:
name: "{{ item }}"
state: present
with_items: "{{ qwq }}"
从Ansible2.5开始,建议使用loop关键字编写循环。
将Register变量与Loop一起使用
register关键字也可以捕获循环任务的输出。以下代码片段显示了循环任务中register变量的结构:
---
- name: create user
hosts: "*"
tasks:
- name: test
command: "echo 'hello {{ item }},how are you.'"
loop:
- tom
- jarry
- alis
register: result
- debug: # 将结果输出到屏幕
var: result
[root@localhost ansible]# ansible-playbook user.yml
......
"stdout_lines": [
"hello tom,how are you."
"stdout_lines": [
"hello jarry,how are you."
"stdout_lines": [
"hello alis,how are you."
.....
有条件地运行任务
Ansible可使用conditionals在符合特定条件时执行任务或play。例如,可以利用一个条件在Ansible安 装或配置服务前确定受管主机上的可用内存。
我们可以利用条件来区分不同的受管主机,并根据它们所符合的条件来分配功能角色。Playbook变量、注册的变量和Ansible事实都可通过条件来进行测试。可以使用比较字符串、数字数据和布尔值的运算符。
以下场景说明了在Ansible中使用条件的情况:
- 可以在变量中定义硬限制(如min_memory)并将它与受管主机上的可用内存进行比较。
- Ansible可以捕获并评估命令的输出,以确定某一任务在执行进一步操作前是否已经完成。例如,如果某一程序失败,则将跳过批处理。
- 可以利用Ansible事实来确定受管主机网络配置,并决定要发送的模板文件(如,网络绑定或中继)。
- 可以评估CPU的数量,来确定如何正确调节某一Web服务器。
- 将注册的变量与预定义的变量进行比较,以确定服务是否已更改。例如,测试服务配置文件的MD5检验以和查看服务是否已更改。
条件任务语法
when语句用于有条件地运行任务。它取要测试的条件为值。如果条件满足,则运行任务。如果条件不满足,则跳过任务。
可以测试的一个最简单条件是某一布尔变量是True还是False。以下示例中的when语句导致任务仅在为True时运行:
---
- name: create user
hosts: "*"
vars:
implement: true # 当implement为true时执行
tasks:
- name: test
command: "echo 'hello {{ item }},how are you.'"
loop:
- tom
- jarry
- alis
when: implement # 条件
[root@localhost ansible]# ansible-playbook vars/user.yml
PLAY [create user] ************************************************************************************
TASK [Gathering Facts] ********************************************************************************
ok: [192.168.220.8]
TASK [test] *******************************************************************************************
changed: [192.168.220.8] => (item=tom)
changed: [192.168.220.8] => (item=jarry)
changed: [192.168.220.8] => (item=alis)
PLAY RECAP ********************************************************************************************
192.168.220.8 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
下面演示了等于某个值时运行,不等于时就跳过
---
- name: create user
hosts: "*"
tasks:
- name: test
user:
name: "{{ item }}"
state: present
loop:
- tom
- jarry
- alis
when: '"{{ item }}" == "jarry"' # 当条件为 name==jarry,执行命令,否则跳过
[root@localhost ansible]# ansible-playbook vars/user.yml
......
TASK [test] *******************************************************************************************
[WARNING]: conditional statements should not include jinja2 templating delimiters such as {{ }} or {%
%}. Found: "{{ item }}" == "jarry"
skipping: [192.168.220.8] => (item=tom) # 不满足条件跳过
changed: [192.168.220.8] => (item=jarry) # 执行满足条件的
skipping: [192.168.220.8] => (item=alis) # 不满足条件跳过
......
当用户被定义后可以执行,没定义就会跳过
---
- name: create user
hosts: "*"
vars:
user: liyuan # 定义 user
tasks:
- name: test
user:
name: "{{ user }}"
state: present
when: user is defined(定义) # user被定义就可以执行
[root@localhost ansible]# ansible-playbook vars/user.yml
......
************************************************************************
changed: [192.168.220.8] # 执行成功
PLAY RECAP ******************************************************************************* ......
下表显示了在处理条件时可使用的一些运算:
示例条件
操作 | 示例 |
---|---|
等于(值为字符串) | ansible_machine == “x86_64” |
等于(值为数字) | max_memory == 512 |
小于 | min_memory < 128 |
大于 | min_memory > 256 |
小于等于 | min_memory <= 256 |
大于等于 | min_memory >= 512 |
不等于 | min_memory != 512 |
变量存在 | min_memory is defined |
变量不存在 | min_memory is not defined |
布尔变量是True。1、True或yes的求值为True | memory_available |
布尔变量是False。0、False或no的求值为False | not memory_available |
第一个变量的值存在,作为第二个变量的列表中的值 | ansible_distribution in supported_distros |