模板仓库

模板市场

模板市场用来管理基于Kubernetes Helm标准的应用模板。高效实现了模板的快速部署,简化了Kubernetes部署应用的版本控制、打包、发布、删除、更新等操作。

私有模板列表及操作

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板列表页面。如图:

列表中的基本操作如表1所示。

表1

操作名称 操作 详解
查询 支持模板名称搜索。
刷新 清空所有搜索条件并刷新列表。
模板详情 支持模板基本信息查看和模板说明。
安装 进入安装模板页面。
删除 删除模板,此操作不可恢复,请慎重。

模板详情

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场→名称超链接

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板市场页面。

4.点击名称超链接,进入模板市场详情页面,支持基本信息和模板说明查看。

1)基本信息。

通过点击访问地址的链接可以直接访问。

2)模板说明。

可以查看对模板的详细说明。

上传模板

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场→上传

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板市场页面。

4.点击"上传 ",选择需要上传的文件。

5.点击“打开”按钮,模板上传完成,返回模板市场页面。

安装模板

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场→安装

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板市场页面。

4.点击"安装",按要求填写基本信息。如表2所示。

表2 属性说明

属性名称 填写规则
版本 请选择要使用的版本。
集群 请选择要使用的集群。
命名空间 请选择要使用的命名空间。
实例名称 必须由小写字母、数字、字符“-”或“.”组成,并且必须以小写字母或数字开始和结束。
服务 请选择服务类型
存储配置 当模板中使用动态存储或本地存储时,有此选项。可参考模板开发指南
域名配置 当模板中有使用istio域名是,有此选项。模板开发指南
高级配置 请输入配置参数。

1)当有存储配置时,选择卷类型、存储类型和存储容量

2)当有域名配置时:

3)配置参数可以根据需要进行修改

5.点击“提交”按钮,模板安装完成,返回模板市场页面。

官方模板列表及操作

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板列表页面。如图:

列表中的基本操作如表3所示。

表3

操作名称 操作 详解
查询 支持模板名称搜索。
刷新 清空所有搜索条件并刷新列表。
模板详情 支持模板基本信息查看和模板说明。
安装 进入安装模板页面。

模板详情

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场→官方模板→名称超链接

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板市场页面。

4.点击“官方模板”,进入官方模板列表。

4.点击名称超链接,进入模板市场详情页面,支持基本信息和模板说明查看。

1)基本信息。

通过点击访问地址的链接可以直接访问。

2)模板说明。

可以查看对模板的详细说明。

安装模板

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板市场→官方模板→安装

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板市场”,进入模板市场页面。

4.点击“官方模板”,进入官方模板列表。

5.点击"安装",按要求填写基本信息。如表4所示。

表4 属性说明

属性名称 填写规则
版本 请选择要使用的版本。
集群 请选择要使用的集群。
命名空间 请选择要使用的命名空间。
实例名称 必须由小写字母、数字、字符“-”或“.”组成,并且必须以小写字母或数字开始和结束。
服务 请选择服务类型。
配额 cpu和内存大小限制
存储 当模板中使用动态存储或本地存储时,有此选项。可参考模板开发指南
域名配置 当模板中有使用istio域名是,有此选项。模板开发指南
高级配置 请输入配置参数。

1)当有存储配置时,选择卷类型、存储类型和存储容量

2)当有域名配置时:

3)配置参数可以根据需要进行修改

5.点击“提交”按钮,模板安装完成,返回模板市场页面。

模板实例

模板实例列表及操作

菜单路径

产品与服务→计算→容器引擎→模板仓库→模板实例

操作步骤

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板实例”,进入模板实例列表页面。列表中的基本操作如表3所示。

表3

操作名称 操作 详解
查询 支持模糊查询,“集群”、“命名空间”、“实例名称”可作为查询条件。
实例详情 进入模板实例详情页面,支持“基本信息”、“资源信息”查看。
刷新 清空所有搜索条件并刷新列表。
删除 删除模板实例,删除操作不可恢复,请慎重。
回滚 回滚到需要的版本。

实例详情信息及操作

1.登录控制台。

2.点击“产品与服务”,选择“计算”→“容器引擎”,进入容器引擎页面。

3.点击“模板仓库”,选择“模板实例”,进入模板实例列表页面。

4.点击“实例名称”超链接,进入实例详情页面。

1)基本信息

描述模板实例的名称、修订版本、命名空间、服务模板、部署状态、运行状态、更新时间、访问信息。

2)资源信息

点击“查看事件”,进行事件的查看。

点击“查看日志”,进行日志的查看。

点击“删除”,进行删除,此操作不可恢复,请慎重。

3)配置参数

点击“编辑配置”,进行编辑。

修改配置参数:

点击“保存配置”,进行保存编辑。

点击“取消配置”,进行取消编辑。

4)修订历史

每编辑一次都会增加一个历史版本,点击“回滚”,进行回滚操作。

模板开发指南

概念

  • helm

Helm是目前Kubernetes服务编排领域的唯一开源子项目,做为Kubernetes应用的一个包管理工具。Helm通过软件打包的形式,支持发布的版本管理和控制,很大程度上简化了Kubernetes应用部署和管理的复杂性。

  • chart

chart是helm的打包格式,包含一组创建Kubernetes资源所需要的yaml文件和一些描述性文件。

开发指引

模板包制作请参考:chart官方开发文档

下面以开发一个fastdfs模板为例:

创建模板

使用命令 “helm create fastdfs” 创建一个模板。目录结构如下:

编辑模板

在第一步骤中创建的模板包,是根据helm命令生成的一个目录demo(默认内容是nginx),所以把一些无用的文件或者目录删掉,然后开始开发自己的模板,目录结构如下:

(1)Chart.yaml文件说明。此文件是模板的说明文件,是必须有的一个文件。包含以下属性:

(2) values.yaml文件说明。此文件是模板的配置文件,是必须有的一个文件。Fastdfs模板配置示例如下:

(3)templates/NOTES.txt/文件说明。模板开发者使用此文件暴露服务的使用信息,例如:访问地址,用户名、密码等等。Fastdfs写法示例如下:

增加注解

须知:本步骤,不是必须的,模板开发者可以根据需求填写。添加的所有注解均不会改变原有配置文件values.yaml的结构。

配置文件中支持配置项使用“注释+注解”的方式标注配置项,方便模板更好的使用。“注解”有以下用途:

  • 更好的使用集群中的存储资源,添加注解之后,在创建模板实例的时候,可以从页面上选择集群中的存储。

  • 服务暴露,添加注解之后,在创建模板实例的时候,可以选择服务访问方式。

  • 配置项校验,添加注解之后,可以根据填写的正则表达式,校验配置项的值。

  • 配额设置,添加注解之后,可以在创建模板实例的时候,对CPU、内存设置最大上限。

所有注解介绍如下:

1.#@Persistences

该注解用来标注存储资源。例如:fastdfs模板需要持久化存储,配置示例如下:

注解属性说明如下:

属性 是否必须 说明
name 配置项,对应values.yaml的key
regular 一个正则表达式,用来校验key对应的value值
persistenceGroup 分组,同一个存储资源的配置信息放到一组
type 目前支持三种,类别(STORAGE_CLASS(存储类型)、STORAGE_SIZE(存储大小)、STORAGE_PATH(存储路径))
descriptions 配置项说明

2.#@Services

该注解用来标注Service资源。例如:fastdfs模板需要对外暴露服务,配置示例如下:

注解属性说明如下:

属性 是否必须 说明
name 配置项,对应values.yaml的key
regular 一个正则表达式,用来校验key对应的value值
serviceGroup service分组,同一个service资源设置为一组,一个chart中可能会出现多个service配置
portsGroup port分组,同一个service资源里面的同一个ports设置为一组,在一个chart中,同一个service资源中可能会配置多个ports
type 类别(PORT(服务端口)、NODE_PORT(节点端口)、PORT_NAME(端口名称)、SERVICE_NAME(服务名称)、DOMAIN(域名)、SERVICE_TYPE(服务类型:ClusterIp、NodePort))
descriptions 配置项说明

3.#@Resources

该注解用来标注最大资源配额。例如:fastdfs要求cpu、内存配置使用上限,配置示例如下:

注解属性说明如下:

属性 是否必须 说明
name 配置项,对应values.yaml的key
regular 一个正则表达式,用来校验key对应的value值
resource 资源(cpu、memory)
resourceGroup 分组,一个chart中可能会出现多对resources配置,每一对设置成一个分组
descriptions 配置项说明

4.#@Secrets

该注解用来标注模板中使用的密码配置。例如:fastdfs模板中,需要有密码自动生成,配置示例如下:

注解属性说明如下:

属性 是否必须 说明
name 配置项,对应values.yaml的key
regular 一个正则表达式,用来校验key对应的value值
isAutoGenerate 是否自动生成密码,不填或者false,不自动生成
descriptions 配置项说明

5.#@Basics

该注解可以标注配置文件中的每一个配置项。例如:fastdfs中的一个配置需要校验,配置示例如下:

注解属性说明如下:

属性 是否必须 说明
name 配置项,对应values.yaml的key
regular 一个正则表达式,用来校验key对应的value值
descriptions 配置项说明

打包模板

使用“helm package –save=false fastdfs”命令打包模板,打包完成,生成模板压缩包如下:

  • fastdfs-0.1.0.tgz

上传模板

登录云平台“容器引擎”控制台,点击左侧导航菜单“模板仓库”→“模板市场”,在“私有模板”页面,点击“上传”上传模板包。如下:

创建实例

登录“容器引擎”控制台,点击左侧导航菜单“模板仓库”→“模板市场”,在“私有模板”列表页面,找到“fastdfs”模板。

然后,点击“安装”,在“安装”页面选择集群、命名空间,填写实例名称,选择服务访问类型,填写节点端口号,选择存储类型,填写存储大小,在高级配置中,填写镜像地址,示例如下:

须知:服务模板使用的镜像,均在“容器镜像服务”控制台获取。在“容器引擎”控制台,点击左侧导航菜单“镜像仓库”→“我的镜像”,进入“容器镜像服务”控制台,在“我的镜像”列表页面,点击镜像名称,进入镜像详情页面,点击“使用指引”查看镜像地址。

访问详情

登录“容器引擎”控制台,点击左侧导航菜单“模板仓库”→“模板市场”,找到已安装的实例,点击“实例名称”,查看实例使用详情。