腾讯蓝鲸论坛-专业的技术交流论坛

 找回密码
 立即加入蓝鲸智云论坛
忘了密码?
搜索
热搜: 用户手册 FAQ
查看: 1834|回复: 7

[官方文档] 社区版 V3.0.25 升级到 V3.1 指引文档

 关闭 [复制链接]

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 12:25:50 |显示全部楼层
社区版 V3.0.25 升级到 V3.1 指引文档

目录(详情请点击跳转)

社区版 V3.1 获取方式

官网


手册下载

社区版 3.0.25 升级到 3.1 指引文档.pdf

160.51 KB, 下载次数: 42

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 12:32:50 |显示全部楼层
版本差异

社区版 V3.0.25 与 V3.1 差异

  • 功能差异: 请参考 release.md
  • 部署差异
    差异点V3.1V3.0.25
    规范化目录结构支持不支持
    插件式部署支持不支持
    可随意调整模块分布支持不支持
    可选的依赖服务安装支持不支持
    可以单独升级任意模块 支持不支持

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 12:34:22 |显示全部楼层
升级说明

  • 升级过程中将数据采集上报将中断
  • 升级过程中,所有服务不可用
  • 升级前务必备份数据库
  • 若部署后, 自行修改过部署方案(如 ES,mysql) 多节点部署, 本升级方案中提供的相关的具体不适用


44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 12:35:46 |显示全部楼层
升级要求

  • 社区版 V3.1 最小机器数量为 3台, 因此需要准备 至少 3台 机器
  • 文档所示的升级操作在 V3.0 的 PAAS 所在机器上完成

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 12:57:29 |显示全部楼层
维护方案

升级准备

  • 下载 V3.1 的部署脚本包: V3.1.6 install_ce-1.0.14,蓝鲸产品代码包 V3.1.6 Beta  到 V3.0 的 PAAS 所在机器。并在 /data/ (或者其他的较大分区目录)下解压,得到 install 目录和 src 目录。要求 install,src 在同级目录中。
  • 停止所有机器上的 monitrc:pkill monit
  • 检查所有机器(升级后的3台)上的 etc 目录下的 resolv.conf 文件,若有 options  配置,需要确保没有 rotate 选项
  • 删除 crontab 中蓝鲸相关的配置项
  • 若安装了 datasvr, 需要停止 kafka 数据写入,操作如下:
    1. $ source /data/bksuite_ce-3.0.25-beta/bk.conf
    2. $ rsync -a  /data/install/migrate/upgrade_bkdata_3.0to3.1 root@$DATASVR_IP:/tmp/
    3. $ ssh $DATASVR_IP "bash /tmp/upgrade_bkdata_3.0to3.1 /data/bksuite_ce-3.0.25-beta"
    复制代码
  • 使用如下命令在 V3.0 的 PAAS 所在机器上备份 mysql,并保存为数据文件: /data/bk3.0_dbbackup_4upgrade.sql (目录和文件名不要改)
    1. $ sqlfile=/data/bk3.0_dbbackup_4upgrade.sql     # 注意文件名不要自定义.否则会找不到
    2. $ mysqldump -h x.x.x.x -u root -pbk@321  --default-character-set=utf8 --all-database --opt >$sqlfile
    复制代码
  • 若安装了 datasvr,需要备份 es 数据数据到新的 es  节点的数据目录:
    1. 1. 在3.0的PAAS上执行:
    2. $ OLD_BKHOME=/data/bksuite_ce-3.0.25-beta  # 修改为实际的安装路径
    3. $ esconfig=elasticsearch/config/elasticsearch.yml
    4. $ es_node_path=$(ssh root@$DATASVR_IP "grep 'path.data' $OLD_BKHOME/common/$esconfig" | sed 's/.*: //')
    5. $ es_cluster=$(ssh root@$DATASVR_IP "grep '^ *cluster.name' $OLD_BKHOME/common/$esconfig" | sed 's/.*: //')
    6. $ rsync -a root@$DATASVR_IP:$es_node_path/$es_cluster/  /data/es/
    复制代码
  • 备份 saas 应用,在 V3.0 的 PAAS 机器上执行:
    1. $ rsync -a $OLD_BKHOME/paas_ce/open_paas/src/paas/media/saas_files /data/src/open_paas/paas/media
    复制代码
  • 停止掉 V3.0 所有服务进程
  • 备份 zookeeper 数据.  在 V3.0 的 PAAS 上执行:
    1. $ mkdir -p /data/zk/data{,Log}/{1,2,3}
    2. $ for i in 1 2 3; do
    3. >     rsync -a $OLD_BKHOME/common/zookeeper/server$i/data/ /data/zk/data/$i/
    4. >     rsync -a $OLD_BKHOME/common/zookeeper/server$i/dataLog/ /data/zk/dataLog/$i/
    5. > done
    6. $ rm -f /data/zk/data/*/*.pid
    复制代码

> Note:
> 以上6-11 步骤,可以通过执行 install/migrate/pre_upgrade.sh 完成

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 13:13:30 |显示全部楼层
升级过程

1.下载安装包

上传安装包到任意一台机器 /data/目录, 该机器做为中控机. 把安装包解压, 并 cd 到解压后的 install 目录中, 开始安装步骤:
  • 官网下载证书,假设保存到 /root/ 目录下。
1.证书下载地址: http://bk.tencent.com/download/#ssl
2.下载证书时, 需要同时填写部署 gse, license 的机器 MAC 地址。
  1. $ cd /data
  2. $ tar xf V3.1.6 Beta
  3. $ tar xf V3.1.6 install_ce-1.0.14
  4. $ cd src/cert; tar xf /root/ssl_certificates.tar.gz
  5. $ cd ../../install   # 回到操作目录
复制代码
2.准备配置文件

部署所需的基本配置文件都在 install 目录下。

  • 在 install 目录中并写入配置文件 install.config, 以下为最简配置, 可以自行增加机器, 将服务分配到新机器上。
    1. $ vi install.config
    2. 1.2.3.4 nginx,appt,rabbitmq,kafka,zk,es,bkdata,consul,fta
    3. 1.2.3.5 license,appo,kafka,zk,es,mysql,beanstalk,consul
    4. 1.2.3.6 paas,cmdb,job,gse,kafka,zk,es,consul,redis,bkarchiva
    复制代码

Note:
1. zk 表示 zookeeper, es 表示 elasticsearch
2. 该配置文件,要保证逗号前后没有空白字符,行末没有空白字符, ip 后面使用空格与服务名称隔开(不能使用 tab )
3. 含有多个内网 ip 的机器,install。config 中使用 /sbin/ifconfig 输出中的第一个内网ip
4. 在 ip 后面写上该机器要安装的服务列表即可。
5. nginx 与 cmdb 不能部署在同一台机器
6. gse 与redis 需要部署在同一台机器上
7. 安装 zk 的机器, 不能有外网IP, 或者必须通过防火墙策略限制zk端口的访问
8. gse 若需要跨云支持, gse 所在机器必须由外网 IP
9. 增加机器数量时, 可以将以上配置中的服务挪到新的机器上。 要保证: kafka, es, zk 的每个组件的总数量为3

  • 根据实际情况修改 global.env, ports.env
    • ports.env 中可以配置各项服务的端口信息
      Note: 安装完成后,配置的防火墙策略需要保证 ports.env 中的端口在内网主机之间的互通
    • globals.env 配置文件中,设定域名,账号密码等信息, 强烈建议修改掉默认值
    • global.env 中配置的域名,必须保证可以在服务器上被解析到,建议使用 DNS 进行配置,域名解析对应的 A 记录要求填写 nginx 所在机器的 ip 地址。        
      若无 DNS 服务,则需要在安装蓝鲸服务的机器上都配置 hosts, 把 paas, job, cmdb 的域名都指向 nginx 所在 ip, 示例如下:
      1. 1.2.3.4   paas.blueking.com
      2. 1.2.3.4   job.blueking.com
      3. 1.2.3.4   cmdb.blueking.com
      复制代码

  • 修改 pip 源
    • vi src/.pip/pip.conf
    • 设置为能连上的 pip 源。默认的 pip 配置通常是无法使用的。
    • 若无法链接外网,公司内部也没有可用的 pip 源。可用通过以下方法解决
      1. 1. 解压下载好的 bkce_src 压缩包,
      2. 2. 分别在 fta/fta,bkdata/monitor,bkdata/dataapi,open_paas/paas,open_paas/esb,
      3.    open_paas/login,open_paas/appengine,paas_agent/paas_agent/ 目录下创建文件:
      4.    SELF_CONTAINED_PIP_PKG, 并找到 requirements。txt,将其中的 python 包下载好,
      5.    放在对应模块的 support-files/pkgs 目录下
      6. 3. 按照安装步骤执行安装
      复制代码

  • 配置代理
    • 如有不是所有服务器都可以连接都外网的,可以根据主机环境要求中的第4点进行操作,也可以通过配置代理的方式来访问)
    • 在所有机器的 .bashrc 中添加
      1. export http_proxy=http://x.y.z:pp
      2. export https_proxy=https://x.y.z:ppp;
      复制代码

3. 配置免密登录
  • 任选一台机器,ssh 登陆后执行以下操作:
    1. $ ssh-keygen -t rsa -b 2048 #有确认提示,一直按回车即可

    2. $ cat ~/.ssh/id_rsa.pub > ~/.ssh/authorized_keys
    3. $ chmod 600 ~/.ssh/authorized_keys
    4. $ for ip in $(awk '{print $1}' install.config );do rsync -a ~/.ssh/authorized_keys root@$ip:/root/ .ssh/;done
    复制代码

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 13:19:38 |显示全部楼层
安装步骤

4. 开始升级

安装过程的输出说明:

白色: 普通输出
蓝色: 步骤说明
黄色: 警告消息,可忽略
红色: 失败提示,或者错误提示


Note:
安装过程中会出现少量的非脚本输出日志(无 ip 和日期前缀的输出行)。也会出现红色的 警告 消息,请忽略。
  1. $ cd /data/install/migrate
  2. $ ./bksuite_upgrade base_service
  3. $ ./bksuite_upgrade bk_products
  4. $ ./bksuite_upgrade app_mgr
  5. $ cd ../install
  6. $ ./bkcec install gse_agent
复制代码

44

主题

0

好友

10万

积分

管理员

Rank: 48Rank: 48Rank: 48

发表于 2017-9-9 13:21:02 |显示全部楼层
升级后要做的事情

  • 进入 install/migrate 目录, 执行 post_upgrade_bkdata_3.0to3.1
  • 重新部署 app
  • 删除旧的版本目录 (可选)

蓝鲸官网

GMT+8, 2018-4-26 04:16

Powered by Discuz! X2.5

© 2001-2012 Comsenz Inc.

回顶部