如何处理Ansible剧本退出码导致的Jenkins任务失败问题

问题背景 #

在Ansible剧本中执行Linux系统重启任务时，机器已成功完成重启，但Ansible返回退出码4，最终导致Jenkins任务标记为失败。尝试过使用Ansible原生reboot模块及自定义shell任务均未解决问题，需从Ansible剧本内部或Jenkins调用层面找到解决方案。

Ansible剧本内部解决方案 #

1. 正确使用Ansible原生reboot模块（推荐） #

Ansible的reboot模块专门处理系统重启场景，能自动处理重启后的SSH连接恢复，避免因连接中断返回错误码。示例配置：

- name: 重启机器并等待连接恢复
  ansible.builtin.reboot:
    msg: "由Ansible触发系统重启"
    connect_timeout: 5          # SSH连接超时时间
    reboot_timeout: 300         # 最长等待重启完成时间（秒）
    pre_reboot_delay: 0         # 重启前延迟时间
    post_reboot_delay: 30       # 重启后等待系统初始化的时间
    test_command: uptime        # 验证系统正常运行的测试命令

该模块会在发送重启指令后主动断开SSH连接，等待系统重启完成后重新建立连接，确保任务返回正确状态码。

2. 优化Shell任务的执行方式 #

如果必须使用shell模块执行重启命令，需将任务放到后台执行并立即断开SSH连接，避免Ansible捕获到连接中断的错误：

- name: 后台执行重启并退出SSH连接
  shell: nohup shutdown -r now > /dev/null 2>&1 & exit 0
  async: 1
  poll: 0

• async: 1：标记任务为异步执行，超时时间1秒
• poll: 0：Ansible不等待任务完成，直接返回成功状态

Jenkins层面解决方案 #

在Jenkins Pipeline中捕获Ansible的退出码，忽略重启导致的退出码4：

stage('执行Ansible重启剧本') {
    steps {
        script {
            def exitCode = sh(
                script: 'ansible-playbook your_restart_playbook.yml',
                returnStatus: true
            )
            // 仅当退出码不是4时，才标记任务失败
            if (exitCode != 0 && exitCode != 4) {
                error "Ansible执行失败，退出码: ${exitCode}"
            } else if (exitCode == 4) {
                echo "系统已成功重启，忽略退出码4"
            }
        }
    }
}

这种方式直接在Jenkins层面过滤特定错误码，确保合法的重启操作不会导致任务失败。

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