Ansible-cmdb项目安装指南：从基础环境到多平台部署

项目概述

Ansible-cmdb是一个基于Ansible的配置管理数据库工具，它能够将Ansible收集的主机信息（facts）转换为可视化的HTML页面或其他格式的报告。本文将详细介绍如何在不同操作系统环境中安装和配置ansible-cmdb。

系统要求

基础环境需求

ansible-cmdb需要Python 2.7或3.0及以上版本的支持。虽然理论上它可以在任何能运行Python的系统上工作，包括：

• 各类Linux发行版（Debian、Ubuntu、CentOS等）
• BSD系统
• Windows系统
• Solaris系统
• MacOS系统

但在实际开发中，项目主要在Ubuntu 16.04上进行开发，并在Debian、Ubuntu和CentOS的最新稳定版本上进行测试验证。

安装方法详解

1. 使用Pip安装（推荐）

Pip是Python的包管理工具，也是安装ansible-cmdb最简便的方式。

安装步骤：

1. 首先确保系统已安装pip工具。如果尚未安装，需要根据您的Linux发行版先安装pip。

2. 执行以下命令安装ansible-cmdb：

   sudo pip install ansible-cmdb
   

3. 如需升级到最新版本：

   sudo pip install --upgrade ansible-cmdb
   

优势：pip安装方式简单快捷，能自动处理依赖关系，且便于后续升级。

2. 使用系统软件包安装

对于Debian/Ubuntu系统用户，可以使用.deb包进行安装：

1. 下载对应版本的.deb安装包
2. 执行安装命令：

   sudo dpkg -i ansible-cmdb*.deb
   

注意：目前仅维护了Debian/Ubuntu的软件包，其他发行版用户建议使用pip方式安装。

3. MacOS系统安装

对于Mac用户，可以通过Homebrew工具安装：

brew install ansible-cmdb

这种方式会自动处理所有依赖关系，是最简便的MacOS安装方案。

4. 源码编译安装

对于其他系统或需要自定义安装的用户，可以采用源码编译方式：

1. 解压下载的源码包：

   tar -vxzf ansible-cmdb*.tar.gz
   

2. 进入解压目录并安装：

   cd ansible-cmdb*
   sudo make install
   

5. 从Git仓库安装（开发者适用）

如需使用最新开发版本，可以从Git仓库直接安装：

git clone 项目仓库地址
cd ansible-cmdb
sudo bash -c ". build.sla && install"

注意：此方式适合开发人员或需要最新功能的用户，但稳定性可能不如正式发布版本。

安装后验证

安装完成后，可以通过以下命令验证是否安装成功：

ansible-cmdb --version

如果正确显示版本号，说明安装成功。

不同安装方式的适用场景

1. 普通用户：推荐使用pip安装，简单方便且易于维护
2. Debian/Ubuntu用户：可以使用系统软件包安装，与系统包管理集成更好
3. Mac用户：使用Homebrew安装最为便捷
4. 特殊环境用户：源码安装提供了最大的灵活性
5. 开发测试人员：Git仓库安装可以获取最新特性

常见问题解决

1. Python版本问题：确保系统安装的Python版本符合要求（2.7+或3.0+）
2. 权限问题：安装时需要使用sudo获取管理员权限
3. 依赖缺失：pip安装会自动解决依赖，其他方式可能需要手动安装依赖包

通过本文介绍的多种安装方式，您可以根据实际环境选择最适合的方法来部署ansible-cmdb工具，为后续的Ansible主机信息可视化工作做好准备。