华为云用户手册

背景信息 部署在虚拟机的组件，组件实例表现为组件在虚拟机中的运行进程；部署在CCE集群的组件，组件实例即Pod，是CCE部署应用或服务的最小基本单位。 部署在虚拟机的组件 使用虚拟机部署方式创建并部署组件时，输入的“组件名称”长度小于54个字符，则组件实例名称长度不超过61个字符。实例名称命名格式为： {组件名称全部字符}-{所属环境名称全部或部分字符}_{系统生成的5位随机字符串} 使用虚拟机部署方式创建并部署组件时，输入的“组件名称”等于或者大于54个字符，则组件实例名称长度为60个字符。实例名称命名格式为： {组件名称的前54个字符}_{系统生成的5位随机字符串} 部署在CCE集群的组件 使用容器部署方式基于界面配置创建并部署组件或者使用容器部署方式基于YAML配置创建并部署组件时，“工作负载类型”选择“有状态”且“工作负载名称”自定义，则组件实例名称长度不超过52个字符。 使用容器部署方式基于界面配置创建并部署组件或者使用容器部署方式基于YAML配置创建并部署组件时，“工作负载类型”选择“无状态”或者“守护进程集”且“工作负载名称”自定义，则组件实例名称长度不超过63个字符。 使用容器部署方式基于界面配置创建并部署组件或者使用容器部署方式基于YAML配置创建并部署组件时，“工作负载名称”默认由系统自动生成，则组件实例名称长度不超过52个字符。 使用导入CCE工作负载创建组件时，“工作负载名称”固定为导入的CCE工作负载的名称。 虚拟机上部署组件的实例数量，即部署组件时所选择的虚拟机数量；CCE集群中部署组件的实例数量，即部署组件时所设置的实例数，也就是Pod的数量。

管理组件实例 登录ServiceStage控制台。 选择以下任意方式进入组件“实例列表”页面： 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称。 在“组件管理”页面，单击待操作组件名称。 在“实例列表”页面，您可执行如下表所示操作。 操作名称 操作说明 重启单个实例 对于部署环境为Kubernetes类型的组件，如果某个实例运行异常，可以通过删除该实例来进行实例重启。 选择待删除实例，单击“操作”列的“删除”。 在弹出对话框，单击“确定”。 查看实例运行监控 通过查看实例运行监控信息，可以了解单个实例运行中的CPU、内存利用率。 单击实例列表待操作实例名称前的。 选择“监控”页签，查看该实例运行监控信息。 查看实例运行事件 ServiceStage支持查看指定实例运行过程中发生的事件详情。 单击实例列表待操作实例名称前的。 选择“事件”页签，查看该实例运行过程中发生的事件详情。 查看实例运行容器 对于部署环境为Kubernetes类型的组件，ServiceStage支持查看指定实例运行容器信息，包括容器名称、运行状态、挂载镜像等。 单击实例列表待操作实例名称前的。 选择“容器”页签，查看该实例运行容器信息。

查看组件详情 登录ServiceStage控制台。 选择以下任意方式进入组件“概览”页面。 在“应用管理”页面，单击组件所属应用名称，在“组件列表”单击待操作组件名称。 在“组件管理”页面，单击待操作组件名称。 在组件“概览”页面，查看组件状态等详细信息。 组件运行状态说明，请参考表1。单击组件状态，可以查看组件的部署记录。 表1 组件运行状态说明 状态 说明 初始化 创建并部署组件时，单击“创建并部署”后，组件处于此状态。 升级/回滚中 单批发布方式升级组件版本配置、滚动发布方式升级组件版本配置、批量升级组件版本配置、回滚组件版本配置、单批发布方式重新部署组件或滚动发布方式重新部署组件过程中，组件处于此状态。 伸缩中 设置手动伸缩策略后，策略执行过程中组件处于此状态。 失败 对组件的操作不成功。例如，组件部署、升级、回滚失败。 您可以单击“失败”进入“部署记录”页面查看失败的原因。 运行中 成功完成对组件的操作，组件状态正常。例如，组件部署、升级、回滚成功。 删除中 删除组件过程中，组件处于此状态。 启动中 参考启停组件实例启动停止的组件过程中，组件处于此状态。 停止中 参考启停组件实例停止组件运行过程中，组件处于此状态。 停止 参考启停组件实例停止组件运行成功后，组件处于此状态。 重启中 参考启停组件实例重启组件过程中，组件处于此状态。 未就绪 状态为“运行中”的组件实例数小于组件全部实例数时，组件处于此状态。 未知 容器部署方式部署的组件，从组件所在CCE同步状态返回Unknown时，组件处于此状态。 异常 容器部署方式部署的组件，组件所在CCE集群被删除或者工作负载被删除时，组件处于此状态。 灰度发布中 灰度发布方式升级组件版本配置、灰度发布方式重新部署组件过程中，组件处于此状态。 灰度发布失败 灰度发布方式升级组件版本配置、灰度发布方式重新部署组件失败后，组件处于此状态。 草稿 组件处于创建过程中，尚未完成参数配置时提前保存后的状态。主要用于防止已配置参数因为关闭页面等因素丢失。 使用容器部署方式基于界面配置创建并部署组件、使用容器部署方式基于YAML配置创建并部署组件、使用虚拟机部署方式创建并部署组件时单击“保存为草稿”后，组件处于此状态。 导入待重启 使用导入CCE工作负载创建组件后，组件未启动时的状态。 导入重启中 使用导入CCE工作负载创建组件后，组件重启过程中的状态。 重启失败 参考启停组件实例重启组件失败，组件处于此状态。

组件来源说明 组件来源 说明 源码仓库 参考创建仓库授权创建授权，然后设置代码来源。 Jar包 支持以下上传方式： 从CodeArts软件发布库选择对应软件包。需要提前将软件包上传至CodeArts软件发布库，相关操作请参考上传软件包。 从SWR软件仓库选择对应的软件包。需要提前将软件包上传至软件仓库，相关操作请参考上传软件包。 从OBS对象存储选择对应的软件包。需要提前将软件包上传至OBS桶中，相关操作请参考流式上传（PUT上传） 。 从自定义文件地址获取对应的软件包，支持自定义HTTP/HTTPS协议的文件地址下载。您需要提前将软件包上传至对应的自定义文件地址下。 War包 Zip包 压缩包 镜像包 容器应用需要基于镜像创建。支持“我的镜像”（私有镜像）、“开源镜像”、“共享镜像”、“第三方镜像”。 若选择“我的镜像”，您首先需要将镜像上传至镜像仓库，请参考上传镜像。 若选择“第三方镜像”，您需要已获取第三方镜像的地址。镜像地址格式为： {第三方镜像仓库IP地址}:{第三方镜像仓库访问端口号}/{镜像存储路径}/{镜像名称}:{镜像版本号} 或者： {镜像名称}:{镜像版本号} 若没标注镜像版本号，则默认为最新版本号latest。 目前仅支持获取第三方公开镜像。

组件部署方式说明 组件部署方式 说明 容器部署 云容器引擎部署：云容器引擎CCE提供高度可扩展的、高性能的企业级Kubernetes集群，支持运行Docker容器。借助云容器引擎，您可以在云平台上轻松部署、管理和扩展容器化应用程序。 虚拟机部署 虚拟机，即弹性 云服务器ECS ，是由CPU、内存、操作系统、云硬盘组成的基础的计算组件。弹性云服务器创建成功后，您就可以像使用自己的本地PC或物理服务器一样，在云上使用弹性云服务器，将组件部署在虚拟机上。

技术栈简介 技术栈包含组件运行所依赖的操作系统、框架和运行时，由技术栈名称、类型、状态、版本等属性构成。其中，版本号遵从语义化版本控制规范。 ServiceStage为您提供并管理技术栈生命周期，您只需聚焦具体业务开发，提升您的应用托管体验。 技术栈各生命周期阶段定义如下： Preview：Beta版本技术栈发布。 GA（General Availability）：正式版本技术栈发布。 EOL（End of Life）：技术栈生命周期结束。 技术栈状态定义如下： Preview：生命周期处于Preview阶段的技术栈。 Supported：生命周期处于GA阶段的技术栈。 Deprecated：生命周期处于GA阶段、但是已经发布了EOL公告的技术栈，或者ServiceStage服务不主推的技术栈。 技术栈的详细信息请参见表1。ServiceStage支持部署打包为War包的基于Spring Boot框架开发的Java应用组件。JDK和Spring Boot版本配套关系如下所示： OpenJDK8：支持Spring Boot 2.0.x~2.7.x。 OpenJDK11：支持Spring Boot 2.2.x~2.7.x。 OpenJDK17：支持Spring Boot 2.5.x及以上版本。 OpenJDK21：支持Spring Boot 2.7.x及以上版本。 Spring Boot版本详细说明，请参考Spring Boot版本说明。

编辑应用 登录ServiceStage控制台。 选择“应用管理”。 选择以下任意方式进入应用编辑页面。 直接编辑：选择待操作应用，在“操作”列单击“编辑”。 查看应用详情后编辑：在“应用管理”页面，单击待操作应用名称，进入“应用概览”页面。查看应用详情后，在页面右上方单击“编辑”。 参考下表重新设置应用信息。 参数 说明 应用名称 应用名称必须唯一，不能重复。 长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或者数字结尾。 企业项目 选择企业项目。 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 开通企业项目后可以使用。 单击下拉列表，可以选择使用已有企业项目。 单击“新建企业项目”，可以参考创建企业项目创建并选择使用新建的企业项目。 标签 标签用于标识资源，当您拥有相同类型的许多资源时，可以使用标签按各种维度（例如用途、所有者或环境）对资源进行分类。 如果您的组织已经设定ServiceStage服务的相关标签策略，则需按照标签策略规则添加标签。标签如果不符合标签策略的规则，则可能会导致应用编辑失败，请联系组织管理员了解标签策略详情。 同一个应用下最多可以添加20个标签。 新增标签：输入标签对应的key值和value值，单击“确定”。 key值：请输入长度为1到36个字符的字符串，只能包含数字、英文字母、下划线（_）、中划线（-）或中文。 value值：请输入长度为1到43个字符的字符串，只能包含数字、英文字母、下划线（_）、点（.）、中划线（-）或中文。 删除标签：单击待删除标签后的。 描述 应用描述信息，长度不超过128个字符。 单击“确定”。

安装虚拟机Agent 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 单击待操作虚拟机类型环境名称，进入环境“概览”页面。 选择“计算”资源类型下的“弹性云服务器 E CS ”资源名称。 在右侧已纳管的资源列表，找到需要安装Agent的虚拟机，在“Agent 状态”列单击“安装”，弹出Agent安装窗口。 选择“授权模式”。 授权Agent可以使用您的身份认证信息，获取应用的部署、升级、启动、停止等任务，并执行任务。 您可以选择“委托授权”、“AK/SK”模式进行授权，推荐使用“委托授权”。 “授权模式”选择“委托授权”： 单击，选择已经创建的委托后单击。 新创建委托，请参考 如何创建委托？。 创建委托时，您需要委托op_svc_ecs账号或者ECS云服务，并且在相应的区域选择Tenant Administrator策略。如果需要使用OBS存储，则还需要在委托授权时添加OBS Administrator策略。 “授权模式”选择“AK/SK”： 安全起见，请获取并使用具有“ServiceStage Development”权限的AK、SK。AK、SK所属账号需和安装虚拟机Agent时使用的账号在同一个用户下。 AK、SK获取请参考访问密钥。 单击“复制命令”，复制窗口下方自动生成的命令，即为Agent安装命令。 “委托授权”模式，命令示例如下： export AGENT_INSTALL_URL=https://${Region_Name}-servicestage-vmapp.obs.${Region_Name}.${Domain_Name}/vmapp/agent/agent-install.sh;if [ -f `which curl` ];then curl -# -O -k ${AGENT_INSTALL_URL};else wget --no-check-certificate ${AGENT_INSTALL_URL};fi;bash agent-install.sh ${Project_ID} ${Version} ${Region_Name} ${Flag} “AK/SK”模式，命令示例如下： export AGENT_INSTALL_URL=https://${Region_Name}-servicestage-vmapp.obs.${Region_Name}.${Domain_Name}/vmapp/agent/agent-install.sh;if [ -f `which curl` ];then curl -# -O -k ${AGENT_INSTALL_URL};else wget --no-check-certificate ${AGENT_INSTALL_URL};fi;bash agent-install.sh ${AK}${SK} ${Project_ID} ${Version} ${Region_Name} ${Flag} AGENT_INSTALL_URL为Agent安装地址。 Region为华北-北京一时，AGENT_INSTALL_URL=https://servicestage-vmapp.obs.cn-north-1.myhwcloud.com/vmapp/agent/agent-install.sh。 如果使用“委托授权”模式，ECS节点有权获取用户的临时AK/SK，命令中不需要输入AK/SK。 ${AK}、${SK}为访问密钥。 ${Region_Name}为区 域名 称。 ${Domain_Name}为全局域名。 ${Project_ID}为项目ID，如何获取项目ID请参考如何获取项目ID？。 ${Version}为版本号，使用latest，自动去下载最新版本。 ${Flag}为布尔值，表示是否自动添加应用访问端口。true表示是；false表示否。 参照界面提示登录虚拟机，执行安装命令。 虚拟机Agent安装成功后，在安装Agent的虚拟机上生成如下目录： /opt/application：使用虚拟机部署方式部署组件的业务、配置文件所在目录。请勿对该目录执行增、删、改操作，否则可能会导致已安装的虚拟机Agent离线。 /opt/servicestage-agent：安装的虚拟机Agent的配置文件所在目录。请勿对该目录执行增、删、改操作，否则可能会导致已安装的虚拟机Agent离线。 /var/log/servicestage-agent：安装的虚拟机Agent的日志目录，存储了agent日志agent.log、监控脚本日志servicestage-agent-watchdog.log。请勿对该目录执行删、改操作，否则可能会导致已安装的虚拟机Agent离线。 /var/log/application：组件日志相关目录。请勿对该目录执行删、改操作，否则可能会导致已安装的虚拟机Agent离线。 /opt/ssa/packages：虚拟机部署方式部署组件业务包的临时存放目录。请勿对该目录执行删、改操作，否则可能会导致已安装的虚拟机Agent离线。 如果虚拟机Agent安装失败，请参考如何处理虚拟机Agent安装成功但是界面仍然显示缺少Agent？处理。

修改环境 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 选择如下方式进入“编辑环境”页面： 直接编辑：选择待操作环境，在“操作”列单击“编辑”。 查看环境详情后编辑：单击待操作环境名称，进入环境“概览”页面，单击“编辑”。 参考下表编辑环境信息。 参数 参数说明 环境名称 环境的名称。 长度为2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或者数字结尾，英文字母区分大小写。 企业项目 企业项目是一种云资源管理方式，企业项目管理服务提供统一的云资源按项目管理，以及项目内的资源管理、成员管理。 已开通企业项目后可以使用。 单击下拉列表，可以选择使用已有企业项目。 单击“新建企业项目”，可以参考创建企业项目创建并选择使用新建的企业项目。 环境标签 标签用于标识资源，当您拥有相同类型的许多资源时，可以使用标签按各种维度（例如用途、所有者或环境）对资源进行分类。 如果您的组织已经设定ServiceStage服务的相关标签策略，则需按照标签策略规则添加标签。标签如果不符合标签策略的规则，则可能会导致编辑环境失败，请联系组织管理员了解标签策略详情。 同一个环境下最多可以添加20个标签。 删除标签 单击待删除标签后的。 新增标签 单击“添加标签”，弹出“添加标签”对话框。 单击“新增标签”。 输入标签对应的key值和value值。 key值：长度为1到36个字符，只能包含数字、英文字母、下划线（_）、中划线（-）或中文。 value值：长度为1到43个字符，只能包含数字、英文字母、下划线（_）、点（.）、中划线（-）或中文。 如果您需要使用同一标签标识多种资源，即所有资源均可在标签输入框下拉选择同一标签，建议在TMS中创建预定义标签。 单击“确定”。 描述 环境描述信息，长度不超128个字符。 单击“保存”，完成环境修改。

移除已纳管基础资源 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 单击待操作环境名称，进入环境“概览”页面。 选择“计算”、“网络”或“中间件”资源类型下的资源名称。 在右侧已纳管的资源列表中： 批量移除资源：勾选待移除的资源，单击“移除资源”。 移除单个资源：在待移除的资源“操作”列，单击“移除”。 资源被移除后，并不会删除资源实例。如需删除，您需要登录对应资源的控制台执行删除操作。

纳管基础资源 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 单击待操作环境名称，进入环境“概览”页面。 参考下表纳管需要纳管到环境下的基础资源。 资源类型 资源名称 操作方法 计算 云容器引擎 CCE 请参考绑定CCE集群。 Kubernetes类型的环境支持绑定CCE集群资源。如需管理环境下的CCE集群资源，请参考管理CCE资源。 弹性云服务器 ECS 选择“计算”资源下的“弹性云服务器 ECS”。 单击“纳管资源”。 勾选待纳管的ECS资源。 单击“确定”。 虚拟机类型的环境支持纳管ECS资源。 同一VPC下，已被其他环境纳管的ECS资源，不支持被再次纳管。 如果纳管的ECS资源Agent状态为“缺少Agent，请先安装”，请参考安装虚拟机Agent完成Agent安装。 弹性伸缩组 AS 选择“计算”资源下的“弹性伸缩组 AS”。 单击“纳管资源”。 勾选待纳管的AS资源。 单击“确定”。 虚拟机类型的环境支持纳管AS资源。 同一VPC下，已被其他环境纳管的AS资源，不支持被再次纳管。 如果纳管的AS资源下选择的ECS Agent状态为“缺少Agent，请先安装”，请参考安装虚拟机Agent完成Agent安装。 网络 弹性负载均衡 ELB 选择“网络”资源下的“弹性负载均衡 ELB”。 单击“纳管资源”。 勾选待纳管的ELB资源。 单击“确定”。 弹性IP EIP 选择“网络”资源下的“弹性IP EIP”。 单击“纳管资源”。 勾选待纳管的EIP资源。 单击“确定”。 虚拟私有云 VPC 选择“网络”资源下的“虚拟私有云 VPC”。 单击“纳管资源”。 勾选待纳管的VPC资源。 单击“确定”。 子网 Subnet 选择“网络”资源下的“子网 Subnet”。 单击“纳管资源”。 勾选待纳管的VPC子网资源。 单击“确定”。 网络 ACL 选择“网络”资源下的“网络 ACL”。 单击“纳管资源”。 勾选待纳管ACL资源。 单击“确定”。 中间件 分布式缓存 DCS 选择“中间件”资源下的“分布式缓存 DCS”。 单击“纳管资源”。 勾选待纳管的DCS资源。 单击“确定”。 ServiceComb引擎 选择“中间件”资源下的“ServiceComb引擎”。 单击“纳管资源”。 选择待纳管的ServiceComb资源。 单击“确定”。 注册配置中心 选择“中间件”资源下的“注册配置中心”。 单击“纳管资源”。 勾选待纳管的注册配置中心资源。 单击“确定”。 云数据库 RDS 选择“中间件”资源下的“云数据库 RDS”。 单击“纳管资源”。 勾选待纳管的RDS资源。 单击“确定”。

前提条件 根据实际需要创建需纳管的基础资源： 已创建环境待纳管的状态为运行中的弹性云服务器ECS，ECS和环境所在的VPC需要一致，且不能被其他环境纳管。 弹性云服务器ECS用于“虚拟机”类型环境下部署和运行组件。创建弹性云服务器ECS，请参考自定义购买ECS。 已创建环境待纳管的弹性伸缩组AS，AS和环境所在的VPC需要一致，且不能被其他环境纳管。且AS中已包含弹性云服务器。 弹性伸缩组AS用于“虚拟机”类型环境下部署和运行组件。创建弹性伸缩组AS，请参考创建伸缩组。 已创建环境待纳管的弹性负载均衡ELB，ELB和环境所在的VPC需要一致。 用于支持通过绑定了弹性公网IP的ELB以公网域名方式访问组件提供的服务，或者通过ELB灰度发布升级容器部署方式部署的组件。请参考下表根据实际应用场景创建弹性负载均衡ELB。 使用场景 参考章节 使用域名访问应用 购买共享型负载均衡器 参考购买独享型负载均衡器创建“规格”为“应用型”的ELB ELB灰度发布 容器部署方式部署的组件适用。 参考购买独享型负载均衡器创建“规格”为“应用型”的ELB 已创建环境待纳管的弹性IP。 弹性IP用于通过弹性IP访问方式访问组件提供的服务。创建弹性IP，请参考申请弹性公网IP。 已创建环境待纳管的 虚拟私有云VPC 。虚拟私有云VPC提供了逻辑隔离的、由您自主配置和管理的虚拟网络环境，旨在提升您的云资源安全性，简化您的网络部署。 创建虚拟私有云VPC，请参考创建虚拟私有云和子网。 已创建环境待纳管的虚拟私有云子网。虚拟私有云子网是VPC中的一个网段，属于三层网络，一个VPC可以创建多个子网，用来分类管理有不同业务需求的云资源。 创建虚拟私有云子网，请参考创建虚拟私有云和子网。 已创建环境待纳管的网络ACL，用于为与其关联了的子网提供安全防护。 创建网络ACL，请参考创建网络ACL。 已创建环境待纳管的分布式缓存DCS，DCS和环境所在的VPC需要一致。 分布式缓存DCS用于在应用运行时读取环境变量来获取分布式缓存的相关信息。创建分布式缓存DCS，请参考购买Redis实例。 已创建环境待纳管的MySQL数据库引擎的云数据库RDS实例，RDS和环境所在的VPC需要一致。 云数据库RDS用于应用数据持久化存储。创建云数据库RDS，请参考购买RDS for MySQ L实例 。 已创建环境待纳管的ServiceComb引擎（即微服务引擎，请参见微服务引擎概述），如果微服务引擎与环境所在VPC不一致，需正确配置VPC连通。 微服务引擎用于将运行在环境下的微服务接入引擎，实现微服务注册发现、服务治理和配置管理。创建微服务引擎，请参考创建微服务引擎。 已创建环境待纳管的注册配置中心。如果注册配置中心与环境所在VPC不一致，需正确配置VPC连通。 注册配置中心用于将运行在环境下的微服务接入引擎，实现微服务注册发现和配置管理。创建注册配置中心，请参考创建注册配置中心。 已创建环境待纳管的应用网关，用于将运行在环境下的微服务接入网关，实现全链路流量和接口管理。Kubernetes类型的高可用环境，每个可用区只能纳管1个应用网关。 创建应用网关，请参考创建应用网关。 仅“华东-上海一”、“亚太-新加坡”区域支持纳管应用网关，用于使用全链路流量控制功能。

后续操作 密钥创建完成后，您可参考表2查找、查看、更新和删除密钥。 密钥删除后可能导致挂载此密钥或在环境变量中引用此密钥的组件升级后无法正常启动。 密钥列表中包含系统密钥资源，系统密钥资源不可更新和删除，只能查看。 表2 密钥管理操作说明 操作项 操作说明 查找密钥 在命名空间下拉列表选择密钥所在命名空间。 在搜索框输入密钥名称。 查看密钥 单击目标密钥“操作”列的“查看YAML”，查看配置项YAML格式文件内容。 更新密钥 单击目标密钥“操作”列的“更新”。 根据表1更改信息。 单击“更新密钥”。 删除单个密钥 单击目标密钥“操作”列的“删除”。 在弹出的对话框，单击“确定”。 批量删除密钥 勾选需要删除的密钥。 单击“删除密钥”。 在弹出的对话框，单击“确定”。

创建密钥 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 单击待操作环境名称，进入环境“概览”页面。 选择“计算”资源类型下的资源名称“云容器引擎 CCE”。 进入“密钥”列表页面。 非高可用环境：选择“密钥”页签。 高可用环境：单击已绑定CCE集群名称，选择“密钥”页签。 单击“创建密钥”。 ServiceStage支持“可视化”和“YAML”两种方式来创建密钥。 方式一：可视化。参照表1设置参数，其中带“*”标志的参数为必填参数。 表1 可视化方式创建密钥参数设置说明 参数 参数说明 *密钥名称 新建密钥的名称，同一个命名空间内必须唯一。 长度为4到24个字符，可以包含英文小写字母、数字和中划线（-），以英文小写字母开头、英文小写字母或者数字结尾。 *所属集群 使用新建密钥的集群。 单击“创建集群”，可以新建CCE集群。创建CCE集群，请参考购买集群。您可以根据您的实际业务需要选择创建 CCE Turbo 集群或者CCE Standard集群。 *命名空间 新建密钥所在的命名空间。 单击“创建命名空间”，可以参考创建命名空间为密钥创建新的所属命名空间。 描述 密钥的描述信息，长度为0到255个字符。 *密钥类型 根据业务需要选择新建的密钥类型。 Opaque：一般密钥类型。当密钥配置文件中未作显式设定时，默认的密钥类型是Opaque。 kubernetes.io/dockerconfigjson：存放拉取私有仓库镜像所需的认证信息。 IngressTLS：存放7层负载均衡服务所需的证书。 其他：若需要创建其他类型的密钥，请手动输入密钥类型，长度为4到24个字符。 *镜像仓库地址 当“密钥类型”选择kubernetes.io/dockerconfigjson时有效，输入镜像仓库的地址。 *密钥数据 应用密钥的文件data字段值。 当密钥为Opaque类型时，输入“键”、“值”。 密钥数据的键必须由数字、字母、点号（.）、中划线（-）或下划线（_）组成，长度为1到63个字符。 密钥数据的值必须为使用Base64编码后的长度为1到1,048,576位的字符，Base64编码方法请参考如何进行Base64编码。 单击“添加更多配置数据”，可以增加密钥数据。 当密钥为kubernetes.io/dockerconfigjson类型时，输入“用户名”和“密码”。 当密钥为IngressTLS类型时，单击“上传文件”，上传“证书文件”和“私钥文件”。 证书文件小于1MB，格式为.crt或.cer。私钥文件小于1MB，格式为.key或.pem。 当密钥为其他类型时，输入对应的“键”、“值”。 密钥数据的键必须由数字、字母、点号（.）、中划线（-）或下划线（_）组成，长度为1到63个字符。 密钥数据的值必须为使用Base64编码后的长度为1到1,048,576位的字符，Base64编码方法请参考如何进行Base64编码。 单击“添加更多配置数据”，可以增加密钥数据。 密钥标签 标签以Key/value键值对的形式附加到各种对象上（如应用、节点、服务等）。 标签定义了这些对象的可识别属性，用来对它们进行管理和选择。 单击“添加标签” 。 输入键、值。 标签的键由数字、字母、点号（.）、中划线（-）、下划线（_）或斜杠（/）组成，必须以字母或者数字开头和结尾，长度为1到63个字符。 标签的值由数字、字母、点号（.）、中划线（-）或下划线（_）组成，必须以字母或者数字开头和结尾，长度为1到63个字符。 图1 可视化方式设置密钥参数 方式二：YAML。 若需要通过上传文件的方式创建密钥，请确保已创建YAML格式的Secret资源文件，且文件小于1MB。详情请参考Secret资源文件配置示例。 在“所属集群”下拉框中，选择相应的集群。 选择以下任一方式设置ConfigMap资源文件。 单击“上传文件”，选择已创建的Secret资源文件后，单击“打开”，等待文件上传完成。 在“编排内容”中写作或者修改上传的Secret资源文件。 图2 YAML方式设置密钥参数 单击“创建密钥”。 密钥列表中会出现新创建的密钥。

ConfigMap资源文件要求 ConfigMap资源文件支持YAML文件格式，且文件大小不得超过1MB。 文件配置示例如下： apiVersion: v1 data: {} kind: ConfigMap metadata: annotations: description: '' labels: {} name: configmap-ww8qkl namespace: cse 配置项关键参数说明请参考表3。 表3 配置项关键参数说明 参数名称 参数说明 apiVersion 固定值：v1。 kind 固定值：ConfigMap。 metadata.name 配置项名称，可自定义。 data 键值对形式配置项数据。

创建配置项 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 单击待操作环境名称，进入环境“概览”页面。 选择“计算”资源类型下的资源名称“云容器引擎 CCE”。 进入“配置项”列表页面。 非高可用环境：选择“配置项”页签。 高可用环境：单击已绑定CCE集群名称，选择“配置项”页签。 单击“创建配置项”。 ServiceStage支持“可视化”和“YAML”两种创建方式来创建配置项。 方式一：可视化。 参照表1设置配置项参数，其中带“*”标志的参数为必填参数。 表1 可视化方式创建配置项参数设置说明 参数 说明 *配置名称 新建的配置项名称，同一个命名空间里必须唯一。 长度为4到24个字符，可以包含英文小写字母、数字和中划线（-），以英文小写字母开头、英文小写字母或者数字结尾。 *所属集群 使用新建配置项的集群。 *命名空间 新建配置项所在的命名空间。 描述 配置项的描述信息，长度范围为0到255个字符。 配置数据 应用配置的数据可以在应用中使用，或被用来存储配置数据。其中，“键”代表文件名；“值”代表文件中的内容。 单击“添加更多配置数据”。 输入键、值。 配置数据的键必须由数字、字母、点号（.）、中划线（-）或下划线（_）组成，长度为1到63个字符。 配置数据的值长度为0到1,048,576个字符。 配置标签 标签以键值对的形式附加到各种对象上（如应用、节点、服务等）。标签定义了这些对象的可识别属性，用来对它们进行管理和选择。 单击“添加标签” 。 输入键、值。 标签的键由数字、字母、点号（.）、中划线（-）、下划线（_）或斜杠（/）组成，必须以字母或者数字开头和结尾，长度为1到63个字符。 标签的值由数字、字母、点号（.）、中划线（-）或下划线（_）组成，必须以字母或者数字开头和结尾，长度为1到63个字符。 图1 可视化方式设置配置项参数 方式二：YAML。 若需要通过上传文件的方式创建配置项，请确保已创建格式为YAML的ConfigMap资源文件，且文件小于1MB。详情请参考ConfigMap资源文件要求。 在“所属集群”下拉框中，选择相应的集群。 选择以下任一方式设置ConfigMap资源文件。 单击“上传文件”，选择本地已创建的ConfigMap资源文件后，单击“打开”，等待文件上传成功。 在“编排内容”中写作或者修改ConfigMap资源文件。 图2 YAML方式设置配置项参数 单击“创建配置项”。 配置项创建完成后，应用配置列表中会出现新创建的应用配置。

前提条件 已创建环境待绑定的状态为“运行中”的CCE集群。集群和环境所在的VPC需要一致，且不能被其他环境纳管。CCE集群用于“Kubernetes”类型环境下部署和运行组件。 创建CCE集群，请参考购买集群。您可以根据您的实际业务需要选择创建CCE Turbo集群或者CCE Standard集群。 如果您创建的是CCE Turbo集群，需要为集群配置SNAT规则，使之能够通过NAT网关访问公网用于拉取源码。否则，会导致使用源码通过容器部署方式部署组件或执行源码构建任务的时候因为无法访问公网导致拉取源码失败，从而导致组件部署或构建失败。为集群配置SNAT规则，请参考从容器访问公网。 为CCE集群添加节点，请参考创建节点。 已创建Kubernetes类型的环境，请参考使用纳管资源配置模式创建Kubernetes环境。

绑定CCE集群 登录ServiceStage控制台。 选择“环境管理”，进入“环境管理”页面。 单击待操作环境名称，进入环境“概览”页面。 选择“计算”资源类型下的资源名称“云容器引擎 CCE”。 单击“立即绑定”。 已创建CCE集群，请参考下表为环境绑定CCE集群。 是否为高可用环境 绑定CCE集群操作方法 是 高可用环境下待绑定集群的master节点所在可用区、集群下运行工作负载的node节点所在可用区必须和绑定集群时所选可用区一致。 在“可用区”下拉列表选择可用区。 在“集群”下拉列表选择该可用区下可绑定的CCE集群。 单击“确定”。 单击“添加集群”。 在“可用区”下拉列表选择另外一个可用区。 在“集群”下拉列表选择该可用区下可绑定的CCE集群。 单击“确定”。 否 在“集群”下拉列表选择待绑定集群。 在“命名空间”下拉列表选择CCE集群待绑定的命名空间。 在绑定了CCE集群的环境下创建并部署组件时，指定了CCE集群绑定的命名空间，创建并部署组件时，如果使用当前环境构建组件镜像，则该命名空间默认用于隔离构建数据；该命名空间也默认用于隔离创建的组件实例。 完成CCE集群绑定后，您可以根据实际业务需要重新为集群绑定新命名空间，请参考绑定命名空间。 单击“确定”。 如果选择的待绑定CCE集群已安装Sermant Injector插件，则需同时纳管已安装的Sermant Injector插件所关联的ServiceComb引擎或者注册配置中心。否则，会导致本环境下Sermant Injector插件不可用。纳管ServiceComb引擎或者注册配置中心，请参考纳管基础资源。 未创建CCE集群，请根据页面提示前往CCE控制台，参考前提条件创建CCE集群后再次执行绑定操作。

使用限制 高可用环境，每个可用区需分别绑定1个CCE集群。非高可用环境，需绑定1个CCE集群。 ServiceStage支持使用CCE集群下“弹性云服务器-虚拟机”、“裸金属服务器”类型的节点。 CCE集群节点支持的操作系统，请参考节点操作系统。 CCE集群节点容器引擎当前支持Docker和Containerd。节点操作系统和容器引擎的对应关系，请参考容器引擎。 环境如果选择的VPC开启了IPv6，需选择绑定开启了IPv6开关的CCE集群资源。否则，会导致在该VPC下的开启了安全认证的微服务引擎专享版上注册的Java Chassis微服务在使用IPv6服务注册发现地址时，注册失败。处理方法，请参考如何处理开启了安全认证的微服务引擎专享版开启IPv6后服务注册失败？。

环境概述 环境是用于组件部署和运行的计算（如云容器引擎 CCE、弹性云服务器 ECS等）、网络（如弹性负载均衡 ELB、弹性IP EIP等）和中间件（如分布式缓存 DCS、云数据库 RDS等）等基础资源的集合。ServiceStage把多种基础资源组合为一个环境，如：开发环境、测试环境、预生产环境和生产环境。按环境维度来管理资源、部署组件，可以减少具体基础资源运维管理的复杂性。 关于组件，请参考组件概述。 ServiceStage支持的环境类型如表1所示。 表1 ServiceStage环境类型说明 环境类型 说明 虚拟机 适用于虚拟机部署方式，组件以软件包方式部署在虚拟机中。 Kubernetes 适用于容器部署方式（云容器引擎部署），组件以容器镜像方式通过Kubernetes调度部署。 ServiceStage支持您创建Kubernetes类型的高可用、非高可用环境： 高可用环境，用于为应用提供同城双活高可用能力，适用于部署需要满足同城高可用需求的应用。环境下需要绑定2个位于不同可用区的CCE集群。 非高可用环境，适用于部署不需要同城高可用的应用。环境下只需绑定1个CCE集群。 虚拟机+Kubernetes 如果环境同时纳管了CCE集群和虚拟机资源，该环境的类型为“虚拟机+Kubernetes”。 组件部署方式，请参考组件部署方式说明。 父主题： 环境管理

自定义策略样例 如下以定制一个 IAM 用户禁止创建及删除微服务引擎的策略为例。 { "Version": "1.1", "Statement": [ { "Action": [ "cse:*:*" ], "Effect": "Allow" }, { "Action": [ "cse:engine:create", "cse:engine:delete" ], "Effect": "Deny" } ] } 拒绝策略需要同时配合其他策略使用，否则没有实际作用。IAM用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先原则。 权限授予成功后，您可以使用IAM用户通过控制台以及REST API等多种方式验证。 此处以上述自定义策略为例，介绍如何通过登录ServiceStage控制台验证自定义禁止创建微服务引擎的权限： 使用新创建的用户登录华为云，登录方法选择为“IAM用户”。 租户名为该IAM用户所属华为云账号的名称。 IAM用户名和IAM用户密码为以租户名在IAM创建用户时输入的用户名和密码。 在“微服务引擎”页面，创建微服务引擎，返回403错误，表示权限配置正确并已生效。

示例流程 图1 给用户授权ServiceStage权限流程 创建用户组并授权 在IAM控制台创建用户组，并授予ServiceStage服务“ServiceStage ReadOnlyAccess”权限。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，验证ServiceStage的只读权限： 在“服务列表”中选择“应用管理与运维平台 ServiceStage”。 进入“应用管理”页面，单击“创建应用”。 若提示权限不足，表示“ServiceStage ReadOnlyAccess”已生效。

购买资源包 资源包适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。 进入购买应用管理与运维平台套餐页面。 选择“区域”、“资源包版本”、“应用实例数”和“购买时长”。 单击“立即购买”。 确认订单正确无误后，单击“去支付”，完成支付。 购买资源包的操作，只有“账号”管理员才能操作，“IAM用户”无权操作。 关于“账号”及“IAM用户”的概念解释，请参见IAM的基本概念章节。 如果购买了专业版或铂金版资源包，会赠送1个微服务引擎专享版引擎，可以进入“微服务引擎”界面，创建免费引擎，参数配置请参考创建微服务引擎。 可以多次购买资源包，但是购买时长不能叠加，到期时间为所有资源包的最晚到期时间。 在“费用中心”的“资源包”页面，可以查看已购买资源包情况。

使用说明 通过ServiceStage创建、部署应用组件以及如何进行应用运维、服务治理的使用说明，如图1所示。 图1 ServiceStage使用说明 在使用ServiceStage之前，您需要先注册华为云账号并授予使用ServiceStage的权限，请参考使用条件。 在使用ServiceStage创建、部署应用组件之前，您需要先完成应用开发。开发微服务应用，请参考ServiceStage开发指南。 在使用ServiceStage前，您需要先登录ServiceStage控制台，请参考登录ServiceStage控制台。 了解ServiceStage控制台，请参考控制台说明。 了解ServiceStage的版本信息，请参考产品版本说明。 如需购买ServiceStage资源包，请参考购买资源包。 如需升级ServiceStage的版本，请参考升级产品版本。 使用ServiceStage提供的工程构建、发布等功能实现应用的持续集成，请参考持续交付。 使用ServiceStage创建环境、应用并部署组件，实现应用的托管和生命周期管理，请参考： 环境管理 应用管理 组件管理

产品版本说明 登录ServiceStage控制台，进入到总览界面可以选择产品版本，目前ServiceStage提供了基础版、专业版、铂金版等版本，说明如下。 表2 ServiceStage版本说明 版本 套餐说明 基础版 可以免费使用20个实例，最大支持100实例。 专业版 可支持超过100实例。 铂金版 可支持超过100实例，购买资源包可提供专属经理、远程技术支持、故障处理客户现场支持服务。 各个版本的计费说明，请参考计费详情。

CCE集群版本号说明 CCE 集群基于社区Kubernetes版本迭代演进，因此集群版本号由社区Kubernetes版本和CCE补丁版本两部分共同构成，格式为vX.Y.Z-rN（例如v1.28.2-r0）： Kubernetes版本：格式为X.Y.Z，继承社区版本策略，其中X对应社区Kubernetes的主要版本，Y对应社区Kubernetes的次要版本，Z对应社区Kubernetes的补丁版本，详情请参见社区Kubernetes版本策略。关于CCE支持的Kubernetes版本详情，请参见Kubernetes版本发布记录。 CCE补丁版本：格式形如v1.30.4-rN，处于维护期的Kubernetes版本会不定期地发布新的补丁版本。当新的补丁版本较上一版本提供了新的特性、Bugfix、漏洞修复或场景优化时，N版本号增加。关于CCE补丁版本详情，请参见补丁版本发布记录。

CCE集群版本阶段说明 版本公测阶段：您可以通过CCE集群公测版本体验最新的Kubernetes版本特性，但需要注意该版本的稳定性未得到完全的验证，不适用于CCE服务SLA。 版本商用阶段：CCE集群商用版本经过充分验证，稳定可靠。您可以将该版本用于生产环境，享受CCE服务SLA保障。 版本EOS（停止服务）阶段：CCE集群版本EOS之后，CCE将不再支持对该版本的集群创建，同时不提供相应的技术支持，包含新特性更新、漏洞/问题修复、补丁升级以及工单指导、在线排查等客户支持，不再适用于CCE服务SLA保障。

CCE集群版本生命周期表 Kubernetes版本号 当前状态 社区发布时间 CCE集群版本公测时间 CCE集群版本商用时间 CCE集群版本EOS（停止服务）时间 v1.31 已商用a 2024年08月 2025年01月 2025年04月 2027年04月 v1.30 已商用a 2024年04月 2024年09月 2024年10月 2026年10月 v1.29 已商用a 2023年11月 2024年04月 2024年06月 2026年06月 v1.28 已商用b 2023年08月 2023年12月 2024年02月 2026年02月 v1.27 已商用b 2023年04月 2023年08月 2023年10月 2025年10月 v1.25 EOS 2022年08月 2022年11月 2023年03月 2025年03月 v1.23 EOS 2021年12月 2022年04月 2022年09月 2024年09月 v1.21 EOS 2021年04月 2021年12月 2022年04月 2024年04月 v1.19 EOS 2020年08月 2020年12月 2021年03月 2023年09月 v1.17 EOS 2019年12月 / 2020年07月 2023年01月 v1.15 EOS 2019年06月 / 2019年12月 2022年09月 v1.13 EOS 2018年12月 / 2019年06月 2022年03月 v1.11 EOS 2018年08月 / 2018年10月 2021年03月 v1.9 EOS 2017年12月 / 2018年03月 2020年12月 a：支持通过控制台、API方式创建。 b：仅支持API方式创建。

CCE AI套件（Ascend NPU）版本发布记录 CCE会定期发布CCE AI套件（Ascend NPU）插件新版本，进行特性更新、性能优化和BUG修复，以提升用户体验和系统稳定性。为了方便您能够体验最新功能、规避已知漏洞或问题，并保障业务的安全性和可靠性，建议定期升级至最新版本的CCE AI套件（Ascend NPU）插件。 表1 CCE AI套件（Ascend NPU）插件版本记录 插件版本 支持的集群版本 更新特性 2.1.53 v1.25 v1.27 v1.28 v1.29 v1.30 v1.31 修复安全漏洞 2.1.46 v1.21 v1.23 v1.25 v1.27 v1.28 v1.29 v1.30 v1.31 支持CCE v1.31集群 2.1.23 v1.21 v1.23 v1.25 v1.27 v1.28 v1.29 v1.30 修复部分问题 2.1.22 v1.21 v1.23 v1.25 v1.27 v1.28 v1.29 v1.30 修复了一些页面显示问题 支持查询超节点信息 支持上报显卡拓扑信息 修复了日志打印问题 2.1.14 v1.21 v1.23 v1.25 v1.27 v1.28 v1.29 v1.30 修复部分问题 2.1.7 v1.21 v1.23 v1.25 v1.27 v1.28 v1.29 修复了为业务容器自动挂载npu-smi失败的问题 2.1.5 v1.21 v1.23 v1.25 v1.27 v1.28 v1.29 适配CCE v1.29集群 新增静默故障码 2.0.9 v1.21 v1.23 v1.25 v1.27 v1.28 修复进程级故障恢复和给工作负载添加注解偶现失败问题 2.0.5 v1.21 v1.23 v1.25 v1.27 v1.28 适配CCE v1.28集群 支持存活探针检查机制 支持为业务容器自动挂载Ascend驱动 1.2.14 v1.19 v1.21 v1.23 v1.25 v1.27 支持NPU监控 1.2.9 v1.19 v1.21 v1.23 v1.25 v1.27 适配CCE v1.27集群 1.2.6 v1.19 v1.21 v1.23 v1.25 支持NPU驱动自动安装 1.2.5 v1.19 v1.21 v1.23 v1.25 支持NPU驱动自动安装 1.2.4 v1.19 v1.21 v1.23 v1.25 适配CCE v1.25集群 1.2.2 v1.19 v1.21 v1.23 适配CCE v1.23集群 1.2.1 v1.19 v1.21 v1.23 适配CCE v1.23集群 1.1.8 v1.15 v1.17 v1.19 v1.21 适配CCE v1.21集群 1.1.2 v1.15 v1.17 v1.19 配置seccomp默认规则 1.1.1 v1.15 v1.17 v1.19 兼容CCE v1.15集群 1.1.0 v1.17 v1.19 适配CCE v1.19集群 1.0.8 v1.13 v1.15 v1.17 适配Snt3 C75驱动 1.0.6 v1.13 v1.15 v1.17 支持C75驱动 1.0.5 v1.13 v1.15 v1.17 支持容器里使用huawei NPU设备的管理插件 1.0.3 v1.13 v1.15 v1.17 支持容器里使用huawei NPU设备的管理插件 父主题： 插件版本发布记录

API变更与弃用 在Kubernetes1.29版本中，新创建的CronJob不再支持在.spec.schedule中通过TZ或者CRON_TZ配置时区，请使用.spec.timeZone替代。已经创建的CronJob不受此影响。 在Kubernetes1.29版本中，移除了alpha API ClusterCIDR。 在Kubernetes1.29版本中，kube-apiserver新增启动参数--authentication-config，用于指定AuthenticationConfiguration文件地址，该启动参数与--oidc-*启动参数互斥。 在Kubernetes1.29版本中，移除了KubeSchedulerConfiguration的API版本kubescheduler.config.k8s.io/v1beta3，请迁移至kubescheduler.config.k8s.io/v1。 在Kubernetes1.29版本中，将CEL表达式添加到v1alpha1 AuthenticationConfiguration中。 在Kubernetes1.29版本中，新增对象ServiceCIDR，允许用户动态配置集群分配Service的ClusterIP时所使用的地址范围。 在Kubernetes1.29版本中，kube-proxy新增启动参数--conntrack-udp-timeout、--conntrack-udp-timeout-stream，可对nf_conntrack_udp_timeout和nf_conntrack_udp_timeout_stream内核参数进行设置 。 在Kubernetes1.29版本中，将CEL表达式的支持添加到v1alpha1 AuthenticationConfiguration的WebhookMatchCondition中。 在Kubernetes1.29版本中，PVC.spec.Resource的类型由原先的ResourceRequirements替换为VolumeResourceRequirements。 在Kubernetes1.29版本中，将PodFailurePolicyRule中的OnPodConditions转变为可选字段。 在Kubernetes1.29版本中，FlowSchema与PriorityLevelConfiguration的API版本flowcontrol.apiserver.k8s.io/v1beta3已升级至flowcontrol.apiserver.k8s.io/v1，并进行了以下更改 PriorityLevelConfiguration：.spec.limited.nominalConcurrencyShares字段在省略时自动设为默认值30，并且为了确保与1.28兼容，在1.29中v1版本该字段不允许显示指定为0。在1.30中，将允许v1版本该字段显示指定为0。flowcontrol.apiserver.k8s.io/v1beta3已废弃，并在1.32中不再支持。 在Kubernetes1.29版本中， 优化了kube-proxy的命令行文档，kube-proxy实际上不会将任何socket绑定到由--bind-address启动参数指定的IP。 在Kubernetes1.29版本中，移除了selectorSpread调度器插件，使用podTopologySpread替代。 在Kubernetes1.29版本中，当CSI-Node-Driver没有在运行时，NodeStageVolume操作会重试。 在Kubernetes1.29版本中，ValidatingAdmissionPolicy支持对CRD资源进行校验。使用该特性需开启特性门控ValidatingAdmissionPolicy。 在Kubernetes1.29版本中，kube-proxy新增启动参数--nf-conntrack-tcp-be-liberal，可对内核参数nf_conntrack_tcp_be_liberal进行配置。 在Kubernetes1.29版本中，kube-proxy新增启动参数--init-only，设置后使kube-proxy的init容器在特权模式下运行，进行一些初始化配置，然后退出。 在Kubernetes1.29版本中，CRI的返回体中新增容器的fileSystem字段，表示容器的fileSystem使用信息，而原先只包含镜像的fileSystem。 在Kubernetes1.29版本中，所有内置的CloudProvider全部默认设置为关闭，如果仍需使用，可通过配置DisableCloudProviders和DisableKubeletCloudCredentialProvider特性门控来选择性关闭或者打开。 在Kubernetes1.29版本中，kubelet可通过--node-ips来设置双栈IP（kubelet设置--cloud-provider=external，此时可以使用--node-ips参数来设置节点地址(IPv4/IPv6)），使用该特性需开启特性门控CloudDualStackNodeIPs。