Container Service for Kubernetes:Use Terraform to create an ACK Edge cluster

• alicloud_db_zones: queries available zones.

• alicloud_instance_types: queries Elastic Compute Service (ECS) instance types that meet the specified conditions.

• alicloud_vpc: creates a virtual private cloud (VPC).

• alicloud_vswitch: creates vSwitches in a VPC to create subnets for the VPC.

• alicloud_cs_edge_kubernetes: creates an ACK Edge cluster.

• alicloud_cs_kubernetes_node_pool: creates a node pool for an ACK managed cluster.

Use Terraform to create an ACK Edge cluster

1. Create a working directory and a file named main.tf in the directory.

   The main.tf file is used to configure the following settings for Terraform:

   • Create a VPC and create a vSwitch in the VPC.

   • Create an ACK Edge cluster.

   • Create a node pool that contains two nodes.

   provider "alicloud" {
     region = var.region_id
   }
   
   variable "region_id" {
     default = "cn-hangzhou"
   }
   
   variable "k8s_name_edge" {
     type        = string
     description = "The name used to create edge kubernetes cluster."
     default     = "edge-example"
   }
   
   variable "new_vpc_name" {
     type        = string
     description = "The name used to create vpc."
     default     = "tf-vpc-172-16"
   }
   
   variable "new_vsw_name" {
     type        = string
     description = "The name used to create vSwitch."
     default     = "tf-vswitch-172-16-0"
   }
   
   variable "nodepool_name" {
     type        = string
     description = "The name used to create node pool."
     default     = "edge-nodepool-1"
   }
   
   variable "k8s_login_password" {
     type    = string
     default = "Test123456"
   }
   
   variable "k8s_version" {
     type        = string
     description = "Kubernetes version"
     default     = "1.28.9-aliyun.1"
   }
   
   variable "containerd_runtime_version" {
     type    = string
     default = "1.6.34"
   }
   
   variable "cluster_spec" {
     type        = string
     description = "The cluster specifications of kubernetes cluster,which can be empty. Valid values:ack.standard : Standard managed clusters; ack.pro.small : Professional managed clusters."
     default     = "ack.pro.small"
   }
   
   data "alicloud_zones" "default" {
     available_resource_creation = "VSwitch"
     available_disk_category     = "cloud_efficiency"
   }
   
   data "alicloud_instance_types" "default" {
     availability_zone    = data.alicloud_zones.default.zones.0.id
     cpu_core_count       = 4
     memory_size          = 8
     kubernetes_node_role = "Worker"
   }
   
   resource "alicloud_vpc" "vpc" {
     vpc_name   = var.new_vpc_name
     cidr_block = "172.16.0.0/12"
   }
   
   resource "alicloud_vswitch" "vsw" {
     vswitch_name = var.new_vsw_name
     vpc_id       = alicloud_vpc.vpc.id
     cidr_block   = cidrsubnet(alicloud_vpc.vpc.cidr_block, 8, 8)
     zone_id      = data.alicloud_zones.default.zones.0.id
   }
   
   
   resource "alicloud_cs_edge_kubernetes" "edge" {
     name                  = var.k8s_name_edge
     version               = var.k8s_version
     cluster_spec          = var.cluster_spec
     worker_vswitch_ids    = split(",", join(",", alicloud_vswitch.vsw.*.id))
     worker_instance_types = [data.alicloud_instance_types.default.instance_types.0.id]
     password              = var.k8s_login_password
     new_nat_gateway       = true
     pod_cidr              = "10.10.0.0/16"
     service_cidr          = "10.12.0.0/16"
     load_balancer_spec    = "slb.s2.small"
     worker_number         = 1
     node_cidr_mask        = 24
   
     # The container runtime. 
     runtime = {
       name    = "containerd"
       version = var.containerd_runtime_version
     }
   }
   # The node pool. 
   resource "alicloud_cs_kubernetes_node_pool" "nodepool" {
     # The name of the cluster. 
     cluster_id = alicloud_cs_edge_kubernetes.edge.id
     # The name of the node pool. 
     node_pool_name = var.nodepool_name
     # The vSwitches of the new Kubernetes cluster. Specify the IDs of one or more vSwitches. The vSwitches must be in the zone specified by availability_zone. 
     vswitch_ids = split(",", join(",", alicloud_vswitch.vsw.*.id))
   
     # The Elastic Compute Service (ECS) instance types and billing method. 
     instance_types       = [data.alicloud_instance_types.default.instance_types.0.id]
     instance_charge_type = "PostPaid"
   
     # Specify custom node names. This parameter is optional. 
     # node_name_mode      = "customized,edge-shenzhen,ip,default"
   
     # The container runtime. 
     runtime_name    = "containerd"
     runtime_version = var.containerd_runtime_version
   
     # The expected number of nodes in the node pool. 
     desired_size = 2
     # The password that is used to log on to the cluster by using SSH. 
     password = var.k8s_login_password
   
     # Specify whether to install the CloudMonitor agent on nodes. 
     install_cloud_monitor = true
   
     # The type of the system disks of the nodes. Valid values: cloud_ssd and cloud_efficiency. Default value: cloud_efficiency. 
     system_disk_category = "cloud_efficiency"
     system_disk_size     = 100
   
     # The OS type. 
     image_type = "AliyunLinux"
   
     # The configurations of the data disks of the nodes. 
     data_disks {
       # The type of data disks. 
       category = "cloud_efficiency"
       # The disk size. 
       size = 120
     }
     lifecycle {
       ignore_changes = [
         labels
       ]
     }
   }

2. Run the following command to initialize Terraform:

   terraform init

   If the following information is returned, Terraform is initialized:

   Terraform has been successfully initialized!
   
   You may now begin working with Terraform. Try running "terraform plan" to see
   any changes that are required for your infrastructure. All Terraform commands
   should now work.
   
   If you ever set or change modules or backend configuration for Terraform,
   rerun this command to reinitialize your working directory. If you forget, other
   commands will detect it and remind you to do so if necessary.

3. Create an execution plan and preview the changes.

   terraform plan

   If the following information is returned, the execution plan is succeeded. You can view the resource information.

   Refreshing Terraform state in-memory prior to plan...
   The refreshed state will be used to calculate this plan, but will not be
   persisted to local or remote state storage.
   ...
   Plan: 4 to add, 0 to change, 0 to destroy.
   ...

4. Run the following command to create an ACK Edge cluster.

   terraform apply

   Type yes, press Enter, and wait until the command execution is completed. If the following information is displayed, the cluster is created.

   ...
   Do you want to perform these actions?
     Terraform will perform the actions described above.
     Only 'yes' will be accepted to approve.
   
     Enter a value: yes
   ...
   alicloud_cs_edge_kubernetes.edge: Creation complete after 8m26s [id=************]
   
   Apply complete!  Resources: 4 added, 0 changed, 0 destroyed.

5. Verify the result

   Run the terraform show command

   Run the following command to query the resources that are created by Terraform:

   terraform show

   

   Log on to the ACK console

   Log on to the ACK console to view the created cluster.

Sample code

provider "alicloud" {
  region = var.region_id
}

variable "region_id" {
  default = "cn-hangzhou"
}

variable "k8s_name_edge" {
  type        = string
  description = "The name used to create edge kubernetes cluster."
  default     = "edge-example"
}

variable "new_vpc_name" {
  type        = string
  description = "The name used to create vpc."
  default     = "tf-vpc-172-16"
}

variable "new_vsw_name" {
  type        = string
  description = "The name used to create vSwitch."
  default     = "tf-vswitch-172-16-0"
}

variable "nodepool_name" {
  type        = string
  description = "The name used to create node pool."
  default     = "edge-nodepool-1"
}

variable "k8s_login_password" {
  type    = string
  default = "Test123456"
}

variable "k8s_version" {
  type        = string
  description = "Kubernetes version"
  default     = "1.28.9-aliyun.1"
}

variable "containerd_runtime_version" {
  type    = string
  default = "1.6.34"
}

variable "cluster_spec" {
  type        = string
  description = "The cluster specifications of kubernetes cluster,which can be empty. Valid values:ack.standard : Standard managed clusters; ack.pro.small : Professional managed clusters."
  default     = "ack.pro.small"
}

data "alicloud_zones" "default" {
  available_resource_creation = "VSwitch"
  available_disk_category     = "cloud_efficiency"
}

data "alicloud_instance_types" "default" {
  availability_zone    = data.alicloud_zones.default.zones.0.id
  cpu_core_count       = 4
  memory_size          = 8
  kubernetes_node_role = "Worker"
}

resource "alicloud_vpc" "vpc" {
  vpc_name   = var.new_vpc_name
  cidr_block = "172.16.0.0/12"
}

resource "alicloud_vswitch" "vsw" {
  vswitch_name = var.new_vsw_name
  vpc_id       = alicloud_vpc.vpc.id
  cidr_block   = cidrsubnet(alicloud_vpc.vpc.cidr_block, 8, 8)
  zone_id      = data.alicloud_zones.default.zones.0.id
}


resource "alicloud_cs_edge_kubernetes" "edge" {
  name                  = var.k8s_name_edge
  version               = var.k8s_version
  cluster_spec          = var.cluster_spec
  worker_vswitch_ids    = split(",", join(",", alicloud_vswitch.vsw.*.id))
  worker_instance_types = [data.alicloud_instance_types.default.instance_types.0.id]
  password              = var.k8s_login_password
  new_nat_gateway       = true
  pod_cidr              = "10.10.0.0/16"
  service_cidr          = "10.12.0.0/16"
  load_balancer_spec    = "slb.s2.small"
  worker_number         = 1
  node_cidr_mask        = 24

  # The container runtime. 
  runtime = {
    name    = "containerd"
    version = var.containerd_runtime_version
  }
}
# The node pool. 
resource "alicloud_cs_kubernetes_node_pool" "nodepool" {
  # The name of the cluster. 
  cluster_id = alicloud_cs_edge_kubernetes.edge.id
  # The name of the node pool. 
  node_pool_name = var.nodepool_name
  # The vSwitches of the new Kubernetes cluster. Specify the IDs of one or more vSwitches. The vSwitches must be in the zone specified by availability_zone. 
  vswitch_ids = split(",", join(",", alicloud_vswitch.vsw.*.id))

  # The ECS instance types and billing method. 
  instance_types       = [data.alicloud_instance_types.default.instance_types.0.id]
  instance_charge_type = "PostPaid"

  # Specify custom node names. This parameter is optional. 
  # node_name_mode      = "customized,edge-shenzhen,ip,default"

  # The container runtime. 
  runtime_name    = "containerd"
  runtime_version = var.containerd_runtime_version

  # The expected number of nodes in the node pool. 
  desired_size = 2
  # The password that is used to log on to the cluster by using SSH. 
  password = var.k8s_login_password

  # Specify whether to install the CloudMonitor agent on nodes. 
  install_cloud_monitor = true

  # The type of the system disks of the nodes. Valid values: cloud_ssd and cloud_efficiency. Default value: cloud_efficiency. 
  system_disk_category = "cloud_efficiency"
  system_disk_size     = 100

  # The OS type. 
  image_type = "AliyunLinux"

  # The configurations of the data disks of the nodes. 
  data_disks {
    # The type of data disks. 
    category = "cloud_efficiency"
    # The disk size. 
    size = 120
  }
  lifecycle {
    ignore_changes = [
      labels
    ]
  }
}