更新时间:2025-08-26 GMT+08:00

使用单批发布方式升级组件版本配置

组件创建并部署完成后,根据业务需要,可使用“单批发布”方式一次性升级单个组件所有实例版本配置。

如需批量升级同一个应用下的多个组件版本配置,请参考批量升级组件版本配置

使用限制

单批发布方式升级组件版本配置过程中,组件服务会中断。仅适用于测试升级场景或者计划停服升级场景。

前提条件

使用单批发布方式升级组件版本配置

  1. 登录ServiceStage控制台
  2. 选择以下任意方式进入组件“概览”页面:

    • “应用管理”页面,单击组件所属应用名称,在“组件列表”单击待操作组件名称。
    • “组件管理”页面,单击待操作组件名称。

  3. 根据是否使用组件模板创建组件选择如下不同操作方法进入“升级组件”页面:

    • 是,选择页面右上角的升级 > 升级
    • 否,单击页面右上角的“升级”

  4. “类型”选择“单批发布”
  5. 单击“下一步”,参考下表设置组件版本配置信息,其中带“*”标志的参数为必填参数。

    参数

    说明

    技术栈

    选择组件技术栈及版本。

    技术栈详情,请参考技术栈简介

    *YAML模式

    选择是否使用YAML配置来升级组件。

    • 选择关闭:使用界面配置来升级组件。
    • 选择开启:使用YAML配置来升级组件,从部署了待升级组件的CCE自动同步组件最新负载信息用于修改后升级组件。您也可以单击“导入YAML文件”,导入已经编辑好的待升级组件YAML配置文件。使用YAML配置来升级组件,组件YAML配置文件中各参数的说明请参考Deployment

    *软件包/镜像

    固定为创建并部署组件时选择的包类型。

    • “YAML模式”选择关闭:选择“源码仓库”,参考创建仓库授权创建授权,设置代码来源;选择软件包或者镜像包,则固定为创建并部署组件时选择的软件包类型(Jar、War、Zip)或者镜像包类型。由您选择的技术栈类型决定,具体情况请参考表1
    • “YAML模式”选择开启:选择“源码仓库”,参考创建仓库授权创建授权,设置代码来源;选择软件包,则固定为创建并部署组件时选择的软件包类型(Jar、War、Zip)。由您选择的技术栈类型决定,具体情况请参考表1

    *上传方式

    • “YAML模式”选择关闭:选择软件包或者镜像包,重新选择已上传的软件包/镜像包,上传方式请参考组件来源说明

      如果选择的是镜像包:

      • 如果创建和部署组件时已经勾选了“启用多容器”,选择指定的容器,单击,可以指定该容器为初始化容器,用于业务容器启动前安装特定工具或脚本。多个容器中,至少需要指定一个容器作为业务容器(非初始化容器)。初始化容器详情,请参考Init容器
      • 如果创建和部署组件时已经勾选了“启用多容器”,单击“选择镜像包”,可以为组件新增容器并选择镜像包来源。
      • 如果创建和部署组件时已经勾选了“启用多容器”,在已选择的容器卡片右上角选择“ > 修改镜像包”,修改容器的镜像包来源。
      • 如果创建和部署组件时已经勾选了“启用多容器”,在已选择的容器卡片右上角选择“ > 删除”,删除该容器。
      • 如果创建和部署组件时已经勾选了“启用多容器”,取消勾选“启用多容器”,可以单容器部署组件。
      • 如果创建和部署组件时没有勾选“启用多容器”,勾选“启用多容器”,启用多容器部署组件。单击“选择镜像包”,可以为组件新增容器并选择镜像包来源、设置“容器名称”
      • 如果重新自定义容器名称:长度为1到63个字符,可以包含小写英文字母、数字或中划线(-),并以小写英文字母开头、小写英文字母或数字结尾。
    • “YAML模式”选择开启:选择软件包,重新选择已上传的软件包,上传方式请参考组件来源说明
    • 如果包类型为软件包且需要使用例如JFrog(制品仓库)作为软件包存储仓库,您可以选择“自定义文件地址”上传方式。
      1. 输入软件包所在的HTTP/HTTPS协议的自定义文件地址。
      2. 选择是否开启认证。

        不开启认证,则默认任何用户都可以下载上传到自定义文件地址的软件包。

        单击开启认证,则只有通过认证的用户才能下载上传到自定义文件地址的软件包。“认证方式”支持“用户密码认证”“自定义Header认证”,认证方式及对应的认证参数由您自定义的文件地址所在服务器支持的认证方式决定。

    镜像访问凭证

    镜像访问凭证即密钥,用于存放拉取私有仓库镜像所需的认证信息。如果是公共仓库镜像,可以保持默认设置或者不设置镜像访问凭证。如果是私有仓库镜像,必须设置正确的镜像访问凭证,否则会导致镜像拉取失败。

    • 最多支持选择16个镜像访问凭证。
    • 单击“创建密钥”,可以创建新的镜像访问凭证。请参考创建密钥“密钥类型”必须选择kubernetes.io/dockerconfigjson。

    *编译命令

    “YAML模式”选择关闭、包类型是“源码仓库”、组件部署方式为容器部署且所选择的技术栈类型为Java、Tomcat、Node.js、Python、Php时支持设置“编译命令”

    • 使用默认命令或脚本:优先执行代码根目录下的build.sh,不存在则按照所选语言的通用方法编译,如Java语言的mvn clean package
    • 使用自定义命令:根据所选语言自定义编译命令,或修改build.sh文件后选择使用默认命令或脚本。
      • 选择“使用自定义命令”时,请在echo、cat、debug命令中慎用敏感信息或者进行敏感信息加密,以免造成敏感信息泄露。
      • 在项目子目录下执行编译命令,需先进入项目子目录,再执行其余脚本命令。例如:

        cd ./weather/

        mvn clean package

    *Dockerfile地址

    “YAML模式”选择关闭、包类型是“源码仓库”、组件部署方式为容器部署且所选择的技术栈类型为Java、Tomcat、Node.js、Python、Php时支持设置“Dockerfile地址”

    “Dockerfile地址”即Dockerfile文件相对于项目的根目录(./)所在的目录,Dockerfile文件用于镜像构建。

    如果未指定“Dockerfile地址”,默认查找项目根目录下的Dockerfile;如果项目根目录下也没有Dockerfile文件,则根据选定的运行环境自动生成Dockerfile。

    *组件版本

    组件版本号,支持自动生成和自定义版本号。

    • 自动生成版本号:单击“自动生成”,默认以此时的时间戳来生成版本号,格式为yyyy.mmdd.hhmms,s取时间戳中秒数的个位值。例如:时间戳为2022.0803.104321,则版本号为2022.0803.10431。
    • 自定义版本号:输入格式为A.B.C或者A.B.C.D,A、B、C、D为自然数。例如,1.0.0或者1.0.0.0。

      自定义版本号需唯一,请勿与该组件的历史版本号重复,否则会导致本次部署记录覆盖掉相同版本的历史部署记录。

    *容器名称

    技术栈不是Docker且“YAML模式”选择关闭时,需设置此参数。

    容器名称要求为长度为1到63个字符的字符串,可以包含小写英文字母、数字和中划线(-),并以小写英文字母开头、小写英文字母或数字结尾。

    资源

    “YAML模式”选择关闭时可设置。

    您可以根据需要自定义“CPU配额”“内存配额”,设置组件运行可以使用的最大/最小CPU核数(Core)和内存数量(GiB),从而选择性地为每个组件的实例设定所需要的资源数量。

    当您为组件实例指定了资源“申请”时,CCE就利用该信息决定将组件实例调度到哪个节点上;当您为组件实例指定了资源“限制”时,CCE就可以确保运行的组件实例占用的资源不会超出所设限制。CCE还会为组件实例预留所申请数量的系统资源。申请值和限制值的配置说明及建议,请参考资源限制指南

    如需修改,请勾选待修改项后输入新的配置值。不勾选表示不限制。

    如果“上传方式”选择的包类型为镜像包且启用了多容器部署时,请根据您的实际业务需要为各容器实例分别设置此参数。

    JVM参数

    “YAML模式”选择关闭、技术栈类型选择Java/Tomcat时可设置,用于配置Java代码运行时的内存参数大小。

    输入JVM参数,例如:

    -Xms256m -Xmx1024m

    多个参数以空格间隔,不填则为空。

    Tomcat配置

    “YAML模式”选择关闭、技术栈类型选择Tomcat时可设置,用于配置Tomcat请求路径、端口号等参数。

    1. 勾选“Tomcat配置”,弹出“Tomcat配置”对话框。
    2. 单击“使用示例模板”,根据业务要求编辑模板文件。

      Tomcat配置,使用默认server.xml配置,上下文路径是“/”,没有指定应用路径。如需自定义应用路径,请参考定制Tomcat Context path

    3. 单击“确定”

    云服务配置

    “YAML模式”选择关闭时,请参考管理组件云服务配置,根据您的实际业务需要进行设置。

    容器配置

    “YAML模式”选择关闭时,请参考管理容器部署组件容器配置,根据您的实际业务需要进行设置。

    应用配置

    “YAML模式”选择关闭时,请参考管理容器部署组件应用配置,根据您的实际业务需要进行设置。

    如果“上传方式”选择的包类型为镜像包且启用了多容器部署时,请根据您的实际业务需要为各容器实例分别设置。

    日志配置

    “YAML模式”选择开启时,请参考14,根据您的实际业务需要进行设置。

    高级配置

    “YAML模式”选择关闭时,请参考管理容器部署组件高级配置,根据您的实际业务需要进行设置。

  6. 单击“升级”

    • 在组件升级过程中,如果发现组件配置错误等原因,您可以单击“中断”终止组件升级,然后再次单击“升级”,参考升级单个组件版本配置,重新设置组件配置并完成组件升级部署。
    • 等待组件状态由“升级/回滚中”转换为“运行中”,表示已成功完成组件版本配置升级。
    • 在组件“查看历史部署记录”页面,可查看部署日志。

      如果出现“查询工作负载实例状态失败”日志信息,您可以单击“查看事件”,进入事件列表查看详情。

后续操作

操作

说明

重新部署组件

根据业务需要,您可以在“查看历史部署记录”列表中选择历史版本配置,并以此版本配置为模板,重新部署组件,请参考重新部署组件

回滚组件

根据业务需要,您可以将组件从当前最新版本配置回滚到升级前或重新部署前的版本配置,请参考回滚组件版本配置