升级指南 - 从0.11升级到0.12 - 《Choerodon(猪齿鱼) v0.15 中文文档》

基础组件调整
微服务开发框架升级
DevOps服务升级
- 升级devops service
- 升级gitlab service
敏捷管理升级
测试管理升级
知识管理升级
整合前端升级

基础组件调整

0.12版本我们去掉了zookeeper和kafka组件，故依赖这两个组件的服务参数需要做出调整。

微服务开发框架升级

请按以下顺序依次进行升级部署，请不要随意调整升级顺序。升级后可能数据库结构会发生改变，故不能进行版本回退。文档升级命令中的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

注意事项

如果报错提示job已存在，直接直接下述命令删除历史job即可

  kubectl delete job --all -n c7n-system

升级register server

升级服务

helm upgrade register-server c7n/go-register-server \
    -f <(helm get values register-server) \
    --version 0.12.0

验证升级
- 验证命令

curl $(kubectl get svc register-server -o jsonpath="{.spec.clusterIP}" -n c7n-system):8000/eureka/apps

出现以下类似信息即为成功升级

{
    "name": "go-register-server",
    "instance": [
    {
    "instanceId": "10.233.64.95:go-register-server:8000",
    "hostName": "10.233.64.95",
    "app": "go-register-server",
    "ipAddr": "10.233.64.95",
    "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": 1545095590,
        "lastRenewalTimestamp": 1545095590,
        "evictionTimestamp": 0,
        "serviceUpTimestamp": 1545095590
    },
    "metadata": {
        "VERSION": "0.12.0"
    },
    "homePageUrl": "http://10.233.64.95:8000/",
    "statusPageUrl": "http://10.233.64.95:8000/info",
    "healthCheckUrl": "http://10.233.64.95:8000/health",
    "vipAddress": "go-register-server",
    "secureVipAddress": "go-register-server",
    "isCoordinatingDiscoveryServer": true,
    "lastUpdatedTimestamp": 1545095590,
    "lastDirtyTimestamp": 1545095590,
    "actionType": "ADDED"
    }
    ]
}

升级config server

升级服务

helm upgrade config-server c7n/config-server \
    -f <(helm get values config-server) \
    --version 0.12.0

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=config-server -o jsonpath="{.items[0].status.podIP}"):8011/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级manager service

0.12版本manager service需要连接Redis数据库，请根据集群内的Redis数据库地址，替换以下参数env.open.SPRING_REDIS_HOST、env.open.SPRING_REDIS_PORT的值。

升级服务(注意redis地址如果您使用一键安装请修改为redis.c7n-system.svc)

helm upgrade manager-service c7n/manager-service \
    --set env.open.SPRING_REDIS_HOST=c7n-redis.c7n-system.svc \
    --set env.open.SPRING_REDIS_PORT=6379 \
    --set env.open.SPRING_REDIS_DATABASE=1 \
    -f <(helm get values manager-service) \
    --version 0.12.1

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=manager-service -o jsonpath="{.items[0].status.podIP}"):8964/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级asgard service

升级服务

helm upgrade asgard-service c7n/asgard-service \
    -f <(helm get values asgard-service) \
    --version 0.12.1

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=asgard-service -o jsonpath="{.items[0].status.podIP}"):18081/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级notify service

升级服务

helm upgrade notify-service c7n/notify-service \
    -f <(helm get values notify-service) \
    --version 0.12.1

验证部署
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=notify-service -o jsonpath="{.items[0].status.podIP}"):18086/health | jq -r .status

出现以下类似信息即为成功部署

UP

升级iam service

升级服务

helm upgrade iam-service c7n/iam-service \
    -f <(helm get values iam-service) \
    --version 0.12.1

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=iam-service -o jsonpath="{.items[0].status.podIP}"):8031/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级api gateway

升级服务

helm upgrade api-gateway c7n/api-gateway \
    -f <(helm get values api-gateway) \
    --version 0.12.0

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -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.12.0

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -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.12.0

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -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.12.0

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=file-service -o jsonpath="{.items[0].status.podIP}"):9091/health | jq -r .status

出现以下类似信息即为成功升级

UP

DevOps服务升级

升级devops service

0.12版本devops service增加了env.open.TEMPLATE_VERSION_CHOERODONMOCHATEMPLATE和env.open.AGENT_CERTMANAGERURL两个参数。并且env.open.TEMPLATE_VERSION_MICROSERVICE、env.open.TEMPLATE_VERSION_MICROSERVICEFRONT、env.open.TEMPLATE_VERSION_JAVALIB均为0.9.0版本。

升级服务

helm upgrade devops-service c7n/devops-service \
    --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.TEMPLATE_VERSION_CHOERODONMOCHATEMPLATE="0.12.1" \
    --set env.open.AGENT_VERSION="0.12.0" \
    --set env.open.AGENT_CERTMANAGERURL="https://openchart.choerodon.com.cn/choerodon/infra/" \
    -f <(helm get values devops-service) \
    --version 0.12.2

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=devops-service -o jsonpath="{.items[0].status.podIP}"):8061/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级gitlab service

升级服务

helm upgrade gitlab-service c7n/gitlab-service \
    -f <(helm get values gitlab-service) \
    --version 0.12.0

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=gitlab-service -o jsonpath="{.items[0].status.podIP}"):8071/health | jq -r .status

出现以下类似信息即为成功升级

UP

敏捷管理升级

0.12版本agile service需要连接wiki，请根据集群内的wiki地址和OIDC TOKEN值，替换以下参数env.open.SERVICES_WIKI_HOST、env.open.SERVICES_WIKI_TOKEN的值。注意env.open.SERVICES_WIKI_TOKEN与xwiki的env.OIDC_ENDPOINT_TOKEN、wiki-service的env.open.WIKI_TOKEN 这三者的值必须一致。可使用helm get values xwiki查看并使用env.OIDC_ENDPOINT_TOKEN中的token值。

升级agile service

升级服务

helm upgrade agile-service c7n/agile-service \
    --set env.open.SERVICES_WIKI_HOST="http://wiki.example.choerodon.io" \
    --set env.open.SERVICES_WIKI_TOKEN="Choerodon" \
    -f <(helm get values agile-service) \
    --version 0.12.1

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=agile-service -o jsonpath="{.items[0].status.podIP}"):8379/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级state machine service

升级服务

helm upgrade state-machine-service c7n/state-machine-service \
    -f <(helm get values state-machine-service) \
    --version 0.12.3

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=state-machine-service -o jsonpath="{.items[0].status.podIP}"):8385/health | jq -r .status

出现以下类似信息即为成功升级

UP

升级issue service

升级服务

helm upgrade issue-service c7n/issue-service \
    -f <(helm get values issue-service) \
    --version 0.12.1

验证升级
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=issue-service -o jsonpath="{.items[0].status.podIP}"):8381/health | jq -r .status

出现以下类似信息即为成功升级

UP

测试管理升级

升级服务

helm upgrade test-manager-service c7n/test-manager-service \
    -f <(helm get values test-manager-service) \
    --version 0.12.2

验证部署
- 验证命令

curl -s $(kubectl get po -n c7n-system -l choerodon.io/release=test-manager-service -o jsonpath="{.items[0].status.podIP}"):8094/health | jq -r .status

出现以下类似信息即为成功部署

UP

知识管理升级

请注意：xwiki的env.OIDC_ENDPOINT_TOKEN、wiki-service的env.open.WIKI_TOKEN与agile-service 的env.open.SERVICES_WIKI_TOKEN这三者的值必须一致。

升级XWiki
XWiki-0.12.1版本需要依赖Choerodon微服务框架的0.12.0版本功能，在升级XWiki之前，请确保Choerodon微服务框架已经升级到0.12.0版本。
安装xwiki的0.12.1版本

helm upgrade xwiki c7n/xwiki \
    -f <(helm get values xwiki) \
    --version 0.12.1

等待xwiki安装启动完成，使用admin用户登录wiki系统(直接访问wiki系统的域名)，然后点击顶部导航栏右侧的齿轮（设置）按钮，进入系统设置：设置->内容->导入，进入到导入的设置页，然后上传Choerodon-wiki-0.12.1-update.xar更新包，下载地址。
上传成功之后，点击刚上传的xar包，在页面右侧会出现需要导入的包的内容，滚动页面到最下方，点击导入按钮，等待导入完成即可。
升级wiki-service服务

helm upgrade wiki-service c7n/wiki-service \
    -f <(helm get values wiki-service) \
    --version 0.12.0

整合前端升级

升级服务

helm upgrade choerodon-front c7n/choerodon-front \
    -f <(helm get values choerodon-front) \
    --version 0.12.3

验证升级
- 验证命令

curl $(kubectl get svc choerodon-front -o jsonpath="{.spec.clusterIP}" -n c7n-system)

出现以下类似信息即为成功升级

<!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>