华为云用户手册

入门实践 当您开通了部署服务后，可以根据业务需要将制品等资源部署到主机或容器，从而实现部署环境标准化和部署过程自动化。本文介绍部署服务中常见的部署方式，帮助您更好的使用部署服务。 在使用部署服务之前，请先做好如下准备工作： 已有可用项目，如果没有，请先新建项目。 具有创建应用的权限，参考权限管理。 已经编译完成的软件包。 表1 常用最佳实践 实践 描述 内网部署 通过代理主机进行内网部署 本实践提供了将应用通过代理主机部署到内网的主机或服务器的完整操作指导，旨在帮助您实现应用的内网部署。 灰度部署 基于Nginx实现灰度发布 本实践基于Nginx负载均衡机制，实现应用的蓝绿发布和灰度发布。 基于Kubernetes Nginx-Ingress实现应用的灰度发布 本实践基于Kubernetes原生的特性实现灰度发布。 虚拟机部署 通过自托管资源池实现跨Region虚拟机部署 本实践介绍如何将应用通过自托管资源池部署到华为云其他Region的主机。 云下IDC部署 通过自托管资源池部署应用至云下IDC 本实践介绍如何将应用通过自托管资源池部署到云下IDC的主机或容器集群。 HE2E DevOps实践 HE2E DevOps实践：部署应用 本实践以“DevOps全流程示例项目”为例，介绍如何部署应用至CCE与E CS 。

创建委托 使用华为云Serverless应用中心部署Stable-Diffusion WebUI应用需要FunctionGraph服务与其他云服务协同工作，因此需要通过配置委托给FunctionGraph授权必要的云服务资源的操作权限，且委托授权的生效需要15-30分钟才能生效，所以强烈建议您提前创建委托。 登录 统一身份认证 服务控制台，左侧导航栏选择“委托”，进入“委托”页面后，右上角单击“创建委托”。 在“创建委托”页面，配置如下参数： 委托名称：自定义。 委托类型：选择“云服务”。 云服务：选择“ 函数工作流 FunctionGraph”。 持续时间：选择“永久”。 描述（可选）：填写相关描述信息。 图1 创建委托 参数配置完成后，单击“下一步”，进入委托授权页面。在列表中搜索并选择如下5个系统策略或系统角色，单击“下一步”，进入选择权限的左右范围页面，给委托进行授权。 OBS Administrator SFS FullAccess SFS Turbo FullAccess VPC Administrator SWR Admin 图2 选择策略 请根据需要选择权限作用范围，如果不确定可以选择“所有资源”或者在“指定区域项目资源”中选择“华东-上海一”。 图3 指定区域项目资源 "OBS Administrator"暂不支持该授权范围，默认授权所有资源。 单击“确定”，委托创建完成，请等待委托生效。 父主题： 准备

初始化 登录函数工作流控制台，区域选择“上海一”。在左侧导航栏选择“应用中心”，在“应用程序”列表中单击需要初始化应用名称，进入“总览”页面。 在“总览”页面，单击“初始化自定义模型”开始配置。 图1 初始化自定义模型 VPC、子网、文件系统请选择前面创建的资源，函数访问路径默认为“/mnt/auto”，其他参数请根据实际业务情况填写。配置完成后，单击“确定”等待初始化完成。 图2 初始化自定义模型配置 步骤3完成后，单击“上传模型”，进入文件管理页面。默认用户名和密码均为admin，登录后请修改密码，保证数据安全。 图3 文件管理 部分关键目录如表1。 表1 关键目录路径 路径 用途 sd/models/Stable-diffusion 用于保存checkpoint模型文件。 sd/models/VAE 用于保存VAE文件。 sd/models/Lora 用于保存Lora模型。 sd/extensions 用于保存插件。 sd/outputs 用于保存生成结果。 父主题： 自定义模型

组件说明 函数流提供多种类型的组件，用户可以通过拖拽组件、配置组件和连接组件进行可视化编排，实现函数任务流的编排。使用函数流功能，请先了解表1。 表1 组件说明 类型 名称 说明 服务组件 函数 FunctionGraph函数，如何创建函数请参见创建函数。 EG 事件网格服务（EventGrid），EG节点会发布已配置的事件至指定的EG事件通道，如何创建EG资源请参见事件网格相关文档。 流程控制器 回调节点 通过人工干预实现对执行中函数流的条件控制，函数流将阻塞在回调节点，直到用户调用回调接口以继续函数流执行，从而达到人工审批的效果。 子流程 把已创建的“函数流”任务作为“子流程”组合成一个新的函数流任务。 并行分支 用于创建多个并行分支的控制器，以便同时执行多个分支任务，并可根据分支执行结束后控制下一步流程。 开始节点 只能加入触发器，用于标识流程的开始，一个流程只能有一个开始节点。 异常处理 用于控制函数执行失败后的下一步流程。 循环节点 用于对数组中每个元素进行循环处理。每次循环会执行一次循环内部的子流程。 时间等待 用于控制当前流程在指定时间延迟后再调用下一个流程。 服务节点 用于对多个函数构成的复杂操作进行抽象，可以将多个函数操作合并成一个原子节点进行管理。 条件分支 用于根据条件判断是否执行下一分支。 结束节点 用于标识流程的结束。

编排规则 设计的函数流必须是一个有向无环图，从开始节点出发，开始节点后续必须且只能连接一个节点（除了异常处理和结束节点）；流程必须在某一个节点结束，结束流程有两种形式： 流程中存在的节点没有任何后继节点，且后续节点非条件分支，并行分支或开始节点。 流程中存在结束节点，且结束节点后续无其他节点。 组件设计规则 表2 触发器和函数和EG 参数 说明 创建函数流时，是否必选 触发器 当前允许流程中配置0-10个触发器。 触发器必须配置在开始节点内。 触发器不允许连接其他任何节点，也不允许被其他节点连接。 否 函数 当前允许流程中配置0-99个函数节点。 当函数连接异常处理节点时，最多可以再连接一个非开始节点和非异常处理节点。 当函数不连接异常处理节点时，只能连接一个非开始节点。 否 EG 当前允许流程中配置0-10个EG节点。 当EG节点连接异常处理节点时，最多可以再连接一个非开始节点和非异常处理节点。 当EG节点不连接异常处理节点时，只能连接一个非开始节点。 否 表3 流程控制器 参数 说明 创建函数流时，是否必选 回调节点 回调节点限制规则参考表2中函数参数，但回调节点不可为服务节点的子节点 否 子流程 该节点选择已创建的函数流任务。 否 并行分支 用于标识节点后面的分支会并行执行。 后继节点允许连接1-20个节点（除了异常处理，开始节点和结束节点），至少连接一个节点。 否 开始节点 用于标识流程开始，每个流程必须有且只能有一个开始节点。 开始节点后面必须接1个节点，后续节点类型不能是结束节点或者异常处理。 必选 异常处理 后面可以接0-10个节点，后继节点不能是开始节点，结束节点和异常处理节点。 否 循环节点 用来对数组中每个元素进行循环处理。每次循环会执行一次循环内部的子流程。 循环节点内部子流程需要满足如下规则： 只能有一个起始节点（没有前驱节点），起始节点只能使用函数，时间等待节点。 循环节点内部只允许编排函数，时间等待，异常处理节点。 否 时间等待 后面可以连接0个或1个节点，节点类型不能是开始节点和异常处理节点。 否 服务节点 服务节点由多个函数节点组成，后续节点可以是结束节点或异常处理节点。 否 条件分支 后面可以连接2-20个后继节点，后继节点类型不能为开始节点，结束节点和异常处理节点。 否 结束节点 后面不能接任何节点。 否

亲和性概念阐述 在应用没有容器化之前，原先一个虚拟机上会装多个组件，进程间会有通信。 但在做容器化拆分的时候，通常直接按进程拆分容器。比如业务进程一个容器，监控日志处理或者本地数据放在另一个容器，并且有独立的生命周期。这时如果进程分布在网络中两个较远的点，请求经过多次转发，性能会很差。 亲和性可以实现就近部署，增强网络能力实现通信上的就近路由，减少网络的损耗。 反亲和性主要是出于高可靠性考虑，尽量分散实例，某个节点故障的时候，对应用的影响只是N分之一或者只是一个实例。 应用与可用区的亲和性 亲和：决定应用组件部署在特定的可用区中。 反亲和：决定应用组件不能部署在特定的可用区中。 应用与节点间的亲和性 亲和：决定应用组件部署在某些特定的主机中。 反亲和：决定应用组件不能部署在某些特定的主机中。 应用间的亲和性 决定应用组件部署在相同或不同节点中。 亲和：用户可根据业务需求进行应用组件的就近部署，应用组件间通信就近路由，减少网络消耗。如图1所示，APP1、APP2、APP3和APP4部署在相同节点上，为亲和性部署。 图1 应用间亲和 反亲和：同个应用组件的多个实例反亲和部署，减少宕机影响；互相干扰的应用反亲和部署，避免干扰。 如图2所示，APP1、APP2、APP3和APP4分别部署在不同节点上，这四个应用为反亲和性部署。 图2 应用间反亲和

操作步骤 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待操作泳道组名称，进入“全链路流量控制”页面。 单击泳道组当前关联的流量入口网关卡片上的“网关路由配置”。 “配置方式”选择“基于流量配置”。 根据您的实际业务需要，输入各泳道的流量配置百分比。 各泳道的流量配置取值范围为[0, 100]之间的整数，全部泳道流量配置百分比之和必须等于100%。 单击“确定”，完成基于流量的网关路由配置。 配置会对泳道组下所有泳道生效。

添加组件标签 登录ServiceStage控制台。 选择以下任意方式进入组件“概览”页面。 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式。 单击“标签管理”。 图2 管理标签 单击“添加标签”： 输入“键”、“值”。 输入的“键”名称不能和已有标签的“键”名称重复。 单击“保存”。 图3 添加标签

删除组件标签 登录ServiceStage控制台。 选择以下任意方式进入组件“概览”页面。 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式。 单击“标签管理”。 选择待删除的标签，单击“操作”列的“删除标签”。 图4 删除标签 单击“保存”。

修改弹性伸缩-HPA策略 您可以根据实际业务需要，编辑已设置好的弹性伸缩-HPA策略，重新设置策略参数。 登录ServiceStage控制台。 选择以下任意方式进入组件“伸缩”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“伸缩”页面，选择“伸缩策略配置”页签，单击“编辑伸缩策略”，重新设置参数。 冷却时间 根据实际业务需要，修改扩容/缩容冷却时间。 实例范围 根据实际业务需要，修改最小实例数和最大实例数。 触发条件 支持通过“界面配置”、“YAML配置”两种方式修改触发条件参数。 “界面配置”方式 根据实际业务需要，修改“CPU利用率”、“内存利用率”指标的“期望值”和“阈值”（缩容阈值、扩容阈值）。 “YAML配置”方式 使用YAML格式可以自定义指标参数配置，并支持更多指标，如pods、Object、External等。 使用“YAML配置”方式配置自定义指标参数，CCE集群需要已安装prometheus插件。 为CCE集群安装prometheus插件，请参考prometheus。 单击“确定”，完成修改。

设置弹性伸缩-HPA策略 登录ServiceStage控制台。 选择以下任意方式进入组件“伸缩”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“伸缩”页面，单击“弹性伸缩 - HPA”右侧的，开启伸缩策略配置，进入“伸缩策略配置”页签。 CCE集群未安装metrics-server插件，请执行4。 CCE集群已安装metrics-server插件，请执行6。 单击“立即前往配置”，在云容器引擎控制台完成metrics-server插件安装。 为CCE集群安装metrics-server插件，请参考metrics-server。 等待插件安装完成后，返回“伸缩策略配置”页面，刷新页面。 设置伸缩策略参数。 策略名称 输入策略名称。伸缩策略设置完成后，策略名称不支持修改。 冷却时间 根据实际业务需要，输入扩容/缩容冷却时间。 策略成功触发后，在扩容/缩容冷却时间内，不会再次触发扩容/缩容。 实例范围 根据实际业务需要，输入最小实例数和最大实例数。 策略成功触发后，工作负载实例将在此实例范围内伸缩。 触发条件 支持通过“界面配置”、“YAML配置”两种方式设置触发条件参数。 “界面配置”方式 根据实际业务需要，设置“CPU利用率”、“内存利用率”指标的“期望值”和“阈值”（缩容阈值、扩容阈值）。 策略成功触发后，通过向上取整（当前CPU或内存利用率指标值 / 期望值 × 当前运行实例数）来计算需要伸缩的实例数。 当前CPU或内存利用率的指标值小于缩容阈值时，触发缩容。 当前CPU或内存利用率的指标值大于扩容阈值时，触发扩容。 “YAML配置”方式 metrics: - type: Resource resource: name: cpu target: type: Utilization averageUtilization: 50 - type: Resource resource: name: memory target: type: Utilization averageUtilization: 50 - type: Pods pods: metric: name: packets-per-second target: type: AverageValue averageValue: 1k - type: Object object: metric: name: requests-per-second describedObject: apiVersion: networking.k8s.io/v1beta1 kind: Ingress name: main-route target: type: Value value: 10k 如以上示例所示，使用YAML格式除了使用CPU（cpu）、内存（memory）的利用率（Utilization）作为指标外，还可以自定义指标参数配置，并支持更多指标，如Pods、Object、External等。 使用“YAML配置”方式配置自定义指标参数，CCE集群需要已安装prometheus插件。 为CCE集群安装prometheus插件，请参考prometheus。 单击“确定”，完成策略设置。 弹性伸缩-HPA策略设置完成后，您可以根据业务需要，执行以下操作： 修改弹性伸缩-HPA策略 查看弹性伸缩-HPA策略运行情况 删除弹性伸缩-HPA策略

查看弹性伸缩-HPA策略运行情况 ServiceStage支持查看已设置好的弹性伸缩-HPA策略的运行状态和运行事件。 登录ServiceStage控制台。 选择以下任意方式进入组件“伸缩”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“伸缩”页面： 选择“状态”页签，查看策略运行状态。 选择“事件”页签，查看策略运行中发生的事件。

删除弹性伸缩-HPA策略 您可以根据实际业务需要，删除不再使用的弹性伸缩-HPA策略。 删除操作无法恢复，请谨慎操作。 登录ServiceStage控制台。 选择以下任意方式进入组件“伸缩”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“伸缩”页面，单击“弹性伸缩 - HPA”右侧的。 单击“确定”，完成策略删除。

设置优雅缩容策略 登录ServiceStage控制台。 选择以下任意方式进入组件“伸缩”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“伸缩”页面，设置优雅缩容策略。 设置“缩容时间窗”：单击，修改参数，单击生效。 图1 设置优雅缩容策略

设置手动伸缩策略 登录ServiceStage控制台。 选择以下任意方式进入组件“伸缩”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“组件管理”页面，单击待操作组件名称或者在组件名称上单击右键选择打开组件“概览”页面的方式，在左侧导航栏单击“伸缩”。 在“伸缩”页面的“手动伸缩”区域，设置手动伸缩策略。 部署环境为Kubernetes类型的组件，请参考以下操作： 单击，修改“实例数”。 单击，实例伸缩操作即可生效。 图2 设置手动伸缩策略（部署环境为Kubernetes类型的组件） 部署环境为虚拟机类型的组件，请参考以下操作： 在“当前实例数”，单击。 选择“伸缩类型”，根据实际需要增加或者减少组件运行实例。 “伸缩类型”选择“扩容”时，单击“添加弹性云服务器”，可参考购买弹性云服务器创建新的ECS实例，用于运行新增组件实例。 “伸缩类型”选择“缩容”时，可以将当前运行组件实例数缩减到1个为止。 单击“确定”。 图3 设置手动伸缩策略（部署环境为虚拟机类型的组件）

操作步骤 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待操作非基线泳道所在泳道组名称，进入“全链路流量控制”页面。 单击待操作非基线泳道卡片上的。 单击切换开关，设置路由规则生效方式。 或：默认生效方式，匹配任意一条路由规则就生效。 且：匹配所有路由规则才生效。 单击“新增匹配规则”，参考下表设置路由匹配规则。 参数 参数说明 匹配类型 支持的路由规则匹配类型。 当前仅支持基于“请求头”类型的匹配。 参数名称 “匹配类型”对应的key值。 条件类型 “条件值”满足的匹配规则。 前缀匹配：以前缀作为匹配条件。 精确匹配：即完全匹配。 正则匹配：以正则表达式作为匹配条件。 条件值 “匹配类型”对应的value值。 单击“确定”，完成基于内容的网关路由配置。 开启泳道流量，使配置生效。 单击。 单击“确定”。 配置会对该非基线泳道下的所有组件生效。如果业务请求无法匹配到该非基线泳道所配置的路由规则，则网关将业务请求转发至基线泳道的组件处理。

删除应用环境变量 登录ServiceStage控制台。 选择“应用管理”。 单击待操作的应用名称，进入应用概览页面。 在左侧导航栏，单击“环境变量”。 在“环境”下拉列表选择已经创建的环境。 删除单个应用环境变量：选择待删除的变量名称，在“操作”栏单击“删除”。 图4 删除单个应用环境变量 批量删除应用环境变量：勾选待删除的变量名称，单击“批量删除”。 图5 批量删除应用环境变量 在弹出对话框，单击“确定”。

导入应用环境变量文件 登录ServiceStage控制台。 选择“应用管理”。 单击待操作的应用名称，进入“应用概览”页面。 在左侧导航栏，单击“环境变量”。 在“环境”下拉列表选择已经创建的环境。 单击“导入”，选择本地已创建好的环境变量文件。 导入的文件应为JSON或YAML格式、字符串形式的键值对映射，例如： {"key1": "value1", "key2": "value2"} 其中： “key1”、"key2"是应用环境变量的名称，必须唯一。 “value1”、"value2"是对应应用环境变量的值。 单击“提交”，完成应用环境变量文件导入。 图2 导入应用环境变量文件

手动添加应用环境变量 登录ServiceStage控制台。 选择“应用管理”。 单击待操作的应用名称，进入“应用概览”页面。 在左侧导航栏，单击“环境变量”。 在下拉列表选择已经创建的环境。 单击“添加环境变量”，输入“变量名称”及“变量/变量引用”的值。 其中： “变量名称”是应用环境变量的名称，必须唯一。 “变量/变量引用”是应用环境变量的值。 例如，设置“变量名称”为“User”，“变量/变量引用”为“admin”。即当程序代码读取“User”环境变量时，获取值为“admin”。例如可以使用admin用户启动子进程，可以用admin用户去读取文件等。实际执行效果视代码而定。 单击“提交”，完成应用环境变量手动添加。 图1 手动添加应用环境变量

编辑应用环境变量 登录ServiceStage控制台。 选择“应用管理”。 单击待操作的应用名称，进入应用概览页面。 在左侧导航栏，单击“环境变量”。 在“环境”下拉列表选择已经创建的环境。 选择待编辑的变量名称，在“操作”栏单击“编辑”。 重新输入“变量名称”及“变量/变量引用”的值。 “变量名称”是应用环境变量的名称，必须唯一。 “变量/变量引用”是应用环境变量的值。 单击“提交”，完成应用环境变量编辑。 图3 编辑应用环境变量

管理命名空间资源配额 默认情况下，CCE集群运行中的Pod可以无限制的使用Node节点上的CPU和内存，这意味着任意一个Pod都可以无节制地使用集群的计算资源，某个命名空间的Pod可能会耗尽集群的所有资源。 kubernetes在一个物理集群上提供了多个虚拟集群，这些虚拟集群被称为命名空间。命名空间可用于多种工作用途，满足多用户的使用需求，通过为每个命名空间配置资源额度可以有效限制资源滥用，从而保证集群的可靠性。您可为命名空间配置包括CPU、内存、Pod数量等资源的额度，更多信息请参见Resource Quotas。 用户创建命名空间、集群默认创建的default命名空间支持资源配额管理。 登录ServiceStage控制台。 在“环境管理”页面，单击待操作环境名称。 在“资源配置”下左侧列表，选择“计算”资源类型下的资源名称“云容器引擎 CCE”。 选择“命名空间”页签，进入命名空间列表。 在待操作的命名空间所在行“操作”列，单击“配额管理”。 在弹出的“配额管理”对话框，您可以查看该命名空间下的资源类型及资源配额总量、配额累计使用量。 图4 进入配额管理页面 单击“编辑配额”，根据您的实际业务需求，设置各资源类型的总配额。 如果不限制该资源类型的使用量，则输入为空。 如果限制该资源类型的使用量，请输入期望的整型数值，取值范围为1到9,007,199,254,740,992。 配额累计使用量包含CCE系统默认创建的资源，如default命名空间下系统默认创建的kubernetes服务（该服务可通过后端kubectl工具查看）等，故建议命名空间下的资源配额略大于实际期望值以去除系统默认创建资源的影响。 如果限制了命名空间下CPU或内存的总配额，则在创建并部署组件、升级单个组件版本配置中为部署环境为Kubernetes类型且命名空间为该命名空间的组件设置资源时，必须设置组件运行可以使用的最大、最小CPU核数（Core）和内存数量（GiB）。否则，会导致操作失败。 如果限制了命名空间下其他资源类型的总配额，当该资源类型剩余使用量不满足需求时，会导致部署环境为Kubernetes类型且命名空间为该命名空间的组件部署失败。 单击“确定”。

创建命名空间 登录ServiceStage控制台。 在“环境管理”页面，单击待操作环境名称。 在“资源配置”下左侧列表，选择“计算”资源类型下的资源名称“云容器引擎 CCE”。 选择“命名空间”页签，单击“创建命名空间”。 参考下表填写参数，其中带“*”标志的参数为必填参数。 参数 说明 *命名空间 输入命名空间的名称。 命名空间描述 输入命名空间的描述信息。 图1 设置命名空间参数 单击“确定”。 创建成功的命名空间会显示在命名空间列表。

删除命名空间 删除命名空间会删除该命名空间下所有的资源（如工作负载、配置项等），请谨慎操作。 集群默认创建的命名空间，不支持删除。 登录ServiceStage控制台。 在“环境管理”页面，单击待操作环境名称。 在“资源配置”下左侧列表，选择“计算”资源类型下的资源名称“云容器引擎 CCE”。 选择“命名空间”页签，删除命名空间。 删除单个命名空间：在待删除的用户创建的命名空间所在行“操作”列，单击“删除”。 图2 删除单个命名空间 批量删除命名空间：勾选待删除的用户创建的命名空间，单击命名空间列表左上端的“删除”。 图3 批量删除命名空间 在弹出的对话框输入“DELETE”后，单击“确定”。

操作步骤 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待操作泳道组名称，进入“全链路流量控制”页面。 单击泳道组当前关联的流量入口网关卡片上的“网关路由配置”。 “配置方式”选择“基于内容配置”。 单击以对应非基线泳道名称命名的页签，进入为指定非基线泳道配置网关路由页面。 单击切换开关，设置路由规则生效方式。 或：默认生效方式，匹配任意一条路由规则就生效。 且：匹配所有路由规则才生效。 单击“新增匹配规则”，参考下表设置路由匹配规则。 参数 参数说明 匹配类型 支持的路由规则匹配类型。 当前仅支持基于“请求头”类型的匹配。 参数名称 “匹配类型”对应的key值。 条件类型 “条件值”满足的匹配规则。 前缀匹配：以前缀作为匹配条件。 精确匹配：即完全匹配。 正则匹配：以正则表达式作为匹配条件。 条件值 “匹配类型”对应的value值。 单击“确定”，完成基于内容的网关路由配置。 配置会对泳道组下对应非基线泳道的所有组件立即生效。如果业务请求无法匹配到非基线泳道所配置的路由规则，则网关将业务请求转发至基线泳道的组件去处理。 如需关闭非基线泳道流量，请参考开启/关闭非基线泳道流量。

前提条件 只能在应用下新增组件，请先创建应用，请参考创建应用。 组件需要部署在指定环境下，请先创建环境并纳管资源，请参考环境管理。 需要根据组织管理组件构建生成的镜像，请先创建组织，请参考创建组织。 （可选）如果基于Kubernetes类型的环境创建并部署组件，请先创建命名空间，请参考创建命名空间。 如果您基于“源码仓库”创建组件，那么您首先需要创建仓库授权，请参考仓库授权。 如果您基于软件包创建组件，那么您首先需要将软件包上传至CodeArts软件发布库、SWR软件仓库或者OBS对象存储中。 将软件包上传至CodeArts软件发布库，请参考上传软件包。 将软件包上传至SWR软件仓库，请参考上传软件包。 将软件包上传至OBS对象存储中，请参考上传对象。 如果上传软件包失败，请参考如何解决上传软件包失败的问题？。

通过Helm客户端安装Sermant Injector 安装Helm客户端。 Helm下载链接：https://github.com/helm/helm/releases，请选择合适的版本，本章节以helm v3.3.0为例进行演示。 下载helm-v3.3.0-linux-amd64.tar.gz。 登录已安装kubectl命令的CCE节点，然后将Helm安装包上传到CCE节点上。 请参考Linux弹性云服务器登录方式概述选择相应方式登录CCE节点。 解压Helm安装包。 在Helm安装包所在的路径执行命令tar -zxf helm-v3.3.0-linux-amd64.tar.gz解压Helm安装包。 将helm移动到系统path所在路径。 以“/usr/local/bin/helm”为例，在Helm解压包所在的路径执行命令mv linux-amd64/helm /usr/local/bin/helm进行移动。 验证安装结果。 执行命令helm version，如果输出下图中的信息，则说明安装成功： 安装用户需要有安装目录和系统path路径的读写权限。 第一次启动Sermant Injector实例之前，需申请Sermant Injector https证书。 登录已安装kubectl命令的CCE节点，请参考Linux弹性云服务器登录方式概述选择相应方式登录CCE节点。 在已安装kubectl命令的CCE节点中执行以下命令申请Sermant Injector https证书： wget -O- https://cse-bucket-cn-east-3.obs.cn-east-3.myhuaweicloud.com/javaagent/certificate.sh | sh 该步骤会把证书挂载到cse命名空间中，如果不存在cse命名空间，则会自动创建。 该步骤会向k8s集群申请名为sermant-injector.cse.svc的CertificateSigningRequest，如果之前存在，则会被覆盖。 该步骤会在cse命名空间中创建名为sermant-injector-secret的Secret，如果之前存在，则会被覆盖。 使用Sermant Injector时，如果提示证书失效等证书相关的错误，请重新申请证书并重新安装Sermant Injector实例。 安装Sermant Injector模板。 登录已安装Helm客户端的CCE节点并执行以下命令下载Sermant Injector模板： wget -O- 'https://cse-bucket-cn-east-3.obs.cn-east-3.myhuaweicloud.com/javaagent/sermant-injector-1.0.9.tgz' | tar zx Sermant Injector模板版本信息如下： 版本 发行时间 1.0.9 2023.06.30 修改配置。 下载模板后，编辑模板包中的values.yaml文件，按需修改配置。配置说明如下： agent: image: # 选填配置，Sermant Agent镜像版本，默认为最新版本。 version: ${agent.version} cse: config: # 必填配置，微服务引擎配置中心地址，获取方式请参考获取微服务引擎配置中心地址。 endpoints: https://localhost:30110 registry: # 必填配置，注册中心类型，当前支持SERVICE_COMB/NACOS type: SERVICE_COMB # 必填配置，微服务引擎注册中心地址，获取方式请参考获取微服务引擎服务注册发现地址。 endpoints: https://localhost:30100 image: # 选填配置，镜像拉取策略：Always(总是拉取)/IfNotPresent(本地有则使用本地镜像,不拉取)/Never(只使用本地镜像，从不拉取) pullPolicy: IfNotPresent # 必填配置，CCE所在的region，具体请参考地区和终端节点。 region: ${region} injector: image: # 选填配置，injector镜像版本，默认为最新版本。 version: ${injector.version} # 选填配置，拉取镜像的密钥。 pullSecrets: default-secret # 选填配置，injector实例数，若CCE集群只有一个节点，则需配置为1。 replicas: 2 webhooks: # 必填配置，K8s集群证书，请在已安装kubectl命令的CCE节点中使用以下命令获取 # kubectl config view --raw --minify --flatten -o jsonpath='{.clusters[].cluster.certificate-authority-data}' caBundle: null 安装Sermant Injector模板。 在Sermant Injector模板包所在路径执行命令helm install sermant-injector sermant-injector-1.0.9进行安装。 如果需要卸载Sermant Injector，请执行helm uninstall sermant-injector命令。卸载Sermant Injector后，不会再自动挂载Sermant Agent。已挂载Sermant Agent的应用如果未重启则不受影响，如果重启，因为Sermant Injector已被卸载，则应用不会再挂载Sermant Agent。 父主题： 安装Sermant Injector

操作步骤 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待关联组件的基线泳道所在泳道组名称，进入“全链路流量控制”页面。 基线泳道未关联组件：单击基线泳道卡片上的“关联组件”或右上角的，在弹出的“关联组件”对话框勾选待关联的组件。 基线泳道已关联组件：单击基线泳道卡片上右上角的，在弹出的“关联组件”对话框勾选待关联的组件。 所有待关联组件需已经绑定同一个微服务引擎（对应于 微服务引擎CSE 服务的ServiceComb引擎专享版）。 组件未被其他泳道关联。 组件的标签为默认的base标签。 单击“确定”，完成基线泳道组件关联。 单击基线泳道卡片上当前已关联的组件数，可以查看基线泳道已关联的组件列表。

实现步骤 请参见OBS帮助中心创建桶。若已有OBS桶，请直接执行步骤2。 创建的OBS桶所在区域必须为华北-北京四。 OBS桶授权。 登录 实时音视频 控制台。 在左侧导航树中选择“云资源授权”，进入桶授权页面。 在对应的OBS桶行单击“授权”，完成桶授权。 配置录制规则。 登录实时音视频控制台。 在左侧导航树中选择“应用管理”，进入应用管理页面。 在需要创建录制规则的应用行单击“录制配置”，进入录制配置页面。 在“录制规则”页签，单击“添加”，进入添加录制规则页面。 一个应用ID仅支持创建一个录制规则。 请您按照实际需求配置录制参数，参数说明如表1所示。 表1 录制参数说明 参数名 描述 存储-桶 存储录制文件的OBS桶。 目前录制文件仅支持存储到华北-北京四的OBS桶中。 区域 OBS桶所在的区域。 存储-路径 存储录制文件的OBS桶路径。 录制格式 录制文件的格式，支持HLS和MP4文件格式。 HLS规则 m3u8命名规则 录制m3u8文件的存储路径和文件的前缀。 默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。 录制周期 录制时长支持0-720分钟，最小录制周期为1分钟，最大录制周期为12小时，超过12小时，系统将按照命名规则生成新文件。如果录制周期为0，则整个流录制为一个文件。 最大断流合并时长 支持如下三种配置： 断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。 断流后不生成新文件：是指录制的直播流中断后，会和之前录制的文件合并为一个文件。最大断流合并时长为30天。 其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 MP4规则 mp4命名规则 录制mp4文件的存储路径和文件的前缀。 默认命名格式： {app_id}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time} 上述特殊变量的含义如下： app_id：应用ID。 record_format：录制格式。 stream：流名。 file_start_time：文件生成时间。 录制周期 录制时长支持1-180分钟，最小录制周期为1分钟，最大录制周期为3小时，超过3小时，系统将按照命名规则生成新文件。 最大断流合并时长 支持如下两种配置： 断流后生成新文件：是指录制的直播流中断后，会立即生成新的录制文件。 其他数值：是指录制的直播流中断时间在设置范围内，则和之前录制的文件合并为一个文件，否则，生成新的录制文件。 单击“确定”，在录制规则列表中会增加一条新的录制规则。 图2 录制规则 您可以在录制规则列表中，根据实际需求选择是否开启自动录制功能。自动录制功能开启后，若该应用下有新创建的房间，则会按照已配置的录制规则自动对该房间中的实时音视频互动过程进行录制。 自动录制功能开启后，仅对同一应用下新创建的房间生效，自动录制功能开启前已创建的房间不生效。 加入房间。 录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC服务会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启云端录制任务，SparkRTC才会根据API中的录制规则ID对实时音视频互动画面进行录制。 回放录制文件。 录制完成后，您可以在OBS控制台中或通过回调消息查看录制文件。 通过OBS控制台查看录制文件 在OBS管理控制台左侧导航栏选择“对象存储”。 在桶列表中单击存储SparkRTC录制文件的桶，进入“概览”页面。 在左侧导航栏，单击“对象”，查看录制文件信息。 您还可以对录制文件进行下载、分享等操作，具体请参见OBS帮助中心。

合流布局 在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。 九宫格模板 每个用户画面平铺在画布上，大小一致。根据用户数量，动态调整每个画面的大小和位置。最多支持25个画面。不同人数的实际布局效果如下图所示。 如果实际视频流的宽高比与视窗的宽高比不一致，视频画面会裁剪以适配视窗的大小。 中途有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，显示背景图。 屏幕共享模板 屏幕分享（或者主讲人摄像头画面）始终占据屏幕左侧或者右侧大画面位置，其他用户依次垂直排列于旁边。最多支持17个画面。不同人数的实际布局效果如下图所示。 大视窗画面，可选择主讲摄像头流或共享屏幕流。 大视窗画面，显示指定的UID用户的视频，如果未指定或者指定用户未进入频道，大视窗区域显示背景色。 左侧大视窗为了保持内容的完整性采用缩放方式处理，右侧小视窗采用裁剪方式适配视窗的大小。 右侧小视窗画面按照加入房间的时间先后顺序排列。 右侧小视窗有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，显示背景图。 自定义布局模板 支持用户自定义合流布局样式，可灵活设置用户画面的大小，指定用户画面在视频画布上的相对位置。 可自定义各个视频窗格在画布上的位置。 可自定义各个视频窗格的宽和高。 针对每一个窗格，可通过user_id指定显示房间内某一用户。 针对窗格，可自定义选择呈现摄像头流或者屏幕分享流。 如果实际视频流的宽高比与视窗的宽高比不一致，自定义布局场景下支持选择裁剪和缩放两种模式。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，则显示背景图。

实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。 由于单AZ桶的可靠性低于多AZ桶，为避免因OBS服务异常导致录制失败，建议您创建多AZ桶用于录制文件的存储。 OBS桶授权：在SparkRTC服务中对存储录制文件的OBS桶进行授权，允许SparkRTC服务将录制文件存储在对应的OBS桶中。 配置录制规则：为实时音视频互动配置录制规则，并开启自动录制功能，加入SparkRTC房间后，与应用中的录制规则ID相同的录制模板会自动生效，录制内容按录制设置存储至OBS中。还可以通过设置回调地址获取录制任务状态通知。 加入房间：录制规则配置完成后，您可以通过SparkRTC APP加入某个SparkRTC房间进行音视频互动，SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启、查询和控制云端录制任务。SparkRTC服务才会根据接口中的录制规则ID对实时音视频互动画面进行录制。 回放录制文件：录制完成后，在已配置的回调地址中会收到录制任务的回调消息，您可以获取到录制文件的基本信息，也可以在OBS中管理录制文件，如下载、分享、删除等。 录制文件的分辨率与推流分辨率相关，按推流原分辨率进行录制。