ansible-playbook

执行 Ansible 剧本

补充说明

ansible-playbook 按 inventory 和 playbook 配置主机，执行任务、处理器和角色。它适合配置管理和编排，核心要求是幂等和可重复执行。

常用示例

ansible-playbook -i inventory.ini site.yml
ansible-playbook -i inventory.ini site.yml --check
ansible-playbook -i inventory.ini site.yml --diff
ansible-playbook -i inventory.ini site.yml --limit web
ansible-playbook -i inventory.ini site.yml --tags deploy
ansible-playbook -i inventory.ini site.yml --skip-tags slow
ansible-playbook -i inventory.ini site.yml -e "version=1.2.3"
ansible-playbook -i inventory.ini site.yml --vault-password-file .vault_pass
ansible-playbook -i inventory.ini site.yml --syntax-check
ansible-playbook -i inventory.ini site.yml --list-tasks
ansible-playbook -i inventory.ini site.yml -f 20 -vvv

易错点与排错

• 任务必须幂等；用 command/shell 时加 creates/changed_when，否则每次都报变更。
• --check 对依赖前序变更的任务可能不准；先在小范围验证。
• become 和 become_user 要显式配置；权限失败先看 SSH 用户和 sudo 规则。
• inventory 可以是 INI、YAML 或动态插件；格式和组名要匹配。
• --limit 只限制目标，不会跳过依赖这些主机的事实收集。
• tags 写错会静默跳过任务；用 --list-tasks 确认实际执行范围。
• handlers 只会在任务 changed 时触发；调试时看通知链。
• delegate_to 和 run_once 会改变执行主机；变量作用域要确认。
• vault 密码文件权限要收紧；不要把密码写进 playbook。

相关命令

• ansible-vault — 加密敏感变量
• ansible-galaxy — 安装角色和集合
• ssh — 底层连接

读完自测

合上页面，先回答，再展开对照。

1. 用 command/shell 模块时如何避免每次都报 changed？
2. --check 的结果一定准确吗？
3. tags 写错会直接报错吗？