高效ansible playbook的核心是逻辑清晰、执行可靠、维护简单，需精准定位主机范围、确保任务幂等、善用变量与条件、拆分复用为模块化结构。
编写高效的 Ansible Playbook，核心不是堆功能，而是让逻辑清晰、执行可靠、维护简单。真正高效的 Playbook 往往结构干净、复用性强、状态可控，而不是写得最多或最炫。
明确目标与主机范围
高效始于精准定位。避免在 hosts 中硬编码 IP 或写过于宽泛的通配符（如 all），优先使用 Inventory 中定义好的主机组名，比如 webservers 或 db_servers。这样既便于权限隔离，也方便后期按环境（dev/staging/prod）切换执行范围。
- 推荐写法：
hosts: webservers，而非hosts: 192.168.1.10,192.168.1.11 - 多环境时可配合
--limit参数动态限定，例如：ansible-playbook deploy.yml --limit staging - 若需跨组操作，用
hosts: webservers:&databases表示交集，webservers:!backup表示排除
任务设计讲求幂等与最小变更
Ansible 的价值在于“多次运行结果一致”。每个 task 应该只做一件事，并且能准确判断目标状态是否已满足——这就是幂等性。比如用 file 模块创建目录时，state: directory 比 command: mkdir -p /path 更安全；用 service 控制服务启停，比 shell 手动调用 systemctl 更可靠。
- 避免
shell和command模块做本可用原生模块完成的事 - 安装软件统一用
apt/yum/dnf，不写shell: apt install -y nginx - 修改配置优先用
lineinfile或replace，而非覆盖整个文件（除非必要）
善用变量与条件控制
把重复值抽成变量，把差异化逻辑交给条件判断。比如不同系统装不同包、不同环境用不同端口、敏感信息加密存储——这些都能显著提升 Playbook 的通用性和安全性。
- OS 差异：用
when: ansible_os_family == 'RedHat'或when: ansible_distribution == 'Ubuntu' - 变量来源：支持 inventory 变量、play 内
vars、外部vars_files，甚至host_vars/和group_vars/目录 - 密码类字段务必通过
ansible-vault加密，不以明文出现在 playbook 或 inventory 中
拆分与复用：从单文件走向模块化
超过 5 个任务的 Playbook 就该考虑拆分。把安装、配置、启动、校验等职责分离到独立 task 文件中，再用 import_tasks 或 include_tasks 引入。更进一步，可封装为 Role，实现跨项目复用。
- 基础结构示例：
tasks/main.yml→tasks/install.yml+tasks/configure.yml+tasks/start.yml -
import_tasks是静态导入（解析期加载），适合稳定流程；include_tasks是动态导入（执行期加载），支持带变量和条件 - Role 目录结构天然支持变量、模板、文件、handlers 等资源集中管理，是企业级项目的标配
