文档

私有构建集群Runner升级指南

更新时间:

升级须知

升级目的

云效 Flow 私有构建集群架构全面优化升级( 原 Agent 升级为新 Runner),全新支持集群负载均衡,提升集群可观测性、容灾能力、并发控制能力。

  • 升级 Runner 后,流水线构建任务将均衡调度,合理分配利用构建集群资源。

  • 升级 Runner 后,将切换为全新私有构建集群 UI 视图,集群卡片式展示更加清晰、新节点接入过程更加流畅,详见构建集群

升级影响

  • 升级范围:当前企业下所有私有构建集群下的机器。

  • 升级过程中,会在构建机器上安装并启动云效 Runner 常驻进程(该进程只会用于构建任务的拉取执行、以及部分执行机负载采集)。

  • 升级过程中,不会对运行中的流水线任务产生影响。只有当企业整体升级成功后,才会切换到新 Runner 执行方式。

升级过程

  • 升级过程中,会在当前企业下所有私有构建集群机器上安装并启动云效 Runner 常驻进程。

  • 确认迁移结果:

    • 全部成功:当企业构建集群机器 Runner 全部安装成功时,企业整体升级成功,流水线自动切换到新 Runner 执行方式。

    • 部分失败/全部失败:当企业构建集群中存在部分或全部机器 Runner 安装失败时,企业整体升级失败,流水线依然使用原 Agent 执行方式(不影响流水线的运行)。请查看升级任务详情,根据失败提示重试升级或跳过失败机器。

升级操作步骤

第1步 阅读并确认升级须知

进入Flow-企业设置-构建集群管理页面,点击升级Runner打开构建 Runner 全面升级弹窗,阅读升级目的、升级影响、升级过程。

image.png

第2步 提交升级

确认升级影响后,点击立即升级提交升级,Runner 升级任务将在后台执行,升级过程中无法对构建集群进行修改操作,请等待升级成功后再操作。或点击预约升级,预约升级后,升级任务将于 次日凌晨 02:00-06:00点 执行,可次日查看升级结果。

image.png

第3步 查看升级结果,使用新功能

升级过程预计几分钟,请刷新页面查看升级结果。升级成功后:

  • 构建集群管理页面将自动切换为新 UI

  • 流水线任务运行时将自动使用新 Runner 下发构建任务

  • 支持接入 Windows 机器作为构建节点,在流水线运行时指定 Windows 构建节点,可以直接在默认VM环境执行构建任务。

image.png

第4步 失败处理

如果升级失败,请点击查看升级失败详情,弹窗展示成功升级机器数,失败升级机器数,列表展示失败机器详情和失败原因。

image.png

请根据失败原因处理后再重试升级(可参考云效统一 Runner 常见问题),若确认某台机器不再使用或可以延后处理,则可以点击跳过某台机器升级。

image.png

当所有机器 Runner 升级状态都为成功已跳过,则可以将本企业Runner升级置为成功,升级成功后构建集群即会切换为新 UI,可以使用构建集群新功能,且流水线任务运行将自动切换为新 Runner 方式。

image.png