All Products
Search
Document Center

Container Service for Kubernetes:Create an ACK Serverless cluster by using Alibaba Cloud CLI

最終更新日:Sep 04, 2023

Alibaba Cloud command-line interface (CLI) is a management tool that is developed based on Alibaba Cloud APIs. You can use Alibaba Cloud CLI to call the APIs of Alibaba Cloud services.

Prerequisites

Before you use Alibaba Cloud CLI, you must configure the information that is required to call Alibaba Cloud resources. This information includes the credential, region, and language. For more information, see Overview.

Install and set up Alibaba Cloud CLI and kubectl

By default, Cloud Shell is preinstalled with Alibaba Cloud CLI and configured with the account information. You do not need to make any configuration changes. If you do not use Cloud Shell, you must install and set up Alibaba Cloud CLI and kubectl.

  • Install Alibaba Cloud CLI.

    • Install Alibaba Cloud CLI in Linux. For more information, see Linux.

    • Install Alibaba Cloud CLI in macOS.

      • macOS.

      • You can also use a package manager to install Alibaba Cloud CLI in macOS. For more information, see Homebrew. After the package manager is installed, run the following command to install Alibaba Cloud CLI:

        brew install aliyun-cli
    • For more information about how to install Alibaba Cloud CLI in Windows, see Windows.

  • Configure Alibaba Cloud CLI. Run the following command to create environment variables that are used to store identity information:

    aliyun configure

    Expected output:

    Configuring profile 'default' in 'AK' authenticate mode...
    Access Key Id []: ************
    Access Key Secret []: ************
    Default Region Id []: cn-beijing
    Default Output Format [json]: json (Only support json)
    Default Language [zh|en] en:
    Saving profile[default] ...Done.
    
    Configure Done!!!
    ..............888888888888888888888 ........=8888888888888888888D=..............
    ...........88888888888888888888888 ..........D8888888888888888888888I...........
    .........,8888888888888ZI: ...........................=Z88D8888888888D..........
    .........+88888888 ..........................................88888888D..........
    .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
    .........+88888888 ............. ************* ..............O8888888D..........
    .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
    .........+88888888...........................................88888888D..........
    ..........D888888888888DO+. ..........................?ND888888888888D..........
    ...........O8888888888888888888888...........D8888888888888888888888=...........
    ............ .:D8888888888888888888.........78888888888888888888O ..............                    

Install and set up a kubectl client. For more information, see Install and Set Up kubectl.

Create an ACK Serverless cluster

  1. Create a working directory and a file named create.json in the directory.

    The following template is an example of the create.json file:

    {
        "cluster_type": "Ask",
        "name": "test-serverless-k8s",
        "region_id": "cn-beijing",
        "zoneid": "cn-beijing-h",
        "nat_gateway": true,
        "private_zone": false,
        "tags": [
            {"key": "env", "value": "test"}
        ]
    }
                            

    The preceding sample template describes the configurations that are used to create an ACK Serverless cluster. For more information, see Create an ACK Serverless cluster.

  2. Run the following command to create an ACK Serverless cluster:

    aliyun cs  POST /clusters --header "Content-Type=application/json" --body "$(cat create.json)"                       
    {
        "cluster_id": "************************",
        "instanceId": "************************",
        "request_id": "**********-****-****-****-************",
        "task_id": "*-************"
    }
  3. After the ACK Serverless cluster is created, run the following command to query information about the cluster:

    aliyun cs GET /clusters/<YOUR-CLUSTER-ID>                    

    Expected output:

      {
          "-": "PayByTraffic",
          "cluster_healthy": "",
          "cluster_id": "************************",
          "cluster_spec": "",
          "cluster_type": "Ask",
          "created": "2020-07-23T10:02:18+08:00",
          "current_version": "v1.16.6-aliyun.1",
          "data_disk_category": "cloud",
          "data_disk_size": 0,
          "deletion_protection": false,
          "docker_version": "",
          "enabled_migration": false,
          "external_loadbalancer_id": "lb-*********",
          "gw_bridge": "",
          "init_version": "v1.16.6-aliyun.1",
          "instance_type": "",
          "name": "test-serverless-k8s",
          "need_update_agent": false,
          "network_mode": "vpc",
          "node_status": "",
          "private_zone": false,
          "profile": "ask.v2",
          "region_id": "cn-beijing",
          "resource_group_id": "rg-*********",
          "security_group_id": "sg-*********",
          "size": 0,
          "state": "running",
          "subnet_cidr": "172.16.0.0/16",
          "swarm_mode": false,
          "tags": [
              {
                  "key": "env",
                  "value": "test"
              }
          ],
          "updated": "2020-07-23T10:05:11+08:00",
          "vpc_id": "vpc-*********",
          "vswitch_cidr": "",
          "vswitch_id": "vsw-*********",
          "worker_ram_role_name": ""
      }   
  4. Run the following command to query the cluster configurations:

    KUBECONFIG=<YOUR-LOCAL-KUBECONFIG-PATH>
    aliyun cs GET /k8s/$cluster_id/user_config | jq -r '.config' > $KUBECONFIG

    Expected output:

    NAME              STATUS   AGE
    default           Active   7m43s
    kube-node-lease   Active   7m45s
    kube-public       Active   7m45s
    kube-system       Active   7m45s

Test the ACK Serverless cluster

  1. Run the following command to deploy an NGINX application in the ACK Serverless cluster:

    kubectl run nginx --image=registry-vpc.cn-shenzhen.aliyuncs.com/acs-sample/nginx:latest

    Expected output:

    deployment.apps/nginx created
  2. Run the following command to query the state of the NGINX application:

    kubectl get deploy nginx

    Expected output:

     NAME    READY   UP-TO-DATE   AVAILABLE   AGE
     nginx   1/1     1            1           58s

Delete and release resources

  • Run the following command to delete the NGINX application:

    kubectl delete deploy nginx

    Expected output:

    deployment.extensions "nginx" deleted
  • You can also run the following command to delete the ACK Serverless cluster and release the relevant resources, such as the virtual private cloud (VPC) where the cluster is deployed:

    aliyun cs DELETE /clusters/************