Container Service for Kubernetes:Install the GPU sharing component

Prerequisites

• The cloud-native AI suite is activated before you use GPU sharing. For more information about the cloud-native AI suite and how it is billed, see Overview of the cloud-native AI suite and Billing of the cloud-native AI suite.

• An ACK Pro cluster is created. When creating the ACK Pro cluster, select the GPU-accelerated architecture for the Instance Type in the Node Pool Configurations step. For more information, see Create an ACK managed cluster.

• The kubeconfig file of the cluster is obtained and used to connect to the cluster by using kubectl.

Limits

• Do not set the CPU policy to static for nodes for which GPU sharing is enabled.

• cGPU does not support CUDA API cudaMallocManaged(). This indicates that cGPU does not allow you to request GPU memory by using the Unified Virtual Memory (UVM) method. You need to use another method, such as cudaMalloc(), to request GPU memory. For more information, visit the NVIDIA official website.

• The pods managed by the DaemonSet of the shared GPU do not enjoy the highest priority. Therefore, the resources may be scheduled to pods that have higher priority and the node may evict the pods managed by the DaemonSet. To prevent this issue, you can modify the actual DaemonSet of the shared GPU. For example, you can modify the gpushare-device-plugin-ds DaemonSet used to share GPU memory and specify priorityClassName: system-node-critical to ensure the priority of the pods managed by the DaemonSet.

• You can install the GPU sharing component without region limits. However, GPU memory isolation is supported only in the regions that are described in the following table. Make sure that your ACK cluster is deployed in one of the regions.

  Regions

  Region	Region ID
  China (Beijing)	cn-beijing
  China (Shanghai)	cn-shanghai
  China (Hangzhou)	cn-hangzhou
  China (Zhangjiakou)	cn-zhangjiakou
  China (Ulanqab)	cn-wulanchabu
  China (Shenzhen)	cn-shenzhen
  China (Chengdu)	cn-chengdu
  China (Heyuan)	cn-heyuan
  China (Hong Kong)	cn-hongkong
  Japan (Tokyo)	ap-northeast-1
  Indonesia (Jakarta)	ap-southeast-5
  Singapore	ap-southeast-1
  US (Virginia)	us-east-1
  US (Silicon Valley)	us-west-1
  Germany (Frankfurt)	eu-central-1

• Version requirements

  Item	Version requirement
  Kubernetes version	1.18.8 or later
  NVIDIA driver version	418.87.01 or later
  Container runtime version	Docker: 19.03.5 or later containerd: 1.4.3 or later
  Operating system	Alibaba Cloud Linux 3.x, Alibaba Cloud Linux 2.x, CentOS 7.6, CentOS 7.7, and CentOS 7.9
  GPU model	NVIDIA P, NVIDIA T, NVIDIA V, NVIDIA A, and NVIDIA H series

Step 1: Install the GPU sharing component

Step 2: Enable GPU sharing and GPU memory isolation

1. On the Clusters page, find the cluster that you want to manage and click its name. In the left-side navigation pane, choose Nodes > Node Pools.

2. In the upper-right corner of the Node Pools page, click Create Node Pool.

3. In the Create Node Pool dialog box, configure the parameters to create a node pool and click Confirm Order.

   The following table describes the key parameters. For more information about other parameters, see Create a node pool.

   Parameter	Description
   Expected Nodes	The initial number of nodes in the node pool. If you do not want to create nodes in the node pool, set this parameter to 0.
   Node Label	The labels that you want to add to the node pool based on your business requirement. For more information about node labels, see Labels for enabling GPU scheduling policies and methods for changing label values. In this example, the value of the label is set to cgpu, which indicates that GPU sharing is enabled for the node. The pods on the node need to request only GPU memory. Multiple pods can share the same GPU to implement GPU memory isolation and computing power sharing. Click the icon next to the Node Label parameter, set the Key field to ack.node.gpu.schedule, and then set the Value field to cgpu. For more information about some common issues when you use the memory isolation capability provided by cGPU, see Usage notes for the memory isolation capability of cGPU. Important After you add the label for enabling GPU sharing to a node, do not run the kubectl label nodes command to change the label value or use the label management feature to change the node label on the Nodes page in the ACK console. This prevents potential issues. For more information about these potential issues, see Issues that may occur if you use the kubectl label nodes command or use the label management feature to change label values in the ACK console. We recommend that you configure GPU sharing based on node pools. For more information, see Configure GPU scheduling policies for node pools.

Step 3: Add GPU-accelerated nodes

Step 4: Install and use the GPU inspection tool

1. Download kubectl-inspect-cgpu.

   • If you use Linux, run the following command to download kubectl-inspect-cgpu:

     wget http://aliacs-k8s-cn-beijing.oss-cn-beijing.aliyuncs.com/gpushare/kubectl-inspect-cgpu-linux -O /usr/local/bin/kubectl-inspect-cgpu

   • If you use macOS, run the following command to download kubectl-inspect-cgpu:

     wget http://aliacs-k8s-cn-beijing.oss-cn-beijing.aliyuncs.com/gpushare/kubectl-inspect-cgpu-darwin -O /usr/local/bin/kubectl-inspect-cgpu

2. Run the following command to grant the execute permissions to kubectl-inspect-cgpu:

   chmod +x /usr/local/bin/kubectl-inspect-cgpu

3. Run the following command to query the GPU usage of the cluster:

   kubectl inspect cgpu

   Expected output:

   NAME                       IPADDRESS      GPU0(Allocated/Total)  GPU Memory(GiB)
   cn-shanghai.192.168.6.104  192.168.6.104  0/15                   0/15
   ----------------------------------------------------------------------
   Allocated/Total GPU Memory In Cluster:
   0/15 (0%)