搭建一个超好用的 cmdb 系统

时间  2019-11-14
标签 搭建 一个 好用 cmdb 系统 繁體版
原文   原文链接

10 分钟为你搭建一个超好用的 cmdb 系统

CMDB 是什么，做为 IT 工程师的你想必已经据说过了，或者已经烂熟了，容我再介绍一下，以防有读者还不知道。CMDB 的全称是 Configuration Management Data Base，翻译下就是配置管理数据库，它存储与管理企业 IT 架构中设备的各类配置信息，它支撑服务流程的运转、发挥着配置信息的价值。在今天，不管是自动化运维、标准化运维、DevOps、甚至是时髦的智能运维，其实都离开不 CMDB，能够说 CMDB 是运维体系的基石，有了配置信息数据库，后面各类标准、流程均可以创建在 CMDB 基础之上，从而实现真正的标准化、自动化、智能化运维，节约运维成本的同时，也下降运维流程混乱带来的操做风险。javascript

今天分享一个开源的 cmdb 系统的搭建过程，经过这一系列搭建的过程你不只能够得到一个支持全文检索、自带 restful api 的 cmdb 系统，并且还能够学到很多时髦的技术。css

后端技术：html

  • Python3
  • Django
  • Django REST framework
  • Elasticsearch
  • uwsgi
  • Nginx
  • Docker

前端技术：前端

  • Vue
  • Element-ui
  • Vue-Router
  • Vuex
  • Axios

先看一下这个 CMDB 系统的容颜，设计上参考了饿了么内部的 cmdb 系统:vue

 
open-cmdb

基本功能有：热添加删除表、自定义字段类型，方便增删改查的前端界面，强大的搜索查找能力（后端使用elasticsearch存储数据 ） 能够配合 kibana 使用，查看数据的删除修改记录、历史版本等，还带有表级权限管理，开放全部 API。java

github 仓库
后端：https://github.com/open-cmdb/cmdb
前端：https://github.com/open-cmdb/cmdb-webnode

 

 

下面介绍两种方法搭建此开源 cmdb 系统 ，一个是使用 Docker，适用于 linux 操做系统 ，另外一个是不使用 Docker，适用于 windows 和 linux 。最后介绍下 vue 环境的搭建。python

1. 使用 Docker

若是你熟悉容器技术，推荐使用此方法，不过最新的 Docker 目前还不支持大多数的 windows 版本，所以若是使用容器，请使用 ubuntu 或 centos 等 Linux 操做系统。首先要安装 Docker，安装 Docker 的方法请参考我以前的一篇文章docker容器从入门到痴迷，或直接网上搜索对应操做系统的安装方法对着作便可，没有难度。mysql

环境准备：

一、一台能够访问互联网的 linux 服务器 内存最好 >= 4G ，并建立一个具备 sudo 权限的普通用户，注意要有 yum 命令，若是没有能够安装下。
二、一个 cmdb 专用的邮箱，用于发送密码和验证码，若是使用16三、qq等第三方邮箱请在设置里面打开POP3/SMTP/IMAP服务并生成受权码。若是不使用注册和忘记密码功能，也能够不许备linux

一键安装

将下述代码保存到 install_cmdb.py 并执行 sudo python3 install_cmdb.py 便可一键安装。

# -*- coding: utf-8 -*-
import os
import subprocess
import argparse
import time

def base(cmd):
    if subprocess.call(cmd, shell=True):
        raise Exception("{} 执行失败".format(cmd))

def install_docker():
    base("sudo yum install -y yum-utils device-mapper-persistent-data lvm2")
    base("sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo")
    base("sudo yum makecache fast")
    base("sudo yum -y install docker-ce")
    if(not os.path.exists("/etc/docker")):
        base("mkdir -p /etc/docker")
    with open("/etc/docker/daemon.json", "w") as f:
        f.write('{\n "registry-mirrors": ["https://9f4w4icn.mirror.aliyuncs.com"] \n}')
    base("sudo systemctl daemon-reload")
    base("sudo systemctl start docker")

def create_dir():
    if (not os.path.exists("/var/cmdb/db")):
        base("sudo mkdir -p /var/cmdb/db")
    if (not os.path.exists("/var/cmdb/es")):
        base("sudo mkdir -p /var/cmdb/es")

def run_db_container():
    base("sudo docker run --name cmdb-db -d -e MYSQL_ROOT_PASSWORD=cmdbcmdb -v /var/cmdb/db:/var/lib/mysql mysql:5.7.21")

def run_es_container():
    base("sudo docker run --name cmdb-es -d -v /var/cmdb/es:/usr/share/elasticsearch/data elasticsearch:5.6.8")

def init_db():
    base("sudo docker run -it --rm --link cmdb-db -e ENV=PRO -e DB_HOST=cmdb-db -e DB_PORT=3306 -e DB_USERNAME=root -e DB_PASSWORD=cmdbcmdb -e DB_NAME=cmdb mingmingtang/cmdb init-db")

def run_cmdb_container(site_url, email_host, email_port, email_username, email_password):
    base("sudo docker run -d --name cmdb --link cmdb-db --link cmdb-es -p 80:80 -e ENV=PRO -e SITE_URL={} -e DB_HOST=cmdb-db -e DB_PORT=3306 -e DB_USERNAME=root -e DB_PASSWORD=cmdbcmdb -e DB_NAME=cmdb -e ELASTICSEARCH_HOSTS=cmdb-es -e EMAIL_HOST={} -e EMAIL_PORT={} -e EMAIL_USERNAME={} -e EMAIL_PASSWORD={} mingmingtang/cmdb start".format(site_url, email_host, email_port, email_username, email_password))

def input_para(help):
    value = ""
    while(not value):
        value = raw_input(help)
    return value

if __name__ == '__main__':
    if(os.geteuid() != 0):
        raise("请以root权限运行")
    site_url = input_para("请输入网站域名或IP（http://cmdb.xxx.com）：")
    email_host = input_para("网站邮箱服务器（smtp.163.com）：")
    email_port = input_para("邮箱服务器端口（25）：")
    email_username = input_para("邮箱用户名（cmdb@163.com）：")
    email_password = input_para("邮箱密码|独立受权码（P@ssw0rd）：")

    print("开始安装docker")
    install_docker()
    print("开始建立目录")
    create_dir()
    print("开始运行mysql容器")
    run_db_container()
    print("开始运行elasticsearch容器")
    run_es_container()
    print("等待数据库启动完成(10s)")
    time.sleep(10)
    print("开始初始化数据库")
    init_db()
    print("开始运行cmdb")
    run_cmdb_container(site_url, email_host, email_port, email_username, email_password)
    print("完成！")

输入网站地址和邮箱信息开始安装，以下图所示：

 

 

 

若是一切顺利一下子后您将看到安装完成，若是失败了可能就要调整一些系统参数并删除已运行的容器从新执行了，不过根据个人安装经验，基本不会出错，容器仍是很是方便部署的。

 

 

执行下述命令

sudo docker ps

将看到三个正在运行的容器，分别是 cmdb，cmdb-es，cmdb-db，以下图所示

 

 

 

其中 cmdb 运行着 web 服务器（nginx，uwsgi，django，vue.js），cmdb-es 运行着 Elasticsearch 全文检索引擎，也存储你的配置信息，cmdb-db 运行着 mysql，保存着 web 服务器的元数据（django 的知识库）。

在浏览器中输入"localhost" 尽情的开始享用吧。

2. 不使用 Docker

下面的内容主要是分享给 windows 用户的，linux 用户也能够对比操做。使用 Docker 虽然方便部署，但它屏蔽了一些细节，不利于二次开发和问题排查。在不使用 Docker 的状况下，咱们不只要装软件，还要安装依赖，配置环境，虽然麻烦，可是能够学到更多知识，出了问题也能够很快定位，更能加深对项目框架的理解，这点付出也是值得的。

（1）安装 mysql，建立数据库，配置权限

若是你的本机已经安装 mysql，则不心再安装，直接建立数据库，配置权限便可。

  1. 安装 mysql

从网官下载最新的 MySQL Community Server [https://dev.mysql.com/downloads/mysql/]
好比我下载的是 mysql-8.0.12-winx64.zip ，这是个免安装版本，直接解压到你想安装的目录内，并在里面新建 my.ini 文件，位置以下图所示：

 
image.png

 

my.ini 的文件内容以下所示：

[mysqld]
# 设置3306端口
port=3306
# 设置mysql的安装目录
basedir=D:\program\mysql\mysql-8.0.12-winx64
# 设置mysql数据库的数据的存放目录
datadir=D:\program\mysql\mysql-8.0.12-winx64\data
# 容许最大链接数
max_connections=200
# 容许链接失败的次数。这是为了防止有人从该主机试图攻击数据库系统
max_connect_errors=10
# 服务端使用的字符集默认为UTF8
character-set-server=utf8
# 建立新表时将使用的默认存储引擎
default-storage-engine=INNODB
# 默认使用“mysql_native_password”插件认证
default_authentication_plugin=mysql_native_password
[mysql]
# 设置mysql客户端默认字符集
default-character-set=utf8
[client]
# 设置mysql客户端链接服务端时默认使用的端口
port=3306
default-character-set=utf8

请注意下面的路径设置要正确，

# 设置mysql的安装目录
basedir=D:\program\mysql\mysql-8.0.12-winx64
# 设置mysql数据库的数据的存放目录
datadir=D:\program\mysql\mysql-8.0.12-winx64\data

若是你想从任意一个命令窗口启动 mysql，请把 D:\program\mysql\mysql-8.0.12-winx64\bin 加入环境变量。*

这个配置文件 my.ini 必定要保存为 gbk 格式，不然会报错，我费了好长时间才发现这个问题。

接下来在MySQL安装目录的 bin 目录（D:\program\mysql\mysql-8.0.12-winx64\bin）下以管理员权限执行命令：mysqld --initialize --console；执行完成后，在输出信息中会打印 root 用户的初始密码，好比

[Server] A temporary password is generated for root@localhost: rIafvf5f5G,a

表示临时密码为 rIafvf5f5G,a ，用于 root 用户第一次登录，以后再修改 root 用户的密码。

这一步执行后完成初始化操做，并在安装目录下生成 data 文件夹，用于存放数据。执行

mysqld --install

完成 mysql 服务的安装，安装完成以后，就能够经过命令 net start mysql 即启动 mysql 的服务了。经过命令 net stop mysql 中止服务。经过命令 sc delete mysql /mysqld -remove 卸载 mysql 服务。接下来就能够建库、用户、分配权限了。

修改 root 密码：
在 mysql 安装目录的 bin 目录下执行命令：mysql -u root -p 而后输入上面的密码，进入 mysql 环境，执行

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '新密码';

注意命令尾的“；”必定要有，这是 mysql 的语法，
管理员 root 的 host 是 localhost，表明仅限 localhost 登陆访问。若是要容许开放其余 ip 登陆，则须要添加新的 host。若是要容许全部 ip 访问，能够直接修改为“%”；

ALTER USER 'root'@'%' IDENTIFIED  BY '远程登录密码';
  1. 建立数据库，并分配用户权限

使用 root 用户登录 mysql 并执行

mysql>create database cmdb;

便可建立数据库 cmdb，可是这个数据库只能有 root 访问，若是要使用其余用户访问，则先新建用户，例如让 aaron 用户能够彻底控制 cmdb

mysql>CREATE USER 'aaron'@'%' IDENTIFIED  BY 'aaron';
Query OK, 0 rows affected (0.48 sec)
mysql> grant all on cmdb.* to  'aaron'@'%';
Query OK, 0 rows affected (0.23 sec)

至此 mysql 已安装配置完毕。

（2）安装 Elasticsearch

全文搜索属于最多见的需求，开源的 Elasticsearch （如下简称 Elastic）是目前全文搜索引擎的首选。
它能够快速地储存、搜索和分析海量数据。维基百科、Stack Overflow、Github 都采用它。安装 Elasticsearch 很是简单，官网下载解压，进入其 bin 目录运行以下图所示的 bat 文件便可 ：

 

 

 

它是一个 java 编写的程序，若是要修改占用内存的大小，请找到配置文件，例如修改成 -Xmx10g -Xms10g 表示初始化 10 个 G 的内存空间给 Elasticsearch ，Elasticsearch 最大使用的内存也是 10G，通常状况下，设置为内存的一半大小，但最好不超过 32 G，根据需求，生产环境适合调大，测试环境适当调小。

若是运行失败，说明本机没有安装 java，或者没有正确地配置 java 环境变量，这些操做也很是简单，网上处处都是，不在此详述。

（3）运行 cmdb 后端 api 服务、前端 ui

首先准备 Python3 的环境，这个也很简单，直接官网下载，运行便可，记得把 Python.exe 所在的路径添加到 Path 变量中。

若是你的电脑里有多个项目，为防止项目的依赖包版本冲突，建议使用 virtualenv 来为每一个项目前建立一个虚拟的 Python 环境，将各自的依赖包装在本身的虚拟环境里。

（1）部署后端

执行如下命令，注意命令后面的注释。

git clone https://github.com/open-cmdb/cmdb.git
cd cmdb
#如建立了虚拟环境，请先激活
pip install  -r requirements.txt #若是这一步有包安装失败，提示却少 microsoft visual c++ 14.0 的话，请在网站 https://www.lfd.uci.edu/~gohlke/pythonlibs/ 上查找相应的whl文件，直接 pip install .whl文件便可。

接下来修改3个文件

  1. 修改 apps/mgmt/views.py 文件，注释掉 “ from . import initialize ”这一行。
  2. 修改 manage.py
    将 APP_NAME = BASE_DIR.rsplit("/", 1)[-1] 修改成
    APP_NAME = BASE_DIR.rsplit("\", 1)[-1] ，这是由于windows的路径\ 在python 里会变成 \。
  3. 修改 cmdb/settings.py 文件，修改mysql 数据库的配置信息以下所示：
DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': "cmdb",
    "HOST": "127.0.0.1",
    "PORT": 3306,
    "USER": "aaron",
    "PASSWORD": "aaron"
  }
}

接着在命令窗口继续执行如下操做：请关注注释内容。

python manage.py makemigrations 
python manage.py migrate
python manage.py cmdb_create_superuser #这一步建立一能够登录的管理员用户
#修改 apps/mgmt/views.py 文件，取消注释“ from . import initialize ”
python manage.py runserver #这一步启动后端的 api 服务

此时一个后端的服务已经启动了，在浏览器中打开 “127.0.0.1:8000”就能够看到 api 的接口了。

 

 

（2）使用 nginx 部署前端并链接后端 api 服务

在命令容器执行如下命令：

git clone https://github.com/open-cmdb/cmdb-web.git

获取前端的源代码，而后下载下载 ngnix 压缩包，并解压至安装目录，修改配置文件 nginx.conf，添加以下 server 配置：

server {
        listen 8080;
        server_name localhost;
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
        root html;
        }
        
        root E:\GitHub\cmdb-web\dist;
        index index.html;
        location / {
        try_files $uri $uri/ @router;
        index index.html;
        }
        
        location @router {
        rewrite ^.*$ /index.html last;
        }

        location ~ /api{
        proxy_pass http://127.0.0.1:8000;
        }
    }

其中以配置

location ~ /api{
        proxy_pass http://127.0.0.1:8000;
        }

让前台发过来中以 api 开头的 url 请求都转发至 http://127.0.0.1:8000 进行解析，即第一步部署的 django 项目，这样就链接了前端和后端。而后咱们在 nginx.exe 所在的目录下启动 nginx 服务。

 

 

接下来在浏览器中输入 127.0.0.1:8080 便可正常访问本文开始处的 cmdb 系统，您能够尝试下强大的搜索功能及增删改功能。

 

 

 

点击右上方【API 文档】 能够访问 cmdb 的接口文档，很是方便。

 

 

至此系统搭建完毕。若是要用于生产环境，请使用 linux 操做系统，并使用 uwsgi 来驱动 django 项目。

3. Vue 环境搭建

我想你不会仅仅知足于将别人的项目下载下来能运行就好了，你确定想对其进行改造来知足本身的需求。所以你可能会须要修改前端或后端，后端的修改其实上面部署的已经能够了，你能够直接阅读 django 项目的源代码进行修改调试。若是要修改前端代码进行调试，你就须要搭建 Vue 环境。

你可能会问了，Vue 是个啥？Vue 是一个 javascript 框架，若是说 jQuery，你可能就知道了，使用方法是相似的，在 html 上引入一行 javascript 的文件，就可使用框架的特性了。 Vue 是一套用于构建用户界面的渐进式框架。与其它大型框架不一样的是，Vue 被设计为能够自底向上逐层应用。Vue 的核心库只关注视图层，不只易于上手，还便于与第三方库或既有项目整合。另外一方面，当与现代化的工具链以及各类支持类库结合使用时，Vue 也彻底可以为复杂的单页应用提供驱动。
学习 vue 须要有 html、css、javascript 基础
新手能够经过 html 上引入 Vue 的 js 文件来使用 vue，以下所示：

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Vue 测试实例 </title>
    <script src="https://cdn.staticfile.org/vue/2.4.2/vue.min.js"></script>
</head>
<body>
<div id="app">
    <p>{{ message }}</p>
</div>

<script> new Vue({ el: '#app', data: { message: 'Hello Vue.js!' } }) </script>
</body>
</html>

可是在较复杂的项目中，仍是要使用工具来帮助咱们管理项目的层级及文件之间的依赖关系，这就须要使用 vue 的命令行工具 vue-cli ，vue-cli 须要 npm 工具来安装，npm 工具集成在 node.js 中，所以须要安装 node.js。
安装 node.js 很是简单，直接官网下载解压便可使用：

 

 

 

将 npm 所在路径添加到环境变量 Path 中，你就能够在任意的命令窗口使用 npm 命令了。
一、安装 vue-cli

先安装淘宝镜像，你们都知道国内直接使用 npm 的官方镜像是很是慢的，这里推荐使用淘宝 NPM 镜像。

npm install -g cnpm --registry=https://registry.npm.taobao.org

执行结果以下：

 

 

这样就可使用 cnpm 命令来安装模块了：使用 cnpm 安装 vue-cli

 

 

而后咱们就可使用 vue init webpack my-project 命令来来建一个项目 my-project，这里须要进行一些配置，能够直接回车来使用默认配置，以下图所示：

 

 

 

等待其初始化完毕后，进入项目，执行如下命令：

C:\Users\xx>cd my-project
C:\Users\xx\my-project>cnpm install
C:\Users\xx\my-project>cnpm run dev

此时会自动 build ，运行成功后会打印以下信息表示服务已正常启动：

 

 
3compliesucce.png

此时打开浏览器，输入 http://localhost:8081，便可看到 my-project 在浏览器中的展现。

 

若是要把这个页面部署在 nginx 服务器上，你还须要 build 命令来生成静态资源，以下图所示：

 

 
image.png

 

此时会在 my-project 下生成 dist 目录，至关于咱们写程序编译生成的目标文件。my-project 下的内容及说明以下图所示：

 

 
Snipaste_2018-10-26_06-47-24.png


此时已经能够开启你的 vue 之旅了。

当学会了 Vue 以后，你就能够修改本项目的前端源代码来知足本身的需求了，进入 src 目录，查看并修改源代码以后，进入 cmdb_web 的项目目录，执行

# 安装依赖，若是慢可换成 cnpm
npm install
# 启动服务，默认端口为8080，若是被占用会自动选取一个未被占用的端口
npm run dev
# 创建静态文件，能够放在 nginx 上运行
npm run build
# 查看创建报告
npm run build --report

便可将生成的 dist 部署到 web 服务器了。

也许你会认为这样实在太麻烦了，不如本身动手写一个 cmdb 系统，若是时间容许固然能够本身写，可是我不推荐这样作，上述这些操做其实都很简单，在熟悉以后就像打字同样容易，并且本身写一个一样效果的系统要直接拿优秀的代码来改造要慢得多，大神例外。做为通常程序员咱们应该避免重复造轮子，学会站在巨人的肩膀上。所以开发一个项目最好是找 github 上相似的优秀开源项目，借鉴其优良设计，甚至能够直接拿来作二次开发，这才是最高效的作法。

10 分钟为你搭建一个超好用的 cmdb 系统

52018.10.28 06:52:31 字数 3823 阅读 11443

CMDB 是什么，做为 IT 工程师的你想必已经据说过了，或者已经烂熟了，容我再介绍一下，以防有读者还不知道。CMDB 的全称是 Configuration Management Data Base，翻译下就是配置管理数据库，它存储与管理企业 IT 架构中设备的各类配置信息，它支撑服务流程的运转、发挥着配置信息的价值。在今天，不管是自动化运维、标准化运维、DevOps、甚至是时髦的智能运维，其实都离开不 CMDB，能够说 CMDB 是运维体系的基石，有了配置信息数据库，后面各类标准、流程均可以创建在 CMDB 基础之上，从而实现真正的标准化、自动化、智能化运维，节约运维成本的同时，也下降运维流程混乱带来的操做风险。

今天分享一个开源的 cmdb 系统的搭建过程，经过这一系列搭建的过程你不只能够得到一个支持全文检索、自带 restful api 的 cmdb 系统，并且还能够学到很多时髦的技术。

后端技术：

  • Python3
  • Django
  • Django REST framework
  • Elasticsearch
  • uwsgi
  • Nginx
  • Docker

前端技术：

  • Vue
  • Element-ui
  • Vue-Router
  • Vuex
  • Axios

先看一下这个 CMDB 系统的容颜，设计上参考了饿了么内部的 cmdb 系统:

 
open-cmdb

基本功能有：热添加删除表、自定义字段类型，方便增删改查的前端界面，强大的搜索查找能力（后端使用elasticsearch存储数据 ） 能够配合 kibana 使用，查看数据的删除修改记录、历史版本等，还带有表级权限管理，开放全部 API。

github 仓库
后端：https://github.com/open-cmdb/cmdb
前端：https://github.com/open-cmdb/cmdb-web

 

 

下面介绍两种方法搭建此开源 cmdb 系统 ，一个是使用 Docker，适用于 linux 操做系统 ，另外一个是不使用 Docker，适用于 windows 和 linux 。最后介绍下 vue 环境的搭建。

1. 使用 Docker

若是你熟悉容器技术，推荐使用此方法，不过最新的 Docker 目前还不支持大多数的 windows 版本，所以若是使用容器，请使用 ubuntu 或 centos 等 Linux 操做系统。首先要安装 Docker，安装 Docker 的方法请参考我以前的一篇文章docker容器从入门到痴迷，或直接网上搜索对应操做系统的安装方法对着作便可，没有难度。

环境准备：

一、一台能够访问互联网的 linux 服务器 内存最好 >= 4G ，并建立一个具备 sudo 权限的普通用户，注意要有 yum 命令，若是没有能够安装下。
二、一个 cmdb 专用的邮箱，用于发送密码和验证码，若是使用16三、qq等第三方邮箱请在设置里面打开POP3/SMTP/IMAP服务并生成受权码。若是不使用注册和忘记密码功能，也能够不许备

一键安装

将下述代码保存到 install_cmdb.py 并执行 sudo python3 install_cmdb.py 便可一键安装。

# -*- coding: utf-8 -*-
import os
import subprocess
import argparse
import time

def base(cmd):
    if subprocess.call(cmd, shell=True):
        raise Exception("{} 执行失败".format(cmd))

def install_docker():
    base("sudo yum install -y yum-utils device-mapper-persistent-data lvm2")
    base("sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo")
    base("sudo yum makecache fast")
    base("sudo yum -y install docker-ce")
    if(not os.path.exists("/etc/docker")):
        base("mkdir -p /etc/docker")
    with open("/etc/docker/daemon.json", "w") as f:
        f.write('{\n "registry-mirrors": ["https://9f4w4icn.mirror.aliyuncs.com"] \n}')
    base("sudo systemctl daemon-reload")
    base("sudo systemctl start docker")

def create_dir():
    if (not os.path.exists("/var/cmdb/db")):
        base("sudo mkdir -p /var/cmdb/db")
    if (not os.path.exists("/var/cmdb/es")):
        base("sudo mkdir -p /var/cmdb/es")

def run_db_container():
    base("sudo docker run --name cmdb-db -d -e MYSQL_ROOT_PASSWORD=cmdbcmdb -v /var/cmdb/db:/var/lib/mysql mysql:5.7.21")

def run_es_container():
    base("sudo docker run --name cmdb-es -d -v /var/cmdb/es:/usr/share/elasticsearch/data elasticsearch:5.6.8")

def init_db():
    base("sudo docker run -it --rm --link cmdb-db -e ENV=PRO -e DB_HOST=cmdb-db -e DB_PORT=3306 -e DB_USERNAME=root -e DB_PASSWORD=cmdbcmdb -e DB_NAME=cmdb mingmingtang/cmdb init-db")

def run_cmdb_container(site_url, email_host, email_port, email_username, email_password):
    base("sudo docker run -d --name cmdb --link cmdb-db --link cmdb-es -p 80:80 -e ENV=PRO -e SITE_URL={} -e DB_HOST=cmdb-db -e DB_PORT=3306 -e DB_USERNAME=root -e DB_PASSWORD=cmdbcmdb -e DB_NAME=cmdb -e ELASTICSEARCH_HOSTS=cmdb-es -e EMAIL_HOST={} -e EMAIL_PORT={} -e EMAIL_USERNAME={} -e EMAIL_PASSWORD={} mingmingtang/cmdb start".format(site_url, email_host, email_port, email_username, email_password))

def input_para(help):
    value = ""
    while(not value):
        value = raw_input(help)
    return value

if __name__ == '__main__':
    if(os.geteuid() != 0):
        raise("请以root权限运行")
    site_url = input_para("请输入网站域名或IP（http://cmdb.xxx.com）：")
    email_host = input_para("网站邮箱服务器（smtp.163.com）：")
    email_port = input_para("邮箱服务器端口（25）：")
    email_username = input_para("邮箱用户名（cmdb@163.com）：")
    email_password = input_para("邮箱密码|独立受权码（P@ssw0rd）：")

    print("开始安装docker")
    install_docker()
    print("开始建立目录")
    create_dir()
    print("开始运行mysql容器")
    run_db_container()
    print("开始运行elasticsearch容器")
    run_es_container()
    print("等待数据库启动完成(10s)")
    time.sleep(10)
    print("开始初始化数据库")
    init_db()
    print("开始运行cmdb")
    run_cmdb_container(site_url, email_host, email_port, email_username, email_password)
    print("完成！")

输入网站地址和邮箱信息开始安装，以下图所示：

 

 

 

若是一切顺利一下子后您将看到安装完成，若是失败了可能就要调整一些系统参数并删除已运行的容器从新执行了，不过根据个人安装经验，基本不会出错，容器仍是很是方便部署的。

 

 

执行下述命令

sudo docker ps

将看到三个正在运行的容器，分别是 cmdb，cmdb-es，cmdb-db，以下图所示

 

 

 

其中 cmdb 运行着 web 服务器（nginx，uwsgi，django，vue.js），cmdb-es 运行着 Elasticsearch 全文检索引擎，也存储你的配置信息，cmdb-db 运行着 mysql，保存着 web 服务器的元数据（django 的知识库）。

在浏览器中输入"localhost" 尽情的开始享用吧。

2. 不使用 Docker

下面的内容主要是分享给 windows 用户的，linux 用户也能够对比操做。使用 Docker 虽然方便部署，但它屏蔽了一些细节，不利于二次开发和问题排查。在不使用 Docker 的状况下，咱们不只要装软件，还要安装依赖，配置环境，虽然麻烦，可是能够学到更多知识，出了问题也能够很快定位，更能加深对项目框架的理解，这点付出也是值得的。

（1）安装 mysql，建立数据库，配置权限

若是你的本机已经安装 mysql，则不心再安装，直接建立数据库，配置权限便可。

  1. 安装 mysql

从网官下载最新的 MySQL Community Server [https://dev.mysql.com/downloads/mysql/]
好比我下载的是 mysql-8.0.12-winx64.zip ，这是个免安装版本，直接解压到你想安装的目录内，并在里面新建 my.ini 文件，位置以下图所示：

 
image.png

 

my.ini 的文件内容以下所示：

[mysqld]
# 设置3306端口
port=3306
# 设置mysql的安装目录
basedir=D:\program\mysql\mysql-8.0.12-winx64
# 设置mysql数据库的数据的存放目录
datadir=D:\program\mysql\mysql-8.0.12-winx64\data
# 容许最大链接数
max_connections=200
# 容许链接失败的次数。这是为了防止有人从该主机试图攻击数据库系统
max_connect_errors=10
# 服务端使用的字符集默认为UTF8
character-set-server=utf8
# 建立新表时将使用的默认存储引擎
default-storage-engine=INNODB
# 默认使用“mysql_native_password”插件认证
default_authentication_plugin=mysql_native_password
[mysql]
# 设置mysql客户端默认字符集
default-character-set=utf8
[client]
# 设置mysql客户端链接服务端时默认使用的端口
port=3306
default-character-set=utf8

请注意下面的路径设置要正确，

# 设置mysql的安装目录
basedir=D:\program\mysql\mysql-8.0.12-winx64
# 设置mysql数据库的数据的存放目录
datadir=D:\program\mysql\mysql-8.0.12-winx64\data

若是你想从任意一个命令窗口启动 mysql，请把 D:\program\mysql\mysql-8.0.12-winx64\bin 加入环境变量。*

这个配置文件 my.ini 必定要保存为 gbk 格式，不然会报错，我费了好长时间才发现这个问题。

接下来在MySQL安装目录的 bin 目录（D:\program\mysql\mysql-8.0.12-winx64\bin）下以管理员权限执行命令：mysqld --initialize --console；执行完成后，在输出信息中会打印 root 用户的初始密码，好比

[Server] A temporary password is generated for root@localhost: rIafvf5f5G,a

表示临时密码为 rIafvf5f5G,a ，用于 root 用户第一次登录，以后再修改 root 用户的密码。

这一步执行后完成初始化操做，并在安装目录下生成 data 文件夹，用于存放数据。执行

mysqld --install

完成 mysql 服务的安装，安装完成以后，就能够经过命令 net start mysql 即启动 mysql 的服务了。经过命令 net stop mysql 中止服务。经过命令 sc delete mysql /mysqld -remove 卸载 mysql 服务。接下来就能够建库、用户、分配权限了。

修改 root 密码：
在 mysql 安装目录的 bin 目录下执行命令：mysql -u root -p 而后输入上面的密码，进入 mysql 环境，执行

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '新密码';

注意命令尾的“；”必定要有，这是 mysql 的语法，
管理员 root 的 host 是 localhost，表明仅限 localhost 登陆访问。若是要容许开放其余 ip 登陆，则须要添加新的 host。若是要容许全部 ip 访问，能够直接修改为“%”；

ALTER USER 'root'@'%' IDENTIFIED  BY '远程登录密码';
  1. 建立数据库，并分配用户权限

使用 root 用户登录 mysql 并执行

mysql>create database cmdb;

便可建立数据库 cmdb，可是这个数据库只能有 root 访问，若是要使用其余用户访问，则先新建用户，例如让 aaron 用户能够彻底控制 cmdb

mysql>CREATE USER 'aaron'@'%' IDENTIFIED  BY 'aaron';
Query OK, 0 rows affected (0.48 sec)
mysql> grant all on cmdb.* to  'aaron'@'%';
Query OK, 0 rows affected (0.23 sec)

至此 mysql 已安装配置完毕。

（2）安装 Elasticsearch

全文搜索属于最多见的需求，开源的 Elasticsearch （如下简称 Elastic）是目前全文搜索引擎的首选。
它能够快速地储存、搜索和分析海量数据。维基百科、Stack Overflow、Github 都采用它。安装 Elasticsearch 很是简单，官网下载解压，进入其 bin 目录运行以下图所示的 bat 文件便可 ：

 

 

 

它是一个 java 编写的程序，若是要修改占用内存的大小，请找到配置文件，例如修改成 -Xmx10g -Xms10g 表示初始化 10 个 G 的内存空间给 Elasticsearch ，Elasticsearch 最大使用的内存也是 10G，通常状况下，设置为内存的一半大小，但最好不超过 32 G，根据需求，生产环境适合调大，测试环境适当调小。

若是运行失败，说明本机没有安装 java，或者没有正确地配置 java 环境变量，这些操做也很是简单，网上处处都是，不在此详述。

（3）运行 cmdb 后端 api 服务、前端 ui

首先准备 Python3 的环境，这个也很简单，直接官网下载，运行便可，记得把 Python.exe 所在的路径添加到 Path 变量中。

若是你的电脑里有多个项目，为防止项目的依赖包版本冲突，建议使用 virtualenv 来为每一个项目前建立一个虚拟的 Python 环境，将各自的依赖包装在本身的虚拟环境里。

（1）部署后端

执行如下命令，注意命令后面的注释。

git clone https://github.com/open-cmdb/cmdb.git
cd cmdb
#如建立了虚拟环境，请先激活
pip install  -r requirements.txt #若是这一步有包安装失败，提示却少 microsoft visual c++ 14.0 的话，请在网站 https://www.lfd.uci.edu/~gohlke/pythonlibs/ 上查找相应的whl文件，直接 pip install .whl文件便可。

接下来修改3个文件

  1. 修改 apps/mgmt/views.py 文件，注释掉 “ from . import initialize ”这一行。
  2. 修改 manage.py
    将 APP_NAME = BASE_DIR.rsplit("/", 1)[-1] 修改成
    APP_NAME = BASE_DIR.rsplit("\", 1)[-1] ，这是由于windows的路径\ 在python 里会变成 \。
  3. 修改 cmdb/settings.py 文件，修改mysql 数据库的配置信息以下所示：
DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME': "cmdb",
    "HOST": "127.0.0.1",
    "PORT": 3306,
    "USER": "aaron",
    "PASSWORD": "aaron"
  }
}

接着在命令窗口继续执行如下操做：请关注注释内容。

python manage.py makemigrations 
python manage.py migrate
python manage.py cmdb_create_superuser #这一步建立一能够登录的管理员用户
#修改 apps/mgmt/views.py 文件，取消注释“ from . import initialize ”
python manage.py runserver #这一步启动后端的 api 服务

此时一个后端的服务已经启动了，在浏览器中打开 “127.0.0.1:8000”就能够看到 api 的接口了。

 

 

（2）使用 nginx 部署前端并链接后端 api 服务

在命令容器执行如下命令：

git clone https://github.com/open-cmdb/cmdb-web.git

获取前端的源代码，而后下载下载 ngnix 压缩包，并解压至安装目录，修改配置文件 nginx.conf，添加以下 server 配置：

server {
        listen 8080;
        server_name localhost;
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
        root html;
        }
        
        root E:\GitHub\cmdb-web\dist;
        index index.html;
        location / {
        try_files $uri $uri/ @router;
        index index.html;
        }
        
        location @router {
        rewrite ^.*$ /index.html last;
        }

        location ~ /api{
        proxy_pass http://127.0.0.1:8000;
        }
    }

其中以配置

location ~ /api{
        proxy_pass http://127.0.0.1:8000;
        }

让前台发过来中以 api 开头的 url 请求都转发至 http://127.0.0.1:8000 进行解析，即第一步部署的 django 项目，这样就链接了前端和后端。而后咱们在 nginx.exe 所在的目录下启动 nginx 服务。

 

 

接下来在浏览器中输入 127.0.0.1:8080 便可正常访问本文开始处的 cmdb 系统，您能够尝试下强大的搜索功能及增删改功能。

 

 

 

点击右上方【API 文档】 能够访问 cmdb 的接口文档，很是方便。

 

 

至此系统搭建完毕。若是要用于生产环境，请使用 linux 操做系统，并使用 uwsgi 来驱动 django 项目。

3. Vue 环境搭建

我想你不会仅仅知足于将别人的项目下载下来能运行就好了，你确定想对其进行改造来知足本身的需求。所以你可能会须要修改前端或后端，后端的修改其实上面部署的已经能够了，你能够直接阅读 django 项目的源代码进行修改调试。若是要修改前端代码进行调试，你就须要搭建 Vue 环境。

你可能会问了，Vue 是个啥？Vue 是一个 javascript 框架，若是说 jQuery，你可能就知道了，使用方法是相似的，在 html 上引入一行 javascript 的文件，就可使用框架的特性了。 Vue 是一套用于构建用户界面的渐进式框架。与其它大型框架不一样的是，Vue 被设计为能够自底向上逐层应用。Vue 的核心库只关注视图层，不只易于上手，还便于与第三方库或既有项目整合。另外一方面，当与现代化的工具链以及各类支持类库结合使用时，Vue 也彻底可以为复杂的单页应用提供驱动。
学习 vue 须要有 html、css、javascript 基础
新手能够经过 html 上引入 Vue 的 js 文件来使用 vue，以下所示：

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Vue 测试实例 </title>
    <script src="https://cdn.staticfile.org/vue/2.4.2/vue.min.js"></script>
</head>
<body>
<div id="app">
    <p>{{ message }}</p>
</div>

<script> new Vue({ el: '#app', data: { message: 'Hello Vue.js!' } }) </script>
</body>
</html>

可是在较复杂的项目中，仍是要使用工具来帮助咱们管理项目的层级及文件之间的依赖关系，这就须要使用 vue 的命令行工具 vue-cli ，vue-cli 须要 npm 工具来安装，npm 工具集成在 node.js 中，所以须要安装 node.js。
安装 node.js 很是简单，直接官网下载解压便可使用：

 

 

 

将 npm 所在路径添加到环境变量 Path 中，你就能够在任意的命令窗口使用 npm 命令了。
一、安装 vue-cli

先安装淘宝镜像，你们都知道国内直接使用 npm 的官方镜像是很是慢的，这里推荐使用淘宝 NPM 镜像。

npm install -g cnpm --registry=https://registry.npm.taobao.org

执行结果以下：

 

 

这样就可使用 cnpm 命令来安装模块了：使用 cnpm 安装 vue-cli

 

 

而后咱们就可使用 vue init webpack my-project 命令来来建一个项目 my-project，这里须要进行一些配置，能够直接回车来使用默认配置，以下图所示：

 

 

 

等待其初始化完毕后，进入项目，执行如下命令：

C:\Users\xx>cd my-project
C:\Users\xx\my-project>cnpm install
C:\Users\xx\my-project>cnpm run dev

此时会自动 build ，运行成功后会打印以下信息表示服务已正常启动：

 

 
3compliesucce.png

此时打开浏览器，输入 http://localhost:8081，便可看到 my-project 在浏览器中的展现。

 

若是要把这个页面部署在 nginx 服务器上，你还须要 build 命令来生成静态资源，以下图所示：

 

 
image.png

 

此时会在 my-project 下生成 dist 目录，至关于咱们写程序编译生成的目标文件。my-project 下的内容及说明以下图所示：

 

 
Snipaste_2018-10-26_06-47-24.png


此时已经能够开启你的 vue 之旅了。

当学会了 Vue 以后，你就能够修改本项目的前端源代码来知足本身的需求了，进入 src 目录，查看并修改源代码以后，进入 cmdb_web 的项目目录，执行

# 安装依赖，若是慢可换成 cnpm
npm install
# 启动服务，默认端口为8080，若是被占用会自动选取一个未被占用的端口
npm run dev
# 创建静态文件，能够放在 nginx 上运行
npm run build
# 查看创建报告
npm run build --report

便可将生成的 dist 部署到 web 服务器了。

也许你会认为这样实在太麻烦了，不如本身动手写一个 cmdb 系统，若是时间容许固然能够本身写，可是我不推荐这样作，上述这些操做其实都很简单，在熟悉以后就像打字同样容易，并且本身写一个一样效果的系统要直接拿优秀的代码来改造要慢得多，大神例外。做为通常程序员咱们应该避免重复造轮子，学会站在巨人的肩膀上。所以开发一个项目最好是找 github 上相似的优秀开源项目，借鉴其优良设计，甚至能够直接拿来作二次开发，这才是最高效的作法。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程