1. Ansible静态清单基础解析

静态清单（Static Inventory）是Ansible最基础也最常用的主机管理方式，它本质上就是一个文本文件（通常命名为inventory或hosts），通过特定的语法规则定义主机与主机组的关系。与动态清单不同，静态清单的所有主机信息都是预先手动编写好的，不会在运行时自动更新。

注意：虽然静态清单看起来简单，但90%的Ansible使用问题都源于清单文件配置错误。我在实际运维中见过太多因为一个缩进或IP错误导致整批服务器配置失败的情况。

静态清单的标准文件路径是/etc/ansible/hosts，但实践中更推荐的做法是在项目目录下创建独立的inventory文件，通过-i参数指定路径。这样可以实现不同环境（dev/test/prod）的清单隔离。

2. 静态清单的构建方法

2.1 基础主机定义

最简单的清单文件就是直接列出主机IP或域名：

192.168.1.100 app1.example.com db-server

这种定义方式适合少量主机，但当主机数量超过10台时就会变得难以维护。此时就需要使用主机组（group）来组织管理。

2.2 主机组定义

主机组用方括号[]定义，组名下可以包含多个主机：

[webservers] web1.example.com web2.example.com [dbservers] db-master.example.com db-slave1.example.com db-slave2.example.com

组可以嵌套定义，通过:children后缀表示子组关系：

[production:children] webservers dbservers

2.3 主机变量定义

静态清单中可以直接为主机或组定义变量：

[webservers] web1.example.com http_port=80 max_connections=200 web2.example.com http_port=8080 max_connections=100 [webservers:vars] nginx_version=1.18 timezone=Asia/Shanghai

经验：变量定义时等号两边不要加空格，否则会被解析为变量值的一部分。这个坑我踩过多次。

3. 高级清单管理技巧

3.1 模式匹配

Ansible支持使用模式匹配来筛选主机：

# 所有webservers组中名称以web开头的主机 ansible 'webservers:web*' -m ping # 所有dbservers组中编号大于等于2的主机 ansible 'dbservers:db-slave[2:]' -m ping

3.2 默认变量组

有两个特殊的组变量可以定义全局默认值：

[all:vars] ansible_user=admin ansible_ssh_private_key_file=~/.ssh/ops_key [ungrouped:vars] ansible_connection=local

3.3 多文件组织

对于复杂环境，可以将清单拆分为多个文件：

inventory/ ├── production ├── staging └── group_vars/ ├── webservers.yml └── dbservers.yml

然后通过目录引用：

ansible-playbook -i inventory/ site.yml

4. 静态清单的常见问题排查

4.1 主机连接失败

典型错误：

UNREACHABLE! => { "changed": false, "msg": "Failed to connect to the host via ssh...", "unreachable": true }

排查步骤：

1. 检查ansible_host变量是否正确定义
2. 确认SSH端口和密钥配置正确
3. 测试直接SSH连接是否可行

4.2 变量未生效

当变量没有按预期生效时：

1. 使用ansible-inventory --graph查看最终解析的主机结构
2. 检查变量定义的作用域（主机/组/all）
3. 确认没有更高优先级的变量覆盖

4.3 组关系错误

组嵌套关系错误会导致主机归类异常：

ansible-inventory --list | jq '._meta.hostvars'

这个命令可以输出所有主机的最终变量集合，是调试的金牌命令。

5. 静态清单的最佳实践

经过多年Ansible实战，我总结出以下经验法则：

1. 环境隔离：为dev/staging/prod环境使用不同的清单文件
2. 版本控制：将清单文件纳入Git管理，但敏感变量应使用ansible-vault加密
3. 命名规范：采用一致的命名规则，如<role>-<env>-<index>（web-prod-01）
4. 变量分层：
   • 通用变量定义在group_vars/all
   • 环境特定变量在group_vars/env_*
   • 主机特定变量在host_vars/
5. 定期验证：使用ansible -m ping all定期测试所有主机的连通性

对于超过100台主机的环境，建议考虑动态清单与静态清单结合使用。但静态清单由于其确定性和易调试性，仍然是大多数场景的首选方案。