Ansible CMDB
文章目录
简介
Ansible-cmdb将Ansible 实际收集的输出信息 转换为包含系统配置信息的静态HTML概述页面（以及其他内容）。
它支持多种类型的输出（html，csv，sql等），并将由Ansible收集的信息与自定义数据进行扩展。对于每个主机，它还显示组，主机变量，自定义变量和机器本地事实。
安装
本实验使用环境如下：
1. 安装 ansible
2. 下载并安装 ansible-cmdb
使用 ansible-cmdb
基本
首先，为你的主机生成 Asible 输出：
接下来，再生成的 out/ 目录调用 ansible CMDB 以生成 CMDB概览界面：
默认模板是 html_fancy，它使用 jQuery。
访问效果：
完全使用
库存扫描
ansible cmdb 可以读取库存文件（hosts，默认情况下），库存目录或者动态库存，并从中提取有用的信息，例如：
- 主机所属的所有组
- 主机变量：每个主机都可以选择的键/值对，可以再剧本中使用。通过 ansible cmdb 扫描它们并将它添加到 ‘hostvars’ 部分下发县的 facts。
读取清单是使用 -i switch 来实现 cmdb 的。它需要一个参数：包含主机文件或者动态库存脚本路径的主机文件目录。可以通过将多个清单文件与逗号（不包含空格）分开来指定多个清单文件。
例如：
如果在该位置存在 host_vars 和 / 或者 group_vars 目录，也将读取它们。
“html_fancy” 模板使用四个额外的字段：
- groups：主机所属的 Ansible 组的列表
- dtap：主机是否是开发、测试、验收或者生产系统
- comment：主机的注释
- ext_id：主机的外部唯一标识符
假设我们有如下 hosts file：
模板
指定模板
ansible-cmdb 提供多个模板你可以使用 -t 或者 –template 参数选择你的模板：
‘html_fancy’ 模板是默认模板
模板可以由 NAME 引用，也可以由 .tpl 文件的相对/绝对路径引用。这允许你实现自己的模板。例如：
模板参数
某些模板支持影响它的输出的参数。蚕食使用 -p 或者 –parameter 选项指定为 ansible-cmdb。可以通过逗号分隔多个参数来指定参数，参数中必须有空格。
例如：要指定带有不呢地 Javascript 库和关闭数的 html_fancy 模板，请执行以下操作：
标准可用模板
ansible cmdb 目前提供了以下模板：
- html_fancy：一个办好所有主机的动态的现代 HTML 页面
- html_fancy_split：一个动态的现代 HTML 页面，每个细节都包含在一个单独的文件中
- txt_table：一个快速文件 table 摘要，其中包含一些最少的信息
- json：转储所有包括组、变量、自定义信息（JSON格式）的主机
- csv：CSV 模板输出主机的 CSV 文件
- markdown：Markdown 模板以 Markdown 格式生成主机信息
- 收费：SQL 模板生成一个可以加载到 SQLite 或者 MySQL 数据库的 .sql 文件
html_fancy
一个奇妙的 HTML 页面，使用 jQuery 和数据表给你一个可以搜索的和可以排序的 table 概述。
它采用可选参数：
- local_js=0|1：从本地磁盘（default=0）加载资源。如果设置，将从本地磁盘加载资源，而不是通过网络加载资源。
- collapsed=0|1：控制默认情况下是否折叠主机信息。值为1，将通过 defaultcontrols 对所有主机进行 collapse 处理。默认情况下，1的值将 collapse 所有主机信息。（default=’0’）
- host_details=0|1：渲染主机详细信。（default=1）
- skip_empty=0|1：跳过没有收集事实的主机（无法接通等）。（default=0）
html_fancy_split
这个模板与 html_fancy 模板基本相同，但是它生成带有一个 index.html 文件的 cmdb/ 目录，并为每一个主机生成一个独立的 html 文件
使用方法：
它接受与 html_fancy 模板相同的参数
sql
sql 模板生成一个 .sql 文件，可以加载到 SQLite 或者 MySQL 数据库中。
事实缓存
Ansible 可以在运行剧本时从主机缓存事实，这中配置在 Ansible 配置文件中修改如下：
通过指定 -f(–fact-cache) 选项，你可以将这些缓存的事实用作 facts cmdb 的事实目录：
请注意，–fact-cache 选项将应用于你指定的所有事实目录。这意味着不能混合事实缓存事实目录的普通 setup 事实目录。另外，如果希望手动扩展（查看 Extending 章节），必须省略 ansible_facts 键并将项目放在 JSON 的 root 中。
列
一些模板，如 txt_table 和 html_fancy，支持列。如果支持列，则可以使用 –columns/-c 命令行选项指定要显示的列。
–columns 采用一个逗号分隔列的列表。列必须由它们的 id 字段指定。有关模板支持那些 id 字段的信息，请在模板中查看。通常是列标题，但在 lowercase 中，也有用下划线替换的空格。
例如：
致谢
本文标题:Ansible CMDB
文章作者:侯海云
发布时间:2018-06-24, 08:44:05
最后更新:2018-06-25, 02:53:27
许可协议: "署名-非商用-相同方式共享 4.0" 转载请保留原文链接及作者。