ALIYUN::CS::ServerlessKubernetesCluster is used to create an ACK Serverless cluster.
Syntax
{
"Type": "ALIYUN::CS::ServerlessKubernetesCluster",
"Properties": {
"VpcId": String,
"Name": String,
"Tags": List,
"ZoneId": String,
"PrivateZone": Boolean,
"VSwitchId": String,
"EndpointPublicAccess": Boolean,
"SecurityGroupId": String,
"VSwitchIds": List,
"ServiceCidr": String,
"Addons": List,
"KubernetesVersion": String,
"NatGateway": Boolean,
"ResourceGroupId": String
}
}
Properties
Property | Type | Required | Editable | Description | Constraint |
VpcId | String | No | No | The ID of the virtual private cloud (VPC). | If you do not specify this property, the system creates a VPC whose CIDR block is 192.168.0.0/16. You must specify the VpcId and VSwitchId properties or leave both properties empty. |
Name | String | Yes | No | The name of the cluster. | The name must start with a digit or letter. The name can contain letters, digits, and hyphens (-). |
Tags | List | No | Yes | The tags of the cluster. | For more information, see Tags properties. |
ZoneId | String | No | No | The ID of the zone. | None. |
PrivateZone | Boolean | No | No | Specifies whether to activate Alibaba Cloud DNS PrivateZone to support the service discovery feature. | Default value: false. Valid values:
For more information, see Use Alibaba Cloud DNS PrivateZone to implement service discovery in ACK Serverless clusters. |
VSwitchId | String | No | No | The ID of the vSwitch. | If you do not specify this property, the system creates a vSwitch whose CIDR block is 192.168.0.0/16. You must specify the VpcId and VSwitchId properties or leave both properties empty. |
EndpointPublicAccess | Boolean | No | No | Specifies whether to enable access to the API server over the Internet. | Default value: true. Valid values:
|
SecurityGroupId | String | No | No | The ID of the security group to which the Elastic Compute Service (ECS) instances in the cluster belong. | None. |
VSwitchIds | List | No | No | The list of vSwitch IDs. | The list can contain up to 10 vSwitch IDs. If you do not specify this property, the system creates a vSwitch whose CIDR block is 192.168.0.0/16. You must specify the VpcId and VSwitchId properties or leave both properties empty. |
ServiceCidr | String | No | No | The CIDR block of the Container Service for Kubernetes (ACK) service. | The CIDR block of the service cannot overlap with the CIDR block of the VPC or container. If you use the VPC that is created by the system, the CIDR block 172.19.0.0/20 is used by default. |
Addons | List | No | No | The list of components that you want to install in the cluster. | Valid values:
For more information, see Addons properties. |
KubernetesVersion | String | No | No | The Kubernetes version of the cluster. | Valid values:
|
ResourceGroupId | String | No | Yes | The resource group to which the cluster belongs. | None. |
NatGateway | Boolean | No | No | Specifies whether to create a NAT gateway. | Default value: false. Valid values:
|
Tags syntax
"Tags": [
{
"Key": String,
"Value": String
}
]
Tags properties
Property | Type | Required | Editable | Description | Constraint |
Key | String | Yes | No | The key of the tag. | The tag key must be 1 to 64 characters in length. The tag key cannot start with |
Value | String | No | No | The value of the tag. | The tag value can be up to 128 characters in length. The tag value cannot start with |
Addons syntax
"Addons": [
{
"Disabled": String,
"Config": String,
"Name": String
}
]
Addons properties
Property | Type | Required | Editable | Description | Constraint |
Disabled | Boolean | No | No | Specifies whether to disable automatic installation for the component. | Default value: false. Valid values:
|
Config | String | No | No | The configurations of the component. | None. |
Name | String | Yes | No | The name of the component. | None. |
Return values
Fn::GetAtt
ClusterId: the ID of the cluster.
TaskId: the ID of the task. The task ID is assigned by the system and is used to query the status of the task.
WorkerRamRoleName: the name of the RAM role for worker nodes.
DefaultUserKubeConfig: the default configurations of user credentials for the cluster.
ScalingRuleId: the ID of the scaling rule.
ScalingGroupId: the ID of the scaling group.
PrivateUserKubConfig: the private configurations of user credentials for the cluster.
ScalingConfigurationId: the ID of the scaling configuration.
Nodes: the list of nodes in the cluster.
APIServerSLBId: the ID of the Server Load Balancer (SLB) instance that is associated with the API server.
Examples
For more examples, visit ServerlessKubernetesCluster.json and ServerlessKubernetesCluster.yml.