只有当应用模板下存在已发布的版本时,您才可以使用应用模板来创建无状态负载。版本定义了无状态负载的通用配置。本文介绍了如何通过边缘智能控制台为应用模板创建版本。
使用限制 目前只有无状态负载能够通过应用模板来创建。有状态负载和守护进程暂不能通过应用模板创建。
前提条件 您已经创建了应用模板。相关操作,请参见创建应用模板 。
操作步骤 登录边缘智能控制台 。
在左侧导航栏顶部的 我的项目 区域,选择您的项目。
在左侧导航栏,选择 应用管理 > 应用模板 。
在应用模板列表中,找到您的应用模板,然后单击应用模板名称。
单击 创建版本 。
在 创建版本 页面,参照配置说明 完成相关参数的设置,然后单击 完成 。
完成以上操作后,您可以模板版本列表查看刚刚创建的版本。新创建版本的 状态 是 未启用 。
接下来,您需要发布该版本,然后才能引用该版本来创建无状态负载。相关操作,请参见发布版本 。
配置说明 应用模板的版本配置包含基础信息 、容器配置 、发布策略 。
基础信息 配置项
说明
名称
为版本设置名称。输入要求如下:
只能使用以下字符:汉字、英文大小写字母、数字、下划线(_)、连字符(-)、半角句号(.)。 长度不超过 32 个字符。特殊字符不能用在开头和结尾,也不能连续使用。 描述
为版本添加描述。
允许使用任意字符。长度不超过 128 个字符。
副本数
设置工作负载在一体机中运行的副本总数。取值范围:1~10。
容器配置 类型
配置项
说明
容器
N/A
单击左侧的 + 添加容器 ,可以添加多个容器。
选择一个容器后,需要完成以下容器配置。
基本信息
容器名称
为容器设置名称。输入要求如下:
只能使用以下字符:小写字母、数字、连字符(-)。 长度不超过 128 个字符。连字符(-)不能用在开头和结尾。 同一个工作负载下,容器名称不允许重复。 镜像地址
输入镜像的 URL 地址。地址需符合 URL 格式。长度不超过 1024 个字符。
说明
您可以将制作好的应用镜像托管在某个镜像仓库,获取镜像的 URL。我们推荐您将镜像托管到火山引擎镜像仓库 。
仓库密钥
针对私有镜像仓库,可设置仓库密钥,以获得镜像访问权限。
选择已有的仓库密钥或单击 创建仓库密钥 ,按如下说明在 创建仓库密钥 对话框补充镜像仓库的密钥:
名称 :容器使用的镜像的仓库名称。
以使用镜像仓库 CR 中的镜像为例,则此处填写镜像所在的 OCI 制品仓库名称。仓库域名 :填写镜像仓库域名,示例:cr-cn-beijing.volces.com
。用户名 :登录镜像仓库的用户名。
以使用镜像仓库 CR 中的镜像为例,则此处填写镜像所在实例的登录用户名。可在 镜像仓库控制台 目标实例的 概览 页面获取。密码 :镜像仓库登录用户名对应的密码。
注意
不使用免密组件,且需要拉取私有镜像时,必须配置该参数。
资源配额
可选。按照业务需求,在容器维度配置 CPU 和内存的上下限,保障容器的健康运行。
注意
如果不设置资源配额和限额,则 K8s 会尽最大可能向工作负载提供资源,但是相应的优先级会降低。例如,另一个配置了资源配额和限额的工作负载,会更容易抢占到资源。
CPU配额 :容器需要使用的最小 CPU 核数。单位:Core。使用一位小数表示。取值范围:0.1 ~ 128.0。CPU限额 :允许容器使用的最大 CPU 核数。单位:Core。使用一位小数表示。取值范围:0.1 ~ 128.0。
如果 CPU 超过限额,容器会被终止。内存配额 :容器需要使用的最小内存值。单位:MB 或 GB。使用整数表示。取值范围:0 MB ~128 GB。内存限额 :允许容器使用的内存最大值。单位:MB 或 GB。使用整数表示。取值范围:0 MB ~128 GB。
如果内存超过限额,容器会被终止。
特权级容器
默认不开启。开启后特权级容器表示赋予该容器特权,允许访问宿主机全部资源。支持部署在 Linux 系统上的容器控制网络堆栈或访问设备。
Init容器
默认不开启。开启后表示将该容器设置为Init容器。Init容器是 Pod 中运行在应用容器前的容器,并且它可以包括仅在安装过程中使用的工具(例如 python、dig)和代码,避免在应用容器中的重复部署,提升应用镜像的安全性。
Init容器不支持设置生命周期管理中的启动后处理、停止前处理,不支持开启健康检查。
容器端口
端口
可选。支持将容器内端口号与宿主机的端口号进行映射。支持 UDP 和 TCP 两种协议。单击 + 添加端口映射。可以添加多个端口映射。
环境变量
环境变量
可选。支持手动设置环境变量和引用实例字段作为环境变量。Kubernetes 在创建 Pod 时,会将环境变量的信息注入到容器中。
单击 + 添加一个环境变量。您可以添加多个环境变量。
对于 手动配置 类型的环境变量,您需要设置环境变量的 变量名 和 变量值 ;对于 实例字段 类型的环境变量,您需要设置环境变量的 变量名 并选择一个实例字段作为 变量值 。可选择的实例字段包括:
metadata.name:工作负载的名称。 metadata.namespace:工作负载所处的命名空间。 spec.nodeName:工作负载所处的节点。 spec.serviceAccountName:所使用的服务账号。 status.hostIP:工作负载所处节点的 IP。 status.podIP:工作负载中 Pod 的 IPv4 地址。 status.podIPs:工作负载中 Pod 的 IPv4 和 IPv6 地址。
存储配置
存储卷
可选。在容器中存储数据分两步:先在 Pod 定义存储卷,也就是添加存储卷,然后在容器挂载卷。
单击 添加存储卷 ,添加存储卷。存储卷是容器中存储数据的位置。为一类数据分配存储资源前,需要先在容器中指定待存储数据的目录。
可以添加的存储卷分为以下类型:
临时目录 :在临时目录下添加存储卷。主机目录 :在主机下的指定目录下添加存储卷。配置文件 :配置文件对应 K8s 中的 ConfigMap 对象。
您必须先在 配置管理 页面创建一个配置文件,然后可以将配置文件作为数据卷挂载。密钥文件 :密钥文件对应 K8s 中的 Secret 对象。
您必须先在 配置管理 页面创建一个密钥文件,然后可以将该密钥文件作为数据卷挂载。挂载卷
可选。支持将宿主机的卷挂载到容器上,可以挂载多个卷。
单击 添加挂载卷 ,为已创建的卷分配存储资源,并分配读写权限。
支持通过 subPath 方式挂载卷的子目录;支持通过 subPathExpr 方式挂载卷的扩展路径。
设备挂载
设备挂载
可选。选择是否开启设备挂载。
开启设备挂载表示允许容器使用宿主机的设备资源。
生命周期
启动命令
可选。
运行命令 :输入容器启动前运行的命令。多行命令使用换行符分隔。运行参数 :输入容器启动前所运行命令的参数。
启动后处理
可选。输入容器启动后需要运行的命令。多行命令使用换行符分隔。
停止前处理
可选。输入容器停止需要运行的命令。多行命令使用换行符分隔。
发布策略 配置项
说明
发布策略
选择一种发布策略。可选项:
滚动发布:用新版本的 Pod 逐步替换旧版本的 Pod。升级的过程中,业务流量会同时负载均衡分布到新版本和旧版本的 Pod 上,因此业务不会中断。选择该策略后,还需要设置以下参数:
滚动数量:扩容过程中,工作负载中可用的 Pod 的数量的上限。 最大不可用:缩容过程中,工作负载中不可用的 Pod 的数量占总 Pod 数量(副本数)的比例上限。 重建:先把工作负载的老版本 Pod 删除,再安装指定的新版本 Pod。升级过程中业务会中断。 标签
为工作负载添加标签。您可以使用标签来标识一个 Pod 所属的应用程序、环境、版本等信息,从而方便您查找和管理 Pod。标签的示例:environment: production
、app:nginx
。
标签由键值对(key-value)组成,其中键和值都是字符串类型。
标签 key 包含两个部分:可选的前缀和标签名。这两部分之间使用斜杠(/)分隔。
标签名部分是必须的。
标签名允许使用英文大小写字母、数字及连字符(-)、下划线(_)和半角句号(.),并且开头和结尾必须是英文大小写字母、数字。长度不超过 63 个字符。 标签前缀部分是可选的。
标签前缀是由半角句号(.)连接的一组 DNS 标签,长度不超过 253 个字符。 如果省略标签前缀,则标签的 key 将被认为是专属于用户的。 标签 value 是必须的。
允许使用英文大小写字母、数字、连字符(-)、下划线(_)和半角句号(.)。长度不超过 63 个字符。特殊字符不允许用在开头和结尾,并且不能连用。 最多允许为工作负载指定 64 个标签。