用途:围绕编写、审查与运行 Ansible 提供决策依据,核心是三条判断原则。
主要能力:一、版本线决定可写内容而非机器上的二进制,重点说明 2.19 模板引擎重写带来的分界,及 2.18 至 2.21 的支持窗口、功能下限与弃用项。二、ok 与 changed 是模块的声明而非测量,command 任务每次运行都声明变更,异步启动同样如此,--check 会跳过无法模拟的内容;幂等性只能由第二次运行 changed=0 证明。三、值来自何处不可猜测,需先读 inventory 布局、group_vars 相邻关系、ansible.cfg 发现顺序与 collection 版本。
使用方式:编写条件表达式时不使用 {{ }},条件必须求值为布尔;字符串中的 {{ }} 视为数据不被渲染;类型会保留,需用 int、string、bool、list 转换。YAML 中以 {{ 开头的值要加引号,文件权限要写成 "0644",表达式含冒号时加引号。command 与 shell 每次报告 changed,应加 creates、removes 或 changed_when;异步任务要处理对应状态。变量优先级从 role defaults、inventory 变量、facts、play vars、role vars、block/task vars、include_vars、registered/set_fact、role 参数到 extra vars 逐级升高。始终使用 FQCN,如 ansible.builtin.copy。
适用场景:Ansible playbook 的编写与审查、版本升级评估、幂等性排查、变量作用域与优先级定位、handler 与委托执行配置、角色与 collection 管理。
限制:资料仅给出规则与陷阱,未提供具体命令示例、安装命令、价格或平台信息;部分版本支持窗口与弃用时间点来自资料原文。