项目上线流程

容器云平台镜像版本统一与升级操作手册

一、前置说明

（一）操作目标

1. 统一容器云平台（http://10.254.240.211/#!/home）中指定镜像的版本并完成编译锁定；

2. 修改 KubeBiz 平台（https://www.kubebiz.com/）对应镜像版本配置；

3. 后台服务器（10.0.19.238）新增升级所需内容；

4. 同步更新平台安装文档（https://cloud-help.mandao.com/docs/cloud/install-core）。

（二）前置准备

1. 确保已获取各平台登录账号及权限：

• 容器云平台：管理员账号（admin/Superme@01）或测试账号（test/Cloud@888）；
• KubeBiz 平台：对应操作权限账号；
• 后台服务器：root 账号（用户名：root，密码：baofoo@64）。

2. 操作环境要求：

• 容器云平台操作需在已完成 NFS 存储安装的环境中执行；
• 所有服务器操作需确保网络通畅，能够正常拉取镜像及脚本文件；
• 后台服务器操作需在 node01 服务器上执行（统一操作环境）。

二、容器云平台操作（http://10.254.240.211/#!/home）

（一）登录平台

1. 打开浏览器，输入平台地址：http://10.254.240.211/#!/home；

2. 在登录页面输入账号密码（管理员账号：admin/Superme@01 或测试账号：test/Cloud@888）；

3. 点击 “登录” 按钮，进入容器云平台首页。

（二）选择镜像信息

1. 登录成功后，在平台顶部导航栏依次点击【云服务】→【模板市场】→【镜像】，进入镜像管理页面；

2. 页面将展示容器云 - 51 环境下的所有镜像列表，包含镜像名称、组织、镜像版本数、创建人邮箱、最新版本、更新时间及操作列（示例镜像包括 logging-server、cloud-terminal-server、cloud-config-server 等）；

3. 确认需统一版本的目标镜像范围（建议全量选择列表中所有镜像），核对当前各镜像的版本信息（当前部分镜像最新版本为 3.42.0，部分为 3.39.x 系列）。

（三）统一编译相同版本

1. 选择首个需编译的镜像（如 cloud-server），点击该镜像操作列的相关配置入口，进入镜像编译配置页面；

2. 在编译配置页面按以下参数设置：

   • 镜像名称：确认目标镜像名称（如 cloud-server）；
   • 镜像版本：输入统一目标版本号（建议与现有最新版本 3.42.0 保持一致）；
   • 目标镜像仓库：选择 “容器云对外仓库”，仓库地址自动填充为 dockerhub.mandao.com/cloud/[镜像名称]；
   • 版本设置：取消 “固定版本” 和 “作为 latest 版本” 勾选（如需设置为 latest 可根据需求调整）；
   • 镜像保留个数：设置为 3（可根据实际需求调整保留的历史版本数量）；
   • 外部文件（可选）：无需添加，保持默认配置；
   • 镜像规则（可选）：勾选 “增加日期后缀”（如需追溯编译时间，无需则取消）；
   • 编译命令：确认默认编译命令（如 RUN cp /usr/share/zoneinfo/Asia/Shanghai/etc/localtime COPY cloud/web/target/cloud.jar/data/appdeploy），无需修改则保持默认。

3. 配置完成后，点击页面底部 “保存” 按钮，再点击 “开始编译”，启动镜像编译流程；

4. 重复步骤 1-3，依次对镜像列表中所有镜像执行相同配置的编译操作，确保所有镜像均统一编译为目标版本（3.42.0）；

5. 编译过程中可通过【持续交付】→【编译记录】查看各镜像编译进度，若编译失败，可查看日志排查问题（常见问题为网络中断、镜像依赖缺失，需确保网络通畅并补充依赖）。

（四）编译完成后锁定版本

1. 所有镜像编译完成后，返回【镜像】→【镜像版本】页面（或通过镜像名称进入单个镜像的版本管理页面）；

2. 版本列表中将显示各镜像已编译完成的目标版本（3.42.0），找到对应版本行，点击操作列的 “锁定” 按钮；

3. 弹出锁定确认弹窗，点击 “确认” 完成版本锁定；

4. 锁定完成后，版本列表中 “锁定” 列将显示锁定状态，锁定后的版本无法被删除或覆盖，确保版本稳定性；

5. 批量操作说明：若支持批量锁定，可勾选所有已编译完成目标版本的镜像，点击页面顶部 “批量解锁” 旁的 “批量锁定” 按钮，一次性完成所有版本锁定（若平台无批量锁定功能，则按单个版本锁定操作）。

三、KubeBiz 平台操作（https://www.kubebiz.com/）

（一）登录平台

1. 打开浏览器，输入平台地址：https://www.kubebiz.com/；

2. 输入已授权的账号密码，点击 “登录” 进入 KubeBiz 平台首页。

（二）修改对应镜像版本

1. 在平台顶部导航栏点击【Kubernetes Config Repositories】，进入配置仓库管理页面；

2. 找到对应容器云平台的配置仓库（命名通常包含 “manager” 或 “cloud” 关键字），点击仓库名称进入文件管理页面；

3. 页面将显示仓库下所有配置文件（如 namespace.yaml、database.yaml、manager-core.yaml、cloud-module.yaml、monitoring-server.yaml 等），根据镜像类型修改对应配置文件：

   • 对于 cloud-server 相关配置：打开 cloud-module.yaml，找到 “image” 字段，将版本号修改为目标版本（3.42.0），示例：dockerhub.mandao.com/cloud/cloud-server:3.42.0；
   • 对于监控类镜像（如 monitoring-server、monitoring-alert-callback-server 等）：打开 monitoring-server.yaml 或对应监控模块配置文件，将镜像版本统一修改为 3.42.0；
   • 其他镜像（如 logging-server、cloud-terminal-server 等）：在对应的配置文件（如 manager-core.yaml、service.yaml 等）中找到对应镜像地址，修改版本号为 3.42.0。

4. 版本补充：在配置文件顶部 “Versions” 下拉框中，点击【– Add New Version –】，输入新版本名称（如 3.42.0），关联修改后的配置文件，确保新版本配置生效；

5. 若需保留历史版本，可在 “Versions” 中保留原版本（如 3.39.0、3.30.0 等），新增 3.42.0 版本作为当前生效版本；

6. 修改完成后，点击页面底部 “Save” 按钮保存配置，确保配置同步至容器云平台。

四、后台服务器操作（10.0.19.238）

（一）登录后台管理服务器

1. 打开终端工具（如 Xshell、SecureCRT 等），新建 SSH 连接；

2. 连接参数配置：

   • 主机地址：10.0.19.238；
   • 端口号：22（默认 SSH 端口）；
   • 用户名：root；
   • 密码：baofoo@64；

3. 输入参数后点击 “连接”，验证密码通过后，成功登录服务器终端。

   （二）进入目标目录

4. 在终端中执行以下命令，切换至目标目录：

   cd /data/nfs/manager-pvc-cloud-help-center-uploads-pvc-1724794a-e88f-4dac-bfad-2fecf9ee26e9/cloud/install/platform

5. 执行以下命令，查看当前目录下已有的版本文件夹及文件：

   ls -l

6. 确认目录下已存在的版本（如 2.4.3、3.10.0、3.39.0 等），确保目录路径正确。

   （三）新增相应内容

7. 执行以下命令，创建目标版本（3.42.0）的文件夹：

   mkdir -p 3.42.0

8. 进入新增的 3.42.0 文件夹：

   cd 3.42.0

9. 下载或复制对应版本的安装脚本至该文件夹，执行以下命令获取完整版、存储化最小化、虚拟化最小化安装脚本（与 3.39.0 版本脚本结构一致，版本号替换为 3.42.0）：

# 完整版安装脚本
wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/3.42.0/install.sh -O install.sh
# 存储化最小化安装脚本
wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/3.42.0/install-mini-mStore.sh -O install-mini-mStore.sh
# 虚拟化最小化安装脚本
wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/3.42.0/install-mini-mStack.sh -O install-mini-mStack.sh
# 插件配置脚本
wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/plugins/download-plugin.sh -O download-plugin.sh

4. 若无法通过 wget 下载，可将 3.39.0 版本的脚本复制至 3.42.0 文件夹，再修改脚本内的版本号为 3.42.0（需确保脚本内所有涉及版本的路径、参数均同步更新）：

# 复制 3.39.0 版本脚本至 3.42.0 文件夹
cp ../3.39.0/*.sh ./
# 修改脚本内版本号（以 install.sh 为例）
sed -i 's/3.39.0/3.42.0/g' install.sh
sed -i 's/3.39.0/3.42.0/g' install-mini-mStore.sh
sed -i 's/3.39.0/3.42.0/g' install-mini-mStack.sh

5. 执行以下命令，添加脚本执行权限：

chmod +x *.sh

6. 确认新增内容：执行 ls -l 查看 3.42.0 文件夹下是否包含上述 4 个脚本文件，且权限为 “-rwxr-xr-x”（可执行权限）。

五、更新升级内容（https://cloud-help.mandao.com/docs/cloud/install-core）

（一）访问安装文档页面

1. 打开浏览器，输入文档地址：https://cloud-help.mandao.com/docs/cloud/install-core；

2. 若文档需要登录，使用容器云平台管理员账号（admin/Superme@01）登录后进入文档页面。

（二）编辑文档更新升级内容

1. 点击文档页面顶部 “编辑” 按钮（通常位于页面右上角，需编辑权限），进入文档编辑模式；

2. 按以下内容更新文档：

   • 文档标题补充：在原标题 “容器云平台安装” 后添加 “（3.42.0 版本升级）”，明确版本信息；
   • 前置须知更新：补充 “本次升级需将所有镜像统一编译为 3.42.0 版本，且已完成镜像版本锁定，确保升级一致性”；
   • 安装脚本更新：将 “第一步：部署容器云平台” 中的 3.39.0 版本脚本路径替换为 3.42.0 版本，更新后脚本如下：

     # 完整版安装（3.42.0 版本）
     wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/3.42.0/install.sh | bash
     # 存储化最小化安装（3.42.0 版本）
     wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/3.42.0/install-mini-mStore.sh | bash
     # 虚拟化最小化安装（3.42.0 版本）
     wget -qO- https://cloud-help.mandao.com/uploads/cloud/install/platform/3.42.0/install-mini-mStack.sh | bash

   • 安装成功效果更新：替换原有的 pod 运行状态示例，补充 3.42.0 版本镜像对应的 pod 信息（如 cloud-server-68549787fc-rprhz（3.42.0）、monitoring-server-xxx（3.42.0）等）；
   • 升级说明补充：在文档末尾新增 “3.42.0 版本升级说明”，内容如下：
   • 本次升级统一了容器云 - 51 环境下所有镜像版本至 3.42.0，包含 logging-server、cloud-terminal-server、cloud-config-server 等核心镜像；
   • 升级前需确保所有镜像已完成编译并锁定，避免版本冲突；
   • 升级过程中若出现 pod 启动失败，可通过 kubectl logs [pod名称] -n manager 查看日志，排查镜像拉取失败或配置错误问题；
   • 升级完成后，需登录 KubeBiz 平台确认配置文件版本同步更新，确保集群运行配置与镜像版本一致。

3. 编辑完成后，点击页面底部 “保存” 按钮，提交文档更新；

4. 保存后，刷新文档页面，验证更新内容是否生效，确保脚本路径、版本号、升级说明均正确显示。

六、操作验证与注意事项

（一）操作验证

1. 容器云平台验证：

   • 进入【镜像】→【镜像版本】，确认所有镜像目标版本（3.42.0）已锁定；
   • 执行命令 kubectl get pod -n manager，查看所有 pod 对应的镜像版本是否为 3.42.0，且状态为 “Running”。

2. KubeBiz 平台验证：

   • 进入配置文件详情页，确认所有镜像地址版本已更新为 3.42.0；
   • 查看集群运行状态，确保无配置冲突导致的服务异常。

3. 后台服务器验证：

   • 进入 /data/nfs/manager-pvc-cloud-help-center-uploads-pvc-1724794a-e88f-4dac-bfad-2fecf9ee26e9/cloud/install/platform/3.42.0 目录，执行 ./install.sh –version（若脚本支持版本查询），验证脚本版本为 3.42.0。

4. 文档验证：

   • 访问文档页面，确认所有脚本路径、版本号、升级说明已更新正确。

（二）注意事项

1. 编译镜像时，需确保网络通畅，镜像拉取可能耗时较长（镜像包体积较大），避免中途中断操作；

2. 版本锁定后，若需修改版本，需先解锁再操作，解锁前需确认无服务依赖该版本；

3. 后台服务器脚本修改时，需确保所有涉及版本号的参数均同步更新，避免脚本执行失败；

4. 升级过程中若出现服务异常，可通过【监控中心】→【告警中心】、【日志搜索】排查问题，必要时回滚至历史版本（3.39.0）；

5. 所有操作需在非业务高峰期执行，避免影响线上服务运行。