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，创建仓库的图表，如果提供了模式，则必须是有效的组名。他将忽略 --limit；
• --host <HOST>，输出指定主机的信息，以仓库脚本形式工作。他将忽略 --limit；
• --list，输出全部主机信息，以仓库脚本形式工作；
• --output <OUTPUT_FILE>，执行 --list 时，会将仓库发送到某个文件而非屏幕； {{#include cli.md:282}}
• --toml，使用 TOML 格式而非默认的 JSON 格式，在使用 --graph 时会被忽略；
• --vars，在图表显示中添加 vars，除非与 --graph 一起使用，否则会被忽略；
• --vault-id，要使用的保险库标识。该参数可指定多次；
• --vault-password-file, --vault-pass-file，保险库口令文件；
• --version，显示程序的版本号、配置文件位置、所配置的模组搜索路径、模组位置、可执行文件位置并退出；
• -J, --ask-vault-password, --ask-vault-pass，询问保险库口令；
• -e, --extra-vars，以 key=value 方式， 或文件名前添加了 @ 的 YAML/JSON 方式，设置一些额外变量。此参数可指定多次；
• -h, --help，打印此帮助消息并退出；
• -i, --inventory，指定仓库主机路径，或逗号分隔的主机列表。--inventory-file 选项已被弃用。该参数可指定多次；
• -l <SUBSET>, --limit <SUBSET>，将选定主机进一步限制为额外模式；
• -v, --verbose，会导致 Ansible 打印更多调试信息。添加多个 -v 会增加调试信息的冗余度，内置插件目前最多会评估到 -vvvvv。 开始时的合理级别是 -vvv，连接的调试则可能需要 -vvvv。可以多次指定此参数；
• -y, --yaml，使用 YAML 格式而非默认的 JSON 格式，在使用 --graph 时会被忽略；

参数，arguments

• group，仓库中组别的名字，与使用 --graph 时相关。

环境

可以指定以下环境变量。

• ANSIBLE_INVENTORY - 覆盖默认的 ansible 仓库文件；
• ANSIBLE_CONFIG - 覆盖默认的 ansible 配置文件。

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

文件

• /etc/ansible/hosts - 默认的仓库文件；
• /etc/ansible/ansible.cfg - 若存在，就会用到的配置文件；
• ~/.ansible.cfg - 用户配置文件，会覆盖存在的默认配置。

（End）

（End）