使用Ansible管理动态和静态清单的指南

Ansible清单回答了一个实际的问题：此自动化应触及哪些系统？如果清单错误，一个好的剧本仍然可能针对错误的主机、跳过新服务器或使用错误的连接变量。

本指南涵盖静态清单文件、动态清单源以及ansible-inventory检查，这些检查有助于确认Ansible看到的正是您期望的基础设施。

理解Ansible清单

Ansible清单本质上是一个主机和组的列表。Ansible使用此信息来确定要连接和执行任务的机器。默认清单文件位置是/etc/ansible/hosts，但您可以为任何Ansible命令或剧本使用-i标志指定不同的清单文件。

管理清单主要有两种方式：

静态清单： 手动在文件（INI或YAML格式）中定义主机和组。
动态清单： 使用脚本或插件从外部源（如云提供商AWS、Azure、GCP）、虚拟化平台（VMware）或CMDB动态生成主机清单。

静态清单文件

对于服务器集合稳定的环境，静态清单非常直接。它们通常以类似INI的格式或YAML编写。

INI格式

在INI格式中，列出主机，并可以将它们组织成组。您还可以为主机或组定义变量。

示例 /etc/ansible/hosts（INI格式）：

[webservers]
web1.example.com
web2.example.com ansible_user=deployer

[databases]
db1.example.com
db2.example.com

[all:vars]
ansible_ssh_private_key_file=~/.ssh/id_rsa
ansible_python_interpreter=/usr/bin/python3

在此示例中：

[webservers]和[databases]定义了组。
web1.example.com和web2.example.com是webservers组中的主机。
ansible_user=deployer为web2.example.com设置了特定的SSH用户。
[all:vars]定义了适用于清单中所有主机的变量。

YAML格式

YAML格式为复杂的清单结构和变量定义提供了更大的灵活性。

示例 /etc/ansible/hosts（YAML格式）：

all:
  children:
    webservers:
      hosts:
        web1.example.com:
        web2.example.com:
          ansible_user: deployer
    databases:
      hosts:
        db1.example.com:
        db2.example.com:
  vars:
    ansible_ssh_private_key_file: ~/.ssh/id_rsa
    ansible_python_interpreter: /usr/bin/python3

此YAML结构实现了与INI示例相同的分组和变量分配。

动态清单

对于服务器频繁配置和取消配置的云原生环境，动态清单至关重要。Ansible通过插件和自定义脚本支持动态清单。

使用动态清单插件

Ansible为流行的云提供商和服务提供了广泛的内置动态清单插件。要使用一个，您通常需要创建一个清单配置文件（通常为YAML），指定插件及其参数。

示例：AWS EC2动态清单配置（aws_ec2.yml）

plugin: amazon.aws.aws_ec2
regions:
  - us-east-1
  - us-west-2
keyed_groups:
  # 按EC2实例标签分组实例
  - key: tags
    prefix: tag
filters:
  # 仅包括正在运行的实例
  instance-state-name: running
compose:
  # 将ansible_host设置为私有IP地址
  ansible_host: private_ip_address

要将其与Ansible一起使用，您可以运行如下命令：

ansible-inventory -i aws_ec2.yml --graph

此命令将查询AWS在指定区域中正在运行的实例，并根据其标签和其他属性以层次结构图显示它们。

许多云清单插件需要安装相应的集合。对于AWS EC2，通常需要amazon.aws，以及环境中、配置文件或实例角色中有效的AWS凭证。

自定义动态清单脚本

如果内置插件不能满足您的需求，您可以编写自己的脚本（例如Python），以JSON格式输出清单数据。此脚本必须是可执行的，并返回表示清单的JSON对象。

示例Python脚本（my_dynamic_inventory.py）：

#!/usr/bin/env python

import json

# 模拟获取清单数据
hosts_data = {
    "_meta": {
        "hostvars": {
            "host1.example.com": {"ansible_user": "admin"},
            "host2.example.com": {"ansible_user": "user"}
        }
    },
    "webservers": {
        "hosts": ["host1.example.com", "host2.example.com"]
    },
    "databases": {
        "hosts": ["db1.example.com"]
    }
}

print(json.dumps(hosts_data))

使脚本可执行：

chmod +x my_dynamic_inventory.py

然后将其与Ansible一起使用：

ansible-inventory -i my_dynamic_inventory.py --list

使用`ansible-inventory`管理清单

ansible-inventory命令是一个强大的工具，用于检查和维护清单。它可以解析不同的清单源，并显示主机及其关联的变量。

查看活动主机

要查看清单中所有主机的平面列表：

ansible-inventory -i /path/to/your/inventory --list

此命令将输出表示整个清单的JSON结构，包括组和主机变量。

分组系统

如静态清单示例所示，分组对于针对特定机器集合至关重要。您可以为不同角色（webservers、databases、appservers）、环境（production、staging）或任何对基础设施有意义的逻辑分类创建组。

Ansible会根据清单文件自动创建组。您还可以定义特殊组，如all（包括所有主机）和ungrouped（未分配到任何特定组的主机）。

使用内置清单命令标志

ansible-inventory命令提供多个标志用于详细检查：

--graph：以层次树格式显示清单，显示组及其成员。

ansible-inventory -i /etc/ansible/hosts --graph

示例输出：

@all
├──@databases
│  ├──db1.example.com
│  └──db2.example.com
└──@webservers
   ├──web1.example.com
   └──web2.example.com

--host <hostname>：显示与特定主机关联的所有变量。

ansible-inventory -i /etc/ansible/hosts --host web2.example.com