用途:在项目包含 playbook、role、inventory、ansible.cfg 或 collections 的 requirements.yml/galaxy.yml 时启用;也用于在共享环境运行前审查既有自动化是否真正幂等。已容器化并由集群编排的服务不适用(应使用 $specsfy-specialist-docker-swarm,Ansible 只负责主机准备);playbook 作为部署流水线一环时配合 $specsfy-specialist-delivery-engineering;完整发布或部署在 $specsfy-specialist-deploy 下进行。
主要能力:以幂等模块和职责单一的 role 建模目标状态;用 Ansible Vault 或外部密钥提供者保护机密;检查变量优先级与 collections/ansible-core 固定版本;遵循 FQCN、可操作的 task/handler 命名、defaults 与 vars 分离、changed_when/failed_when 语义真实、最小化 become、机密任务用 no_log: true,以及需要时显式使用 serial 和 throttle。
使用方式:执行前确认主机、组、目标环境、连接方式和精确主机范围;用 ./deploy check-hosts 列出主机并用 ping 模块确认,用 ./deploy sync-keys 仅添加公钥;由代理执行时在部署编排器下使用 ./deploy run --non-interactive,无外部来源时在人类终端执行 ./deploy configure-vault,不通过对话索取或读取密码,./deploy run 保持手动并隐藏输入。先做语法检查、ansible-lint 与 check mode diff(不得泄露机密),在一次性环境验证同一操作两次执行第二次不报告 changed,再以 serial、--limit 和 max_fail_percentage/any_errors_fatal 应用到生产。
限制:资料未提供具体安装命令、收费与平台信息;未完成两次连续幂等验证和 check mode 前,不得宣称 role 幂等或安全。