Jenkins流水线运行Ansible Playbook故障求助

兄弟，我之前在Jenkins流水线里跑Ansible也踩过不少坑，咱们一步步来排查你遇到的问题：

你说已经装了Ansible插件且验证了系统路径能识别，但Jenkins的执行环境和你登录服务器的shell环境可能不是一回事，先排查这几点：

• 检查全局工具配置：进入「Manage Jenkins」→「Global Tool Configuration」，找到Ansible配置项：
  • 如果是手动安装的Ansible，直接填它的绝对路径（比如/usr/bin/ansible），别依赖系统PATH，Jenkins的运行用户可能读不到你的环境变量；
  • 也可以选「Install automatically」让Jenkins自动下载对应版本，然后给这个配置起个名字（比如Ansible-2.15）。
• 在Jenkinsfile里指定工具：确保流水线里引用了刚才配置的Ansible工具，示例如下：

pipeline {
    agent any
    tools {
        ansible 'Ansible-2.15' // 这里填你在全局配置里给Ansible起的名字
    }
    stages {
        stage('Deploy with Ansible') {
            steps {
                ansiblePlaybook(
                    playbook: 'deploy.yml', // 相对于Jenkins工作空间的路径
                    inventory: 'inventory.ini',
                    credentialsId: 'your-ssh-credential-id' // 提前在Jenkins凭证里配置好SSH密钥/密码
                )
            }
        }
    }
}

• 验证插件执行环境：可以在流水线里加个调试步骤，确认Ansible能被Jenkins识别：

steps {
    sh 'ansible --version'
}

如果用sh 'ansible-playbook ...'出现SSH连接失败，大概率是Jenkins运行用户（通常是jenkins用户）的SSH权限问题，按下面的步骤来：

• 配置Jenkins用户的SSH密钥：
  1. 切换到jenkins用户：sudo su - jenkins
  2. 生成SSH密钥（如果没有的话）：ssh-keygen -t ed25519（一路回车用默认配置）
  3. 把公钥（~/.ssh/id_ed25519.pub里的内容）复制到目标服务器的~remote-user/.ssh/authorized_keys文件里
• 信任目标主机指纹：
  可以临时关闭StrictHostKeyChecking（测试用，生产建议手动添加指纹），在jenkins用户的~/.ssh/config里添加：

Host *
    StrictHostKeyChecking no
    UserKnownHostsFile /dev/null

• 测试SSH连通性：切换到jenkins用户后，直接执行ssh remote-user@target-server，看能不能正常登录，排除端口、防火墙的问题。
• 用Jenkins凭证管理密码（如果不用密钥）：如果目标服务器用密码登录，别明文写在playbook里，用Jenkins凭证存储密码，然后在流水线里调用：

withCredentials([string(credentialsId: 'target-server-password', variable: 'SSH_PASS')]) {
    sh 'ANSIBLE_PASSWORD=$SSH_PASS ansible-playbook deploy.yml -i inventory.ini -u remote-user'
}

• 检查Jenkins工作空间里的playbook、inventory文件权限：有时候代码拉取后权限不足，加个sh 'ls -la'看看文件是不是可读；
• 确认Python版本：Ansible对Python版本有要求（比如2.15+需要Python3.8+），用sh 'python3 --version'和sh 'ansible --version'验证环境是否匹配。

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