清单插件
清单插件允许用户指向数据源，以编译 Ansible 用于定位任务的主机清单，可以使用 -i /path/to/file 和/或 -i 'host1, host2' 命令行参数或来自其他配置源。如有必要，您可以创建自定义清单插件。
启用清单插件
Ansible 附带的大多数清单插件默认启用，或可以通过 auto 插件使用。
在某些情况下，例如，如果清单插件不使用 YAML 配置文件，您可能需要启用特定的插件。您可以通过在 ansible.cfg 文件中的 [inventory] 部分设置 enable_plugins 来完成此操作。修改此项将覆盖默认的已启用插件列表。以下是 Ansible 附带的默认已启用插件列表
[inventory]
enable_plugins = host_list, script, auto, yaml, ini, toml
如果插件位于集合中，并且未被 auto 语句选取，则可以追加完全限定的名称
[inventory]
enable_plugins = host_list, script, auto, yaml, ini, toml, namespace.collection_name.inventory_plugin_name
或者，如果它是本地插件，可能存储在 DEFAULT_INVENTORY_PLUGIN_PATH 设置的路径中，您可以按如下方式引用它
[inventory]
enable_plugins = host_list, script, auto, yaml, ini, toml, my_plugin
如果您使用支持 YAML 配置源的插件，请确保名称与清单源文件中 plugin 条目中提供的名称匹配。对于其他插件，您必须将其保存在 ansible.cfg 中配置的目录源之一中并启用它，或者添加到集合中，然后通过 FQCN 引用它。
使用清单插件
要使用清单插件，您必须提供清单源。大多数情况下，这是一个包含主机信息的文件或带有插件选项的 YAML 配置文件。您可以使用 -i 标志来提供清单源或配置默认清单路径。
ansible hostname -i inventory_source -m ansible.builtin.ping
要开始使用具有 YAML 配置源的清单插件，请创建一个具有针对所讨论插件记录的可接受文件名模式的文件，然后添加 plugin: plugin_name。如果插件在集合中，请使用完全限定的名称。
注意
清单插件具有它们必须符合的必需名称模式，例如
包含 kubevirt.core.kubevirt 清单插件的清单必须使用 *.kubevirt.yml 文件名模式。包含 servicenow.servicenow.now 清单插件的清单必须使用 *.servicenow.yml 文件名模式。
# demo.aws_ec2.yml
plugin: amazon.aws.aws_ec2
每个插件都应记录任何命名限制。此外，YAML 配置文件必须以扩展名 yml 或 yaml 结尾，才能默认使用 auto 插件启用（否则，请参阅上面关于启用插件的部分）。
提供任何必需的选项后，您可以使用 ansible-inventory -i demo.aws_ec2.yml --graph 查看填充的清单
@all:
|--@aws_ec2:
| |--ec2-12-345-678-901.compute-1.amazonaws.com
| |--ec2-98-765-432-10.compute-1.amazonaws.com
|--@ungrouped:
如果您在剧本相邻的集合中使用清单插件，并且想使用 ansible-inventory 测试您的设置，请使用 --playbook-dir 标志。
您的清单源可能是清单配置文件的目录。构造的清单插件仅对清单中已有的主机进行操作，因此您可能希望在特定点（例如最后）解析构造的清单配置。Ansible 以递归方式按字母顺序解析目录。您无法配置解析方法，因此请命名您的文件以使其可预测地工作。直接扩展构造功能的清单插件可以通过添加构造选项以及清单插件选项来解决该限制。否则，您可以使用带有多个源的 -i 来强制执行特定顺序，例如 -i demo.aws_ec2.yml -i clouds.yml -i constructed.yml。
您可以使用带有构造的 keyed_groups 选项的主机变量创建动态组。groups 选项也可用于创建组，compose 创建和修改主机变量。以下是利用构造功能的 aws_ec2 示例
# demo.aws_ec2.yml
plugin: amazon.aws.aws_ec2
regions:
- us-east-1
- us-east-2
keyed_groups:
# add hosts to tag_Name_value groups for each aws_ec2 host's tags.Name variable
- key: tags.Name
prefix: tag_Name_
separator: ""
# If you have a tag called "Role" which has the value "Webserver", this will add the group
# role_Webserver and add any hosts that have that tag assigned to it.
- key: tags.Role
prefix: role
groups:
# add hosts to the group development if any of the dictionary's keys or values is the word 'devel'
development: "'devel' in (tags|list)"
# add hosts to the "private_only" group if the host doesn't have a public IP associated to it
private_only: "public_ip_address is not defined"
compose:
# use a private address where a public one isn't assigned
ansible_host: public_ip_address|default(private_ip_address)
# alternatively, set the ansible_host variable to connect with the private IP address without changing the hostname
# ansible_host: private_ip_address
# if you *must* set a string here (perhaps to identify the inventory source if you have multiple
# accounts you want to use as sources), you need to wrap this in two sets of quotes, either ' then "
# or " then '
some_inventory_wide_string: '"Yes, you need both types of quotes here"'
现在 ansible-inventory -i demo.aws_ec2.yml --graph 的输出
@all:
|--@aws_ec2:
| |--ec2-12-345-678-901.compute-1.amazonaws.com
| |--ec2-98-765-432-10.compute-1.amazonaws.com
| |--...
|--@development:
| |--ec2-12-345-678-901.compute-1.amazonaws.com
| |--ec2-98-765-432-10.compute-1.amazonaws.com
|--@role_Webserver
| |--ec2-12-345-678-901.compute-1.amazonaws.com
|--@tag_Name_ECS_Instance:
| |--ec2-98-765-432-10.compute-1.amazonaws.com
|--@tag_Name_Test_Server:
| |--ec2-12-345-678-901.compute-1.amazonaws.com
|--@ungrouped
如果主机在上面的配置中没有变量（换句话说，tags.Name、tags、private_ip_address），则该主机将不会添加到清单插件创建的组之外的组，并且 ansible_host 主机变量将不会被修改。
支持缓存的清单插件可以使用 ansible.cfg 文件的 [defaults] 部分中定义的 fact 缓存的常规设置，或者在 [inventory] 部分中定义特定于清单的设置。各个插件可以在其配置文件中定义特定于插件的缓存设置
# demo.aws_ec2.yml
plugin: amazon.aws.aws_ec2
cache: true
cache_plugin: ansible.builtin.jsonfile
cache_timeout: 7200
cache_connection: /tmp/aws_inventory
cache_prefix: aws_ec2
以下是在 ansible.cfg 文件中设置清单缓存以及用于缓存插件和超时的一些 fact 缓存默认值的示例
[defaults]
fact_caching = ansible.builtin.jsonfile
fact_caching_connection = /tmp/ansible_facts
cache_timeout = 3600
[inventory]
cache = yes
cache_connection = /tmp/ansible_inventory
插件列表
您可以使用 ansible-doc -t inventory -l 查看可用插件的列表。使用 ansible-doc -t inventory <plugin name> 查看特定于插件的文档和示例。