From: 刘洪青 <hongqing.liu@supwisdom.com>
Date: Tue, 21 Sep 2021 11:02:35 +0000 (+0800)
Subject: chore: 认证授权服务升级文档（V1.3-V1.4）
X-Git-Url: https://source.supwisdom.com/gerrit/gitweb?a=commitdiff_plain;h=95e88a62ebb88310b418635518c5c714e3784ab0;p=institute%2Fdeploy-authx-service.git

chore: 认证授权服务升级文档（V1.3-V1.4）
---

diff --git "a/deploy-manifests/k8s-rancher/0.1.4.\350\256\244\350\257\201\346\216\210\346\235\203\346\234\215\345\212\241\345\215\207\347\272\247\346\226\207\346\241\243\357\274\210V1.3-V1.4\357\274\211.md" "b/deploy-manifests/k8s-rancher/0.1.4.\350\256\244\350\257\201\346\216\210\346\235\203\346\234\215\345\212\241\345\215\207\347\272\247\346\226\207\346\241\243\357\274\210V1.3-V1.4\357\274\211.md"
new file mode 100644
index 0000000..fbcb3ac
--- /dev/null
+++ "b/deploy-manifests/k8s-rancher/0.1.4.\350\256\244\350\257\201\346\216\210\346\235\203\346\234\215\345\212\241\345\215\207\347\272\247\346\226\207\346\241\243\357\274\210V1.3-V1.4\357\274\211.md"
@@ -0,0 +1,155 @@
+
+# 认证授权服务升级文档（V1.3 ~ V1.4）
+
+
+## 部署变更说明
+
+对本次升级进行的简要说明，具体的升级步骤，详见 **升级说明**
+
+1. 数据库用户变更
+
+新增，authx_log
+（可选）移除，agent_service
+
+2. 镜像变更
+
+新增，authx-log
+新增，attest-server
+
+3. 域名变更
+
+（可选）新增，域名 authx-service，将 personal-security-center、security-center、以及 authx-management 合并
+（可选）废弃，域名 personal-security-center，合并至 域名 authx-service
+（可选）废弃，域名 security-center，合并至 域名 authx-service
+（可选）迁移，原域名 authx-management 挂在 域名 admin-platform 域名下，现合并至 authx-service
+（可选）废弃，域名 token，合并至 域名 cas
+
+4. Context Path 变更
+
+（可选）变更，personal-security-center-zuul，context path 更新为 /personal
+（可选）变更，token-server，context path 更新为 /token
+
+5. 访问地址变更
+
+（可选）变更，用户认证授权管理前端UI，`https://admin-platform.paas.xxx.edu.cn/authx-management` 变更为 `https://authx-service.paas.xxx.edu.cn/authx-management`
+（可选）变更，安全中心后端API，`https://personal-security-center.paas.xxx.edu.cn` 变更为 `https://authx-service.paas.xxx.edu.cn/personal`
+（可选）变更，Token 认证，`https://token.paas.xxx.edu.cn` 变更为 `https://cas.pass.xxx.edu.cn/token`
+
+6. 部署yaml 变更
+
+新增，7.attest-server
+新增，8.authx-log
+
+新增，0.authx-service，4.4.authx-service-bff.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+
+新增，1.thirdparty-agent-service，4.2.thirdparty-agent-service.yaml，ConfigMap 增加 人脸服务对接配置 `FACE_*`
+
+新增，2.user-data-service，4.1.user-data-service-poa.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+新增，2.user-data-service，4.2.user-data-service-goa.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+新增，2.user-data-service，4.3.user-data-service-biz.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+
+新增，3.user-authorization-service，4.1.user-authorization-poa.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+新增，3.user-authorization-service，4.2.user-authorization-sa.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+
+新增，4.cas-server，4.2.cas-server-sa-api.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+新增，4.cas-server，4.5.cas-server-site-webapp.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+
+新增，5.token-server，4.1.token-server.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+变更，5.token-server，4.1.token-server.yaml，ConfigMap 修改 将 `SPRING_RABBITMQ_*` 调整为 `USER_RABBITMQ_*`
+（可选）新增，5.token-server，4.1.token-server.yaml，ConfigMap 增加 context path 配置 `SERVER_SERVLET_CONTEXT_PATH: /token`
+（可选）变更，5.token-server，4.1.token-server.yaml，ConfigMap 修改 `TOKEN_SERVER_PREFIX: https://cas.paas.xxx.edu.cn/token`
+
+新增，6.personal-security-center，4.4.personal-security-center-bff.yaml，ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+（可选）新增，6.personal-security-center，4.5.personal-security-center-zuul.yaml，ConfigMap 增加 context path 配置 `SERVER_SERVLET_CONTEXT_PATH: /personal`
+（可选）变更，6.personal-security-center，4.4.personal-security-center-bff.yaml，ConfigMap 修改 `PERSONAL_SECURITY_CENTER_SERVER_PREFIX: https://authx-service.paas.xxx.edu.cn/personal`
+（可选）变更，6.personal-security-center，4.5.personal-security-center-zuul.yaml，ConfigMap 修改 `APP_SERVER_HOST_URL: https://authx-service.paas.xxx.edu.cn/personal`
+（可选）变更，6.personal-security-center，4.5.personal-security-center-zuul.yaml，ConfigMap 修改 `APPLICATION_INDEX_REDIRECT_URI: https://authx-service.paas.xxx.edu.cn`
+（可选）变更，6.personal-security-center，4.9.security-center-ui.yaml，ConfigMap 修改 `MAIN_SERVER: https://authx-service.paas.xxx.edu.cn`
+（可选）变更，6.personal-security-center，4.9.security-center-ui.yaml，ConfigMap 修改 `PERSONAL_CENTER_API: https://authx-service.paas.xxx.edu.cn/personal`
+
+
+## 升级说明
+
+1. 将 工作负载 下的服务 升级到 1.4.x 版本（注意，先执行 `*-installer`）
+
+2. 部署 7.attest-server
+
+3. 部署 8.authx-log
+
+4. ConfigMap 增加 日志服务相关配置 `AUTHX_LOG_*`
+   包括：
+   authx-service-bff
+   user-data-service-poa
+   user-data-service-goa
+   user-data-service-biz
+   user-authorization-poa
+   user-authorization-sa
+   cas-server-sa-api
+   cas-server-site-webapp
+   token-server
+   personal-security-center-bff
+
+5. token-server，ConfigMap 增加 `USER_RABBITMQ_*`
+
+6. （可选）调整 authx-management-ingress 的 host 为 authx-service.paas.xxx.edu.cn
+
+7. （可选，和 6 一起修改）修改 ConfigMap admin-platform/admin-platform-spa-env 下的配置项 `CAS_SERVER_SPA_URL`, `USER_SERVER_SPA_URL`, `AUTH_SERVER_SPA_URL`
+
+  ```
+  CAS_SERVER_SPA_URL: https://authx-service.paas.xxx.edu.cn/authx-management/cas-server
+  USER_SERVER_SPA_URL: https://authx-service.paas.xxx.edu.cn/authx-management/user-server
+  AUTH_SERVER_SPA_URL: https://authx-service.paas.xxx.edu.cn/authx-management/auth-server
+  ```
+
+8. （可选）token-server，ConfigMap 增加 context path 配置 `SERVER_SERVLET_CONTEXT_PATH: /token`
+9. （可选，和 8 一起修改）调整 token-server-ingress 下 token-server-svc 对应的 path 为 /token
+
+10. （可选）调整 token-server-ingress 的 host 为 cas.paas.xxx.edu.cn；调整 host 后，必须增加 context path 配置（即 8、9）
+
+  注：
+  若 修改了 token-server 的 context path、或 调整了host，则须调整 超级APP 的配置
+
+11. （可选）修改 token-server 的 ConfigMap
+
+  `TOKEN_SERVER_PREFIX: https://cas.paas.xxx.edu.cn/token`
+  注：
+  若 context path 未配置，则不修改；
+  若 host 未调整，则修改为 `https://token.paas.xxx.edu.cn/token`
+
+12. （可选）personal-security-center-zuul，ConfigMap 增加 context path 配置 `SERVER_SERVLET_CONTEXT_PATH: /personal`
+13. （可选，和 12 一起修改）调整 personal-security-center-ingress 下 personal-security-center-zuul-svc 对应的 path 为 /personal
+
+14. （可选）调整 personal-security-center-ingress 的 host 为 authx-service.paas.xxx.edu.cn；调整 host 后，必须增加 context path 配置（即 12、13）
+
+  注：
+  若 修改了 personal-security-center-zuul 的 context path、或 调整了host，则须调整 超级APP 的配置、门户个人中心 的配置
+
+15. （可选）调整 security-center-ingress 的 host 为 authx-service.paas.xxx.edu.cn
+
+14. （可选）修改 personal-security-center-zuul 的 ConfigMap
+
+  `PERSONAL_SECURITY_CENTER_SERVER_PREFIX: https://authx-service.paas.xxx.edu.cn/personal`
+  注：
+  若 context path 未配置，则不修改；
+  若 host 未调整，则修改为 `https://personal-security-center.paas.xxx.edu.cn/personal`
+
+  `APP_SERVER_HOST_URL: https://authx-service.paas.xxx.edu.cn/personal`
+  注：
+  若 context path 未配置，则不修改；
+  若 host 未调整，则修改为 `https://personal-security-center.paas.xxx.edu.cn/personal`
+
+  `APPLICATION_INDEX_REDIRECT_URI: https://authx-service.paas.xxx.edu.cn` （若 host 未调整，则不修改）
+
+
+15. （可选）修改 security-center-ui 的 ConfigMap
+
+  `MAIN_SERVER: https://authx-service.paas.xxx.edu.cn` （若 host 未调整，则不修改）
+
+  `PERSONAL_CENTER_API: https://authx-service.paas.xxx.edu.cn/personal`
+  注：
+  若 context path 未配置，则不修改；
+  若 host 未调整，则修改为 `https://personal-security-center.paas.xxx.edu.cn/personal`
+
+
+
+