使用容器部署方式基于YAML配置创建并部署组件
本章节指导您使用容器部署方式基于YAML配置创建组件、保存组件草稿和部署组件，可以满足您通过K8s部署模板灵活部署组件的需求，适用于对CCE有深度了解的用户。
草稿是指组件处于创建过程中，尚未完成参数配置时提前保存，防止已配置参数因为关闭页面等因素丢失。在组件创建过程中，您可以随时单击“保存为草稿”，防止组件参数配置丢失。
前提条件
- 只能在应用下新增组件，需要先创建应用，请参考创建应用。
- 组件需要部署在指定环境下，需要先创建Kubernetes类型环境并纳管资源，请参考环境管理。
- 需要根据组织管理组件构建生成的镜像，需要先创建组织，请参考创建组织。
- 需要根据命名空间隔离构建数据和组件实例，需要先创建命名空间，请参考创建命名空间。
- 如果您基于“源码仓库”创建组件，那么您首先需要创建仓库授权，请参考创建仓库授权。
- 如果您基于软件包创建组件，那么您首先需要将软件包上传至CodeArts软件发布库、SWR软件仓库或者OBS对象存储中。
- 将软件包上传至CodeArts软件发布库，请参考上传软件包。
- 将软件包上传至SWR软件仓库，请参考上传软件包。
- 将软件包上传至OBS对象存储中，请参考流式上传（PUT上传）。
- 从自定义文件地址获取对应的软件包，支持自定义HTTP/HTTPS协议的文件地址下载。您需要提前将软件包上传至对应的自定义文件地址下。
- 如果您基于镜像包创建组件，请参考组件来源说明准备镜像。
- 如果您需要基于组件草稿创建组件，请参考本章节保存组件草稿。
使用容器部署方式基于YAML配置创建并部署组件
- 登录ServiceStage控制台。
- 根据您的实际业务需要选择组件创建方式。
- 从零开始创建组件，请执行以下操作。
- 选择以下任意方式进入“创建组件”页面：
- 选择。
- 在“应用管理”页面，选择待创建部署组件的应用，单击“操作”列的“新增组件”。
- 在“应用管理”页面，单击待创建部署组件的应用名称，在“应用概览”页面，单击“新增组件”。
- 执行5。
- 选择以下任意方式进入“创建组件”页面：
- 基于组件草稿创建组件，请执行以下操作。
- 选择以下任意方式进入“创建组件”页面：
- 在“应用管理”页面，单击组件草稿所在应用名称，进入“应用概览”页面。单击组件列表中“状态”为“草稿”的待操作组件名称。
- 在“组件管理”页面，单击“状态”为“草稿”的待操作组件名称。
- 执行5。
- 选择以下任意方式进入“创建组件”页面：
- 在“基本信息”区域，参考下表设置组件基本信息，其中带“*”标志的参数为必填参数。
参数
说明
*组件名称
组件的名称，组件创建并部署后不支持修改。
长度2到64个字符，可以包含英文字母、数字、下划线（_）或中划线（-），以英文字母开头、英文字母或者数字结尾。
- 不同应用下的同名组件可以部署在同一个环境下。
- 同一个应用下的同名组件可以部署在同一个环境下相同CCE集群下的不同泳道。关于泳道，请参考全链路流量控制概述。
- 同一个应用下的同名组件可以部署在同一个高可用环境下的不同CCE集群。
- 同一个应用下的同名组件可以部署在不同环境下。
*组件版本
组件版本号，支持自动生成和自定义版本号。
- 自动生成版本号：单击“自动生成”，默认以您单击“自动生成”时的时间来生成版本号，格式为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”或者“虚拟机+Kubernetes”类型的组件部署环境。
环境类型，请参考环境概述。
说明：如果环境同时纳管了CCE集群和虚拟机资源，该环境的类型为“虚拟机+Kubernetes”。
*选择集群
“所属环境”为高可用环境，用于选择组件部署和运行的CCE集群。
*命名空间
选择组件实例所在容器命名空间，用于隔离组件实例。关于命名空间，请参考管理命名空间。
*部署方式
选择组件的部署方式为“容器部署”。
当选择的“所属环境”为“虚拟机+Kubernetes”类型时需设置。组件部署方式，请参考组件部署方式说明。
*所属应用
组件所属应用。
*工作负载类型
工作负载是在Kubernetes上运行的应用程序。无论您的工作负载是单个组件还是协同工作的多个组件，您都可以在Kubernetes上的一组Pod中运行它。在Kubernetes中，工作负载是对一组Pod的抽象模型，用于描述业务的运行载体。您可以根据实际业务需要选择以下任意一种工作负载类型：
- 无状态：工作负载完全独立、功能相同，支持弹性伸缩、滚动升级。典型场景如nginx。
- 有状态：工作负载具有持久化的存储，支持有序的部署、伸缩删除。典型场景如mysql-HA、etcd。
*工作负载名称
工作负载名称默认由系统自动生成，也支持自定义。
工作负载默认名称由您输入的“组件名称”、选择的“所属环境”名称以及系统生成的6位随机字符串组成，长度不超过52个字符。
- 当您输入的“组件名称”长度不超过45个字符时，工作负载默认名称为：
组件名称全部字符-所属环境名称全部或部分字符-系统生成的6位随机字符串
其中，工作负载默认名称中的下划线（_）会被替换为中划线（-），名称中的大写字母会被转换为对应的小写字母。
例如，输入的组件名称为Com_calc，选择的所属环境名称为env-cce，则工作负载默认名称示例如下：
com-calc-env-cce-1uw8g0
- 当您输入的“组件名称”长度超过了45个字符时，工作负载默认名称为：
组件名称的前45个字符-系统生成的6位随机字符串
其中，工作负载默认名称中的下划线（_）会被替换为中划线（-），名称中的大写字母会被转换为对应的小写字母。
例如，输入的组件名称为C_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa，则工作负载默认名称示例如下：
c-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-1uw8g0
您也可以自定义工作负载名称。
- “工作负载类型”选择“有状态”：请输入长度为1到52个字符的字符串，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。
- “工作负载类型”选择“无状态”：请输入长度为1到63个字符的字符串，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。
组件创建并部署完成后，不再支持修改工作负载的名称。
标签
ServiceStage支持为组件添加key/value键值对类型的标签对组件进行管理和选择，例如用于设置组件实例调度策略。同一个组件下最多可以添加20个标签。
- 单击“添加标签”。
- 在“添加标签”对话框，单击“新增标签”。
- 输入Key值及其对应的Value值。
- key值：1到36个字符，只能包含数字、英文字母、下划线（_）、中划线（-）或中文。
- value值：2到43个字符，只能包含数字、英文字母、下划线（_）、点（.）、中划线（-）或中文。
须知：Key的取值不能是系统内置的app、casid或version。
- 单击“确定”。
描述
组件描述信息。
- 单击
，在编辑栏输入不超过128个字符的组件描述信息。 - 单击
，完成组件描述信息设置。
图1 设置组件基本信息
- 在“组件包”区域，参考下表设置组件包参数，其中带“*”标志的参数为必填参数。
参数
说明
*技术栈
- 根据组件部署方式，参考表1，选择组件技术栈类型。
仅支持选择已启用的状态为“启用中”的技术栈。启用技术栈，请参考启用技术栈。
- 在“名称”下拉列表，选择技术栈版本。
仅支持选择已启用的状态为“启用中”的技术栈版本。启用技术栈版本，请参考启用技术栈版本。
- 设置“JVM”参数，用于配置Java代码运行时的内存参数大小。技术栈类型选择Java、Tomcat时可设置。
单击“技术栈配置”，输入JVM参数，如-Xms256m -Xmx1024m，多个参数以空格间隔，不填则为空。
- 设置“Tomcat配置”参数，用于配置Tomcat请求路径、端口号等参数。技术栈类型选择Tomcat时可设置。
- 单击“技术栈配置”，勾选“Tomcat配置”，弹出“Tomcat配置”对话框。
- 单击“使用示例模板”，根据业务要求编辑模板文件。
说明：
Tomcat配置，使用默认server.xml配置，上下文路径是"/"，没有指定应用路径。
如需自定义应用路径，请参考定制Tomcat Context path。
- 单击“确定”。
*源码/软件包
*上传方式
组件来源为软件包或镜像包时，需选择已上传的软件包或镜像包，上传方式请参考组件来源说明。
- 如果组件来源为软件包且选择“自定义文件地址”上传方式，需要执行以下操作：
- 如果组件来源是镜像包：
- 可重新自定义“容器名称”：长度为1到63个字符，可以包含小写英文字母、数字和中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。
- 单击已选择的镜像包卡片右上角的
，可修改镜像包来源。
镜像访问凭证
- 最多支持选择16个镜像访问凭证。
- 单击“创建密钥”，可以创建新的镜像访问凭证。请参考创建密钥，“密钥类型”必须选择kubernetes.io/dockerconfigjson。
*容器名称
- 容器名称默认和5设置的“工作负载名称”的值一致。您也可以自定义容器名称：长度为1到63个字符，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。
- 如果“上传方式”选择的组件来源为镜像包且启用了多容器部署时，需为新增容器自定义容器名称：长度为1到63个字符，可以包含小写英文字母、数字或中划线（-），并以小写英文字母开头，小写英文字母或数字结尾。
- 根据组件部署方式，参考表1，选择组件技术栈类型。
- 在“构建”区域，参考下表设置构建参数，其中带“*”标志的参数为必填参数。
6选择的组件的技术栈类型为Java、Tomcat、Node.js、Python、Php时需设置。
参数
说明
*编译命令
组件来源是“源码仓库”时，根据业务需要设置“编译命令”。
- 使用默认命令或脚本：优先执行代码根目录下的build.sh，不存在则按照所选语言的通用方法编译，如Java语言的mvn clean package。
- 使用自定义命令：根据所选语言自定义编译命令，或修改build.sh文件后选择使用默认命令或脚本。
*Dockerfile地址
组件来源是“源码仓库”时，根据业务需要设置“Dockerfile地址”。
“Dockerfile地址”即Dockerfile文件相对于项目的根目录（./）所在的目录，Dockerfile文件用于镜像构建。
如果未指定“Dockerfile地址”，默认查找项目根目录下的Dockerfile；如果项目根目录下也没有Dockerfile文件，则根据选定的运行环境自动生成Dockerfile。
*组织
组织用于管理组件构建生成的镜像。
*构建环境
选择用于构建镜像的环境类型。执行构建的环境，必须是Kubernetes环境，且能够访问Internet。
推荐您选择“使用当前环境构建”。如果当前环境的CCE集群不能访问Internet，且您单独规划了构建环境，则可选择“使用独立环境构建”。
- 使用独立环境构建：可使用单独的构建环境进行镜像构建。独立构建环境CCE集群和当前组件部署环境CCE集群的CPU架构必须保持一致，否则会导致组件部署失败。
- 使用当前环境构建：使用组件所属的部署环境进行镜像构建。当前环境CCE集群的master节点和node节点的CPU架构必须保持一致，否则会导致组件构建失败。
*选择环境
- “构建环境”选择“使用独立环境构建”时，可选择使用不同于组件所属的独立构建环境。
- “构建环境”选择“使用当前环境构建”时，固定选择使用组件所属的部署环境。
*命名空间
选择执行构建的环境下CCE集群命名空间，用于隔离构建数据。关于命名空间，请参考管理命名空间。
过滤节点标签
通过节点标签可以将构建任务下发到绑定了EIP的固定节点上。
如果存在以下情况，您需要通过设置过滤节点标签将构建任务下发到绑定了EIP的固定节点上，保证组件构建、部署成功。
- “构建环境”选择“使用独立环境构建”时，需要设置过滤节点标签，将构建任务下发到独立构建环境下的node节点，保证该节点和当前组件部署环境下node节点CPU架构一致。
- “构建环境”选择“使用当前环境构建”时，如果环境下有node节点和master节点CPU架构不一致，需要设置过滤节点标签，将构建任务下发到和master节点CPU架构一致的node节点上。
新增过滤标签，请参考添加节点标签。
YAML模式
单击
开启YAML模式，使用YAML配置来部署组件。图2 设置构建参数
- 根据是否继续设置组件参数选择以下操作：
- 在“访问方式”区域，开启组件公网访问。
开启组件公网访问后，支持通过绑定了弹性公网IP的ELB以公网域名方式访问组件，以使用组件提供的服务。
- 如果组件创建并部署成功后通过ELB灰度发布方式进行升级维护，需在本操作步骤开启组件公网访问。ELB灰度发布，请参考灰度发布方式升级组件版本配置。
- 开启了公网访问的组件创建并部署完成后，您可以参考修改组件访问域名修改已设置的组件访问域名。
- 默认不开启组件公网访问。组件创建并部署完成后，您也可以设置组件访问方式，请参考设置组件访问方式。
单击
，开启公网访问后，设置以下参数：
- 设置“公网ELB”。
- 选择所选环境中已经存在的绑定了弹性公网IP的弹性负载均衡(ELB)资源。
- 若不存在，请单击“去所选的环境里添加”，在环境编辑页面，单击“新增可选资源”，为该环境添加已创建的弹性负载均衡(ELB)资源。
- 若需创建弹性负载均衡(ELB)资源，请参考下表根据实际应用场景进行创建。
使用场景
参考章节
使用域名访问应用
- 购买共享型负载均衡器
- 参考购买独享型负载均衡器创建“规格”为“应用型”的ELB
参考购买独享型负载均衡器创建“规格”为“应用型”的ELB
- 弹性负载均衡ELB需已绑定弹性公网IP，且必须与当前组件部署环境下纳管的计算资源处于相同的虚拟私有云VPC及其子网下。
- 组件在不同部署环境下需绑定不同ELB，避免路由错误。
- 设置“对外协议”。
- 选择“HTTP”，会存在安全风险，建议优先选择使用安全的“HTTPS”方式。
- 选择“HTTPS”，单击“使用已有”选择已经创建的证书。
若证书不存在，请单击“新创建”创建新的服务器证书。创建服务器证书请参考创建证书。
- 设置“域名”。
- 选择“自动生成”，自动生成的域名仅有7天有效期。
- 选择“绑定域名”，在输入框中输入自定义域名。
- 设置“监听端口”。
输入应用进程的监听端口号。
图3 设置公网访问
- 在“实例间发现服务配置”区域，参考下表设置组件的服务（Service）名称及端口，其中带“*”标志的参数为必填参数。
5选择的“工作负载类型”为“有状态”时，需执行本操作，用于解决有状态负载（StatefulSet）内Pod互相访问的问题，给每个Pod提供固定的访问域名。
参数
说明
*Service名称
输入应用发布的可被外部访问的名称。
Service是将运行在一组Pods上的应用程序公开为网络服务的抽象方法。
说明：部署在同一个CCE下的组件，Service名称必须唯一，否则会导致组件部署失败。
*端口配置
设置以下端口配置参数。
- 端口名称：Pod间通信的端口名称。
- 容器端口：容器中应用启动监听的端口。
- 访问端口：访问Service的端口。
如需增加端口配置，请单击“新增端口配置”。
- 如果5选择的组件所属环境为高可用环境，需要选择组件部署和运行的CCE集群。
关于高可用环境，请参考使用纳管资源配置模式创建Kubernetes环境。
- 导入或编辑组件YAML配置文件。
- 导入组件YAML配置文件：单击“导入YAML文件”，导入已经编辑好的组件YAML配置文件。
- 编辑组件YAML配置文件：根据实际业务需求编辑组件配置参数。
组件YAML配置文件中各参数的说明请参考Deployment。
您可以参考5中“工作负载名称”说明，修改YAML配置中“name”值，重新自定义工作负载名称。组件创建并部署完成后，不再支持修改工作负载的名称。
您也可以参考6中“容器名称”说明，修改YAML配置中“name”值，重新自定义容器名称。组件创建并部署完成后，您也可以通过组件升级修改容器名称。
- 请参考下表根据是否部署组件执行后续操作。
是否部署组件
操作方法
是
单击“创建并部署”。
否
单击“保存为草稿”。
组件会以草稿状态保存在您在5中选择的应用下的组件列表中。草稿是指组件处于创建过程中，尚未完成参数配置时提前保存，防止已配置参数因为关闭页面等因素丢失。您可以利用已保存的组件草稿继续创建组件。
