Ansible CMDB

Ansible CMDB

CMDBAnsible-CMDB

• CMDB

文章目录

1. 1. 简介
2. 2. 安装

1. 2.1. 1. 安装 ansible
2. 2.2. 2. 下载并安装 ansible-cmdb

1. 3. 使用 ansible-cmdb

1. 3.1. 基本
2. 3.2. 完全使用
3. 3.3. 库存扫描
4. 3.4. 模板

1. 3.4.1. 指定模板
2. 3.4.2. 模板参数
3. 3.4.3. 标准可用模板

1. 3.4.3.1. html_fancy
2. 3.4.3.2. html_fancy_split
3. 3.4.3.3. sql
4. 3.4.3.4. 事实缓存
5. 3.4.3.5. 列

1. 4. 致谢

简介

github项目地址：https://github.com/fboender/ansible-cmdb

官方文档：http://ansible-cmdb.readthedocs.io/en/latest/

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

致谢

官方文档：http://ansible-cmdb.readthedocs.io/en/latest/

帮酷：ansible-cmdb

本文标题:Ansible CMDB

文章作者:侯海云

发布时间:2018-06-24, 08:44:05

最后更新:2018-06-25, 02:53:27

原始链接:https://www.ihaiyun.cc/2018/06/24/Ansible-CMDB/

许可协议: "署名-非商用-相同方式共享 4.0" 转载请保留原文链接及作者。

Linux 运维技能树

GlusterFS 部署