BK-CMDB

蓝鲸配置平台（蓝鲸CMDB）是一个面向资产及应用的企业级配置管理平台。

本文档内容为如何在 Kubernetes 集群上部署 BK-CMDB 服务。

说明：内置的mongodb、redis、zookeeper、elasticsearch等组件仅用于测试环境，正式环境部署必须配置为外部组件。

BK-CMDB 部署项目

架构设计

• 点击这里

部署

环境要求

• Kubernetes 1.12+
• Helm 3+

安装Chart

使用以下命令安装名称为bkcmdb的release, 其中<bkcmdb helm repo url>代表helm仓库地址, password为自己设置的任意密码:

$ helm repo add bkee <bkcmdb helm repo url>
$ helm install bkcmdb bkee/bkcmdb --set mongodb.auth.password=${password} --set redis.auth.password=${password}

上述命令将使用默认配置在Kubernetes集群中部署bkcmdb, 并输出访问指引。

卸载Chart

使用以下命令卸载bkcmdb:

$ helm uninstall bkcmdb

上述命令将移除所有和bkrepo相关的Kubernetes组件。

Chart依赖

• bitnami/mongodb
• bitnami/redis
• bitnami/zookeeper
• bitnami/elasticsearch

配置说明

各项配置集中在仓库的一个values.yaml文件之中

镜像配置

启动时初始化配置说明

启动时会执行job，分别对cmdb依赖的mongodb数据库进行初始化操作，以及往GSE注册dataid

蓝鲸产品URL配置

adminserver服务配置说明

apiserver服务配置说明

authserver服务配置说明

cacheservice服务配置说明

cloudserver服务配置说明

coreservice服务配置说明

datacollection服务配置说明

eventserver服务配置说明

hostserver服务配置说明

operationserver服务配置说明

procserver服务配置说明

taskserver服务配置说明

toposerver服务配置说明

synchronizeserver服务配置说明

webserver服务配置说明

服务开启鉴权开关

common开头的配置

以common开头的配置，对应的是cmdb中common.yaml的配置文件中的各项配置，可根据原common.yaml中的配置对common开头的配置进行修改

mongodb配置

mongodb.externalMongodb 和 mongodb.watch 开头的配置，可根据原mongodb.yaml中的配置进行修改

redis配置

redis.redis、redis.snapshotRedis、redis.discoverRedis、redis.netCollectRedis 开头的配置，可根据原redis.yaml中的配置进行修改

zookeeper配置

配置发现中心、服务发现中心配置

elasticsearch配置

monstache配置

monstache是一个用于将mongodb的数据同步到es去创建索引的一个组件

bkLogConfig配置

• bkLogConfig配置用于配置接入蓝鲸日志平台功能

serviceMonitor配置

• serviceMonitor配置用于配置服务监控功能

证书相关配置

配置案例

1. 使用外接mongodb

mongodb:
  enabled: false
  ...
  # external mongo configuration
  externalMongodb:
    enabled: xxx
    usr: xxx
    pwd: xxx
    database: xxx
    host: 127.0.0.1:27017
    maxOpenConns: xxx
    maxIdleConns: xxx
    mechanism: xxx
    rsName: xxx
    socketTimeoutSeconds: xxx
  watch:
    usr: xxx
    pwd: xxx
    database: xxx
    host: 127.0.0.1:27017
    maxOpenConns: xxx
    maxIdleConns: xxx
    mechanism: xxx
    rsName: xxx
    socketTimeoutSeconds: xxx

2. 使用外接redis

redis:
  enabled: false
  ...
  # external redis configuration
  redis:
    host: 127.0.0.1:6379
    pwd: xxx
    database: xxx
    maxOpenConns: xxx
    maxIdleConns: xxx
    sentinelPwd: xxx
    masterName: xxx

  snapshotRedis:
    host: 127.0.0.1:6379
    pwd: xxx
    database: xxx
    maxOpenConns: xxx
    maxIdleConns: xxx
    sentinelPwd: xxx
    masterName: xxx

  discoverRedis:
    host: 127.0.0.1:6379
    pwd: xxx
    database: xxx
    maxOpenConns: xxx
    maxIdleConns: xxx
    sentinelPwd: xxx
    masterName: xxx

  netCollectRedis:
    host: 127.0.0.1:6379
    pwd: xxx
    database: xxx
    maxOpenConns: xxx
    maxIdleConns: xxx
    sentinelPwd: xxx
    masterName: xxx

3. 使用外接zookeeper作为配置发现中心和服务发现中心

zookeeper:
  enabled: false
configAndServiceCenter:
  addr: 127.0.0.1:2181

4. 使用elasticsearch相关操作

• 如果在cmdb中使用es，首先需要开始es的开关

common:
  es:
    fullTextSearch: "on"

• 在cmdb中使用elasticsearch需要依赖两个组件，一个是elasticsearch本身，一个monstache（用于将mongodb数据同步到elasticsearch）

  （1）使用内置组件

  ​ helm chart中有内置的elasticsearch和monstache，可通过下面操作打开：

  elasticsearch:
    enabled: true
  
  ··
  
  monstache:
    enabled: true

  ​ 将elasticsearch和monstache的enabled变为true即可

  （2）使用外接组件

  这里仅需配置连接外置的elasticsearch，这时外置的monstach已经与cmdb没有配置上的联系

  common:
    es: 
      url: xxx
      usr: xxx
      pwd: xxx

  配置上外部es的url，账户密码的信息即可

• 当然也可以使用内置的monstache，连接外部的elasticsearch

  monstache:
    enabled: true
  	
  ···
  
  common:
    es: 
      url: xxx
      usr: xxx
      pwd: xxx

  将monstache.enabled变为true，配置好外部的elasticsearch的配置即可

5. 配置webserver不同的服务暴露方式

默认通过Ingress暴露服务，也可以使用以下方式：

• 使用NodePort直接访问

  webserver:
    ingress:
      enabled: false
      ...
    service:
      type: "NodePort"   
      ports:
        ...
          nodePort: 32033 # 端口可以自定义

  common:
    ...
    site:
      domainUrl: http://127.0.0.1:32033/ # ip需要根据实际情况的进行配置，端口为上面配置的同一端口

  修改上述配置后，即可通过ip:32033的方式访问

6. 开启权限验证

通过进行下面的配置：

开启权限
iam:
  auth:
    enabled: true

// 配置权限中心和esb地址、app code、app secret，开启前端的auth
bkIamApiUrl: xxx
bkComponentApiUrl: xxx

common:
 ...
  auth:
    appCode: xxx
    appSecret: xxx
  esb:
    appCode: xxx
    appSecret: xxx
 ...
  webServer:
    site:
      authScheme: iam

7. blueking方式登陆

通过将登陆方式设置为蓝鲸登陆方式和配置蓝鲸登陆地址等信息：

# pass地址
bkPaasUrl: xxx
# bk-login地址
bkLoginApiUrl: xxx

common:
  ...
  webServer:
    site:
      appCode: bk_cmdb
    ...
    login:
      version: blueking

8. 配置authserver不同的服务暴露方式

默认通过Ingress暴露服务，也可以使用以下方式：

• 使用NodePort直接访问

  authserver:
    ingress:
      enabled: false
      ...
    service:
      type: "NodePort"   
      ports:
        ...
          nodePort: 32033 # 端口可以自定义

  修改上述配置后，即可通过ip:32033方式对外暴露访问

常见问题

1. cmdb的helm chart启动后如何访问

答：因为默认的访问方式是通过ingress访问，域名为 cmdb.bk.com，所以需要配置 cmdb.bk.com 的dns解析，例如在机器的/usr/hosts文件中配置：

127.0.0.1 cmdb.bk.com 

在minikube环境通过下面指令启用Ingress控制器

  minikube addons enable ingress

配置完后，通过访问cmdb.bk.com/login地址进行登陆，默认 的账号为cc，密码为cc

2. cmdb启动不起来

答：

1、cmdb启动需要依赖的redis、mongodb、zookeeper等，部分服务需要等依赖的组件ready后才可以启动，再加上需要等adminserver启动完后，有一个bootstrap的job需要执行，所以需要等待一段时间服务才能启动

2、authserver需要相关配置连接权限中心，如果没有配置是启动不来的，根据默认配置无法启动。可通过修改

authserver:
  enabled: false

变为false不启动authserver服务 或者配置权限中心所需要的配置

如果长时间有些服务无法启动，如：toposerver，请确认job是否启动并执行完成

3. 想要配置多个外置zookeeper地址作为服务中心怎么办？

答：通过,(逗号)分隔，如下：

configAndServiceCenter:
  addr: 127.0.0.1:2181,127.0.0.2:2181

4. 想要配置多个外置redis地址怎么办？

答：通过,(逗号)分隔，如下：

redis:
  ...
  # external redis configuration
  redis:
    host: 127.0.0.1:6379,128.0.0.1:6379

5. 想要配置多个外置mongo地址怎么办？

答：通过,(逗号)分隔，如下：

mongodb:
  # external mongo configuration
  externalMongodb:
    enabled: xxx
    usr: xxx
    pwd: xxx
    database: xxx
    host: 127.0.0.1:27017,127.0.0.1:27018