Ansible Playbook未触发rescue块直接执行失败问题排查

问题现象 #

编写的Ansible Playbook调用包含block-rescue结构的Role，执行逻辑如下：

1. block块内先执行文件复制（开启备份）
2. 复制发生变更后，执行Validate脚本（返回非零退出码）
   预期触发rescue块回滚文件，但实际Playbook直接在Validate步骤失败终止，未进入rescue流程。即使注释掉rescue任务的when条件，问题依旧。

相关代码 #

Playbook #

- hosts: <host>
  become: true
  vars:
    dest_dir: <dir>
  roles:
    - {role: '<role>', tags: '<tag>'}

Role任务文件 #

- name: Copy and check file.
  block:
    - name: Copy
      ansible.builtin.copy:
        src: <source file>
        dest: "{{dest_dir}}"
        mode: 0666
        owner: root
        group: root
        backup: true
      register: copy_result
    - name: Print result
      ansible.builtin.debug:
        var: copy_result
    - name: Validate
      ansible.builtin.shell: <script> 1
      when: copy_result is changed
  rescue:
    - name: Revert
      ansible.builtin.copy:
        remote_src: true
        src: "{{copy_result.backup_file}}"
        dest: "{{dest_dir}}"
      when: copy_result.backup_file is defined

Validate脚本 #

exit $1

错误信息 #

TASK [<task> : Validate] ******************************************************
fatal: [<host>]: FAILED! => {"changed": true, "cmd": "<script> 1", "delta": "0:00:00.010525", "end": "2024-09-17 10:49:23.559180", "msg": "non-zero return code", "rc": 1, "start": "2024-09-17 10:49:23.548655", "stderr": "", "stderr_lines": [], "stdout": "", "stdout_lines": []}

原因分析 #

导致rescue未触发的核心原因可能有以下几点：

1. Ansible版本过低：block-rescue是Ansible 2.0引入的特性，低于该版本的环境不支持此结构，任务失败会直接终止。
2. 强制终止配置：ansible.cfg中设置了fail_fast = true，或Playbook中添加了any_errors_fatal: true，会导致单个任务失败后立即终止整个Playbook，无法进入rescue。
3. YAML缩进错误：rescue的缩进层级与block不一致，被当成block内的任务，而非独立的rescue块。
4. 任务失败标记异常：Validate任务的失败状态未被正确识别（如错误配置failed_when或changed_when），导致block未触发rescue。
5. 回滚任务路径错误：原rescue任务中dest设为目录，会导致备份文件被复制为目录下的新文件而非覆盖原文件，但这是回滚失效的问题，而非rescue未触发的原因。

解决方法 #

1. 确认Ansible版本
   执行ansible --version，确保版本≥2.0。若版本过低，升级至支持block-rescue的版本。

2. 检查终止相关配置

• 查看ansible.cfg，确认fail_fast未设为true
• 检查Playbook中是否存在any_errors_fatal: true，如有则移除或调整适用范围

3. 修正YAML缩进与回滚路径
   确保block与rescue缩进层级一致，同时修正回滚任务的dest路径，确保覆盖原文件：

- name: Copy and check file.
  block:
    - name: Copy
      ansible.builtin.copy:
        src: <source file>
        dest: "{{dest_dir}}"
        mode: 0666
        owner: root
        group: root
        backup: true
      register: copy_result
    - name: Print result
      ansible.builtin.debug:
        var: copy_result
    - name: Validate
      ansible.builtin.shell: <script> 1
      when: copy_result is changed
  rescue:
    - name: Revert
      ansible.builtin.copy:
        remote_src: true
        src: "{{copy_result.backup_file}}"
        dest: "{{dest_dir}}/{{ copy_result.src | basename }}"
      when: copy_result.backup_file is defined

4. 明确标记Validate任务失败状态
   添加failed_when确保任务失败被正确识别：

- name: Validate
  ansible.builtin.shell: <script> 1
  when: copy_result is changed
  register: validate_result
  failed_when: validate_result.rc != 0
  changed_when: false

5. 测试block-rescue基础功能
   临时简化任务验证功能是否正常：

- name: Test block-rescue
  block:
    - name: Force failure
      ansible.builtin.command: /bin/false
  rescue:
    - name: Rescue triggered
      ansible.builtin.debug:
        msg: "Rescue block executed successfully"

若能输出Rescue block executed successfully，说明block-rescue功能正常，问题出在原任务逻辑；若仍直接失败，需排查环境配置问题。

内容的提问来源于stack exchange，提问作者user27352970