基础配置
集群ID
集群ID为集群唯一标识,集群创建后自动生成,无需用户主动指定
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
uid |
uuid格式,36位长度,由小写字母、数字、中划线(-)组成 |
无 |
支持初始化时配置,不支持后续修改 |
CCE Standard/CCE Turbo |
配置建议:
集群ID由服务后台自动生成,无需用户手动配置
集群名称
集群名称
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
name |
以小写字母开头,由小写字母、数字、中划线(-)组成,长度范围4-128位,且不能以中划线(-)结尾 |
无 |
支持初始化时配置,不支持后续修改 |
CCE Standard/CCE Turbo |
集群显示名称
集群显示名称
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
alias |
以小写字母开头,由小写字母、数字、中划线(-)组成,长度范围4-128位,且不能以中划线(-)结尾 |
集群显示名不指定时,默认继承集群名称的取值 |
更新集群时支持修改 |
CCE Standard/CCE Turbo |
集群显示名,用于在 CCE 界面显示,该名称创建后可修改
配置建议:
按照集群资源归属(如一般集群还是GPU集群)、应用场景(测试集群还是生产集群)等维度命名,方便区分和管理
计费模式
包年包月是预付费模式,按订单的购买周期计费,适用于可预估资源使用周期的场景,价格比按需计费模式更优惠。
按需计费是后付费模式,按资源的实际使用时长计费,可以随时开通/删除资源。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
billingMode |
0: 按需计费 1: 包周期 |
0 |
按需计费的集群支持变更为包周期集群,包周期集群无法变更为按需计费模式。 |
CCE Standard/CCE Turbo |
集群转包时支持勾选归属集群的计算节点一并转包;同时,发起转包后需要完成订单付费操作才能生效,请按照前端引导进行操作
配置建议:
长期稳定使用的集群可以考虑选择包周期模式,有助于降低成本
集群版本
集群版本,与Kubernetes社区基线版本保持一致,建议选择最新版本。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
version |
在维版本 |
最新的商用版本 |
仅支持创建集群时自定义版本,集群创建完成后不支持修改,此时可以通过升级集群变更版本号 |
CCE Standard/CCE Turbo |
若不配置,默认创建最新版本的集群。
若指定集群基线版本但是不指定具体r版本,则系统默认选择对应集群版本的最新r版本。建议不指定具体r版本由系统选择最新版本。
Turbo集群支持1.19及以上版本商用。
配置建议:
推荐使用最新的商用版本。
集群平台版本号
CCE集群平台版本号,表示集群版本(version)下的内部版本。用于跟踪某一集群版本内的迭代,集群版本内唯一,跨集群版本重新计数。不支持用户指定,集群创建时自动选择对应集群版本的最新平台版本。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
platformVersion |
platformVersion格式为:cce.X.Y X: 表示内部特性版本。集群版本中特性或者补丁修复,或者OS支持等变更场景。其值从1开始单调递增。 Y: 表示内部特性版本的补丁版本。仅用于特性版本上线后的软件包更新,不涉及其他修改。其值从0开始单调递增。 |
无 |
允许 |
CCE Standard/CCE Turbo |
CCE集群平台版本号,表示集群版本(version)下的内部版本。用于跟踪某一集群版本内的迭代,集群版本内唯一,跨集群版本重新计数。不支持用户指定,集群创建时自动选择对应集群版本的最新平台版本。
配置建议:
推荐使用最新的集群小版本
集群类别
集群类别
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
category |
CCE:表示CCE Standard集群 Turbo:表示CCE Turbo集群 |
无 |
支持初始化时配置,不支持后续修改 |
CCE Standard/CCE Turbo |
CCE:CCE Standard集群。CCE Standard集群支持虚拟机与裸金属服务器混合、GPU、NPU等异构节点的混合部署,基于高性能网络模型提供全方位、多场景、安全稳定的容器运行环境。
Turbo: CCE Turbo集群。 全面基于云原生基础设施构建的云原生2.0的容器引擎服务,具备软硬协同、网络无损、安全可靠、调度智能的优势,为用户提供一站式、高性价比的全新容器服务体验。
自定义集群API Server证书SAN
集群的API Server服务端证书中的自定义SAN(Subject Alternative Name)字段,遵从SSL标准X509定义的格式规范。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
customSan |
不允许出现同名重复。 格式符合IP和域名格式。 |
无 |
允许 |
CCE Standard/CCE Turbo |
SAN通常在TLS握手阶段被用于客户端校验服务端的合法性:服务端证书是否被客户端信任的CA所签发,且证书中的SAN是否与客户端实际访问的IP地址或DNS域名匹配。
当客户端无法直接访问集群内网私有IP地址或者公网弹性IP地址时,您可以将客户端可直接访问的IP地址或者DNS域名签入集群服务端证书,以支持客户端开启双向认证,提高安全性。典型场景例如DNAT访问、域名访问等特殊场景。
配置建议:
域名访问场景的典型使用方式如下:
客户端配置Host域名指定DNS域名地址,或者客户端主机配置/etc/hosts,添加相应域名映射。
云上内网使用,云解析服务DNS支持配置集群弹性IP与自定义域名的映射关系。后续更新弹性IP可以继续使用双向认证+自定义域名访问集群,无需重新下载kubeconfig.json配置文件。
自建DNS服务器,自行添加A记录。
集群规模
集群支持管理的最大节点数量,请根据业务场景选择。创建完成后支持扩容,不支持缩容。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
flavor |
|
cce.s1.small |
不支持直接修改,仅支持通过集群规格变更修改 |
CCE Standard/CCE Turbo |
s1:单控制节点CCE集群。
s2:多控制节点CCE集群。
最大节点数:当前集群支持管理的最大节点规模,请根据业务需求选择。
单控制节点集群:普通集群是单控制节点,控制节点故障后,集群将不可用,但已运行工作负载不受影响。
多控制节点集群:即高可用集群,当某个控制节点故障时,集群仍然可用。
配置建议:
除用于试验性用途用户可以视情况选择单控制节点规格外,凡是对可靠性有要求的应用场景请务必选择多控制节点集群规格。
请结合业务最大预期规模选择合适的集群规格,同时预留一定的buffer(如业务规模评估在50节点规模左右,那么请选择50上一档位的规格,即200节点规格),集群使用过程中建议保持对集群管理面资源占用情况的监控跟踪,观察到资源存在压力时及时调整集群规格进行扩容,避免集群过载风险
集群控制节点操作系统架构
集群控制节点架构
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
type |
VirtualMachine BareMetal Windows ARM64 |
VirtualMachine |
支持初始化时配置,不支持后续修改 |
CCE Standard/CCE Turbo |
VirtualMachine:Master节点为x86架构服务器
ARM64: Master节点为鲲鹏(ARM架构)服务器
集群控制节点指定可用区
集群控制节点所处的可用区,以下两个参数不可同时指定。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
masters |
availabilityZone列表,用于指定master节点的可用区,该列表长度与集群的master节点数有关。例如3个master节点的集群示例如下: [ {"availabilityZone": "AZ1"}, {"availabilityZone": "AZ2"}, {"availabilityZone": "AZ3"} ] |
无 |
支持初始化时配置,不支持后续修改 |
CCE Standard/CCE Turbo |
clusterAZ |
|
无 |
允许 |
CCE Standard/CCE Turbo |
集群资源标签
为集群添加TMS资源标签,便于按照相应维度对集群资源和其他云服务资源进行统一检索和管理
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
clusterTags |
标签以key=value的形式赋值,其中key:最大长度36字符,由小写字母、数字、中划线(-)、下划线(_)组成 value:最大长度43字符,由小写字母、数字、中划线(-)、下划线(_)组成 |
无 |
允许 |
CCE Standard/CCE Turbo |
每个集群最多支持添加20个标签
配置建议:
用户可以按照管理需求,将资源划分的维度以标签形式进行抽象,常见的划分维度包括业务领域、部门、环境归属(生产环境、测试环境)等
supportIstio
支持Istio
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
supportIstio |
bool值 |
无 |
允许 |
- |
支持Istio
集群描述
集群描述,对于集群使用目的的描述,可根据实际情况自定义,默认为空。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
description |
仅支持utf-8编码 支持200个字符以内 |
无 |
允许 |
CCE Standard/CCE Turbo |
集群描述,对于集群使用目的的描述,可根据实际情况自定义,默认为空。集群创建成功后可通过接口更新指定的集群来做出修改,也可在CCE控制台中对应集群的“集群详情”下的“描述”处进行修改。
配置建议:
用户根据实际情况自行定义
企业项目
集群所归属的企业项目。企业项目是一种云资源管理方式,企业项目管理服务提供统一的云资源按项目管理,以及项目内的资源管理、成员管理。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
enterpriseProjectId |
租户下已存在的企业项目ID |
default |
在企业项目管理界面支持变更 |
CCE Standard/CCE Turbo |
用户需要开通企业项目功能后才可配置企业项目。
集群所属的企业项目与集群下所关联的其他云服务资源所属的企业项目尽量保持一致
配置建议:
与资源标签用途类似,用户可以按照管理需求,将不同归属的集群规划到不同企业项目下进行治理,常见的划分维度包括业务领域、部门、环境归属(生产环境、测试环境)等
集群公网IP
集群管理节点弹性公网IP
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
clusterExternalIP |
租户下已存在的公网IP |
无 |
允许 |
CCE Standard/CCE Turbo |
为集群管理面绑定公网IP,以支持从公网调用集群接口
配置建议:
对于有通过公网访问集群API的用户,可以按需为集群绑定公网IP
绑定公网IP后集群访问入口将暴露在公网,请谨慎操作
容器网络固定IP池掩码位数
容器网络固定IP池掩码位数,仅vpc-router网络支持。
该参数决定节点可分配容器IP数量,与创建节点时设置的maxPods参数共同决定节点最多可以创建多少个Pod
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
alpha.cce/fixPoolMask |
24 ~ 28 |
无 |
允许 |
CCE Standard/CCE Turbo |
容器网络固定IP池掩码位数,仅vpc-router网络支持。
该参数决定节点可分配容器IP数量,与创建节点时设置的maxPods参数共同决定节点最多可以创建多少个Pod
默认Docker的UmaskMode
集群默认Docker的UmaskMode配置
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
dockerUmaskMode |
secure/normal |
normal |
允许 |
CCE Standard/CCE Turbo |
集群CPU管理策略
提供的CPU管理策略为应用分配独占的CPU核(即CPU绑核),提升应用性能,减少应用的调度延迟。
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
kubernetes.io/cpuManagerPolicy |
none/static |
无 |
支持初始化时配置,不支持后续修改 |
CCE Standard/CCE Turbo |
集群CPU管理策略。取值为none(或空值)或static,默认为none(或空值)。
none(或空值):关闭工作负载实例独占CPU核的功能,优点是CPU共享池的可分配核数较多
static:支持给节点上的工作负载实例配置CPU独占,适用于对CPU缓存和调度延迟敏感的工作负载,Turbo集群下仅对普通容器节点有效,安全容器节点无效。
包周期类型
包周期类型
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
periodType |
month:月 year:年 |
无 |
允许 |
CCE Standard/CCE Turbo |
包周期类型。作为请求参数,billingMode为1(包周期)时生效,且为必选。 作为响应参数,仅在创建包周期集群时返回。
包周期数
包周期数
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
periodNum |
periodType=month(周期类型为月)时,取值为[1-9]。 periodType=year(周期类型为年)时,取值为1-3。 |
无 |
允许 |
CCE Standard/CCE Turbo |
包周期数。作为请求参数,billingMode为1时生效,且为必选。 作为响应参数,仅在创建包周期集群时返回。
自动续订
是否自动续订
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
isAutoRenew |
true:自动续订 false:不自动续订 |
无 |
允许 |
CCE Standard/CCE Turbo |
是否自动续订。billingMode为1时生效,不填写此参数时默认不会自动续费。
自动扣款
是否自动扣款
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
isAutoPay |
true:自动扣款 false:不自动扣款 |
无 |
允许 |
CCE Standard/CCE Turbo |
是否自动扣款。billingMode为1时生效,不填写此参数时默认不会自动扣款。
集群升级方式
记录集群通过何种升级方式升级到当前版本
参数名 |
取值范围 |
默认值 |
是否允许修改 |
作用范围 |
---|---|---|---|---|
upgradefrom |
无 |
无 |
允许 |
CCE Standard/CCE Turbo |