文档中心知识库API Explorer
文档中心›ZCF›升级ZCF

升级

升级概览

ZCF 升级包括基础设施组件升级和 ZCF 升级两部分。基础设施组件用于承载云平台、存储、容器和网络服务等资源，需按对应产品文档单独升级；ZCF 升级是指通过 ZCF Bundle 升级随 Bundle 交付的全局管理类能力。

管理员可在生命周期管理中上传 ZCF Bundle，并创建升级计划，按页面引导完成备份、预检、升级执行和结果确认。开始 ZCF 升级前，请先确认基础设施组件版本已满足目标 ZCF 版本映射关系；如不满足，请先完成对应基础设施组件升级。

对象 升级口径
ZCF 升级
  • 通过 ZCF Bundle 升级 ZCF 全局管理类能力，包括 ZCF 控制面、统一门户、身份认证、云联邦、可观测性、生命周期管理和许可证管理等。
  • 管理员在升级管理页面中创建计划并执行升级，具体范围以 Bundle manifest 和升级计划为准。
基础设施组件
  • 包括 ZStack Cloud、ZStack ZStone、ZStack Zaku 和 ZStack ZNS 等承载云平台、存储、容器和网络资源的组件。
  • 基础设施组件需按对应产品文档单独升级。升级前请确认其版本与目标 ZCF 版本映射关系；升级后请在 ZCF 中确认接入、资源采集和可观测数据正常。

升级基础设施组件

如当前 ZStack Cloud、ZStack ZStone、ZStack Zaku 或 ZStack ZNS 版本不满足目标 ZCF 版本要求，请先完成基础设施组件升级。升级通常按以下顺序进行：

  1. 确认目标 ZCF 版本与各基础设施组件的版本映射关系。
  2. 按对应产品发布说明和升级文档升级基础设施组件。
  3. 在 ZCF 中确认组件接入、资源采集、可观测数据和统一认证访问正常。

升级 ZCF

基础设施组件版本满足要求后，可通过 ZCF Bundle 升级 ZCF 全局管理类能力。升级通常按以下顺序进行：

  1. 获取与当前环境和目标版本匹配的 ZCF Bundle。
  2. 上传 ZCF Bundle，并确认安装包可用于创建升级计划。
  3. 查看当前版本、目标版本、升级路径和组件健康状态。
  4. 创建升级计划，确认升级对象、组件变化和影响范围。
  5. 运行升级备份和预检，处理阻断项或确认风险项。
  6. 执行 ZCF 升级，并在页面中持续跟踪升级进度、步骤状态和事件信息。
  7. 升级完成后，确认 ZCF 版本、平台健康、组件访问、资源采集、可观测数据和升级历史记录。

注意事项

Note: 本教程用于说明基于 ZCF Bundle 的升级操作流程，实际可执行的升级路径以目标 Bundle 支持范围和页面校验结果为准。如果页面提示升级路径不支持或安装包不可升级，请先按页面提示处理，不要直接执行升级。

准备升级

升级前，请先完成基础设施组件版本映射、升级包、维护窗口、权限和环境状态确认，避免在升级过程中因版本不匹配、健康异常或任务冲突导致升级受阻。

  1. 确认基础设施组件版本是否满足目标 ZCF 版本要求。

    基础设施组件包括 ZStack Cloud、ZStack ZStone、ZStack Zaku 和 ZStack ZNS。此类组件承载云平台、存储、容器和网络资源，不会在 ZCF Bundle 升级流程中被单独升级。

    请根据目标 ZCF 版本映射关系确认各基础设施组件版本。版本不满足要求时，请先参考升级基础设施组件完成产品侧升级和升级后确认；版本已满足要求时，请记录当前版本，用于后续检查和问题追溯。

  2. 获取目标版本的 ZCF Bundle。

    请从 ZCF 正式下载页获取与当前环境架构匹配的 ZCF Bundle，并阅读目标版本发布说明，确认目标版本、升级范围和已知限制。

    请根据当前环境架构选择对应 Bundle，实际包名以下载页面为准。常见包名如下：

    • x86 架构：zcf-bundle-latest-amd64.bin
    • ARM 架构：zcf-bundle-latest-arm64.bin
    • 下载地址：点击这里

    上传 Bundle 后，系统会根据包内版本信息和当前环境计算可升级状态。如页面提示架构不匹配或缺少目标架构安装包，请更换对应架构的 Bundle。

  3. 确认当前管理员具备升级所需权限。

    管理员需要具备上传安装包、创建升级计划和执行升级的操作权限。

  4. 确认平台处于适合升级的状态。
    检查项说明
    维护窗口按业务影响范围预留升级窗口，并提前通知相关运维和业务人员。
    平台健康确认 ZCF 关键服务和已接入组件运行正常。存在健康异常时，请先定位并处理。
    升级范围确认目标 Bundle 和升级计划覆盖的 ZCF 全局管理类能力范围。ZStack Cloud、ZStack ZStone、ZStack Zaku、ZStack ZNS 等基础设施组件，请按对应产品发布说明和升级文档维护。
    版本映射确认 ZStack Cloud、ZStack ZStone、ZStack Zaku 和 ZStack ZNS 等基础设施组件版本满足目标 ZCF 版本要求；不符合要求时，先完成对应组件升级。
    资源容量确认节点磁盘、CPU、内存等资源满足升级和备份要求。
    任务冲突确认没有正在执行的升级、部署或其他可能影响平台状态的关键任务。
    备份策略确认升级前备份可用，并保留必要的恢复信息和运维联系人。

准备完成后，可进入生命周期管理 > ZCF升级，并在升级管理页面的安装包管理区域上传 ZCF Bundle。

升级基础设施组件

升级基础设施组件前，请确认已阅读目标 ZCF 版本和对应产品版本的发布说明，并已准备产品侧升级所需安装包、维护窗口、备份和运维权限。

基础设施组件包括 ZStack Cloud、ZStack ZStone、ZStack Zaku 和 ZStack ZNS，用于承载云平台、存储、容器和网络服务等资源。此类组件不通过升级管理页面单独升级；如当前版本不满足目标 ZCF 版本映射关系，请先完成产品侧升级，再继续 ZCF Bundle 升级流程。

  1. 确认需要升级的基础设施组件。

    根据目标 ZCF 版本映射关系和当前环境版本，确认 ZStack Cloud、ZStack ZStone、ZStack Zaku 或 ZStack ZNS 是否满足要求。若多个组件均需升级，请以各产品升级文档中的依赖关系和顺序要求为准；若组件版本已满足要求，可跳过产品侧升级，但仍需完成升级后确认。

  2. 按对应产品文档完成基础设施组件升级。
    组件 产品侧升级 产品侧确认
    ZStack Cloud 按 ZStack Cloud 发布说明和升级文档升级云平台基础环境。升级前请确认目标版本与 ZCF 版本兼容，并预留业务维护窗口。 确认管理界面、管理节点、云主机、网络、主存储和镜像服务器等关键服务正常。
    ZStack ZStone 按 ZStack ZStone 发布说明和升级文档升级存储环境。升级前请确认存储业务影响范围和恢复方案。 确认存储集群、存储池、数据服务和管理页面正常。
    ZStack Zaku 按 ZStack Zaku 发布说明和升级文档升级容器环境。升级前请确认集群、节点和工作负载状态。 确认 Kubernetes 集群、节点、工作负载和管理页面正常。
    ZStack ZNS 按 ZStack ZNS 发布说明、升级文档或应用市场相关说明维护网络服务环境。升级前请确认网关、负载均衡和 NAT 等业务影响范围。 确认网络服务、网关、负载均衡、NAT 和管理页面正常。
  3. 在 ZCF 中确认基础设施组件接入状态。

    进入云联邦 > 平台管理，在接入平台列表或区域中确认已升级组件的连接状态、版本信息、采集配置和更新时间正常。若连接异常，请先在组件侧确认服务状态和访问地址，再重新验证接入。

  4. 确认资源采集和可观测数据正常。

    根据组件接入时启用的采集项，进入可观测性相关页面查看资源、监控指标、日志、仪表盘和报表数据。若数据为空或更新时间异常，请检查组件接入状态和对应采集配置。

  5. 确认组件访问和统一认证能力正常。

    如已为组件下发 SSO 配置，请通过统一身份认证入口登录 ZCF，并按权限访问对应组件页面，确认登录、跳转和资源访问正常。

基础设施组件升级和检查完成后，可继续上传目标版本 ZCF Bundle，并创建 ZCF 升级计划。

升级 ZCF

升级 ZCF 是指通过 ZCF Bundle 升级随 Bundle 交付的全局管理类能力，包括 ZCF 控制面、统一门户、身份认证、云联邦、可观测性、生命周期管理和许可证管理等。ZCF Bundle 不单独升级 ZStack Cloud、ZStack ZStone、ZStack Zaku 和 ZStack ZNS 等基础设施组件。

开始 ZCF 升级前，请确认基础设施组件版本已满足目标 ZCF 版本映射关系。若不满足，请先完成基础设施组件升级，再上传 ZCF Bundle 并创建升级计划。

上传 ZCF Bundle

已获取目标版本 ZCF Bundle 文件。当前仅支持上传 .bin 格式的 Bundle 文件。

升级管理页面中的安装包管理区域用于统一管理 Depot 中的 Bundle。就绪的 ZCF Bundle 可用于后续创建升级计划。

  1. 在主菜单右上角切换至全局管理。
  2. 进入生命周期管理 > ZCF升级。
  3. 点击上传 Bundle。
    图 1. 上传 Bundle


  4. 选择目标版本的 ZCF Bundle 文件，并点击上传。
  5. 在Bundle 管理页签中确认安装包状态。
    查看项说明
    安装包确认 Bundle 名称为 zcf，并可查看包含的组件数量。
    版本确认版本与计划升级的目标版本一致。
    架构确认 Bundle 架构与当前环境架构匹配。
    状态确认安装包为就绪或可升级状态。若显示不可升级，请查看页面提示的原因，常见原因包括版本低于当前环境、升级路径不支持或组件版本不匹配。
    使用情况确认该 Bundle 是否已被当前升级计划使用，避免删除或重复上传影响升级计划。
    图 2. 安装包管理


Bundle 上传完成且状态满足升级要求后，可在升级管理页面查看可用升级目标。

查看可用升级

升级管理页面用于选择升级包、确认升级路径，并查看当前环境是否满足创建升级计划的基本条件。

  1. 在主菜单右上角切换至全局管理。
  2. 进入生命周期管理 > ZCF升级。
  3. 在可用安装包区域选择目标升级包。

    可通过搜索框按安装包或版本筛选，也可按全部、就绪、受阻和当前版本等状态查看 Bundle。建议选择状态为就绪的 Bundle；如状态为受阻，请先查看详情和阻断原因。

  4. 在环境摘要中确认当前版本、升级路径、组件健康和安装包内容。
    查看项说明
    当前版本当前环境正在运行的 ZCF 版本。
    目标版本所选 Bundle 对应的目标版本。
    升级路径当前版本到目标版本之间是否存在受支持的升级路径。
    Bundle所选 Bundle 的名称、版本和 Manifest 校验和等信息。
    可用性确认所选 Bundle 是否可用于当前环境。页面提示暂不可升级时，请先处理阻断原因。
    最低可升级版本确认当前 ZCF 版本是否满足 Bundle 声明的最低可升级版本要求。
    组件健康升级前关键组件的健康概览。组件异常时，请先进入可观测性页面定位问题。
    组件变化确认本次 ZCF 升级涉及的组件版本变化。ZStack Cloud、ZStack ZStone、ZStack Zaku、ZStack ZNS 等基础设施组件，请按对应产品发布说明和升级文档维护。
    组件包摘要查看 Bundle 中组件包的完整性和架构匹配情况。缺少当前环境架构所需组件包时，不能创建升级计划。

    当所选 Bundle 状态为就绪且环境摘要满足升级要求时，创建升级计划按钮可用；如按钮不可用，请先处理页面提示的阻断项。

确认目标 Bundle 可升级后，可创建升级计划。

创建升级计划并完成升级前检查

目标 ZCF Bundle 已上传，并在升级管理页面中显示为可用于升级。

升级计划用于记录本次升级的目标版本、升级范围、执行顺序和检查结果。执行升级前，需要先通过备份和预检，确认当前环境具备升级条件。

  1. 在升级管理页面选择目标 Bundle，并点击创建升级计划。
  2. 在确认计划阶段查看升级对象、组件变化和影响范围。

    以确认计划页面列出的升级对象为准。页面会展示升级顺序、升级要求、节点或目标、版本变化、执行动作和健康状态。ZCF 会按计划执行已纳入生命周期管理的升级步骤；ZStack Cloud、ZStack ZStone、ZStack Zaku、ZStack ZNS 等基础设施组件不在该计划中单独升级。

    如果发现目标版本、升级范围或组件变化与预期不一致，请返回升级管理页面中的安装包管理区域重新确认 Bundle。

  3. 点击运行备份，生成升级前备份。

    备份用于在升级异常时提供恢复依据。备份完成后，请在页面中查看备份记录，确认记录 ID、备份数量、过期时间和备份项状态正常。页面显示 backup not required 时，表示该组件没有要求执行备份，不代表备份失败或漏执行。备份失败时，请先处理失败原因，再继续后续步骤。

  4. 备份完成后，点击运行预检。

    系统会按当前升级计划运行预检。预检完成后，请以页面展示的实际检查项和检查结果为准处理问题；预检结果会影响后续是否可执行升级。

  5. 查看预检结果，并按结果处理。

    预检完成后，页面会汇总显示预检结果，并支持按全部、错误、警告和通过等状态筛选检查项。请逐项查看页面给出的检查结果、状态、描述和说明，并按页面提示处理。

    图 3. 预检结果


    结果状态含义处理方式
    错误存在阻断升级的问题。按页面说明修复后，重新运行预检。
    警告存在需确认的风险，但不一定阻断升级。评估风险影响，并在当前 Precheck revision 中确认风险后再执行升级。
    通过该检查项满足升级要求。无需处理，继续查看其他检查项。
    跳过该检查项不适用于当前升级计划或当前组件。查看页面说明确认原因。
  6. 存在警告时，确认当前 Precheck revision 的风险。

    如果预检结果中存在 Warning，请先查看警告项的风险说明和业务影响，并在页面中确认当前 Precheck revision 的风险。风险确认仅针对当前预检结果生效；重新运行预检并生成新的 revision 后，需要重新确认风险。完成风险确认后，才能执行升级。

    如果预检存在错误或其他阻断项，请先修复并重新运行预检，不要直接执行升级。

预检通过并完成必要确认后，可进入执行升级阶段。

执行升级

升级计划已创建，升级备份和预检已完成，且不存在必须修复的阻断项。

执行升级后，系统会按升级计划推进组件升级，并在页面中展示当前阶段、步骤状态和事件信息。升级过程中请持续关注页面状态，避免同时执行会影响平台状态的操作。

  1. 在升级管理页面确认当前计划状态。

    确认升级对象、目标版本、备份状态和预检结果均符合预期。

  2. 点击执行升级。

    执行前，请再次确认维护窗口仍然有效，且相关运维人员可随时响应升级异常。

  3. 在页面中跟踪升级进度。
    关注项说明
    计划状态查看计划是否处于运行中、受阻、已暂停、失败或已完成等状态。
    当前步骤查看当前正在执行的组件和升级动作，判断升级是否按预期推进。
    事件信息查看升级开始、备份、预检、执行、失败、继续和完成等事件。
    失败详情当升级失败或受阻时，查看失败组件、失败步骤、错误信息和恢复依据。
  4. 等待升级计划执行完成。

    升级完成前，请勿删除本次升级使用的 Bundle，也不要手动清理升级备份和相关记录。

处理升级异常

升级计划进入受阻、已暂停或失败状态时，请先在页面中查看失败详情和事件信息，再按提示处理。不要直接删除 Bundle、清理备份或手动修改升级记录。

  1. 在升级管理页面查看当前计划状态。

    重点确认失败步骤、失败组件、错误信息和最近事件。

  2. 根据页面提示处理阻断或失败原因。
    异常类型处理方向
    预检结果过期重新运行预检，确认结果仍满足升级要求。
    组件健康异常进入可观测性相关页面定位异常组件，修复后点击重新检查组件。
    资源容量不足释放或扩容相关资源后重新运行预检。
    任务冲突等待冲突任务结束，或按业务影响处理冲突任务后重新运行预检。
    步骤失败查看失败详情和恢复信息，按页面提示重新检查组件、终止计划或联系技术支持。
  3. 按页面提供的操作继续处理升级计划。

    页面可能提供重新检查组件、终止计划等操作。请结合失败详情和业务影响选择操作，并以当前页面实际可用按钮为准。

    终止计划只会停止当前升级计划继续执行，不会回滚已执行的升级步骤，也不会自动恢复环境。终止前，请确认已保留计划 ID、失败详情、备份信息和相关日志，并评估后续恢复或人工处理方案。

  4. 处理完成后，继续跟踪升级计划状态。

    如果页面提示需要人工处理，请保留计划 ID、目标版本、失败步骤、错误信息、备份信息和相关日志，并联系技术支持。

升级计划恢复执行后，请继续在升级页面观察进度，直到计划完成或进入新的异常状态。

确认升级结果

升级计划完成后，请从版本、健康、访问和历史记录等方面确认升级结果，确保平台可继续承载日常运维和业务访问。

  1. 在升级管理页面确认计划状态为已完成。
  2. 确认当前版本已更新为目标版本。

    如版本未更新或页面显示异常，请先刷新页面并查看升级历史记录。

  3. 检查平台健康和关键服务状态。

    可进入运维 > 监控中心 > 平台健康查看关键服务、健康域、组件明细和外部依赖状态。

  4. 确认管理员和普通用户可正常登录并访问授权页面。

    建议至少验证统一身份认证登录、全局管理视角、可用区视角，以及本次升级涉及的主要页面。

  5. 确认基础设施组件访问正常。

    如环境已接入 ZStack Cloud、ZStack ZStone、ZStack Zaku 或 ZStack ZNS，请分别确认对应产品升级记录、版本和运行状态，并在 ZCF 中确认接入状态、资源采集、可观测数据和服务入口正常。

  6. 查看升级历史记录。

    在升级管理页面点击查看历史，确认本次升级记录已生成。

    查看项说明
    计划 ID本次升级计划的唯一标识，用于后续定位升级记录。
    Bundle本次升级使用的 ZCF Bundle。
    升级路径本次升级的源版本和目标版本。
    当前状态升级计划的执行结果或当前状态。
    更新时间升级记录最近一次更新的时间。

确认升级结果正常后，可关闭维护窗口，并按内部流程归档升级记录。

上一篇安装部署下一篇许可证
升级教程 | ZStack Cloud Foundation | ZStack 资源中心