安装和使用Ansible-CMDB的详细指南

目录结构及介绍

在克隆或下载Ansible-CMDB项目之后，你会看到以下主要目录：

• src: 这个目录包含了Ansible-CMDB的主要脚本和其他源代码。
  • ansible-cmdb.py: 主要执行文件，用于处理并转换Ansible收集的事实数据。
• docs: 包含了项目的文档和说明。

此外，还有其他辅助目录如测试文件等，但以上两个是最关键的部分。

启动文件介绍

ansible-cmdb.py

ansible-cmdb.py是整个项目的入口点。通过调用这个脚本并指定参数，你可以将Ansible收集到的主机事实转化为静态HTML页面或其他格式的概览报告。

基本语法如下:

ansible-cmdb [options] <facts_directory> > output_file.html

其中，<facts_directory>是你之前使用Ansible收集主机信息时保存数据的目录。output_file.html是最终生成的HTML报告文件名。

可用选项包括但不限于：

• -t, --template: 指定模板类型，默认为html_fancy。
• -i, --inventory: 指向额外信息的库存列表路径。
• -f, --fact-cache: 路径指向包含缓存事实的目录。

配置文件介绍

实际上，Ansible-CMDB并不依赖于特定的配置文件来运行。然而，为了配合其工作流，你需要关注几个配置项，主要是关于如何使用Ansible收集主机信息和如何指定Ansible-CMDB的相关选项。

当你使用Ansible从主机上收集信息时，可以设置fact_caching和fact_caching_connection选项。例如，在你的ansible.cfg中加入以下内容:

[defaults]
fact_caching = jsonfile
fact_caching_connection = /path/to/cache/directory/

这样，每次Ansible运行playbook后都会在指定目录下缓存事实数据。

然后，在使用Ansible-CMDB生成CMDB报告时，通过-f或--fact-cache指定上述缓存事实目录即可利用这些已收集的信息。

综上所述，虽然Ansible-CMDB本身可能不需要额外配置文件，但在集成环境中，正确地设置Ansible相关配置至关重要以确保数据的顺利收集与使用。