私有构建集群Runner升级指南
升级须知
升级目的
云效Flow私有构建集群架构全面优化升级（ 原Agent升级为新Runner），全新支持集群负载均衡，提升集群可观测性、容灾能力、并发控制能力。
升级Runner后，流水线构建任务将均衡调度，合理分配利用构建集群资源。
升级Runner后，将切换为全新私有构建集群UI视图，集群卡片式展示更加清晰、新节点接入过程更加流畅，详见构建集群。
升级影响
升级范围：当前企业下所有私有构建集群下的机器。
升级过程中，会在构建机器上安装并启动云效Runner常驻进程（该进程只会用于构建任务的拉取执行、以及部分执行机负载采集）。
升级过程中，不会对运行中的流水线任务产生影响。只有当企业整体升级成功后，才会切换到新Runner执行方式。
升级过程
升级过程中，会在当前企业下所有私有构建集群机器上安装并启动云效Runner常驻进程。
确认迁移结果：
全部成功：当企业构建集群机器Runner全部安装成功时，企业整体升级成功，流水线自动切换到新Runner执行方式。
部分失败/全部失败：当企业构建集群中存在部分或全部机器Runner安装失败时，企业整体升级失败，流水线依然使用原Agent执行方式（不影响流水线的运行）。请查看升级任务详情，根据失败提示重试升级或跳过失败机器。
升级操作步骤
第1步：阅读并确认升级须知
进入Flow-企业设置-构建集群管理页面，点击升级Runner打开构建Runner全面升级弹窗，阅读升级目的、升级影响、升级过程。
第2步：提交升级
确认升级影响后，点击立即升级提交升级，Runner升级任务将在后台执行，升级过程中无法对构建集群进行修改操作，请等待升级成功后再操作。或点击预约升级，预约升级后，升级任务将于 次日凌晨 02:00-06:00点 执行，可次日查看升级结果。
第3步：查看升级结果，使用新功能
升级过程预计几分钟，请刷新页面查看升级结果。升级成功后：
构建集群管理页面将自动切换为新UI。
流水线任务运行时将自动使用新Runner下发构建任务。
支持接入Windows机器作为构建节点，在流水线运行时指定Windows构建节点，可以直接在默认VM环境执行构建任务。
第4步：失败处理
如果升级失败，请点击查看升级失败详情，弹窗展示成功升级机器数，失败升级机器数，列表展示失败机器详情和失败原因。
请根据失败原因处理后再重试升级（可参考主机部署问题），若确认某台机器不再使用或可以延后处理，则可以点击跳过某台机器升级。
当所有机器Runner升级状态都为成功或已跳过，则可以将本企业Runner升级置为成功，升级成功后构建集群即会切换为新UI，可以使用构建集群新功能，且流水线任务运行将自动切换为新Runner方式。
主机组Runner升级指南
升级须知
升级目的
云效Flow主机组管理全面优化升级（原Agent 升级为新Runner），全新支持ARM主机部署，优化主机节点接入方式和接入过程观测等。
升级影响
升级范围：当前企业下所有Flow主机组下的机器。
升级过程中，会在机器上安装并启动云效Runner常驻进程（该进程只会用于构建任务的拉取执行，以及部分执行机负载采集）。
升级过程中，不会对运行中的流水线任务产生影响。只有当企业整体升级成功后，才会切换到新Runner部署方式。
升级过程
点击立即升级后，升级任务立即执行。
升级过程中，会在当前企业下所有主机上安装并启动云效Runner常驻进程。升级过程中，你将无法新建/修改 Flow主机组。
确认迁移结果：
全部成功：当企业所有主机Runner全部安装成功时，企业整体升级成功，流水线主机部署任务将自动切换到新Runner执行方式。
部分失败/全部失败：当企业主机组中存在部分或全部机器Runner安装失败时，企业整体升级失败，主机部署任务依然使用原Agent方式。请查看升级任务详情，根据失败提示重试升级或跳过失败机器。
升级操作步骤
第1步：阅读并确认升级须知
进入Flow-企业设置-主机组管理页面，点击升级Runner打开主机组Runner全面升级弹窗，阅读升级目的、升级影响、升级过程。
第2步：提交升级
确认升级影响后，点击立即升级提交升级，Runner升级任务将在后台执行，升级过程中无法对主机组进行修改操作，请等待升级成功后再操作。
第3步：查看升级结果，使用新功能
升级过程预计几分钟，请刷新页面查看升级结果。升级成功后：
Flow 主机组管理页面将自动切换为新 UI。
流水线主机部署任务将自动使用新 Runner 下发部署任务。
支持接入 Linux ARM 架构机器作为环境部署主机。
第4步：失败处理
如果升级失败，请点击查看升级失败详情，弹窗展示成功升级机器数，失败升级机器数，列表展示失败机器详情和失败原因。
请根据失败原因处理后再重试升级（可参考主机部署问题），若确认某台机器不再使用或可以延后处理，则可以点击跳过某台机器升级。
当所有机器Runner升级状态都为成功或已跳过，则可以将本企业Runner升级置为成功，升级成功后主机组管理即会切换为新 UI，可以使用主机组管理新功能。