ansible-inventory
显示 Ansible 库存信息,默认情况下它使用库存脚本 JSON 格式
概要
usage: ansible-inventory [-h] [--version] [-v] [-i INVENTORY] [-l SUBSET]
[--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 如何处理它
- --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
设置额外的变量为 key=value 或 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 在 GPLv3+ 许可证的条款下发布。
另请参阅
ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-galaxy(1), ansible-playbook(1), ansible-pull(1), ansible-vault(1)