Container Service for Kubernetes (ACK) allows you to use a node pool to manage multiple nodes in a cluster as a group. For example, you can centrally manage the labels and taints of the nodes in a node pool. This topic describes how to add an existing Windows node to an ACK edge cluster.

Prerequisites

Limits

  • Make sure that you have a sufficient node quota in the cluster. To add more nodes, Submit a ticket to apply for a quota increase. For more information about the quota limits related to ACK edge clusters, see Limits.
  • Only Windows Server 2019 is supported.
  • You can add both Windows nodes and Linux nodes to an ACK edge cluster. For more information about how to add a Linux node to an ACK edge cluster, see Add an edge node.
  • You can deploy only workloads that support the HostNetwork mode on Windows nodes.

Step 1: Enable the Containers feature

Launch Windows PowerShell on the Windows node that you want to add to the cluster and run the following command to enable the Containers feature. For more information about how to launch Windows PowerShell, see Installing Windows PowerShell.

Install-WindowsFeature Containers

Expected output:

Success   Restart Needed   Exit Code        Feature Result
True      Yes              SuccessRest...   {Containers}
WARNING: You must restart this server to finish the installation process.

The output shows that you must restart the Windows node to finish the installation process.

Step 2: Add a Windows node

  1. Log on to the ACK console.
  2. In the left-side navigation pane of the ACK console, click Clusters.
  3. On the Clusters page, find the cluster that you want to manage and click the name of the cluster or click Details in the Actions column. The details page of the cluster appears.
  4. In the left-side navigation pane of the details page, choose Nodes > Node Pools.
  5. On the Node Pools page, find the node pool to which you want to add a Windows node and choose More > Add Existing Node in the Actions column.
  6. On the Select Existing ECS Instance wizard page, set Mode to Manual and select the Elastic Compute Service (ECS) instance that you want to add to the cluster from the ECS instances list.
  7. Click Next Step to go to the Specify Instance Information wizard page.
    Parameter Description Example
    Cluster ID/Name Information about the cluster to which you want to add the node. This parameter is automatically set. c593a437a5e754c65876c3f47a8bd**** / testcluster
    Script Validity Period The default value of Script Validity Period is 1 hour. If you want to use the script for more than 1 hour, set the validity period to a proper value. If you set Script Validity Period to 0, the script is permanently valid. 1
    Architecture The CPU architecture of the node that you want to add. Select AMD64/X86_64 if you want to add a Windows node. AMD64/X86_64
    Specifications The configurations of the node that you want to add. Refer to the sample configurations when you add a Windows node. For more information about the configuration parameters, see Parameters.
    {
      "quiet": true,
      "platform": "Windows"
    }
  8. Click Next Step. On the Complete wizard page, click Copy to copy the script. Log on to the Windows node that you want to add and launch Windows PowerShell to run the script.
    Node added
    The message in the following figure appears after the node is added to the cluster. Node added
  9. On the Complete wizard page, click Done.

Step 3 (optional) : Add the Windows node again or remove the Windows node

If you want to remove the Windows node or add the node again when the system fails to add the node, perform the following steps:

  1. Run the following command on the Windows node to clear the node data:
    Start-BitsTransfer -Source http://aliacs-k8s-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/public/pkg/run/attach/{cluster_version}/windows/edgeadm -Destination edgeadm.exe; ./edgeadm.exe reset
    Note Replace {cluster_version} with the Kubernetes version of the cluster. Example: 1.18.8-aliyunedge.1.
  2. Add the Windows node again or remove the Windows node.
    • You must clear the data on the Windows node before you add the node again. For more information about how to add a Windows node, see Step 2: Add a Windows node.
    • You must clear the data on the Windows node before you remove the node. For more information about how to remove a Windows node, see Remove a node.