响应消息 表4 响应参数 参数 参数类型 描述 id String 目标服务ID。 host String 目标服务host信息。 host信息由目标服务的接入引擎后的微服务名、微服务所在环境名、微服务所属应用名称已经微服务接入的引擎类型组成，以点号（.）分隔。 例如，unit-controller.testing.test-application.servicecomb。unit-controller为接入引擎的微服务名称，testing为unit-controller微服务所在环境名，test-application为unit-controller微服务所属应用名称，servicecomb表示unit-controller微服务接入的是ServiceComb引擎。 name String 目标服务名称。 service_source_name String 目标服务对应的服务来源名称。 engine_id String 目标服务对应的服务来源引擎ID。 engine_type String 目标服务对应的服务来源引擎类型。 swimlane_group_id String 泳道组ID。 swimlane_group_name String 泳道组名称。 status String 目标服务状态。 TARGET_SERVICE_MANAGED：目标服务已经被纳管。 MICROSERVICE_OF_TARGET_SERVICE_UNROUTING：目标服务对应的微服务不支持路由。 MICROSERVICE_OF_TARGET_SERVICE_MANAGED：目标服务对应的微服务被纳管。

请求消息 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。

响应示例 [ { "id": "8177d237-b912-4167-a90d-33c603610d0b", "host": "provider..demo-java-chassis-cse-v2.servicecomb", "name": "provider", "service_source_name": "cscs", "engine_id": "d68a5ca7-b5b6-4917-a464-0adef94b8067", "engine_type": "servicecomb", "swimlane_group_id": null, "swimlane_group_name": null, "status": null }, { "id": "8d8d5d85-2ae6-463b-b2e9-0fa9d9a0aa7d", "host": "test.static", "name": "test", "service_source_name": "static", "engine_id": null, "engine_type": null, "swimlane_group_id": null, "swimlane_group_name": null, "status": "MICROSERVICE_OF_TARGET_SERVICE_UNROUTING" } ]

请求消息 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。

创建基线泳道 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待创建基线泳道所在泳道组名称，进入“全链路流量控制”页面。 单击“创建基线泳道”，参考下表填写泳道信息，其中带“*”标志的参数为必填参数。 参数名称 参数说明 *泳道名称 泳道的名称。 长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或数字结尾。 *标签 用于在Kubernetes类型的环境下创建并部署组件时，将绑定微服务引擎的组件打上相应的标签以标记流量。当有请求访问时，应用网关会根据路由规则将流量转发到对应流量标签的微服务上。当无法找到对应标签的微服务时，将转发至基线泳道对应的微服务。 基线泳道的标签默认为base，不可修改。 单击“确定”，完成基线泳道创建。

更换泳道组目标服务 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待操作泳道组名称，进入“全链路流量控制”页面。 单击泳道组当前关联的流量入口网关卡片上“目标服务”后的，参考下表填写相关参数，其中带“*”标志的参数为必填参数。 参数名称 参数说明 *目标服务 更换通过该网关转发流量的目标服务。 您可以根据实际业务需要，在下拉列表选择已创建好的目标服务。 说明： 可选择的目标服务需要未被其他泳道组使用，其对应的微服务未被其他泳道组使用且支持路由。 单击“创建目标服务”，您可以根据实际业务需要创建新的目标服务以供选择。创建目标服务，请参考创建服务。 单击已关联目标服务后的，可以删除已关联目标服务。 单击“确定”，完成泳道组目标服务更换。

克隆基线泳道组件到灰度泳道 登录ServiceStage控制台。 单击“全链路流量控制”。 单击待操作灰度泳道所在泳道组名称，进入“全链路流量控制”页面。 单击待操作灰度泳道卡片右上角的。 设置“发布单名称”及“描述”信息。 发布单名称：长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或数字结尾。 描述：长度不超过128个字符。 设置“激进策略”。 单击，可开启“激进策略”。遇到组件发布失败，会继续发布剩余组件。 勾选待克隆到灰度泳道的组件，单击“确定”。 参考下表批量设置待克隆组件版本配置信息。 参数名称 参数说明 组件名称 组件的名称。 长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或者数字结尾。 不同应用下的同名组件可以部署在同一个环境下。 同一个应用下的同名组件可以部署在同一个环境下的不同泳道。 同一个应用下的同名组件可以部署在不同环境下。 组件版本 组件版本号。 默认以您开始执行克隆组件操作的时间来生成版本号，格式为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。 说明： 您可以执行以下操作，批量同步设置组件版本号： 鼠标移动到指定组件的“组件版本”输入框，单击。 勾选需要同步配置组件版本号的其他组件。 单击“确定”。 所属应用 选择组件所属应用。您可以执行以下操作，批量同步设置组件所属应用： 鼠标移动到指定组件“所属应用”下拉列表框，单击。 勾选需要同步配置组件所属应用的其他组件。 单击“确定”。 所属环境 选择组件部署环境，仅可选择“Kubernetes”类型环境。 须知： 如果组件已经绑定了指定的微服务引擎、分布式缓存或云数据库实例，而为该组件重新选择的环境下并未绑定这些指定的实例，则会在高级配置预检查中报错。 您可以执行以下操作，批量同步设置组件所属环境： 鼠标移动到指定组件“所属环境”下拉列表框，单击。 勾选需要同步配置组件所属环境的其他组件。 单击“确定”。 重新设置组件所属环境后，该组件所属集群会同步变更为重新选择的环境下绑定的集群，所属命名空间会同步变更为重新选择的环境下绑定集群的default命名空间。 所属集群 选择组件部署和运行的CCE集群。 您可以执行以下操作，批量同步设置组件所属命名空间： 鼠标移动到指定组件“所属集群”下拉列表框，单击。 勾选需要同步配置组件所属集群的其他组件。 单击“确定”。 批量同步设置组件所属集群后，仅选择的组件所属环境下绑定了选择的集群，该组件所属集群才会同步变更，且所属命名空间会同步变更为重新选择的集群的default命名空间。 所属命名空间 选择执行构建的环境下CCE集群命名空间，用于隔离构建数据。关于命名空间，请参考管理命名空间。 您可以执行以下操作，批量同步设置组件所属命名空间： 鼠标移动到指定组件“所属命名空间”下拉列表框，单击。 勾选需要同步配置组件所属命名空间的其他组件。 单击“确定”。 批量同步设置组件所属命名空间后，仅所选组件的所属集群下存在选择的命名空间，该组件所属命名空间才会同步变更。 镜像包 单击： 重新选择组件来源，请参考组件来源说明。 您可以自定义“容器名称”。 容器名称要求为长度为1到63个字符的字符串，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。 实例数 设置运行在环境下的组件实例数，取值范围为[1, 200]。 您可以执行以下操作，批量同步设置组件实例数： 鼠标移动到指定组件“实例数”输入框，单击。 勾选需要同步配置组件实例数的其他组件。 单击“确定”。 根据实际业务需要设置组件构建参数。 组件技术栈类型为Java、Tomcat、Node.js、Python、Php时可以设置。 单击目标组件所在行“操作”列的“构建”。 参考下表设置构建参数，其中带“*”标志的参数为必填参数。 参数名称 参数说明 *编译命令 组件来源是“源码仓库”时，根据业务需要设置“编译命令”。 使用默认命令或脚本：优先执行代码根目录下的build.sh，不存在则按照所选语言的通用方法编译，如Java语言的mvn clean package。 使用自定义命令：根据所选语言自定义编译命令，或修改build.sh文件后选择使用默认命令或脚本。 须知： 选择“使用自定义命令”时，请在echo、cat、debug命令中慎用敏感信息或者进行敏感信息加密，以免造成敏感信息泄露。 在项目子目录下执行编译命令，需先进入项目子目录，再执行其余脚本命令。例如： cd ./weather/ mvn clean package *Dockerfile地址 组件来源是“源码仓库”时，根据业务需要设置“Dockerfile地址”。 “Dockerfile地址”即Dockerfile文件相对于项目的根目录（./）所在的目录，Dockerfile文件用于镜像构建。 如果未指定“Dockerfile地址”，默认查找项目根目录下的Dockerfile；如果项目根目录下也没有Dockerfile文件，则根据选定的运行环境自动生成Dockerfile。 *组织 组织用于管理组件构建生成的镜像。 *构建环境 选择用于构建镜像的环境类型。执行构建的环境，必须是Kubernetes环境，且能够访问Internet。 推荐您选择“使用当前环境构建”。如果当前环境的CCE集群不能访问Internet，且您单独规划了构建环境，则可选择“使用独立环境构建”。 使用独立环境构建：可使用单独的构建环境进行镜像构建。独立构建环境CCE集群和当前组件部署环境CCE集群的CPU架构必须保持一致，否则会导致组件部署失败。 使用当前环境构建：使用组件所属的部署环境进行镜像构建。当前环境CCE集群的master节点和node节点的CPU架构必须保持一致，否则会导致组件构建失败。 *选择环境 “构建环境”选择“使用独立环境构建”时，可选择使用不同于组件所属的独立构建环境。 “构建环境”选择“使用当前环境构建”时，固定选择使用组件所属的部署环境。 *命名空间 选择执行构建的环境下CCE集群命名空间，用于隔离构建数据。关于命名空间，请参考管理命名空间。 过滤节点标签 如果存在以下情况，您需要通过设置过滤节点标签将构建任务下发到绑定了EIP的固定节点上，保证组件构建、部署成功。 “构建环境”选择“使用独立环境构建”时，需要设置过滤节点标签，将构建任务下发到独立构建环境下的node节点，保证该节点和当前组件部署环境下node节点CPU架构一致。 “构建环境”选择“使用当前环境构建”时，如果环境下有node节点和master节点CPU架构不一致，需要设置过滤节点标签，将构建任务下发到和master节点CPU架构一致的node节点上。 新增过滤标签，请参考添加节点标签。 单击“确定”。 单击目标组件所在行“操作”列的“高级配置”。 单击，开启公网访问。 设置“公网ELB”。 选择所选环境中已经存在的绑定了弹性公网IP的弹性负载均衡(ELB)资源。 若不存在，请单击“去所选的环境里添加”，在环境编辑页面，单击“新增可选资源”，为该环境添加已创建的弹性负载均衡(ELB)资源。 若需创建弹性负载均衡(ELB)资源，请参考下表根据实际应用场景进行创建。 使用场景 参考章节 使用 域名 访问应用 购买共享型负载均衡器 参考购买独享型负载均衡器创建“规格”为“应用型”的ELB ELB灰度发布 参考购买独享型负载均衡器创建“规格”为“应用型”的ELB 弹性负载均衡ELB需已绑定弹性公网IP，且必须与当前组件部署环境下纳管的计算资源处于相同的 虚拟私有云VPC 及其子网下。 组件在不同部署环境下需绑定不同ELB，避免路由错误。 设置“对外协议”。 选择“HTTP”，会存在安全风险，建议优先选择使用安全的“HTTPS”方式。 选择“HTTPS”，单击“使用已有”选择已经创建的证书。 若证书不存在，请单击“新创建”创建新的服务器证书。创建服务器证书请参考创建证书。 设置“域名”。 选择“自动生成”，自动生成的域名仅有7天有效期。 选择“绑定域名”，在输入框中输入自定义域名。 设置“监听端口”。 输入应用进程的监听端口号。 图1 设置公网访问 设置组件的“云服务配置”参数，请参考管理容器部署组件云服务配置。 您可以执行以下操作，批量同步为组件绑定微服务引擎、分布式缓存或云数据库： 鼠标移动到指定组件已绑定的微服务引擎、分布式缓存或云数据库，单击。 勾选需要同步配置的其他组件。 单击“确定”。 仅所选组件的所属环境下已绑定了选择的微服务引擎、分布式缓存或云数据库，才会同步变更。否则，保持不变。 您可以执行以下操作，批量为组件同步删除微服务引擎、分布式缓存或云数据库： 鼠标移动到指定组件已绑定的微服务引擎、分布式缓存或云数据库，单击。 单击“同步删除”，勾选需要同步配置的其他组件，单击“确定”。 如果仅为当前组件删除已绑定的微服务引擎、分布式缓存或云数据库，单击“取消”。 您可以执行以下操作，为指定组件重新绑定微服务引擎、分布式缓存或云数据库： 鼠标移动到指定组件已绑定的微服务引擎、分布式缓存或云数据库，单击。 重新选择当前环境下已纳管的微服务引擎、分布式缓存或云数据库，单击“确定”。 设置组件的“容器配置”参数，请参考管理容器部署组件容器配置。 设置组件的“高级配置”参数，请参考管理容器部署组件高级配置。 单击“确定”。 （可选）单击“高级配置预检查”，检查各组件的高级配置是否正确。 如果组件绑定了指定的微服务引擎、分布式缓存或云数据库实例，而该组件所属环境下并未绑定这些指定的实例，高级配置预检查会报错。请执行以下操作重新配置后再执行后续操作。 请在弹出的“高级配置预检查”对话框确认后，单击“确定”。 单击报错组件“操作”列的“高级配置”。 参考管理容器部署组件云服务配置，重新正确设置“微服务引擎”、“分布式缓存”、“云数据库”参数配置。 单击“下一步”，系统自动进行高级配置预检查，检查各组件的高级配置是否正确。 如果组件绑定了指定的微服务引擎、分布式缓存或云数据库实例，而该组件所属环境下并未绑定这些指定的实例，高级配置预检查会报错。请执行以下操作重新配置后再执行后续操作。 请在弹出的“高级配置预检查”对话框确认后，单击“确定”。 单击报错组件“操作”列的“高级配置”。 参考管理容器部署组件云服务配置，重新设置“微服务引擎”、“分布式缓存”、“云数据库”参数配置。 设置所选待克隆组件的“部署批次”，用于指定该组件在所有已选组件里面的部署次序。 如果已选组件之间存在依赖关系，例如某组件的启动需要依赖其他组件，则需要设置“部署批次”，使被依赖的组件优先被部署。 例如，选择了基线泳道的A、B、C三个待克隆组件，A组件的启动依赖于B、C组件。因此，需要将B、C组件的“部署批次”设置为1，将A组件的“部署批次”设置为2。 如果已选克隆组件之间不存在依赖关系，则“部署批次”可以保持默认，所有已选组件一次性被部署。 单击“完成并发布”，进入该批量克隆发布单的“发布单管理”页面。 您可以查看该发布单的发布记录和发布单信息，执行删除发布单操作。

编辑泳道组 登录ServiceStage控制台。 单击“全链路流量控制”。 选择以下任意方式弹出泳道组编辑对话框： 单击待操作泳道组所在行“操作”列“编辑”。 单击待操作泳道组名称，进入“全链路流量控制”页面，单击“编辑”。 参考下表填写泳道组信息，其中带“*”标志的参数为必填参数。 参数名称 参数说明 *泳道组名称 泳道组的名称。 长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或数字结尾。 流量入口网关 流量入口网关即微服务应用网关，用于通过标签控制流量转发到对应泳道的目标服务组件。 您可以根据实际业务需要，在下拉列表选择已创建好的微服务应用网关。 单击“创建应用网关”，您可以根据实际业务需要创建新的微服务应用网关以供选择。创建微服务应用网关，请参考创建应用网关。 *目标服务 设置了“流量入口网关”参数时，需要选择通过该网关转发流量的目标服务。 您可以根据实际业务需要，在下拉列表选择已创建好的目标服务。 说明： 可选择的目标服务需要未被其他泳道组使用，其对应的微服务未被其他泳道组使用且支持路由。 单击“创建目标服务”，您可以根据实际业务需要创建新的目标服务以供选择。创建目标服务，请参考创建服务。 描述 泳道组的描述信息，长度不超过128个字符。 单击“确定”，完成泳道组编辑。

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