从Jenkins运行Ansible Playbook时遭遇未识别参数错误求助

问题原因 #

你遇到的错误核心是**-k/--ask-pass是一个开关参数**，它的作用是触发Ansible交互式询问SSH密码，不需要在后面直接跟随密码值。当你在-k后添加环境变量中的密码时，Ansible会把这个密码识别为无法解析的额外参数，从而抛出错误。

正确实现方式 #

方案1：通过Extra Vars传递SSH密码

移除-k参数，改用-e参数传递ansible_password变量，这是Ansible推荐的密码传递方式：

result = sh (
    script: "ansible-playbook -i hostname.txt -u '${env.SERVICE_ACCOUNT_ID}' install_agent_onprem-TM.yaml -e 'ansible_password=${env.SERVICE_ACCOUNT_PWD}'",
    returnStdout: true
).trim()

如果密码包含特殊字符（空格、引号、$等），建议用双引号包裹extra vars，避免转义问题：

result = sh (
    script: """ansible-playbook -i hostname.txt -u '${env.SERVICE_ACCOUNT_ID}' install_agent_onprem-TM.yaml -e "ansible_password=${env.SERVICE_ACCOUNT_PWD}" """,
    returnStdout: true
).trim()

方案2：配合sshpass工具传递密码（需提前安装）

如果使用Ansible 2.10+版本，可通过--ssh-extra-args配合sshpass工具传递密码（需在Jenkins节点上安装sshpass）：

result = sh (
    script: "ansible-playbook -i hostname.txt -u '${env.SERVICE_ACCOUNT_ID}' install_agent_onprem-TM.yaml --ssh-extra-args '-o PasswordAuthentication=yes' --extra-vars 'ansible_ssh_pass=${env.SERVICE_ACCOUNT_PWD}'",
    returnStdout: true
).trim()

额外注意事项 #

• 若采用方案2，需在Jenkins节点安装sshpass：Debian/Ubuntu用apt-get install sshpass，RHEL/CentOS用yum install sshpass。
• Jenkins凭据变量自动显示为****是安全掩码机制，不影响实际密码值的传递。
• 密码含特殊字符时优先选择方案1的双引号包裹方式，减少转义麻烦。

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