- 微服务开发框架升级
- 添加Choerodon Chart仓库
- 升级register server
- 升级config server
- 升级manager service
- 升级iam service
- 部署notify service
- 部署asgard service
- 升级api gateway
- 升级gateway helper
- 升级oauth server
- 升级file service
- DevOps服务升级
- 升级devops service
- 升级gitlab service
- 敏捷管理升级
- 测试管理升级
- 知识管理升级
- 整合前端升级
微服务开发框架升级
请按以下顺序依次进行升级部署,请不要随意调整升级顺序。升级后可能数据库结构会发生改变,故不能进行版本回退。文档升级命令中的RELEASE NAME是在基于分步安装文档之上编写的,若你在安装时指定了其他RELEASE NAME,请以你安装时指定的RELEASE NAME为准。一键部署安装的请执行helm list命令查看RELEASE NAME。
添加Choerodon Chart仓库
helm repo add c7n https://openchart.choerodon.com.cn/choerodon/c7n/
helm repo update
升级register server
- 升级服务
helm upgrade register-server c7n/go-register-server \
-f <(helm get values register-server) \
--version=0.9.0
验证升级
- 验证命令
curl $(kubectl get svc register-server -o jsonpath="{.spec.clusterIP}" -n choerodon-devops-prod):8000/eureka/apps
- 出现以下类似信息即为成功升级
{
"name": "go-register-server",
"instance": [
{
"instanceId": "192.168.3.19:go-register-server:8000",
"hostName": "192.168.3.19",
"app": "go-register-server",
"ipAddr": "192.168.3.19",
"status": "UP",
"overriddenstatus": "UNKNOWN",
"port": {
"@enabled": true,
"$": 8000
},
"securePort": {
"@enabled": false,
"$": 443
},
"countryId": 8,
"dataCenterInfo": {
"name": "MyOwn",
"@class": "com.netflix.appinfo.InstanceInfo$DefaultDataCenterInfo"
},
"leaseInfo": {
"renewalIntervalInSecs": 10,
"durationInSecs": 90,
"registrationTimestamp": 1528201698,
"lastRenewalTimestamp": 1528201698,
"evictionTimestamp": 0,
"serviceUpTimestamp": 1528201698
},
"metadata": {
"VERSION": "0.9.0"
},
"homePageUrl": "http://192.168.3.19:8000/",
"statusPageUrl": "http://192.168.3.19:8000/info",
"healthCheckUrl": "http://192.168.3.19:8000/health",
"vipAddress": "go-register-server",
"secureVipAddress": "go-register-server",
"isCoordinatingDiscoveryServer": true,
"lastUpdatedTimestamp": 1528201698,
"lastDirtyTimestamp": 1528201698,
"actionType": "ADDED"
}
]
}
升级config server
- 升级服务
helm upgrade config-server c7n/config-server \
-f <(helm get values config-server) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=config-server -o jsonpath="{.items[0].status.podIP}"):8011/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
升级manager service
- 升级服务
helm upgrade manager-service c7n/manager-service \
-f <(helm get values manager-service) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=manager-service -o jsonpath="{.items[0].status.podIP}"):8964/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
升级iam service
- 升级服务
helm upgrade iam-service c7n/iam-service \
-f <(helm get values iam-service) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=iam-service -o jsonpath="{.items[0].status.podIP}"):8031/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
部署notify service
原event store service由notify service和asgard service进行取代,请部署这两个服务。具体详情请查看这里
- 创建数据库
CREATE USER IF NOT EXISTS 'choerodon'@'%' IDENTIFIED BY "password";
CREATE DATABASE IF NOT EXISTS notify_service DEFAULT CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON notify_service.* TO choerodon@'%';
FLUSH PRIVILEGES;
- 部署服务
helm install c7n/notify-service \
--set preJob.preConfig.mysql.host=choerodon-mysql \
--set preJob.preConfig.mysql.port=3306 \
--set preJob.preConfig.mysql.database=manager_service \
--set preJob.preConfig.mysql.username=choerodon \
--set preJob.preConfig.mysql.password=password \
--set preJob.preInitDB.mysql.host=choerodon-mysql \
--set preJob.preInitDB.mysql.port=3306 \
--set preJob.preInitDB.mysql.database=notify_service \
--set preJob.preInitDB.mysql.username=choerodon \
--set preJob.preInitDB.mysql.password=password \
--set env.open.SPRING_DATASOURCE_URL="jdbc:mysql://choerodon-mysql:3306/notify_service?useUnicode=true&characterEncoding=utf-8&useSSL=false" \
--set env.open.SPRING_DATASOURCE_USERNAME=choerodon \
--set env.open.SPRING_DATASOURCE_PASSWORD=password \
--set env.open.EUREKA_CLIENT_SERVICEURL_DEFAULTZONE="http://register-server.choerodon-devops-prod:8000/eureka/" \
--set env.open.SPRING_CLOUD_CONFIG_ENABLED=true \
--set env.open.SPRING_CLOUD_CONFIG_URI="http://config-server.choerodon-devops-prod:8010/" \
--set env.open.CHOERODON_EVENT_CONSUMER_KAFKA_BOOTSTRAP_SERVERS="kafka-0.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-1.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-2.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092" \
--set env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_BROKERS="kafka-0.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-1.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-2.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092" \
--set env.open.SPRING_KAFKA_BOOTSTRAP_SERVERS="kafka-0.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-1.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-2.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092" \
--set env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_ZK_NODES="zookeeper-0.zookeeper-headless.choerodon-devops-prod.svc.cluster.local:2181\,zookeeper-1.zookeeper-headless.choerodon-devops-prod.svc.cluster.local:2181\,zookeeper-2.zookeeper-headless.choerodon-devops-prod.svc.cluster.local:2181" \
--name notify-service \
--version=0.9.0 --namespace=choerodon-devops-prod
参数名含义preJob.preConfig.mysql{}初始化配置所需manager_service数据库信息preJob.preInitDB.mysql{}初始化数据库所需数据库信息env.open.SPRING_DATASOURCE_URL数据库链接地址env.open.SPRING_DATASOURCE_USERNAME数据库用户名env.open.SPRING_DATASOURCE_PASSWORD数据库密码env.open.SPRING_CLOUD_CONFIG_ENABLED启用配置中心env.open.SPRING_CLOUD_CONFIG_URI配置中心地址env.open.EUREKA_CLIENT_SERVICEURL_DEFAULTZONE注册服务地址env.open.SPRING_KAFKA_BOOTSTRAP_SERVERSkafk地址env.open.CHOERODON_EVENT_CONSUMER_KAFKA_BOOTSTRAP_SERVERSkafk地址env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_BROKERSkafk地址env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_ZK_NODESzookeeper地址
验证部署
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=notify-service -o jsonpath="{.items[0].status.podIP}"):18086/health | jq -r .status
- 出现以下类似信息即为成功部署
UP
部署asgard service
- 创建数据库
CREATE USER IF NOT EXISTS 'choerodon'@'%' IDENTIFIED BY "password";
CREATE DATABASE IF NOT EXISTS asgard_service DEFAULT CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON asgard_service.* TO choerodon@'%';
FLUSH PRIVILEGES;
- 部署服务
helm install c7n/asgard-service \
--set preJob.preConfig.mysql.host=choerodon-mysql \
--set preJob.preConfig.mysql.port=3306 \
--set preJob.preConfig.mysql.database=manager_service \
--set preJob.preConfig.mysql.username=choerodon \
--set preJob.preConfig.mysql.password=password \
--set preJob.preInitDB.mysql.host=choerodon-mysql \
--set preJob.preInitDB.mysql.port=3306 \
--set preJob.preInitDB.mysql.database=asgard_service \
--set preJob.preInitDB.mysql.username=choerodon \
--set preJob.preInitDB.mysql.password=password \
--set env.open.SPRING_DATASOURCE_URL="jdbc:mysql://choerodon-mysql:3306/asgard_service?useUnicode=true&characterEncoding=utf-8&useSSL=false" \
--set env.open.SPRING_DATASOURCE_USERNAME=choerodon \
--set env.open.SPRING_DATASOURCE_PASSWORD=password \
--set env.open.EUREKA_CLIENT_SERVICEURL_DEFAULTZONE="http://register-server.choerodon-devops-prod:8000/eureka/" \
--set env.open.SPRING_CLOUD_CONFIG_ENABLED=true \
--set env.open.SPRING_CLOUD_CONFIG_URI="http://config-server.choerodon-devops-prod:8010/" \
--set env.open.CHOERODON_EVENT_CONSUMER_KAFKA_BOOTSTRAP_SERVERS="kafka-0.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-1.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-2.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092" \
--set env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_BROKERS="kafka-0.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-1.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-2.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092" \
--set env.open.SPRING_KAFKA_BOOTSTRAP_SERVERS="kafka-0.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-1.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092\,kafka-2.kafka-headless.choerodon-devops-prod.svc.cluster.local:9092" \
--set env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_ZK_NODES="zookeeper-0.zookeeper-headless.choerodon-devops-prod.svc.cluster.local:2181\,zookeeper-1.zookeeper-headless.choerodon-devops-prod.svc.cluster.local:2181\,zookeeper-2.zookeeper-headless.choerodon-devops-prod.svc.cluster.local:2181" \
--name asgard-service \
--version=0.9.0 --namespace=choerodon-devops-prod
参数名含义preJob.preConfig.mysql{}初始化配置所需manager_service数据库信息preJob.preInitDB.mysql{}初始化数据库所需数据库信息env.open.SPRING_DATASOURCE_URL数据库链接地址env.open.SPRING_DATASOURCE_USERNAME数据库用户名env.open.SPRING_DATASOURCE_PASSWORD数据库密码env.open.SPRING_CLOUD_CONFIG_ENABLED启用配置中心env.open.SPRING_CLOUD_CONFIG_URI配置中心地址env.open.EUREKA_CLIENT_SERVICEURL_DEFAULTZONE注册服务地址env.open.SPRING_KAFKA_BOOTSTRAP_SERVERSkafk地址env.open.CHOERODON_EVENT_CONSUMER_KAFKA_BOOTSTRAP_SERVERSkafk地址env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_BROKERSkafk地址env.open.SPRING_CLOUD_STREAM_KAFKA_BINDER_ZK_NODESzookeeper地址
验证部署
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=asgard-service -o jsonpath="{.items[0].status.podIP}"):18081/health | jq -r .status
- 出现以下类似信息即为成功部署
UP
升级api gateway
- 升级服务
helm upgrade api-gateway c7n/api-gateway \
-f <(helm get values api-gateway) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=api-gateway -o jsonpath="{.items[0].status.podIP}"):8081/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
升级gateway helper
- 升级服务
helm upgrade gateway-helper c7n/gateway-helper \
-f <(helm get values gateway-helper) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=gateway-helper -o jsonpath="{.items[0].status.podIP}"):9181/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
升级oauth server
- 升级服务
helm upgrade oauth-server c7n/oauth-server \
-f <(helm get values oauth-server) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=oauth-server -o jsonpath="{.items[0].status.podIP}"):8021/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
升级file service
- 升级服务
helm upgrade file-service c7n/file-service \
-f <(helm get values file-service) \
--version=0.9.0
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=file-service -o jsonpath="{.items[0].status.podIP}"):9091/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
DevOps服务升级
升级devops service
创建CRD
- 在任意master节点新建
C7NHelmRelease.yaml
文件,粘贴以下信息:
- 在任意master节点新建
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
name: c7nhelmreleases.choerodon.io
spec:
group: choerodon.io
names:
kind: C7NHelmRelease
listKind: C7NHelmReleaseList
plural: c7nhelmreleases
singular: c7nhelmrelease
scope: Namespaced
version: v1alpha1
- 执行以下命令进行部署:
kubectl apply -f C7NHelmRelease.yaml
确认Gitlab开启SSH协议
- 设置Gitlab启用SSH协议(必须开启)
- 升级服务
helm upgrade devops-service c7n/devops-service \
-f <(helm get values devops-service) \
--set env.open.AGENT_VERSION="0.9.6" \
--set env.open.TEMPLATE_VERSION_MICROSERVICE="0.9.0" \
--set env.open.TEMPLATE_VERSION_MICROSERVICEFRONT="0.9.0" \
--set env.open.TEMPLATE_VERSION_JAVALIB="0.9.0" \
--set env.open.SERVICES_GITLAB_SSHURL="gitlab.example.choerodon.io" \
--set env.open.SECURITY_IGNORED="/ci\,/webhook\,/v2/api-docs\,/agent/**\,/ws/**\,/webhook/**" \
--set env.open.SERVICES_GATEWAY_URL=http://api.example.choerodon.io \
--version=0.9.3
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=devops-service -o jsonpath="{.items[0].status.podIP}"):8061/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
- 升级之后,请用平台 admin 用户去调用 swagger-ui 里面devops-service平滑升级接口,用于给0.9版本以前的应用增加 GitOps ,扫回部署信息。
接口地址:http://api.example.choerodon.io/manager/swagger-ui.html
devops-service > devops-check-controler > 平滑升级接口:
version: 填写0.9
调用完之后可以查看devops-service的devops-check-log表里面的log字段查看平滑升级信息
升级gitlab service
- 升级服务
helm upgrade gitlab-service c7n/gitlab-service \
-f <(helm get values gitlab-service) \
--version=0.9.1
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=gitlab-service -o jsonpath="{.items[0].status.podIP}"):8071/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
敏捷管理升级
为保持Choerodon平台组件版本一致性,敏捷管理服务跳过0.7版本号,与其他服务组件版本号保持一致。
- 升级服务
helm upgrade agile-service c7n/agile-service \
-f <(helm get values agile-service) \
--version=0.9.1
验证升级
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=agile-service -o jsonpath="{.items[0].status.podIP}"):8379/health | jq -r .status
- 出现以下类似信息即为成功升级
UP
测试管理升级
- 升级服务
helm upgrade test-manager-service c7n/test-manager-service \
-f <(helm get values test-manager-service) \
--version=0.9.2
验证部署
- 验证命令
curl -s $(kubectl get po -n choerodon-devops-prod -l choerodon.io/release=test-manager-service -o jsonpath="{.items[0].status.podIP}"):8094/health | jq -r .status
- 出现以下类似信息即为成功部署
UP
知识管理升级
- 升级XWiki
XWiki-0.9.0版本需要依赖Choerodon微服务框架的0.9.0版本功能,在升级XWiki之前,请确保Choerodon微服务框架已经升级到0.9.0版本。
- 下载
Choerodon-wiki
从0.8.0
升级到0.9.0
的升级包Choerodon-wiki-0.9.0-update.rar
,下载地址为地址。 - 在XWiki的卷目录下的
/data/data
:- 编辑xwiki.properties文件,修改
oidc.endpoint.userinfo=http://localhost:8080/iam/v1/users/self
。 - 并在下一行添加一个参数
oidc.endpoint.logout=http://localhost:8080/oauth/logout
。 - 注意:域名需要修改为Choerodon平台网关的域名地址。
- 编辑xwiki.properties文件,修改
- 在XWiki的卷目录
/data/data/extension/repository
下,将下载到的升级包中的repository-0.9.0-update
目录下的内容复制进去。 - 使用admin用户进入系统设置: 设置–Content–导入
- 上传升级包中的
Choerodon-wiki-0.9.0-update.xar
。 - 点击上传成功的包,在右侧包内容下选择
给已有文档添加一个新的版本
,并点击导入,等待导入完成。
- 上传升级包中的
- 在浏览器地址栏中访问路径
/bin/view/ConfluenceTest
- 注:此时页面可能会错乱,是正常情况,下一步会修复。
- 点击页面右上角的更多,在弹出框中选择删除。
- 进入到删除页面,勾选
Affect children
, 并确认删除。
- 重启XWiki。
- 升级服务
helm upgrade wiki-service c7n/wiki-service \
-f <(helm get values wiki-service) \
--version=0.9.1
更新旧数据
- 打开
Choerodon
平台的swagger-ui
界面,url为http://localhost:8080/manager/swagger-ui.html
。 - 选择
wiki:wiki-service
,打开wiki-scanning-controller
,使用更新wiki系统主页
接口。 - 点击
Try it out!
之后,wiki系统就会将已经存在的空间首页替换为0.9.0版本最新的内容。
- 打开
整合前端升级
- 升级服务
前端添加了PRO_FILE_SERVER
用于指定文件存储服务Minio的地址,注意替换为真实的地址
helm upgrade choerodon-front c7n/choerodon-front \
-f <(helm get values choerodon-front) \
--set env.open.PRO_FILE_SERVER="http://minio.example.choerodon.io" \
--version=0.9.1
验证升级
- 验证命令
curl $(kubectl get svc choerodon-front -o jsonpath="{.spec.clusterIP}" -n choerodon-devops-prod)
- 出现以下类似信息即为成功升级
<!DOCTYPE html><html><head><meta http-equiv="Content-type"content="text/html; charset=utf-8"><title>Choerodon</title><link rel="shortcut icon"href="favicon.ico"></head><body><div id="app"></div><script type="text/javascript"src="app/vendor_19e4b950.js"></script><script type="text/javascript"src="app/main_19e4b950.js"></script></body></html>
在访问搭建好的Choerodon的api,
api.example.choerodon.io/manager/swagger-ui.html
,选择iam_service
->client-controller
->创建client
- 认证请使用用户名:admin,密码:admin
- 提交以下数据,注意正式搭建时请替换以下值为真实值
{
"accessTokenValidity": 60,
"additionalInformation": "",
"authorizedGrantTypes": "implicit,client_credentials,authorization_code,refresh_token",
"autoApprove": "default",
"name": "choerodon",
"objectVersionNumber": 0,
"organizationId": 1,
"refreshTokenValidity": 60,
"resourceIds": "default",
"scope": "default",
"secret": "secret",
"webServerRedirectUri": "http://choerodon.example.choerodon.io"
}