基础设施即代码 / 系统课时

使用 Conditionals 控制任务

使用 Conditionals 控制任务

Conditionals 用来决定某个任务在当前主机上是否应该执行。你可以把普通变量、Facts 和前序任务的注册结果组合进 when,让同一个 Playbook 针对不同主机走不同路径,同时保持跳过、失败和变更状态清晰可读。

学习目标

  • 能使用变量、Facts 和 register 结果编写 when 条件。
  • 能正确表达 AND、OR、未定义值保护和类型转换。
  • 能区分 when、failed_when 与 changed_when 各自控制的行为。

条件是在每台主机上分别判断的

任务开始前,Ansible 会针对当前主机计算 when。结果为真时执行模块,为假时记录为 skipped;因此同一个任务可以在一部分主机执行,在另一部分主机跳过。条件引用的 Facts 和注册结果也都是主机上下文的一部分。

变量、Facts 与注册结果共同决定任务是否执行

组合变量、Facts 与注册结果

下面示例面向 Linux 主机:先执行一次只读命令并注册结果,再由开关变量、系统 Facts 和命令返回值共同决定维护任务是否执行。条件列表中的每一项都必须为真,因此它天然表示 AND。

yaml
- 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:

bash
ansible-playbook -i localhost, conditionals.yml

预期输出中应能看到维护任务为 ok,而不是 skipped;任务计数和 Facts 输出细节可能随环境不同:

text
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 三种状态定位问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Conditionals 控制任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通