addon
Configurations of cluster components.
Parameter |
Type |
Example |
Description |
---|---|---|---|
name |
String |
nginx-ingress-controller |
The name of a component. |
config |
String |
{\"IngressSlbNetworkType\":\"internet\"} |
The configurations of a component. |
disabled |
Boolean |
false |
Specifies whether a component is automatically installed in a newly created cluster. In addition to the required components, some optional components, such as Simple Log Service components, are also installed when you create a cluster. You can set this parameter to disable the automatic installation of an optional component. You can install the component in the console or by calling the API after the cluster is created. Valid values:
|
data_disk
Configurations of node data disks.
Parameter |
Type |
Example |
Description |
---|---|---|---|
category |
String |
cloud_ssd |
The type of data disk. Valid values:
Default value: |
size |
Long |
40 |
The size of a data disk. Unit: GiB. Valid values: 40 to 32768. Default value: |
encrypted |
String |
true |
Specifies whether to encrypt a data disk. Valid values:
Default value: |
auto_snapshot_policy_id |
String |
sp-2zej1nogjvovnz4z**** |
The ID of an automatic snapshot policy. Automatic backup is performed for a disk based on the specified automatic snapshot policy. By default, this parameter is empty. This indicates that automatic backup is disabled. |
performance_level |
String |
PL1 |
The performance level (PL) of a data disk. This parameter takes effect only for enhanced SSDs. You can specify a higher PL if you increase the size of a data disk. For more information, see Enhanced SSDs. |
provisioned_iops |
Long |
1000 |
The predefined IOPS of a data disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000} This parameter is supported only when |
bursting_enabled |
Boolean |
true |
Specifies whether to enable the burst feature for the data disk. Valid values:
This parameter is supported only when |
maintenance_window
Configurations of the cluster maintenance window.
Parameter |
Type |
Example |
Description |
---|---|---|---|
enable |
Boolean |
false |
Specifies whether to enable the cluster maintenance window. Valid values:
Default value: |
maintenance_time |
String |
03:00:00Z |
The start time of the cluster maintenance window. The value must be in the standard Golang time format. Example: 15:04:05Z. |
duration |
String |
3h |
The duration of the cluster maintenance window. The duration ranges from 1 hour to 24 hours. Unit: h. Default value: 3h. |
weekly_period |
String |
Monday,Thursday |
The day of the week when maintenance is performed. Separate multiple days with commas (,). Valid values: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday. Default value: |
nodepool
Configurations of node pools.
Parameter |
Type |
Example |
Description |
---|---|---|---|
auto_scaling |
Object |
The auto scaling configuration of the node pool. |
|
enable |
Boolean |
true |
Specifies whether to enable auto scaling for a node pool.
Default value: |
max_instances |
Long |
10 |
The maximum number of Elastic Compute Service (ECS) instances that can be created in the node pool. |
min_instances |
Long |
0 |
The minimum number of ECS instances that must be kept in the node pool. |
type |
String |
cpu |
The instance types that can be used for the auto scaling of the node pool. Valid values:
Default value: |
is_bond_eip |
Boolean |
true |
This parameter is deprecated. Specifies whether to associate an EIP with a node pool. Valid values:
Default value: |
eip_internet_charge_type |
String |
PayByBandwidth |
This parameter is deprecated. The metering method of the EIP. Valid values:
Default value: PayByBandwidth. |
eip_bandwidth |
Long |
5 |
This parameter is deprecated. The maximum bandwidth of the EIP. Unit: Mbit/s. |
kubernetes_config |
Object |
The configuration of the cluster where the node pool is deployed. |
|
cms_enabled |
Boolean |
true |
Specifies whether to install the CloudMonitor agent on ECS nodes. After the CloudMonitor agent is installed on ECS nodes, you can view monitoring information about the instances in the CloudMonitor console. We recommend that you install the CloudMonitor agent. Valid values:
Default value: |
cpu_policy |
String |
none |
The CPU management policy of the nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later.
Default value: |
labels |
Array of tag |
The labels of the nodes in the node pool. You can add labels to the nodes in the cluster. |
|
runtime |
String |
containerd |
The container runtime. Valid values:
Default value: |
runtime_version |
String |
1.6.20 |
The version of the container runtime. |
taints |
Array of taint |
The taints. |
|
user_data |
String |
MXM= |
The user-defined data on the node. |
node_name_mode |
String |
customized,aliyun,ip,com |
A custom node name consists of a prefix, a node IP address, and a suffix.
Set the value in the customized,aliyun,ip,com format. The value consists of four parts that are separated by commas (,). customized and ip are fixed content. aliyun is the prefix and com is the suffix. Example: aliyun.192.168.xxx.xxx.com. |
nodepool_info |
Object |
The configuration of the node pool. |
|
name |
String |
np-test |
The name of the node pool. |
resource_group_id |
String |
rg-acfmyvw3wjm**** |
The ID of the resource group to which the node pool belongs. |
type |
String |
ess |
The type of the node pool. Valid values:
|
scaling_group |
Object |
The configuration of the scaling group that is used by the node pool. |
|
auto_renew |
Boolean |
false |
Specifies whether to enable auto-renewal for a node pool. This parameter takes effect only when
Default value: |
auto_renew_period |
Long |
0 |
The auto-renewal period for the nodes in the node pool. This parameter takes effect and is required only when If you specify Default value: 1. |
data_disks |
Array of data_disk |
The configurations of the data disks that you want to attach to the nodes in the node pool. |
|
image_id |
String |
aliyun_2_1903_x64_20G_alibase_20200904.vhd |
The ID of a custom image. By default, the image provided by ACK is used. |
instance_charge_type |
String |
PostPaid |
The billing method of the nodes in the node pool. Valid values:
Default value: |
instance_types |
Array of String |
ecs.n1.medium |
The type of instance. |
key_pair |
String |
np-key |
The name of the key pair. You must set this parameter or the Note
You must set |
login_password |
String |
Hello1234 |
The password for SSH logon. You must set this parameter or the |
period |
Long |
0 |
The subscription duration of the nodes in a node pool. This parameter takes effect and is required only when Default value: 1. |
period_unit |
String |
Month |
The unit of the subscription duration. This parameter is required when Valid value: |
platform |
String |
AliyunLinux |
The release version of the operating system. Valid values:
Default value: |
rds_instances |
Array of String |
rm-2zey3t89t6280**** |
The IDs of ApsaraDB RDS instances. |
spot_strategy |
String |
NoSpot |
The type of preemptible instance. Valid values:
For more information, see Preemptible instances. |
spot_price_limit |
Array |
The instance type for preemptible instances and the price limit of the instance type. |
|
instance_type |
String |
ecs.c6.large |
The instance type of preemptible instances. |
price_limit |
String |
0.39 |
The maximum bid price of a preemptible instance. |
scaling_policy |
String |
release |
The scaling mode of the scaling group. Valid values:
Default value: |
security_group_id |
String |
sg-2zeihch86ooz9io4**** |
Specifies the ID of the security group to which you want to add the node pool. You must set this parameter or |
security_group_ids |
Array of String |
sg-2zeihch86ooz9io4**** |
The security group ID. |
system_disk_category |
String |
cloud_efficiency |
The type of system disk. Valid values:
Default value: |
system_disk_size |
Long |
120 |
The system disk size of a node. Unit: GiB. Valid values: 40 to 500. |
system_disk_performance_level |
String |
PL1 |
The performance level (PL) of the system disk that you want to use for the node. This parameter takes effect only for ESSDs.
|
system_disk_provisioned_iops |
Long |
1000 |
The predefined IOPS of a system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000} This parameter is supported only when |
system_disk_bursting_enabled |
Boolean |
true |
Specifies whether to enable the burst feature for system disks. Valid values:
This parameter is supported only when |
tags |
Array |
The labels that you want to add to the ECS instances. Each key must be unique and cannot exceed 128 characters in length. Neither keys nor values can start with aliyun or acs:. Neither keys nor values can contain https:// or http://. |
|
key |
String |
key |
The key of a label. |
value |
String |
value |
The value of a label. |
vswitch_ids |
Array of String |
vsw-2ze0fmpbwo140ahni**** |
The IDs of vSwitches. |
multi_az_policy |
String |
COST_OPTIMIZED |
The ECS instance scaling policy for a multi-zone scaling group. Valid values:
Default value: |
on_demand_base_capacity |
Long |
0 |
The minimum number of pay-as-you-go instances that must be kept in the scaling group. Valid values: 0 to 1000. If the number of pay-as-you-go instances is less than the value of this parameter, Auto Scaling preferably creates pay-as-you-go instances. |
on_demand_percentage_above_base_capacity |
Long |
20 |
The percentage of pay-as-you-go instances among the extra instances that exceed the number specified by |
spot_instance_pools |
Long |
5 |
The number of instance types that are available for creating preemptible instances. Auto Scaling creates preemptible instances of multiple instance types that are available at the lowest cost. Valid values: 1 to 10. |
spot_instance_remedy |
Boolean |
false |
Specifies whether to supplement preemptible instances. If this parameter is set to true, when the scaling group receives a system message that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
|
compensate_with_on_demand |
Boolean |
true |
Specifies whether to automatically create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created due to reasons such as the cost or insufficient inventory. This parameter takes effect only when
|
internet_charge_type |
String |
PayByBandwidth |
The metering method of the public IP address. Valid values:
|
internet_max_bandwidth_out |
Long |
10 |
The maximum outbound bandwidth of the public IP address of the node. Unit: Mbit/s. Valid values: 1 to 100. |
image_type |
String |
AliyunLinux |
The type of OS image. Specify this parameter or the platform parameter. Valid values:
|
deploymentset_id |
String |
ds-bp1d19mmbsv3jf6xxxxx |
The ID of the deployment set to which the ECS instances in the node pool belong. |
desired_size |
Long |
2 |
The expected number of nodes in the node pool. |
private_pool_options |
Object |
The configuration of the private node pool. |
|
id |
String |
eap-bp67acfmxazb4**** |
The ID of the private node pool. |
match_criteria |
String |
Open |
The type of private node pool. This parameter specifies the type of private pool that you want to use to create instances. A private node pool is generated when an elasticity assurance or a capacity reservation service takes effect. The system selects a private node pool to launch instances. Valid values:
|
tee_config |
Object |
The configuration of confidential computing. |
|
tee_enable |
Boolean |
false |
Specifies whether to enable confidential computing for the node pool. |
management |
Object |
The configuration of the managed node pool feature. |
|
enable |
Boolean |
false |
Specifies whether to enable the managed node pool feature. Valid values:
|
auto_repair |
Boolean |
false |
Specifies whether to enable auto repair. This parameter takes effect only when you specify
|
upgrade_config |
Object |
The configuration of auto update. The configuration takes effect only when |
|
auto_upgrade |
Boolean |
false |
Specifies whether to enable auto update. Valid values:
|
surge |
Long |
0 |
The number of additional nodes. |
surge_percentage |
Long |
0 |
The percentage of additional nodes to the nodes in the node pool. You must set this parameter or |
max_unavailable |
Long |
0 |
The maximum number of nodes that can be in the Unavailable state. Valid values: 1 to 1000. Default value: 1. |
count |
Long |
1 |
This parameter is deprecated. Use the desired_size parameter instead. The number of nodes in the node pool. |
interconnect_mode |
String |
basic |
The network type of the edge node pool. This parameter takes effect only when you set the
|
interconnect_config |
Object |
This parameter is deprecated. The configurations of the edge node pool. |
|
cen_id |
String |
cen-ey9k9nfhz0f******* |
This parameter is deprecated. The ID of the Cloud Enterprise Network (CEN) instance that is associated with the enhanced edge node pool. |
ccn_id |
String |
ccn-qm5i0i0q9yi******* |
This parameter is deprecated. The ID of the Cloud Connect Network (CCN) instance that is associated with the enhanced edge node pool. |
ccn_region_id |
String |
cn-shanghai |
This parameter is deprecated. The region to which the CCN instance that is associated with the enhanced edge node pool belongs. |
bandwidth |
Long |
10 |
This parameter is deprecated. The bandwidth of the enhanced edge node pool. Unit: Mbit/s. |
improved_period |
String |
1 |
This parameter is deprecated. The subscription duration of the enhanced edge node pool. The duration is measured in months. |
max_nodes |
Long |
10 |
The maximum number of nodes supported by an edge node pool. The value must be equal to or greater than 0. A value of 0 indicates that the number of nodes in the node pool is limited only by the quota of nodes in the cluster. In most cases, this parameter is set to a value larger than 0 for edge node pools. This parameter is set to 0 for node pools whose types are ess or default edge node pools. |
runtime
Configurations of container engines.
Parameter |
Type |
Example |
Description |
---|---|---|---|
name |
String |
containerd |
The name of a container runtime. The following types of runtime are supported by ACK.
Default value: |
version |
String |
1.6.20 |
The version of the container runtime. By default, the latest version is used. For more information about the changes to Sandboxed-Container, see Sandboxed-Container release notes. |
tag
Configurations of labels.
Parameter |
Type |
Example |
Description |
---|---|---|---|
key |
String |
env |
The |
value |
String |
prod |
The |
taint
Configurations of node taints.
Parameter |
Type |
Example |
Description |
---|---|---|---|
key |
String |
key |
The |
value |
String |
value |
The |
effect |
String |
NoSchedule |
The scheduling policy. Valid values:
Default value: |