微服务开发框架升级

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

升级manager service

• 升级服务

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

• 验证升级

  • 验证命令

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

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

    UP

升级asgard service

• 升级服务

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

• 验证升级

  • 验证命令

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

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

    UP

升级notify service

• 升级服务

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

• 验证部署

  • 验证命令

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

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

    UP

移除 iam service

helm delete --purge iam-service

安装 base service

0.19以前的base-service的数据库为iam_service,0.19以后更名为base_service,对于配置文件中是使用iam_service还是base_service遵从一下标准： 如果是新安装的版本，就使用base_service，如果是升级上来的版本，原版本数据库使用的是什么数据库名称，配置文件中就配置对应的数据库名称

• 若需了解项目详情及各项参数含义，请移步 choerodon/base-service。

• 编写参数配置文件 base-service.yaml

  preJob:
    timeout: 300
    preConfig:
      datasource:
        url: jdbc:mysql://c7n-mysql.c7n-system.svc:3306/manager_service?useUnicode=true&characterEncoding=utf-8&useSSL=false&useInformationSchema=true&remarks=true
        username: choerodon
        password: password
    preInitDB:
      datasource:
        url: jdbc:mysql://c7n-mysql.c7n-system.svc:3306/iam_service?useUnicode=true&characterEncoding=utf-8&useSSL=false&useInformationSchema=true&remarks=true
        username: choerodon
        password: password
  env:
    open:
      SPRING_CLOUD_CONFIG_ENABLED: true
      SPRING_CLOUD_CONFIG_URI: http://register-server.c7n-system:8000/
      SPRING_DATASOURCE_URL: jdbc:mysql://c7n-mysql.c7n-system.svc/iam_service?useUnicode=true&characterEncoding=utf-8&useSSL=false&useInformationSchema=true&remarks=true
      SPRING_DATASOURCE_USERNAME: choerodon
      SPRING_DATASOURCE_PASSWORD: password
      SPRING_REDIS_HOST: c7n-redis.c7n-system.svc
      SPRING_REDIS_PORT: 6379
      SPRING_REDIS_DATABASE: 1
      EUREKA_CLIENT_SERVICEURL_DEFAULTZONE: http://register-server.c7n-system:8000/eureka/
      CHOERODON_GATEWAY_URL: http://api.example.choerodon.io

• 部署服务

  helm install c7n/base-service \
      -f base-service.yaml \
      --name base-service \
      --version 0.19.3 \
      --namespace c7n-system

• 验证部署

  • 验证命令

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

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

    UP

升级api gateway

• 升级服务

  helm upgrade api-gateway c7n/api-gateway \
      -f <(helm get values api-gateway) \
      --set env.open.SPRING_CACHE_MULTI_L1_ENABLED=true \
      --set env.open.SPRING_CACHE_MULTI_L2_ENABLED=false \
      --version 0.19.1

• 验证升级

  • 验证命令

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

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

    UP

升级oauth server

• 升级服务

  helm upgrade oauth-server c7n/oauth-server \
      -f <(helm get values oauth-server) \
      --version 0.19.2

• 验证升级

  • 验证命令

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

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

    UP

升级file service

• 升级服务

  helm upgrade file-service c7n/file-service \
      -f <(helm get values file-service) \
      --version 0.19.2

• 验证升级

  • 验证命令

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

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

    UP

DevOps服务升级

升级gitlab service

• 升级gitlab-service

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

• 验证升级

  • 验证命令

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

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

    UP

升级workflow service

• 升级workflow-service

  helm upgrade workflow-service c7n/workflow-service \
      -f <(helm get values workflow-service) \
      --version 0.19.0

• 验证升级

  • 验证命令

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

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

    UP

升级devops service

从0.17开始，开发管理可以选择接入SonarQube进行代码质量管理。如果不需要进行代码质量管理在kubernetes控制节点的服务器中执行如下命令: kubectl edit cm devops-service -n c7n-system 如果存在service.sonarqube.url的内容删除即可。

• 不需要代码质量管理执行如下命令升级服务:

  helm upgrade devops-service c7n/devops-service \
      --set env.open.AGENT_VERSION="0.19.2" \
      -f <(helm get values devops-service) \
      --version 0.19.10

• 如果需要代码质量管理，请参考安装文档安装Sonarqube后再根据Sonarqube的参数执行如下命令进行升级：

  helm upgrade devops-service c7n/devops-service \
      --set env.open.AGENT_VERSION="0.19.2" \
      --set env.open.SERVICES_SONARQUBE_URL="http://sonarqube.example.choerodon.io" \
      --set env.open.SERVICES_SONARQUBE_USERNAME="admin" \
      --set env.open.SERVICES_SONARQUBE_PASSWORD="admin" \
      -f <(helm get values devops-service) \
      --version 0.19.10

  • 验证命令

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

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

    UP

敏捷管理升级

移除state machine service

helm delete --purge state-machine-service

移除 issue service

helm delete --purge issue-service

移除foundation service

helm delete --purge foundation-service

升级agile service

注意：SERVICES_ATTACHMENT_URL上个版本包含agile-service的bucket。0.19版本需要去掉bucket，只需设置minio的地址即可。

• 升级服务

  helm upgrade agile-service c7n/agile-service \
      --set env.open.SERVICES_ATTACHMENT_URL=https://minio.choerodon.com.cn \
      -f <(helm get values agile-service) \
      --version 0.19.3

• 验证升级

  • 验证命令

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

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

    UP

测试管理升级

• 升级服务

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

• 验证部署

  • 验证命令

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

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

    UP

知识管理升级

• 移除xwiki helm delete --purge xwiki
• 移除wiki service helm delete --purge wiki-service

安装 elasticsearch-kb

• 安装 elasticsearch helm install c7n/elasticsearch-kb \ --version 0.19.0 \ --name elasticsearch-kb \ --namespace c7n-system

升级knowledgebase-service

• 升级服务

  helm upgrade knowledgebase-service c7n/knowledgebase-service \
      -f <(helm get values knowledgebase-service) \
      --set env.open.ELASTICSEARCH_IP=elasticsearch-kb.c7n-system:9200 \
      --version 0.19.2

• 验证部署

  • 验证命令

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

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

    UP

数据迁移

迁移数据库

执行0.19.0数据修复脚本，执行以下命令（HOST替换成对应参数）,并注意要查看修复程序执行日志确认是否执行成功

helm install c7n/choerodon-datafix \
    --set env.open.AgileDBHOST=c7n-mysql.c7n-system.svc \
    --set env.open.AgileDBPORT=3306 \
    --set env.open.AgileDBUSER=choerodon \
    --set env.open.AgileDBPASS=password \
    --set env.open.IssueDBHOST=c7n-mysql.c7n-system.svc \
    --set env.open.IssueDBPORT=3306 \
    --set env.open.IssueDBUSER=choerodon \
    --set env.open.IssueDBPASS=password \
    --set env.open.StateMachineDBHOST=c7n-mysql.c7n-system.svc \
    --set env.open.StateMachineDBPORT=3306 \
    --set env.open.StateMachineDBUSER=choerodon \
    --set env.open.StateMachineDBPASS=password \
    --set env.open.FoundationDBHOST=c7n-mysql.c7n-system.svc \
    --set env.open.FoundationDBPORT=3306 \
    --set env.open.FoundationDBUSER=choerodon \
    --set env.open.FoundationDBPASS=password \
    --set env.open.BaseDBHOST=c7n-mysql.c7n-system.svc \
    --set env.open.BaseDBPORT=3306 \
    --set env.open.BaseDBUSER=choerodon \
    --set env.open.BaseDBPASS=password \
    --set env.open.AsgardDBHOST=c7n-mysql.c7n-system.svc \
    --set env.open.AsgardDBPORT=3306 \
    --set env.open.AsgardDBUSER=choerodon \
    --set env.open.AsgardDBPASS=password \
    --version 0.19.0  \
    --name choerodon-datafix \
    --namespace c7n-system

清除 redis 旧的菜单和 api 统计数据

• 查看 api-gateway 所用 redis index (SPRING_REDIS_DATABASE)

  helm get values api-gateway

• 清理数据，以下命令中 select 5 的 5 即为 SPRING_REDIS_DATABASE 的值，请按实际情况修改

  kubectl get po -n c7n-system
  kubectl exec -it c7n-redis-xxxx -n c7n-system bash
  redis-cli
  select 5
  flushdb

清理管理服务菜单权限缓存数据

kubectl get po -n c7n-system
kubectl exec -it c7n-mysql-xxxx -n c7n-system bash
mysql -h 127.0.0.1 -u choerodon -ppassword
use manager_service;
truncate table mgmt_actuator;

重启 manager-service ，重新初始化菜单权限数据

kubectl scale deployment manager-service --replicas=0 -n c7n-system
kubectl scale deployment manager-service --replicas=1 -n c7n-system

整合前端升级

• 升级服务

  helm upgrade choerodon-front c7n/choerodon-front \
      --set env.open.API_HOST=http://api.example.choerodon.io \
      --set env.open.CLIENT_ID=choerodon \
      --set env.open.DEVOPS_HOST=ws://devops.example.choerodon.io \
      --set env.open.FILE_SERVER=http://minio.example.choerodon.io \
      --set env.open.HEADER_TITLE_NAME=Choerodon \
      --set env.open.HTTP=http \
      --set env.open.WEBSOCKET_SERVER=ws://notify.example.choerodon.io \
      --set env.open.COOKIE_SERVER= \
      --set env.open.CUSTOM_THEME_COLOR= \
      --set ingress.host="c7n.example.choerodon.io" \
      --set service.enabled=true \
      --set ingress.enabled=true \
      --version 0.19.6 \

• 验证升级

  • 验证命令

  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>

迁移DevOps数据

调用Devops迁移数据接口

• 同步harbor用户（如已经调用无需再次调用）

从0.18.13以下的版本升级到0.18.13以及以上的版本时，为了在gitlab-ci中使用每个项目单独的用户去推送镜像，需要手动调用api去同步创建harbor用户,请使用管理员用户登陆平台，在管理界面的平台服务->平台接口->devops-service->devops-check-controller里面调用数据修复接口，参数传入为0.18.13，记得检查gitlab-ci.yaml文件内docker login时的参数是否为 DOCKER_USERNAME和DOCKER_PASSWORD

• 同步集群

从0.19.5以下的版本升级到0.19.5以及以上的版本时，为了将原来组织下的集群迁移到项目下，并为组织创建默认运维项目，需要手动调用api去同步创建项目。请使用管理员用户登陆平台，在管理界面的平台服务->平台接口->devops-service->devops-check-controller里面调用数据修复接口，参数传入为0.19.5

• SonarQube插件升级

对于已经安装了的SonarQube，升级choerodon到0.19.x时对应的SonarQube插件版本也要升级到sonar-auth-choerodonoauth-plugin-1.5.2-RELEASE.jar