官方运维工具

本文主要介绍企业如何基于官方运维工具安装和升级 Zadig，适用于企业正式使用的场景。建议联系官方获取相应的支持。 该工具可帮助企业便利的实施 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 之间的按名称寻址

安装官方运维工具

安装准备

• 需要一台可以正常连通 K8s 集群的机器用于执行安装命令
• 确保该机器已经安装了 kubectl 客户端 并且可以使用管理员的权限操作 K8s 集群

执行安装

执行以下命令安装客户控制台：

curl -sS https://admin.8slan.com/api/plutus/customer/installer/install_plutus_customer.sh | bash

安装成功输出：

...
plutus customer installation complete
visit {访问地址} to access plutus customer
use password: {密码} to login to plutus
plutus customer installation completed in 36 seconds

配置授权凭证

提示

安装成功够立即登录可能会出现不成功的情况，这是因为系统在做初始化，遇到这种情况请耐心等待片刻。

使用安装成功输出的访问地址和密码登录客户控制台，并使用授权凭证进行初始化。

授权凭证由 Zadig 官方签发。

[🔥推荐]官方安装支持

通过开启「供应商维护配置」选项，Zadig 可以获取客户端控制台的部分操作权限，便可获得完整的官方安装协助。

「供应商维护配置」权限开放配置方式，如下图所示：

勾选配置后点击保存即可。

安装 Zadig

步骤 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：配置许可证

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

升级 Zadig

注意

请勿跨版本升级。

步骤 1：备份数据

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

步骤 2：执行升级

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

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

提示

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

步骤3：验证升级

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

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

回滚 Zadig

注意

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

步骤 1：恢复数据

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

步骤 2：执行回滚

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

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

提示

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

步骤 3：验证回滚

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

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

安装参数说明

通用安装参数

高可用安装参数

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

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