ansible-inventory

显示 Ansible 库存信息,默认情况下它使用库存脚本 JSON 格式

概述

usage: ansible-inventory [-h] [--version] [-v] [-i INVENTORY] [-l SUBSET]
                      [--flush-cache] [--vault-id VAULT_IDS]
                      [-J | --vault-password-file VAULT_PASSWORD_FILES]
                      [--playbook-dir BASEDIR] [-e EXTRA_VARS] [--list]
                      [--host HOST] [--graph] [-y] [--toml] [--vars]
                      [--export] [--output OUTPUT_FILE]
                      [group]

描述

用于显示或转储 Ansible 所看到的已配置库存

常用选项

--export

在进行 –list 时,以优化导出方式表示,而不是准确表示 Ansible 如何处理它

--flush-cache

清除库存中每个主机的实际情况缓存

--graph

创建库存图表,如果提供模式,它必须是有效的组名。它会忽略限制

--host <HOST>

输出特定主机信息,作为库存脚本使用。它会忽略限制

--list

输出所有主机信息,作为库存脚本使用

--output <OUTPUT_FILE>

在进行 –list 时,将库存发送到文件而不是屏幕

--playbook-dir <BASEDIR>

由于此工具不使用剧本,因此将其用作替代剧本目录。这将设置许多功能的相对路径,包括角色/组变量/等。

--toml

使用 TOML 格式而不是默认的 JSON,对于 –graph 忽略

--vars

向图表显示添加变量,除非与 –graph 一起使用,否则忽略

--vault-id

要使用的 Vault 标识。此参数可以多次指定。

--vault-password-file, --vault-pass-file

Vault 密码文件

--version

显示程序的版本号、配置文件位置、已配置的模块搜索路径、模块位置、可执行文件位置并退出

-J, --ask-vault-password, --ask-vault-pass

询问 Vault 密码

-e, --extra-vars

将其他变量设置为键=值或 YAML/JSON,如果文件名在前面添加 @。此参数可以多次指定。

-h, --help

显示此帮助消息并退出

-i, --inventory, --inventory-file

指定库存主机路径或逗号分隔的主机列表。–inventory-file 已弃用。此参数可以多次指定。

-l <SUBSET>, --limit <SUBSET>

将所选主机进一步限制到其他模式

-v, --verbose

导致 Ansible 打印更多调试消息。添加多个 -v 将提高详细程度,内置插件当前最多评估到 -vvvvvv。开始时的合理级别是 -vvv,连接调试可能需要 -vvvv。此参数可以多次指定。

-y, --yaml

使用 YAML 格式而不是默认的 JSON,对于 –graph 忽略

参数

group

库存中的组名,在使用 –graph 时相关

环境

可以指定以下环境变量。

ANSIBLE_INVENTORY – 覆盖默认的 Ansible 库存文件

ANSIBLE_CONFIG – 覆盖默认的 Ansible 配置文件

在 ansible.cfg 中,大多数选项都有更多可用的选项。

文件

/etc/ansible/hosts – 默认清单文件

/etc/ansible/ansible.cfg – 配置文件,如果存在则使用

~/.ansible.cfg – 用户配置文件,如果存在则覆盖默认配置

作者

Ansible 最初由 Michael DeHaan 编写。

有关完整贡献者列表,请参阅 AUTHORS 文件。

许可证

Ansible 在 GPLv3+ 许可证条款下发布。

另请参阅

ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-galaxy(1), ansible-playbook(1), ansible-pull(1), ansible-vault(1)