如何配置Ansible command模块接受预期的非零返回码？

你的核心问题是：pgrep命令在未找到进程时会返回非零码（1），但Ansible默认会把非零返回码判定为任务失败，导致后续的assert任务无法执行。要让command模块接受预期内的非零返回，有两种可靠的处理方式：

方法1：用failed_when精准控制失败条件 #

这是最优方案，既能允许预期的非零返回，又能捕获真实的命令错误（比如pgrep不存在、参数写错等）。修改后的任务如下：

- name: Make sure all expected processes are down
  tags: ensure_processes_down
  block:
    - name: Find list of unexpected processes
      command:
        argv:
          - /usr/bin/pgrep
          - --list-name
          - unexpected_processes_pattern_here
      register: pgrep_status
      # pgrep正常返回0（找到进程）或1（未找到），其他返回码才判定为任务失败
      failed_when: pgrep_status.rc not in [0, 1]
      # 标记任务为无状态变更（仅查询，未修改系统）
      changed_when: false

    - name: Ensure no processes were found
      assert:
        that: pgrep_status.rc != 0
        msg: 'Cannot run while these processes are up: {{ pgrep_status.stdout }}'

解释：设置failed_when后，只有当pgrep返回0/1之外的码时，任务才会失败；返回0或1时都会正常执行后续的assert，由assert来判断是否触发最终的失败逻辑。

方法2：用ignore_errors忽略所有非零返回（不推荐） #

如果只是简单粗暴地忽略所有非零返回，可以添加ignore_errors: yes，但这种方式会掩盖真实的命令错误（比如pgrep路径写错），所以仅适合场景非常简单的情况：

- name: Find list of unexpected processes
  command:
    argv:
      - /usr/bin/pgrep
      - --list-name
      - unexpected_processes_pattern_here
  register: pgrep_status
  ignore_errors: yes

额外优化建议 #

如果你想更贴合Ansible的原生风格，可以尝试用ansible.builtin.pidof模块替代直接调用pgrep，它专门用于查询进程PID，返回结果更易处理，但匹配规则的灵活性不如pgrep。

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