运行ansible playbook报unrecognized arguments: create-file.yml是什么原因？

API 探路者

2026-9-23

报错信息解析

对应完整报错如下：

Identity added: /tmp/ansible-runner20211205-356-7iz5rz/artifacts/result/ssh_key_data (/tmp/ansible-runner20211205-356-7iz5rz/artifacts/result/ssh_key_data)
usage: ansible-playbook [-h] [--version] [-v] [-k]
                        [--private-key PRIVATE_KEY_FILE] [-u REMOTE_USER]
                        [-c CONNECTION] [-T TIMEOUT]
                        [--ssh-common-args SSH_COMMON_ARGS]
                        [--sftp-extra-args SFTP_EXTRA_ARGS]
                        [--scp-extra-args SCP_EXTRA_ARGS]
                        [--ssh-extra-args SSH_EXTRA_ARGS] [--force-handlers]
                        [--flush-cache] [-b] [--become-method BECOME_METHOD]
                        [--become-user BECOME_USER] [-K] [-t TAGS]
                        [--skip-tags SKIP_TAGS] [-C] [--syntax-check] [-D]
                        [-i INVENTORY] [--list-hosts] [-l SUBSET]
                        [-e EXTRA_VARS] [--vault-id VAULT_IDS]
                        [--ask-vault-pass | --vault-password-file VAULT_PASSWORD_FILES]
                        [-f FORKS] [-M MODULE_PATH] [--list-tasks]
                        [--list-tags] [--step] [--start-at-task START_AT_TASK]
                        playbook [playbook ...]
ansible-playbook: error: unrecognized arguments: create-file.yml

第一行Identity added: xxx为正常日志，说明系统已成功加载配置的AWS Ubuntu主机私钥凭证到ssh-agent中，凭证本身加载无异常
后续的usage提示是ansible-playbook命令的参数帮助信息，触发该提示的唯一原因是命令执行时传入的参数格式不符合要求
最后一行ansible-playbook: error: unrecognized arguments: create-file.yml为核心错误：系统将待执行的playbook文件名create-file.yml识别为非法参数，而非要运行的playbook目标文件

触发原因

该报错和凭证本身无直接关联，是manageIQ拼接ansible执行命令时参数顺序错位导致：

最常见原因是配置作业模板时，误将create-file.yml填写到了「额外命令参数」「额外变量」栏，未填到指定playbook文件的专用配置项中，导致文件名被拼接到参数列表的错误位置
其次可能是配置的额外参数存在未闭合的引号、多余特殊符号，导致参数解析混乱，后续的playbook路径被误判为非法参数
不加凭证时本地运行正常，是因为本地执行时参数顺序符合ansible-playbook [参数] playbook文件名的规范，加凭证后manageIQ拼接命令时出现参数错位

修复方案

检查作业模板配置：确认create-file.yml填写在Playbook专用的选择/输入栏，未填到其他参数配置项中
检查SSH凭证配置：确认远程用户名、私钥内容里没有多余的未转义特殊符号、空格，避免命令拼接时参数被异常拆分
排查额外参数配置：如果有填写自定义命令参数，确认所有引号闭合、参数格式符合ansible规范，无多余的短横线、分隔符
可查看manageIQ的任务执行日志，提取完整的最终拼接的ansible-playbook执行命令，对比参数顺序即可快速定位错位项

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