名稱

類型

是否必選

示例值

描述

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集群的安裝的組件列表：

• 組件的參數(shù)：

  • name：必選。

  • config：可選，取值為空時(shí)表示無需配置。

  • disabled：可選，是否禁止默認(rèn)安裝。

• 網(wǎng)絡(luò)插件：必選，包含F(xiàn)lannel和Terway兩種網(wǎng)絡(luò)類型，創(chuàng)建集群時(shí)二選一。

  • Flannel網(wǎng)絡(luò)：[{"name":"flannel","config":""}]。

  • Terway網(wǎng)絡(luò)：[{"name": "terway-eniip","config": "\"IPVlan\":\"false\""}]。

• 存儲(chǔ)插件：可選，僅支持CSI類型。

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

• 日志組件：可選。

  重要

  如果不開啟日志服務(wù)，將無法使用集群審計(jì)功能。

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

  • 創(chuàng)建新的SLS Project：[{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}]。

• Ingress：可選，默認(rèn)開啟安裝Ingress組件nginx-ingress-controller：

  • 安裝Ingress并且開啟公網(wǎng)：[{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}]。

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

• 事件中心：可選，默認(rèn)開啟。事件中心提供對(duì)Kubernetes事件的存儲(chǔ)、查詢、告警等能力。Kubernetes事件中心關(guān)聯(lián)的Logstore在90天內(nèi)免費(fèi)。關(guān)于免費(fèi)策略的更多信息，請(qǐng)參見創(chuàng)建并使用K8s事件中心。

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

cloud_monitor_flags

Boolean

否

true

集群是否安裝云監(jiān)控插件。取值：

• true：集群不安裝云監(jiān)控插件。

• false：集群安裝云監(jiān)控插件。

默認(rèn)值：false。

cluster_type

String

是

Kubernetes

集群類型。創(chuàng)建專有版安全沙箱集群時(shí)，只能選擇Kubernetes。

container_cidr

String

否

172.20.0.0/16

Pod網(wǎng)絡(luò)地址段，不能和VPC網(wǎng)段沖突。當(dāng)選擇系統(tǒng)自動(dòng)創(chuàng)建VPC時(shí)，默認(rèn)使用172.16.0.0/16網(wǎng)段。當(dāng)創(chuàng)建Flannel網(wǎng)絡(luò)類型的集群時(shí)，該字段為必填。

cpu_policy

String

否

none

節(jié)點(diǎn)CPU管理策略。當(dāng)集群版本在1.12.6及以上時(shí)支持以下兩種策略：

• static：允許為節(jié)點(diǎn)上具有某些資源特征的Pod賦予增強(qiáng)的CPU親和性和獨(dú)占性。

• none：表示啟用現(xiàn)有的默認(rèn)CPU親和方案。

默認(rèn)值：none。

deletion_protection

Boolean

否

true

集群是否開啟集群刪除保護(hù)，防止通過控制臺(tái)或API誤刪除集群。取值：

• true：集群開啟集群刪除保護(hù)。

• false：集群不開啟集群刪除保護(hù)。

默認(rèn)值：false。

disable_rollback

Boolean

否

true

集群創(chuàng)建失敗是否回滾。取值：

• true：集群創(chuàng)建失敗回滾。

• false：集群創(chuàng)建失敗不回滾。

默認(rèn)值：false。

endpoint_public_access

Boolean

否

true

是否開啟公網(wǎng)API Server。取值：

• true：表示開放公網(wǎng)API Server。

• false：表示不會(huì)創(chuàng)建公網(wǎng)的API Server，僅創(chuàng)建私網(wǎng)的API Server。

默認(rèn)值：true。

is_enterprise_security_group

Boolean

否

true

自動(dòng)創(chuàng)建企業(yè)級(jí)安全組，當(dāng)security_group_id為空時(shí)生效。Terway網(wǎng)絡(luò)類型集群，必須指定為企業(yè)安全組。

• true：自動(dòng)創(chuàng)建企業(yè)級(jí)安全組。

• false：不自動(dòng)創(chuàng)建企業(yè)級(jí)安全組。

默認(rèn)值：false。

key_pair

String

是

security-key

密鑰對(duì)名稱，和login_password二選一。

kubernetes_version

String

否

1.16.9-aliyun.1

集群版本，與Kubernetes社區(qū)基線版本保持一致。建議選擇最新版本，若不指定，默認(rèn)使用最新版本。目前您可以在ACK控制臺(tái)創(chuàng)建兩種最新版本的集群。您可以通過API創(chuàng)建其他Kubernetes版本集群。關(guān)于ACK支持的Kubernetes版本，請(qǐng)參見Kubernetes版本發(fā)布概覽。

login_password

String

是

Hello@1234

SSH登錄密碼，和key_pair二選一。密碼規(guī)則為8~30個(gè)字符，且至少同時(shí)包含三項(xiàng)（大小寫字母、數(shù)字和特殊符號(hào)）。

master_auto_renew

Boolean

否

true

Master節(jié)點(diǎn)是否開啟自動(dòng)續(xù)費(fèi)，當(dāng)master_instance_charge_type取值為PrePaid時(shí)才生效，可選值為：

• true：自動(dòng)續(xù)費(fèi)。

• false：不自動(dòng)續(xù)費(fèi)。

默認(rèn)值：true。

master_auto_renew_period

Long

否

1

Master節(jié)點(diǎn)自動(dòng)續(xù)費(fèi)周期，當(dāng)選擇包年包月付費(fèi)類型時(shí)才生效，且為必選項(xiàng)。

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

默認(rèn)值：1。

master_count

Long

否

3

Master節(jié)點(diǎn)數(shù)量，取值3或5。

默認(rèn)值：3。

master_instance_charge_type

String

否

PrePaid

Master節(jié)點(diǎn)付費(fèi)類型，取值：

• PrePaid：包年包月。

• PostPaid：按量付費(fèi)。

默認(rèn)為PostPaid按量付費(fèi)。

master_instance_types

Array of String

否

["ecs.n4.xlarge"]

Master節(jié)點(diǎn)實(shí)例類型。指定的實(shí)例規(guī)格數(shù)量需要和master_count保持一致，并且和master_instance_types中的元素一一對(duì)應(yīng)。

master_period

Long

否

1

Master節(jié)點(diǎn)包年包月時(shí)長(zhǎng)，當(dāng)master_instance_charge_type取值為PrePaid時(shí)才生效且為必選值。

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

默認(rèn)值：1。

master_period_unit

String

否

Month

Master節(jié)點(diǎn)付費(fèi)周期，當(dāng)付費(fèi)類型為PrePaid的時(shí)候需要指定周期。

取值：Month。

master_system_disk_category

String

否

cloud_ssd

Master節(jié)點(diǎn)系統(tǒng)盤類型，取值：

• cloud_efficiency：高效云盤。

• cloud_ssd：SSD云盤。

默認(rèn)值：cloud_ssd。

master_system_disk_size

Long

否

120

Master節(jié)點(diǎn)系統(tǒng)盤類型，取值范圍[40,500]，單位：GiB。

默認(rèn)值：120。

master_system_disk_performance_level

String

否

PL1

集群Master節(jié)點(diǎn)系統(tǒng)盤磁盤性能等級(jí)， 僅對(duì)ESSD磁盤生效。磁盤性能等級(jí)和磁盤大小有關(guān)。更多信息，請(qǐng)參見ESSD云盤。

master_vswitch_ids

Array of String

否

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

Master節(jié)點(diǎn)虛擬交換機(jī)ID。

name

String

是

cluster-demo

集群名稱。

命名規(guī)則：由數(shù)字、漢字、英文字符或短劃線（-）組成，長(zhǎng)度范圍1~63個(gè)字符，且不能以短劃線（-）開頭。

node_cidr_mask

String

否

25

節(jié)點(diǎn)IP數(shù)量，通過指定網(wǎng)絡(luò)的CIDR來確定IP的數(shù)量，只對(duì)于Flannel網(wǎng)絡(luò)類型集群生效。

默認(rèn)值：25。

node_port_range

String

否

30000~32767

節(jié)點(diǎn)服務(wù)端口。取值范圍為[30000,65535]。

num_of_nodes

Long

是

3

Worker節(jié)點(diǎn)數(shù)。范圍是[0,100]。

pod_vswitch_ids

Array of String

否

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

Pod的虛擬交換機(jī)列表。

您需要為每一個(gè)節(jié)點(diǎn)虛擬交換機(jī)指定至少一個(gè)相同可用區(qū)的Pod虛擬交換機(jī)，并且不能跟節(jié)點(diǎn)vswitch重復(fù)。

proxy_mode

String

否

ipvs

kube-proxy代理模式，支持iptables和ipvs兩種模式。

默認(rèn)值：ipvs。

region_id

String

是

cn-beijing

集群所在的地域ID。

runtime

runtime

是

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

security_group_id

String

否

sg-bp1bdue0qc1g7k****

使用已有安全組創(chuàng)建集群時(shí)需要指定安全組ID，集群節(jié)點(diǎn)自動(dòng)加入到此安全組，和is_enterprise_security_group二選一。

service_cidr

String

是

172.21.0.0/20

Service網(wǎng)絡(luò)地址段，不能和VPC網(wǎng)段及Pod網(wǎng)絡(luò)網(wǎng)段沖突。當(dāng)選擇系統(tǒng)自動(dòng)創(chuàng)建VPC時(shí)，默認(rèn)使用172.19.0.0/20網(wǎng)段。

snat_entry

Boolean

否

true

是否為網(wǎng)絡(luò)配置SNAT：

• 當(dāng)已有VPC能訪問公網(wǎng)環(huán)境時(shí)，設(shè)置為false。

• 當(dāng)已有VPC無法訪問公網(wǎng)環(huán)境時(shí)：

  • 設(shè)置為true，表示配置SNAT，此時(shí)可以訪問公網(wǎng)環(huán)境。

  • 設(shè)置為false，表示不配置SNAT，此時(shí)無法訪問公網(wǎng)環(huán)境。

如果您的應(yīng)用需要訪問公網(wǎng)，建議配置為true。

默認(rèn)值：false。

ssh_flags

Boolean

否

true

是否開放公網(wǎng)SSH登錄。取值：

• true：表示開放。

• false：表示不開放。

默認(rèn)值：false。

tags

Array

否

集群標(biāo)簽。

Key

String

否

env

標(biāo)簽key-value的鍵。

value

String

否

prod

標(biāo)簽key-value的值。

tains

Array

否

節(jié)點(diǎn)污點(diǎn)信息。污點(diǎn)和容忍度（Toleration）相互配合，可以用來避免Pod被分配到不合適的節(jié)點(diǎn)上。更多信息，請(qǐng)參見taint-and-toleration。

effect

String

否

NoSchedule

調(diào)度策略。取值：

• NoSchedule：Pod不會(huì)被調(diào)度到標(biāo)記了Taints的節(jié)點(diǎn)上。

• NoExecute：一旦Taint生效，該節(jié)點(diǎn)內(nèi)正在運(yùn)行的Pod沒有對(duì)應(yīng)Tolerate設(shè)置，會(huì)直接被逐出。

• PreferNoSchedule：NoSchedule的寬松版本。避免將Pod調(diào)度到有污點(diǎn)的節(jié)點(diǎn)上。

Key

String

否

disk_type

污點(diǎn)key-value的鍵。

value

String

否

sshd

污點(diǎn)key-value的值。

timeout_mins

Long

否

60

集群創(chuàng)建超時(shí)時(shí)間。單位：分鐘。

默認(rèn)值：60。

user_data

String

否

IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****

節(jié)點(diǎn)自定義數(shù)據(jù)。更多信息，請(qǐng)參見ECS實(shí)例自定義數(shù)據(jù)概述。

vpcid

String

是

vpc-2zeik9h3ahvv2zz95****

集群使用的VPC實(shí)例ID。

vswitch_ids

Array of String

是

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

虛擬交換實(shí)例ID。

worker_auto_renew

Boolean

否

true

Worker節(jié)點(diǎn)是否開啟自動(dòng)續(xù)費(fèi)，當(dāng)worker_instance_charge_type取值為PrePaid時(shí)才生效，可選值為：

• true：自動(dòng)續(xù)費(fèi)。

• false：不自動(dòng)續(xù)費(fèi)。

默認(rèn)值：true。

worker_auto_renew_period

Long

否

1

Worker節(jié)點(diǎn)自動(dòng)續(xù)費(fèi)周期，當(dāng)選擇包年包月付費(fèi)類型時(shí)才生效，且為必選值。取值范圍：{1,2,3,6,12}。

worker_data_disks

Array

是

Worker節(jié)點(diǎn)數(shù)據(jù)盤類型、大小等配置的組合。

auto_snapshot_policy_id

String

否

sp-bp14j6w7ss6ozz****

自動(dòng)快照策略ID。

category

String

否

cloud_ssd

Worker節(jié)點(diǎn)數(shù)據(jù)盤類型，取值：

• cloud_efficiency：高效云盤。

• cloud_ssd：SSD云盤。

• cloud：普通云盤。

默認(rèn)值：cloud_efficiency。

encrypted

String

否

false

是否對(duì)數(shù)據(jù)盤加密。取值：

• true：對(duì)數(shù)據(jù)盤加密。

• false：不對(duì)數(shù)據(jù)盤加密。

默認(rèn)值：false。

size

String

是

200

數(shù)據(jù)盤大小，內(nèi)存單位為GiB。取值：

• cloud_efficiency：[20,32768]

• cloud_ssd：[20,32768]

• cloud：[5,2000]

worker_instance_charge_type

String

是

PrePaid

Worker節(jié)點(diǎn)付費(fèi)類型，取值：

• PrePaid：包年包月。

• PostPaid：按量付費(fèi)。

默認(rèn)：按量付費(fèi)。

worker_instance_types

Array of String

是

["ecs.ebmg5s.24xlarge"]

Worker節(jié)點(diǎn)實(shí)例類型。

worker_period

Long

否

1

Worker節(jié)點(diǎn)包年包月時(shí)長(zhǎng)，當(dāng)worker_instance_charge_type取值為PrePaid時(shí)才生效且為必選值。取值范圍：{1,2,3,6,12,24,36,48,60}。

默認(rèn)值：1。

worker_period_unit

String

否

Month

Worker節(jié)點(diǎn)付費(fèi)周期，當(dāng)付費(fèi)類型為PrePaid的時(shí)候需要指定周期。取值：Month，當(dāng)前只支持以月為周期。

worker_system_disk_category

String

否

cloud_efficiency

Worker節(jié)點(diǎn)系統(tǒng)盤類型，取值：

• cloud_efficiency：高效云盤。

• cloud_ssd：SSD云盤。

默認(rèn)值：cloud_ssd。

worker_system_disk_size

Long

否

200

Worker節(jié)點(diǎn)系統(tǒng)盤大小，單位為GiB。

取值范圍：[40,500]。

該參數(shù)的取值必須大于或者等于max{40, ImageSize}。

默認(rèn)值：120。

worker_vswitch_ids

Array of String

否

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

集群節(jié)點(diǎn)使用的虛擬交換機(jī)列表，一個(gè)節(jié)點(diǎn)對(duì)應(yīng)一個(gè)值。

zone_id

String

否

cn-beijing-b

集群所屬地域的可用區(qū)ID。

resource_group_id

String

否

rg-acfm3mkrure****

集群所屬資源組ID，實(shí)現(xiàn)不同資源的隔離。

名稱

類型

示例值

描述

cluster_id

String

cb95aa626a47740afbf6aa099b650****

集群ID。

request_id

String

687C5BAA-D103-4993-884B-C35E4314A1E1

請(qǐng)求ID。

task_id

String

T-5a54309c80282e39ea00002f

任務(wù)ID。