基础设施即代码 / 系统课时
使用 Conditionals 控制任务
使用 Conditionals 控制任务
Conditionals 用来决定某个任务在当前主机上是否应该执行。你可以把普通变量、Facts 和前序任务的注册结果组合进 when,让同一个 Playbook 针对不同主机走不同路径,同时保持跳过、失败和变更状态清晰可读。
学习目标
- 能使用变量、Facts 和
register结果编写when条件。 - 能正确表达 AND、OR、未定义值保护和类型转换。
- 能区分
when、failed_when与changed_when各自控制的行为。
条件是在每台主机上分别判断的
任务开始前,Ansible 会针对当前主机计算 when。结果为真时执行模块,为假时记录为 skipped;因此同一个任务可以在一部分主机执行,在另一部分主机跳过。条件引用的 Facts 和注册结果也都是主机上下文的一部分。

组合变量、Facts 与注册结果
下面示例面向 Linux 主机:先执行一次只读命令并注册结果,再由开关变量、系统 Facts 和命令返回值共同决定维护任务是否执行。条件列表中的每一项都必须为真,因此它天然表示 AND。
- name: Control tasks with conditions
hosts: localhost
connection: local
gather_facts: true
vars:
maintenance_enabled: true
tasks:
- name: Check kernel name
ansible.builtin.command: uname -s
register: kernel_check
changed_when: false
- name: Run maintenance action
ansible.builtin.debug:
msg: "maintenance condition passed"
when:
- maintenance_enabled | bool
- ansible_facts['os_family'] is defined
- kernel_check.rc == 0
- kernel_check.stdout == 'Linux'预期结果:在 Linux 本机上,uname -s 正常返回且开关为真时,第二个任务会执行;任一条件不满足时,该任务显示为 skipped。
运行 Playbook:
ansible-playbook -i localhost, conditionals.yml预期输出中应能看到维护任务为 ok,而不是 skipped;任务计数和 Facts 输出细节可能随环境不同:
TASK [Run maintenance action]
ok: [localhost] => {
"msg": "maintenance condition passed"
}写出可维护的复合条件
多项 AND 条件优先写成列表,每行只表达一个判断,便于定位是哪一项不满足。需要 OR 时,把相关判断放在同一个表达式中并用括号明确优先级,例如 when: (maintenance_enabled | bool) and (kernel_check.rc == 0 or (force_run | default(false) | bool))。
when 是表达式上下文,不需要 {{ }}。在这里继续写 when: "{{ maintenance_enabled }}" 不仅多余,还会让表达式与字符串渲染混在一起,降低可读性。涉及数值或布尔输入时仍应先用 int、bool 等过滤器明确类型。
保护可能不存在的变量
条件最常见的失败不是“结果为假”,而是表达式在求值时访问了不存在的变量。对可选输入可以使用 default,例如 optional_limit | default(0) | int > 0。如果后续表达式必须直接读取该变量,可在同一个条件里先判断定义状态:optional_limit is defined and optional_limit | int > 0。
对注册结果也要遵守同样原则。只有前序任务确实运行并完成后,result.rc、result.stdout 等字段才有意义;若前序任务本身可能被跳过,就应先判断结果对象和所需字段是否可用,而不是无条件读取。
区分执行条件与结果判定
when 决定模块是否执行;failed_when 在模块已经返回结果后重新定义“什么算失败”;changed_when 则重新定义“是否算发生变更”。三者都使用条件表达式,但控制的是不同阶段。
例如只读检查命令通常配合 changed_when: false,避免每次运行都显示 changed;如果某个命令返回非零状态在业务上仍属正常,可以用 failed_when 精确定义失败条件。不要把这些结果判定写进 when 来绕过真正需要执行的检查。
当条件逻辑按“输入是否存在 → 类型是否明确 → 条件是否成立 → 任务状态如何记录”的顺序设计时,Playbook 会更容易预测,也更容易从 skipped、failed 和 changed 三种状态定位问题。