容器服务 Kubernetes 版 ACK：通过OpenAPI创建专有版安全沙箱Kubernetes集群

名称

类型

是否必选

示例值

描述

addons

Array

是

[{"name": "terway-eniip","config": ""}, {"name": "logtail-ds","config": "{\"IngressDashboardEnabled\":\"true\",\"sls_project_name\":\"your_sls_project_name\"}"}, {"name":"nginx-ingress-controller","config":"{\"IngressSlbNetworkType\":\"internet\"}"}]

Kubernetes集群的安装的组件列表：

• 组件的参数：

  • name：必选。

  • config：可选，取值为空时表示无需配置。

  • disabled：可选，是否禁止默认安装。

• 网络插件：必选，包含Flannel和Terway两种网络类型，创建集群时二选一。

  • Flannel网络：[{"name":"flannel","config":""}]。

  • Terway网络：[{"name": "terway-eniip","config": "\"IPVlan\":\"false\""}]。

• 存储插件：可选，仅支持CSI类型。

  csi插件：[{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}]。

• 日志组件：可选。

  重要

  如果不开启日志服务，将无法使用集群审计功能。

  • 使用已有SLS Project：[{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}]。

  • 创建新的SLS Project：[{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}]。

• Ingress：可选，默认开启安装Ingress组件nginx-ingress-controller：

  • 安装Ingress并且开启公网：[{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}]。

  • 不安装Ingress：[{"name": "nginx-ingress-controller","config": "","disabled": true}]。

• 事件中心：可选，默认开启。事件中心提供对Kubernetes事件的存储、查询、告警等能力。Kubernetes事件中心关联的Logstore在90天内免费。关于免费策略的更多信息，请参见创建并使用K8s事件中心。

  开启事件中心：[{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\" your_sls_project_name\"}"}]。

cloud_monitor_flags

Boolean

否

true

集群是否安装云监控插件。取值：

• true：集群不安装云监控插件。

• false：集群安装云监控插件。

默认值：false。

cluster_type

String

是

Kubernetes

集群类型。创建专有版安全沙箱集群时，只能选择Kubernetes。

container_cidr

String

否

172.20.0.0/16

Pod网络地址段，不能和VPC网段冲突。当选择系统自动创建VPC时，默认使用172.16.0.0/16网段。当创建Flannel网络类型的集群时，该字段为必填。

cpu_policy

String

否

none

节点CPU管理策略。当集群版本在1.12.6及以上时支持以下两种策略：

• static：允许为节点上具有某些资源特征的Pod赋予增强的CPU亲和性和独占性。

• none：表示启用现有的默认CPU亲和方案。

默认值：none。

deletion_protection

Boolean

否

true

集群是否开启集群删除保护，防止通过控制台或API误删除集群。取值：

• true：集群开启集群删除保护。

• false：集群不开启集群删除保护。

默认值：false。

disable_rollback

Boolean

否

true

集群创建失败是否回滚。取值：

• true：集群创建失败回滚。

• false：集群创建失败不回滚。

默认值：false。

endpoint_public_access

Boolean

否

true

是否开启公网API Server。取值：

• true：表示开放公网API Server。

• false：表示不会创建公网的API Server，仅创建私网的API Server。

默认值：true。

is_enterprise_security_group

Boolean

否

true

自动创建企业级安全组，当security_group_id为空时生效。Terway网络类型集群，必须指定为企业安全组。

• true：自动创建企业级安全组。

• false：不自动创建企业级安全组。

默认值：false。

key_pair

String

是

security-key

密钥对名称，和login_password二选一。

kubernetes_version

String

否

1.16.9-aliyun.1

集群版本，与Kubernetes社区基线版本保持一致。建议选择最新版本，若不指定，默认使用最新版本。目前您可以在ACK控制台创建两种最新版本的集群。您可以通过API创建其他Kubernetes版本集群。关于ACK支持的Kubernetes版本，请参见Kubernetes版本发布概览。

login_password

String

是

Hello@1234

SSH登录密码，和key_pair二选一。密码规则为8~30个字符，且至少同时包含三项（大小写字母、数字和特殊符号）。

master_auto_renew

Boolean

否

true

Master节点是否开启自动续费，当master_instance_charge_type取值为PrePaid时才生效，可选值为：

• true：自动续费。

• false：不自动续费。

默认值：true。

master_auto_renew_period

Long

否

1

Master节点自动续费周期，当选择包年包月付费类型时才生效，且为必选项。

取值范围：{1, 2, 3, 6, 12}。

默认值：1。

master_count

Long

否

3

Master节点数量，取值3或5。

默认值：3。

master_instance_charge_type

String

否

PrePaid

Master节点付费类型，取值：

• PrePaid：包年包月。

• PostPaid：按量付费。

默认为PostPaid按量付费。

master_instance_types

Array of String

否

["ecs.n4.xlarge"]

Master节点实例类型。指定的实例规格数量需要和master_count保持一致，并且和master_instance_types中的元素一一对应。

master_period

Long

否

1

Master节点包年包月时长，当master_instance_charge_type取值为PrePaid时才生效且为必选值。

取值范围：{1, 2, 3, 6, 12, 24, 36, 48, 60}。

默认值：1。

master_period_unit

String

否

Month

Master节点付费周期，当付费类型为PrePaid的时候需要指定周期。

取值：Month。

master_system_disk_category

String

否

cloud_ssd

Master节点系统盘类型，取值：

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD云盘。

默认值：cloud_ssd。

master_system_disk_size

Long

否

120

Master节点系统盘类型，取值范围[40,500]，单位：GiB。

默认值：120。

master_system_disk_performance_level

String

否

PL1

集群Master节点系统盘磁盘性能等级， 仅对ESSD磁盘生效。磁盘性能等级和磁盘大小有关。更多信息，请参见ESSD云盘。

master_vswitch_ids

Array of String

否

["vsw-2ze3ds0mdip0hdz8i****"]

Master节点虚拟交换机ID。

name

String

是

cluster-demo

集群名称。

命名规则：由数字、汉字、英文字符或短划线（-）组成，长度范围1~63个字符，且不能以短划线（-）开头。

node_cidr_mask

String

否

25

节点IP数量，通过指定网络的CIDR来确定IP的数量，只对于Flannel网络类型集群生效。

默认值：25。

node_port_range

String

否

30000~32767

节点服务端口。取值范围为[30000,65535]。

num_of_nodes

Long

是

3

Worker节点数。范围是[0,100]。

pod_vswitch_ids

Array of String

否

["vsw-2ze97jwri7cei0mpw****"]

Pod的虚拟交换机列表。

您需要为每一个节点虚拟交换机指定至少一个相同可用区的Pod虚拟交换机，并且不能跟节点vswitch重复。

proxy_mode

String

否

ipvs

kube-proxy代理模式，支持iptables和ipvs两种模式。

默认值：ipvs。

region_id

String

是

cn-beijing

集群所在的地域ID。

runtime

runtime

是

{"name": "Sandboxed-Container.runv", "version": "2.2.0"}

security_group_id

String

否

sg-bp1bdue0qc1g7k****

使用已有安全组创建集群时需要指定安全组ID，集群节点自动加入到此安全组，和is_enterprise_security_group二选一。

service_cidr

String

是

172.21.0.0/20

Service网络地址段，不能和VPC网段及Pod网络网段冲突。当选择系统自动创建VPC时，默认使用172.19.0.0/20网段。

snat_entry

Boolean

否

true

是否为网络配置SNAT：

• 当已有VPC能访问公网环境时，设置为false。

• 当已有VPC无法访问公网环境时：

  • 设置为true，表示配置SNAT，此时可以访问公网环境。

  • 设置为false，表示不配置SNAT，此时无法访问公网环境。

如果您的应用需要访问公网，建议配置为true。

默认值：false。

ssh_flags

Boolean

否

true

是否开放公网SSH登录。取值：

• true：表示开放。

• false：表示不开放。

默认值：false。

tags

Array

否

集群标签。

Key

String

否

env

标签key-value的键。

value

String

否

prod

标签key-value的值。

tains

Array

否

节点污点信息。污点和容忍度（Toleration）相互配合，可以用来避免Pod被分配到不合适的节点上。更多信息，请参见taint-and-toleration。

effect

String

否

NoSchedule

调度策略。取值：

• NoSchedule：Pod不会被调度到标记了Taints的节点上。

• NoExecute：一旦Taint生效，该节点内正在运行的Pod没有对应Tolerate设置，会直接被逐出。

• PreferNoSchedule：NoSchedule的宽松版本。避免将Pod调度到有污点的节点上。

Key

String

否

disk_type

污点key-value的键。

value

String

否

sshd

污点key-value的值。

timeout_mins

Long

否

60

集群创建超时时间。单位：分钟。

默认值：60。

user_data

String

否

IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****

节点自定义数据。更多信息，请参见ECS实例自定义数据概述。

vpcid

String

是

vpc-2zeik9h3ahvv2zz95****

集群使用的VPC实例ID。

vswitch_ids

Array of String

是

["vsw-2ze48rkq464rsdts1****"]

虚拟交换实例ID。

worker_auto_renew

Boolean

否

true

Worker节点是否开启自动续费，当worker_instance_charge_type取值为PrePaid时才生效，可选值为：

• true：自动续费。

• false：不自动续费。

默认值：true。

worker_auto_renew_period

Long

否

1

Worker节点自动续费周期，当选择包年包月付费类型时才生效，且为必选值。取值范围：{1,2,3,6,12}。

worker_data_disks

Array

是

Worker节点数据盘类型、大小等配置的组合。

auto_snapshot_policy_id

String

否

sp-bp14j6w7ss6ozz****

自动快照策略ID。

category

String

否

cloud_ssd

Worker节点数据盘类型，取值：

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD云盘。

• cloud：普通云盘。

默认值：cloud_efficiency。

encrypted

String

否

false

是否对数据盘加密。取值：

• true：对数据盘加密。

• false：不对数据盘加密。

默认值：false。

size

String

是

200

数据盘大小，内存单位为GiB。取值：

• cloud_efficiency：[20,32768]

• cloud_ssd：[20,32768]

• cloud：[5,2000]

worker_instance_charge_type

String

是

PrePaid

Worker节点付费类型，取值：

• PrePaid：包年包月。

• PostPaid：按量付费。

默认：按量付费。

worker_instance_types

Array of String

是

["ecs.ebmg5s.24xlarge"]

Worker节点实例类型。

worker_period

Long

否

1

Worker节点包年包月时长，当worker_instance_charge_type取值为PrePaid时才生效且为必选值。取值范围：{1,2,3,6,12,24,36,48,60}。

默认值：1。

worker_period_unit

String

否

Month

Worker节点付费周期，当付费类型为PrePaid的时候需要指定周期。取值：Month，当前只支持以月为周期。

worker_system_disk_category

String

否

cloud_efficiency

Worker节点系统盘类型，取值：

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD云盘。

默认值：cloud_ssd。

worker_system_disk_size

Long

否

200

Worker节点系统盘大小，单位为GiB。

取值范围：[40,500]。

该参数的取值必须大于或者等于max{40, ImageSize}。

默认值：120。

worker_vswitch_ids

Array of String

否

["vsw-2ze3ds0mdip0hdz8i****"]

集群节点使用的虚拟交换机列表，一个节点对应一个值。

zone_id

String

否

cn-beijing-b

集群所属地域的可用区ID。

resource_group_id

String

否

rg-acfm3mkrure****

集群所属资源组ID，实现不同资源的隔离。

名称

类型

示例值

描述

cluster_id

String

cb95aa626a47740afbf6aa099b650****

集群ID。

request_id

String

687C5BAA-D103-4993-884B-C35E4314A1E1

请求ID。

task_id

String

T-5a54309c80282e39ea00002f

任务ID。