Jenkins部署时从Ansible Vault提取加密文件失败问题排查

架构老林

2026-7-8

问题分析与解决方法

核心错误点及修正方案：

Inventory配置错误
dev.ini中存在拼写错误：anisble_connection=local应改为ansible_connection=local，但更关键的是——该参数会强制Ansible在**本地（Jenkins构建服务器）**执行所有任务，完全不会连接到remoteDevServer远程主机。如果你的目标是部署到远程服务器，必须移除这个参数，让Ansible默认通过SSH连接远程节点。
加密方式误用
ansible-vault encrypt_string是用来加密单个字符串的命令，不能直接加密整个配置文件。加密完整文件应该使用：
```
ansible-vault encrypt config.properties
```
加密后无需重命名文件，Ansible会自动识别加密后的文件格式。
Playbook格式不符合YAML规范
Ansible对YAML缩进和换行要求严格，你的Playbook缺少必要的换行和缩进，正确格式应为：
```
- hosts: remote_servers
  tasks:
    - name: Copy and decrypt secure file to remote
      copy:
        src: config.properties
        dest: /目标路径/config.properties
        decrypt: yes
```
注意hosts与tasks同级缩进，tasks下的任务和copy模块参数都需要正确缩进。
Jenkinsfile变量传递问题
- extraVars中的变量如果是Jenkins环境变量，需要用双引号包裹才能正确读取，比如：
```
extraVars: [
    ansible_user: "${ansible_user}",
    ansible_password: "${ansible_password}"
]
```
- 确认vaultCredentialsId对应的Jenkins凭据，确实存储了用于解密Ansible Vault文件的密码。