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

使用发布单模板创建Region级发布单

同一个项目下,ServiceStage可支持最多创建1,000个Region级发布单。

本章节指导您使用发布单模板创建Region级发布单,将在同一个Region下的应用、组件、构建任务按需组合在不同阶段下并编排发布。

发布单模板说明

创建好的模板文件需要打包成zip包。一个发布单模板包里可以包含多个应用,一个应用下可以包含多个组件。发布单模板包目录总体结构示例如下:

release/  
|-- app-1
|   |-- app.yaml
|   |-- component-1/
|   |   |-- spec.yaml
|   |   |-- variables.yaml
|   |   |-- values.yaml
|   |   |-- component/
|   |   |   |-- demo_component.yaml
|   |   |   |-- demo_config.yaml
|   |   |   |-- deployment.yaml
|   |   |   |-- configmap.yaml
|   |   |   |-- service.yaml
|   |   |--...(其他Kubernetes资源文件)
|   |   |-- README.md
|   |-- component-2/
……
|-- app-2
……

其中,release为发布模板压缩包名称,app-1、app-2为模板包中的应用目录,component-1、component-2为应用下的组件目录。

  • 应用目录下文件说明
    • app.yaml,应用说明文件。声明了应用名称及所属企业项目。文件内容示例如下:
      kind: ServiceStageApplication
      spec:
          name: test-application-zyh
          enterprise_project_id: 0
    • spec.yaml,应用配置信息文件。包含模型版本、模型类型等。文件内容示例如下:
      # 模型版本号,当前只有v1.0.0一个版本
      model_version: v1.0.0
      
      # 模型类型,Application表示为应用模型
      model_type: Application    
    • values.yaml,变量默认值说明文件。文件内容示例如下:
      namespace: demo
      dep_name: demo-dep
      svc_port: 8080
      value: World
      image: swr.example.com/ss/demo-app:latest
    • variables.yaml,支持的变量声明文件,所有变量在该文件中声明,包含变量名、类型、描述和默认值。文件内容示例如下:
      variable:
        namespace:
          type: string
          default: demo
          description: 命名空间
        dep_name:
          type: string
          default: demo-dep
          description: 工作负载的名字
        svc_port:
          type: integer
          default: 8080
          description: 服务的端口号
        value:
          type: string
          default: World
          description: Hello接口响应数据
        cce_resource:
          type: cce
          description: CCE资源
        image:
          type: string
          description: 工作负载镜像
  • 组件目录下文件说明

    组件目录下文件说明,请参考组件模板说明

前提条件

  • 已经参考发布单模板说明将准备好的发布单模板文件打包为zip包并上传到存储库。
    • 将模板包上传至SWR软件仓库,请参考上传软件包

      如果禁用了PKIToken,则不支持SWR软件仓库。

    • 从OBS对象存储选择对应的模板包。需要提前将模板包上传至OBS桶中,相关操作请参考流式上传(PUT上传)
    • 如果需要使用例如JFrog(制品仓库)作为模板包存储仓库,支持HTTP/HTTPS协议的自定义文件下载地址作为模板包下载地址,您需要提前将模板包上传至对应的自定义文件地址下。
  • 如果发布单模板中包含了创建环境及基础资源任务,需联系管理员参考下表为操作账号所在用户组授予资源编排服务RFS的对应权限。同时,还需要为操作账号所在用户组授予待创建的基础资源创建权限。授权操作,请参考给用户组授权

    操作账号所在用户组拥有的ServiceStage权限

    需要授予操作账号所在用户组的RFS权限

    ServiceStage FullAccess

    RF FullAccess

    ServiceStage Administrator

    ServiceStage Developer

操作步骤

  1. 登录ServiceStage控制台
  2. 单击左侧导航栏“发布管理”

    • 如果默认进入的是如下图所示的新版“发布管理”页面,请执行4

      新版发布管理详情,请参考新版发布管理概述

    • 如果默认进入的是如下图所示的旧版“发布管理”页面,请执行3

      旧版发布管理详情,请参考旧版发布管理概述

  3. 单击“立即体验新版”或者“体验新版”,切换到新版“发布管理”页面。

    新、旧版本发布单之间数据不互通,新、旧版本发布单页面切换不会造成发布单数据丢失。

  4. 选择“Region级发布单”
  5. 单击“基于发布单模板创建”,参考下表填写发布单参数,其中带“*”标志的参数为必填参数。

    参数名称

    参数说明

    *发布单名称

    发布单的名称在同一个“企业项目”下需保持唯一。

    长度2到64个字符,可以包含英文字母、数字、下划线(_)或中划线(-),以英文字母开头、英文字母或者数字结尾。

    *企业项目

    企业项目是一种云资源管理方式,企业项目管理服务提供统一的云资源按项目管理,以及项目内的资源管理、成员管理。

    请参考开通企业项目,开通企业项目后使用。

    • 单击下拉列表,可以选择使用已有企业项目。
    • 单击“创建企业项目”,可以参考创建企业项目,创建并选择使用新建的企业项目。

    描述

    发布单描述信息。

    1. 单击
    2. 输入不超过128个字符的发布单描述信息。
    3. 单击

  6. 设置“模板包配置”,参考下表根据模板包存储方式选择已经上传的发布单模板包。

    模板包存储库

    操作方法

    CodeArts软件发布库

    如果禁用了PKIToken,则不支持使用CodeArts软件发布库。

    1. 单击“选择软件包”
    2. 从CodeArts软件发布库选择已经上传的模板包。
    3. 单击“确定”

    OBS对象存储

    1. 单击“选择软件包”
    2. 从OBS桶选择已经上传的模板包。
    3. 单击“确定”

    SWR软件仓库

    如果禁用了PKIToken,则不支持使用SWR软件仓库。

    1. 单击“选择软件包”
    2. 从SWR软件仓库选择已经上传的模板包。
    3. 单击“确定”

    自定义文件地址

    如果需要使用例如JFrog(制品仓库)作为组件模板包存储仓库,您可以执行以下操作获取已经上传到自定义文件地址下的组件模板包。
    1. 输入模板包所在的HTTP/HTTPS协议的自定义文件下载地址。

      自定义文件地址必须是发布单模板包文件的完整路径,例如:https://172.16.0.1:8082/artifactory/template-release.zip。

      单击“添加自定义文件地址”,可以输入多个模板包所在的HTTP/HTTPS协议的自定义文件下载地址。

    2. 选择是否开启认证。

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

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

  7. 单击“下一步”

    • “模板预览”区域,您可以查看发布单模板文件的详细内容。
    • “配置参数”区域,您可以查看并修改发布单配置参数。

  8. 单击“创建并部署”

    • “发布流程视图”页面,可以查看发布单流程详情。
    • 发布单创建成功后,其“发布状态”“初始化成功”。查看发布单状态,请参考查看Region级发布单详情
    • 发布单创建成功后,您可以参考管理Region级发布单管理发布单。