如何从Jenkins Pipeline运行Ansible Playbook？含S3下载示例

我来帮你梳理下在Jenkins Pipeline里顺利运行这个Ansible Playbook的步骤和注意事项，毕竟本地环境和Jenkins代理节点的环境差异，经常是这类问题的根源～

1. 先搞定Jenkins节点的基础环境准备 #

• 确认Ansible配置正确性：你在Pipeline里用了installation: 'Ansible'，要先去Jenkins的「全局工具配置」里检查这个Ansible安装项的路径是否正确，确保Jenkins代理节点上确实安装了对应版本的Ansible。
• AWS凭证配置：你的Playbook用了profile: update，这意味着Jenkins代理节点的运行用户（比如ec2-user或者jenkins用户）的家目录下，需要有~/.aws/credentials文件，里面包含update这个profile的access key和secret key，而且文件权限必须设为chmod 600 ~/.aws/credentials（避免权限过宽被报错）。
  • 如果不想在节点上硬编码凭证，也可以用Jenkins的凭证管理功能，把AWS凭证存在Secret Text里，然后在Pipeline里动态写入到节点的~/.aws/credentials中。
• 目标目录权限检查：Playbook里要把文件下载到/etc/downlds/，得确保这个目录已经存在，并且Jenkins运行用户有读写权限。可以在Pipeline里加一步创建目录的命令：

  sh 'mkdir -p /etc/downlds && chmod 755 /etc/downlds'
  

2. 处理Playbook的变量传递问题 #

你的Playbook里用了{{ item1 }}和{{ item2 }}这两个变量，本地运行时可能是通过命令行参数、环境变量或者ansible.cfg传入的，但在Jenkins Pipeline里必须明确传递这些变量。可以用ansiblePlaybook步骤的extraVars参数来实现：

node {
  ansiblePlaybook installation: 'Ansible', 
                  playbook: '/home/ec2-user/Playbooks/copyfile.yml',
                  extraVars: [
                    item1: '你的第一个文件名',
                    item2: '你的第二个文件名'
                  ]
}

如果变量是动态的（比如来自Jenkins参数化构建），直接替换成params对象里的参数即可，比如item1: params.FILE_NAME_1。

3. 注意delegate_to: localhost的实际指向 #

你在Playbook里指定了delegate_to: localhost，这里的localhost指的是Jenkins代理节点本身，而不是你本地的机器。所以要确保：

• Jenkins代理节点能正常访问S3（网络连通，安全组允许出站访问S3服务）；
• 运行Playbook的用户（Jenkins节点的执行用户）拥有访问该S3桶的权限。

4. 开启调试日志排查问题 #

如果运行还是有问题，建议在ansiblePlaybook步骤里加上verbose参数，获取更详细的日志：

ansiblePlaybook installation: 'Ansible', 
                playbook: '/home/ec2-user/Playbooks/copyfile.yml',
                extraVars: [item1: 'file1.txt', item2: 'file2.txt'],
                verbose: vv // 用vvv可以获取最详细的调试日志

然后查看Jenkins的构建日志，就能找到具体的错误点（比如变量未定义、权限不足、S3连接失败等）。

完整的Pipeline示例 #

给你一个包含环境准备、变量传递和运行Playbook的完整Pipeline代码：

node {
  stage('Prepare Environment') {
    // 创建目标目录并设置权限
    sh 'mkdir -p /etc/downlds && chmod 755 /etc/downlds'
    
    // 从Jenkins凭证中获取AWS凭证并写入节点（可选，替代硬编码的credentials文件）
    withCredentials([string(credentialsId: 'aws-update-profile-creds', variable: 'AWS_CREDS')]) {
      sh '''
        mkdir -p ~/.aws
        echo "${AWS_CREDS}" > ~/.aws/credentials
        chmod 600 ~/.aws/credentials
      '''
    }
  }

  stage('Run Ansible Playbook') {
    ansiblePlaybook installation: 'Ansible',
                    playbook: '/home/ec2-user/Playbooks/copyfile.yml',
                    extraVars: [
                      item1: 'sample-file-1.txt',
                      item2: 'sample-file-2.txt'
                    ],
                    verbose: vv
  }
}

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