官方运维工具

本文主要介绍企业如何正式安装、升级、回滚 Zadig，其中包括资源准备及详细的操作步骤。

提示

官方为企业管理员提供了便利的运维工具，可在线实施 Zadig 的安装与日常版本的升级、回滚，联系官方获取相应的支持。

资源准备

1. Kubernetes 集群，版本：v1.16 ~ v1.26，节点建议：2 台 8C16G，且对该集群有管理员操作权限
2. 可正常连通上述 K8s 集群，且安装了 kubectl (opens new window) 客户端的机器，用于执行安装命令
3. 网络：
   • 如果选择 IP+端口 的方式访问 Zadig 系统，需要确保集群节点有外部 IP 可供访问
   • 如果选择域名方式访问 Zadig 系统，需要准备可用的域名
4. 数据库：
   • 高可用的 MongoDB（版本： v3.4+）
   • 高可用的 MySQL（版本：v5.7+）

注意事项

1. 受限于部分类型集群网络插件及其配置，Service 的后端 Pod 可能无法通过该 Service 访问自身，在安装之前请确保集群中不存在此问题
2. 配置 kube-dns 服务，以支持服务和 Pod 之间的按名称寻址

安装

步骤 1：选择版本

访问客户控制台 > 版本，点击发现新版本获取 Zadig 的所有版本，按需选择版本后点击部署进入参数配置页面。

提示

1. 若忘记控制台登录密码，可以通过以下命令找回：
   kubectl get cm plutus-customer-config -n {控制台所在的命名空间} -o=jsonpath='{.data.PLUTUS_PASSWORD}'

2. 使用 IP + 端口 方式访问控制台时，若忘记具体端口，可以通过以下命令查看：
   kubectl get svc plutus-customer-portal -n {控制台所在的命名空间}

步骤 2：配置参数

设置安装参数后点击部署。

安装过程受硬件配置和网络情况影响，不同环境下的时间可能不同，可以执行 kubectl -n {Zadig 所在的 Namespace} get pod 查询服务状态，当版本状态变为部署成功时，则说明部署完成。

配置选项说明：

• 命名空间：选择安装 Zadig 的命名空间
• Release 名称：可自定义
• Helm values 文件：配置 Zadig 的相关安装参数
  • 支持手动输入 YAML 和指定 key/value 两种方式来配置
  • 点我查看安装参数说明

步骤 3：访问系统

• 首次登录系统需注册系统管理员。

步骤 4：配置许可证

• 成功注册登录系统后，访问企业管理 -> 许可证 配置许可证。

升级

注意

请勿跨版本升级。

步骤 1：备份数据

• 请务必做好数据备份，参考文档：备份数据。
• 请备份好当前的安装参数。

步骤 2：执行升级

访问客户控制台 > 版本，点击发现新版本获取 Zadig 的新版本，选择新版本后点击部署。

将备份的安装参数填入 Helm values 文件 后部署即可。

提示

升级时请勿修改命名空间和 Release 名称。

步骤3：验证升级

部署成功后清理浏览器缓存，登录 Zadig 系统，检查以下功能是否正常，对此次升级做验收：

1. 检查账号系统是否可以正常登录。
2. 检查项目/工作流/环境/服务/构建/系统集成的数据是否正常。
3. 检查环境中服务实例是否正常，工作流是否可正常运行。
4. 检查日常高频使用的功能。

回滚

注意

回滚前请确认 Zadig 进入停机状态，回滚过程中请勿使用 Zadig 系统。

步骤 1：恢复数据

将目标版本的备份数据恢复，参考文档：数据导入。

步骤 2：执行回滚

访问客户控制台 > 版本，选择要回滚的目标版本后点击回滚。

配置 Helm values 文件 将备份的安装参数填入。

提示

回滚时请勿修改命名空间和 Release 名称。

步骤 3：验证回滚

部署成功后清理浏览器缓存，登录 Zadig 系统，检查以下功能是否正常，对此次回滚做验收：

1. 检查账号系统是否可以正常登录。
2. 检查项目/工作流/环境/服务/构建/系统集成的数据是否正常。
3. 检查环境中服务实例是否正常，工作流是否可正常运行。
4. 检查日常高频使用的功能。

安装参数说明

通用安装参数

高可用安装参数

如果安装高可用 Zadig，还需配置以下参数：

高可用版本使用外置的 MongoDB, MySQL 组件，数据持久化以及高可用性由具体的 MongoDB, MySQL 服务提供商保障