找 Ansible 资料，首选官方文档配合结构化项目实战，社区博客仅作为特定问题的补充参考。很多教程只展示了如何运行，却没强调如何确保多次运行结果一致，这在实际生产中至关重要。

基础环境与 Inventory 配置

确保控制节点安装 Ansible，被管节点开启 SSH 并配置免密登录。不要一开始就纠结复杂架构，先打通两台机器。编写 hosts 文件，分组管理主机，静态文件更适合入门。

# /etc/ansible/hosts 或项目根目录下的 hosts 文件
[webservers]
web1.example.com ansible_user=ubuntu
web2.example.com ansible_user=centos

[dbservers]
db1.example.com ansible_user=root

[all:vars]
ansible_python_interpreter=/usr/bin/python3

实战：Nginx 自动化部署 Playbook

将 ad-hoc 命令转化为 YAML 格式的 playbook。注意缩进规范，建议使用 yaml-lint 检查语法。以下是一个完整的 site.yml 示例，包含变量、任务和处理程序。

---
- name: Install and configure Nginx
  hosts: webservers
  become: yes
  vars:
    nginx_port: 80
  tasks:
    - name: Install nginx
      apt:
        name: nginx
        state: present
      when: ansible_os_family == "Debian"

    - name: Start nginx service
      service:
        name: nginx
        state: started
        enabled: yes

    - name: Deploy custom index.html
      template:
        src: templates/index.html.j2
        dest: /var/www/html/index.html
      notify: restart nginx

  handlers:
    - name: restart nginx
      service:
        name: nginx
        state: restarted

项目结构与 Roles 规范

当 playbook 变长时，学习 directory structure 规范，将任务拆分为 roles，便于复用。以下是推荐的标准目录结构树状图。

project/
├── ansible.cfg
├── hosts
├── site.yml
└── roles/
    ├── common/
    │   ├── tasks/
    │   ├── handlers/
    │   ├── templates/
    │   └── vars/
    └── nginx/
        ├── tasks/
        ├── handlers/
        └── templates/

敏感信息加密 (Ansible Vault)

不要在 playbook 中明文写密码，建议使用 Ansible Vault 加密变量。以下是加密解密的具体命令。

# 加密文件
ansible-vault encrypt secrets.yml

# 查看加密文件内容
ansible-vault view secrets.yml

# 编辑加密文件
ansible-vault edit secrets.yml

# 运行 playbook 时输入密码
ansible-playbook site.yml `--ask-vault-pass`

验证与幂等性检查

学习成果的最终验证标准是“幂等性”和“可维护性”。连续运行两次同一个 playbook，第二次运行应显示 changed=0。

# 测试主机连通性
ansible all -m ping

# 执行临时命令
ansible all -m shell -a "uptime"

# 运行 playbook 并检查变更（不实际执行）
ansible-playbook site.yml `--check`

# 运行 playbook 并限制特定主机
ansible-playbook site.yml `--limit` webserver

# 增加详细输出用于排查
ansible-playbook site.yml -vvv

工程实践中的常见风险

• 硬编码敏感信息：明文密码极易泄露，必须使用 Vault 或外部变量管理。
• 忽略错误处理：默认情况下任务失败会停止，需根据场景配置 ignore_errors 或 block/rescue。
• Python 版本依赖：被管节点通常需要 Python 环境，部分精简系统可能需要指定 python_interpreter。
• 过度使用 shell 模块：优先使用专用模块（如 yum, systemd），shell 模块难以保证幂等性且不易维护。
• 版本兼容性：Ansible 版本迭代较快，社区中很多教程基于旧版本编写，可能导致模块参数变更或语法弃用。

参考来源

• Ansible 官方文档，Ansible documentation，https://docs.ansible.com/
• Ansible 最佳实践，Ansible Best Practices，https://docs.ansible.com/ansible/latest/playbook_best_practices.html