Ansible CMDB

时间  2019-12-08 标签 ansible cmdb
Ansible CMDB
文章目录
简介
Ansible-cmdb将Ansible 实际收集的输出信息 转换为包含系统配置信息的静态HTML概述页面（以及其余内容）。
它支持多种类型的输出（html，csv，sql等），并将由Ansible收集的信息与自定义数据进行扩展。对于每一个主机，它还显示组，主机变量，自定义变量和机器本地事实。
安装
本实验使用环境以下：
IP
系统版本
软件版本
功能
192.168.8.12/24
CentOS Linux release 7.3.1611 (Core)
ansible 2.4.2.0 ansible-cmdb.py v1.27
ansible-cmdb
192.168.8.14/24
CentOS Linux release 7.3.1611 (Core)
 
应用服务
1. 安装 ansible
1
yum install -y ansible
2. 下载并安装 ansible-cmdb
1
2
3
wget https://github.com/fboender/ansible-cmdb/releases/download/1.27/ansible-cmdb-1.27-2.noarch.rpm
 
yum install -y ./ansible-cmdb-1.27-2.noarch.rpm
使用 ansible-cmdb
基本
首先，为你的主机生成 Asible 输出：
1
2
3
mkdir out
 
ansible -m setup --tree out/ all
接下来，再生成的 out/ 目录调用 ansible CMDB 以生成 CMDB概览界面：
1
ansible-cmdb out/ > overview.html
默认模板是 html_fancy，它使用 jQuery。
访问效果：
彻底使用
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Usage: ansible-cmdb.py [option] <dir> > output.html
 
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-t TEMPLATE, --template=TEMPLATE
Template to use. Default is 'html_fancy'
-i INVENTORY, --inventory=INVENTORY
Inventory to read extra info from
-f, --fact-cache <dir> contains fact-cache files
-p PARAMS, --params=PARAMS
Params to send to template
-d, --debug Show debug output
-q, --quiet Don't report warnings
-c COLUMNS, --columns=COLUMNS
Show only given columns
--exclude-cols=EXCLUDE_COLUMNS
Exclude cols from output
库存扫描
ansible cmdb 能够读取库存文件（hosts，默认状况下），库存目录或者动态库存，并从中提取有用的信息，例如：
  • 主机所属的全部组
  • 主机变量：每一个主机均可以选择的键/值对，能够再剧本中使用。经过 ansible cmdb 扫描它们并将它添加到 ‘hostvars’ 部分下发县的 facts。
读取清单是使用 -i switch 来实现 cmdb 的。它须要一个参数：包含主机文件或者动态库存脚本路径的主机文件目录。能够经过将多个清单文件与逗号（不包含空格）分开来指定多个清单文件。
例如：
1
ansible-cmdb -i ./hosts out/ > overview.html
若是在该位置存在 host_vars 和 / 或者 group_vars 目录，也将读取它们。
“html_fancy” 模板使用四个额外的字段：
  • groups：主机所属的 Ansible 组的列表
  • dtap：主机是不是开发、测试、验收或者生产系统
  • comment：主机的注释
  • ext_id：主机的外部惟一标识符
假设咱们有以下 hosts file：
1
2
3
[cmdb]
192.168.8.12 dtap=test comment="New database server"
192.168.8.14 dtap=dev comment="Old database server"
模板
指定模板
ansible-cmdb 提供多个模板你可使用 -t 或者 –template 参数选择你的模板：
1
ansible-cmdb -t html_fancy_split out/ overview.html
‘html_fancy’ 模板是默认模板
模板能够由 NAME 引用，也能够由 .tpl 文件的相对/绝对路径引用。这容许你实现本身的模板。例如：
1
ansible-cmdb -t/home/fboender/my_template out/> my_template.html
模板参数
某些模板支持影响它的输出的参数。蚕食使用 -p 或者 –parameter 选项指定为 ansible-cmdb。能够经过逗号分隔多个参数来指定参数，参数中必须有空格。
例如：要指定带有不呢地 Javascript 库和关闭数的 html_fancy 模板，请执行如下操做：
1
ansible-cmdb -t html_fancy -p local_js=1,collapsed=1 out> overview.html
标准可用模板
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 文件
使用方法：
1
ansible-cmdb -t html_fancy_split out/
它接受与 html_fancy 模板相同的参数
sql
sql 模板生成一个 .sql 文件，能够加载到 SQLite 或者 MySQL 数据库中。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
ansible-cmdb -t sql out/ > cmdb.sql
 
[root@centos7 ~]# head cmdb.sql
DROP TABLE IF EXISTS hosts;
CREATE TABLE hosts (
name VARCHAR(255),
fqdn VARCHAR(255),
main_ip VARCHAR(15),
os_name VARCHAR(80),
os_version VARCHAR(40),
system VARCHAR(40),
kernel VARCHAR(40),
arch_hardware VARCHAR(12),
 
echo"CREATE DATABASE ansiblecmdb" | mysql
 
mysql ansiblecmdb <cmdb.sql
事实缓存
Ansible 能够在运行剧本时从主机缓存事实，这中配置在 Ansible 配置文件中修改以下：
1
2
3
[defaults]
fact_caching=jsonfile
fact_caching_connection =/path/to/facts/dir
经过指定 -f(–fact-cache) 选项，你能够将这些缓存的事实用做 facts cmdb 的事实目录：
1
ansible-cmdb -f/path/to/facts/dir> overview.html
请注意，–fact-cache 选项将应用于你指定的全部事实目录。这意味着不能混合事实缓存事实目录的普通 setup 事实目录。另外，若是但愿手动扩展（查看 Extending 章节），必须省略 ansible_facts 键并将项目放在 JSON 的 root 中。
列
一些模板，如 txt_table 和 html_fancy，支持列。若是支持列，则可使用 –columns/-c 命令行选项指定要显示的列。
–columns 采用一个逗号分隔列的列表。列必须由它们的 id 字段指定。有关模板支持那些 id 字段的信息，请在模板中查看。一般是列标题，但在 lowercase 中，也有用下划线替换的空格。
例如：
1
2
3
4
5
[root@centos7 ~]# ansible-cmdb -t txt_table --columns name,os,ip,mem,cpus out/
Name OS IP Mem CPUs
------------ --------------- --------------- --- ----
192.168.8.14 CentOS 7.3.1611 192.168.139.151 2g 2
192.168.8.12 CentOS 7.3.1611 192.168.139.129 2g 2
致谢
本文标题: Ansible CMDB
文章做者: 侯海云
发布时间:2018-06-24, 08:44:05
最后更新:2018-06-25, 02:53:27
许可协议: "署名-非商用-相同方式共享 4.0" 转载请保留原文连接及做者。
联系我们 沪ICP备13005482号-10