2.6 高级进阶
2.6.1 历史查询功能
操作历史，应该是管理系统必备的功能之一。Django-echelon就是一个很好的功能模块，该功能模块可以单独使用于任何的Django项目中，非常方便，接下来我们讲解如何将该功能添加到CMDB系统中，设置步骤具体如下。
（1）修改settings.py设置。
①添加echelon APP：
INSTALLED_APPS = (
'......',
'echelon',
)
②添加echelon中间件：
MIDDLEWARE_CLASSES = (
'......',
'echelon.middleware.EchelonMiddleware',
)
（2）修改urls.py设置：
# encoding:utf8
from django.conf.urls import patterns, include, url
urlpatterns = patterns('',
'......',
# 操作历史
url(r'^cmdb/changelog/', include('echelon.urls')),
)
（3）将echelon代码复制到Django项目的主目录中，将html代码复制到templates目
录中。
（4）刷新DB，创建数据表：
$ python manage.py syncdb
（5）把操作历史的URL信息添加到前端页面的导航栏中就可以了（配置cmdb/cmdb_menu.py程序），具体操作如下：
CMDB_TOP_MENU = [
'......',
#导航名称、URL、图标、子导航信息
[u'操作历史 ', '/cmdb/changelog/', 'time', []],
]
（6）启动Django服务，打开前端页面，然后点击操作历史，就可以看到用户的操作信息了（见图2-14），具体如下。
图2-14 用户的操作信息
以上代码都可以在open-cmdb库上找到源代码。
2.6.2 API功能
CMDB作为一个数据源中心，很多运维工具都会调用CMDB数据进行使用，因此API接口就非常有必要了，由于各个系统的需求不一样，从头到尾开发一套适用于各个系统的CMDB API也比较困难，那么有没有什么简单的方法呢？答案肯定是有，这里我推荐Django API利器Django REST framework。
Django REST framework是一个非常强大、灵活的API构建工具，它能很容易、很快速地帮我们构建Web API。下面来讲解构建的过程，具体步骤如下。
（1）安装Django REST framework。
主要安装3个模块：djangorestframework、markdown、django-filter。具体代码如下：
pip install djangorestframework
pip install markdown
pip install django-filter
（2）配置settings.py：
INSTALLED_APPS = (
'......',
'rest_framework',
)
REST_FRAMEWORK = {
# Use Django's standard `django.contrib.auth` permissions,
# or allow read-only access for unauthenticated users.
'DEFAULT_PERMISSION_CLASSES': [
'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly'
]
}
（3）设置urls.py：
urlpatterns += patterns(
'',
url(r'^api/', include(myproject.api.router.urls)),
url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework')),
)
（4）创建我们的CMDB API（根据models信息来创建，这里只附上一个简单的讲解，具体的内容请看源码）：
# -*- coding: utf-8 -*-
# 导入cmdb.models模块
import cmdb.models
# 从rest_framework中导入模块
from rest_framework import routers, serializers, viewsets
# 给需要生成API的model定义一个数据序列
# Serializers define the API representation.
class IDCSerializer(serializers.HyperlinkedModelSerializer):
class Meta:
# 使用的model名称
model = cmdb.models.IDC
# 字段序列
fields = ('url', 'name', 'memo')
# 定义视图
class IDCViewSet(viewsets.ModelViewSet):
# 查询所有数据，这个可以根据自己的需要来展示几个
queryset = cmdb.models.IDC.objects.all()
# 序列化信息
serializer_class = IDCSerializer
# 配置路由注册，自动生成API URL
# Routers provide an easy way of automatically determining the URL conf.
router = routers.DefaultRouter()
router.register(r'idcs', IDCViewSet)
（5）配置导航栏信息：
cmdb_menu.py CMDB_TOP_MENU = [ [u'API文档 ', '/api/', 'book', []], ]
（6）启动Django服务，展示如下（图2-15）。
图2-15 启动Django服务
通过API文档，可以看到全部的API信息，如图2-16所示。
图2-16 全部的API信息
点击IDC的具体URL，就能看到展示的信息和用法，如图2-17所示。
到这里CMDB API就完成了最基本的功能，后续还需要读者自己去调整页面和授
权等。
图2-17 展示的信息和用法
2.6.3 数据表结构
对于数据表结构，前面的定义是比较简单的，有兴趣的读者可以根据自己的实际需求去增加，这里仅列举一个简单的优化例子——IDC表优化。
IDC表前面就一个IDC名称字段，这里将根据作者所在公司的需求来做优化，优化后的字段具体如下：
class IDC(models.Model):
# 机房名称字段
name = models.CharField(u'机房名称', max_length=200, unique=True)
# 名称缩写
short_name = models.CharField(u'名称缩写', max_length=200, unique=True)
# 机房地域
zone = models.CharField(u'机房地域', max_length=200, blank=True)
# 机房地域缩写
zone_short_name = models.CharField(u'地域缩写', max_length=200, blank=True)
# 机房地址
address = models.CharField(u'机房地址', max_length=200, blank=True)
# 机柜U数
unit_size = models.PositiveIntegerField(u'机柜U数', default=42, help_text="机房每个机柜拥有Unit数目")
# 机柜电数
power_size = models.PositiveIntegerField(u'机柜电数', default=12, help_text="机房每个机柜拥有电力(An)数目")
INTERFACE_TYPE_CHOICES = (
(0, '光纤'),
(1, '普通'),
(2, '其他'),
)
# 网络接入方式是光纤、普通还是其他
interface_type = models.SmallIntegerField(
'网络接入', choices=INTERFACE_TYPE_CHOICES, default=0)
# 机房所有设备的总带宽
bandwidth_equipment = models.BigIntegerField(u'设备带宽', default=0, help_text="设备带宽(Mbps)")
# 机房可用带宽
bandwidth_usable = models.BigIntegerField(u'可用带宽', default=0, help_text="可使用最大带宽(Mbps)")
# 物理接入带宽
bandwidth_line = models.BigIntegerField(u'接入带宽', default=0, help_text="物理接入带宽(Mbps)")
# 保底带宽
bandwidth_min = models.BigIntegerField(u'保底带宽', default=0, help_text="保底带宽(Mbps)")
# 报警阀值
bandwidth_threshold = models.BigIntegerField(u'报警阈值', default=0, help_text="报警阈值(Mbps)")
LINE_MODEL_CHOICES = (
(0, '单线'),
(1, '双线'),
(2, 'BGP'),
)
# 机房线路类型是单线、双线还是BGP
line_model = models.SmallIntegerField(
'线路类型', choices=LINE_MODEL_CHOICES, default=0)
# 接入线路条数
line_count = models.IntegerField(u'线路条数', default=1, help_text="接入线路条数")
# 是否冗余
line_redundancy = models.BooleanField("是否冗余", default=False, help_text="接入线路是否冗余")
# 是否限速，限速大小
speed_limit = models.IntegerField(u'限速大小', default=0, help_text="限速大小(Mbps, 0:不限速)")
CHARGE_TYPE_CHOICES = (
(0, '峰值'),
(1, '95值'),
(2, '保底'),
(3, '计时'),
(4, '包月'),
(5, '包年'),
)
# 计费模式
charge_type = models.SmallIntegerField(
'计费模式', choices=CHARGE_TYPE_CHOICES, default=0)
# 是否直连ISP
isp_direct_link = models.BooleanField("是否直连ISP", default=False)
# 所属运营商，这里需要再建立一个ISP的类
isp = models.ForeignKey("ISP", verbose_name="运营商")
# 联系人
contact = models.ForeignKey(UserProfile, related_name="idc_contact", verbose_name="联系人", help_text="IDC机房联系人")
# IDC经理
manager = models.ForeignKey(UserProfile, related_name="idc_manager", verbose_name="经理", help_text="IDC经理")
# 值班人
duty_officer = models.ForeignKey(UserProfile, related_name="duty_officer", verbose_name="值班人", help_text="IDC机房值班联系人")
# IDC报障邮箱
support_email = models.EmailField(u'报障邮箱', help_text="IDC报障邮箱")
# 公司联系人
company_contact = models.ForeignKey(UserProfile, related_name="xsj_contact", verbose_name="公司联系人", help_text="公司联系人")
# 开通时间
start_time = models.DateTimeField(u'开通时间',
auto_now_add=True)
# 到期时间
end_time = models.DateTimeField(u'到期时间',
default=datetime.datetime(2140, 1, 1, 0, 0, 1))
memo = models.CharField(u'备注', max_length=200, blank=True)
def __unicode__(self):
return self.name
class Meta:
db_table = 'idc'
现在这个表结构就是一个复杂的数据表结构，通过修改base_admin.py就可以直接展示了。
2.6.4 用户管理功能
Django有一套自己的用户管理、用户组管理和权限管理，我们在初始化Django项目的时候，Django会默认创建User、Permission、Group这3个表及对应的关联关系表。
本章所介绍的这套简单的CMDB系统，已经将展示、添加、编辑和删除都模块化了。通过模板构建用户管理也是一件很轻松的事情，只需要把Django自带的用户信息提取出来套用模板即可，具体步骤如下。
（1）在cmdb/base_admin.py中设置。
导入User模块：
from django.contrib.auth.models import User
'user': {
# model名称
'model': User,
# form表单
'form': User_CheckFrom,
#名称 'name': u'用户管理 ',
#是否可以导入信息
'import': '',
# table展示字段
'list_display': ['username',
'password', 'email', 'is_superuser', 'is_active', 'is_staff',
'groups',
'user_permissions'],
#编辑只读字段
'readonly': ['username'],
#动作
'action_list': [(u'编辑 ', 'pencil', '/cmdb/user/modify/'),]
},
（2）把用户管理的URL信息添加到前端页面的导航栏中。（配置cmdb/cmdb_menu.py程序），具体操作如下：
CMDB_TOP_MENU = [
'......',
#导航名称、URL、图标、子导航信息
[u'用户管理 ', '/cmdb/user/show/', 'user', []],
]
（3）启动Django服务，打开前端页面，点击用户管理，信息如图2-18所示。
图2-18 用户组管理信息
（4）到这里一个简单的用户管理功能就实现了，如果读者需要更详细的用户信息，可以去创建一个UserProfile表，然后关联到Django自带的User信息中，限于篇幅，本章就不逐一详细介绍了。
2.6.5 用户组管理功能
用户组管理和用户管理的原理是相通的，添加方式也是一样的，这里只是简述讲解一下添加的步骤。
（1）在cmdb/base_admin.py中设置：
'group': {
# model名称
'model': Group,
# form表单
'form': Group_CheckFrom,
# 名称
'name': u'用户组管理',
# 是否可以导入信息
'import': '',
# table展示字段
'list_display': ['name',
'permissions'],
# 编辑只读字段
'readonly': ['name', ],
# 动作
'action_list': [(u'编辑', 'pencil', '/cmdb/group/modify/'),]
},
（2）把用户组管理的URL信息添加到前端页面的导航栏中就可以了（配置cmdb/cmdb_menu.py程序），具体操作如下：
CMDB_TOP_MENU = [
'......',
#导航名称、URL、图标、子导航信息
[u'用户组管理 ', '/cmdb/group/show/', 'list', []],
]
（3)启动Django服务，打开前端页面，点击用户组管理（默认为空），信息如图2-19所示。
图2-19 添加用户组管理
（4）到这里组管理功能也实现成功了，现在我们就可以创建自己想要的组信息，把相应的用户添加到组中了。
到此为止，我们已经基于CMDB完善了用户、用户组、操作历史、开放API几大实用功能。通过这些构建，可以将CMDB和自动化运维平台的其他系统逐一打通，构建属于自己的平台。
