Container Service for Kubernetes:Manage the cnfs-nas-daemon add-on

Overview

The cnfs-nas-daemon add-on runs as a DaemonSet that bundles the CPFS client tool. This add-on:

• Does not require installation of client tools on Kubernetes nodes.

• Supports:

  • CPFS: Mount statically provisioned CPFS for Lingjun volumes

Prerequisites

• The cluster runs Kubernetes 1.26 or later. Manually upgrade the cluster if needed.

• The csi-plugin v1.33.1 or later is installed in the cluster. To upgrade, see Manage CSI components.

Procedure

1. Log on to the ACK console. In the left navigation pane, click Clusters.

2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Components and Add-ons.

3. Click the Volumes tab.

4. Install the cnfs-nas-daemon add-on.

   Installing cnfs-nas-daemon deploys a DaemonSet in the cluster.

   1. Find the cnfs-nas-daemon and click Install.

   2. Configure the DaemonSet parameters for cnfs-nas-daemon as needed and click OK.

      Important

      The DaemonSet for cnfs-nas-daemon defaults to updateStrategy: OnDelete, preventing mass disruption of pods with mounted volumes during add-on upgrades. Manually delete the original pods to complete the update, or modify updateStrategy to RollingUpdate.

   3. Verify the deployment status of the DaemonSet for cnfs-nas-daemon:

      kubectl get pods -n cnfs-system -l app=cnfs-nas-daemon 

      Expected output:

      NAME                    READY   STATUS    RESTARTS   AGE
      cnfs-nas-daemon-47mjw   1/1     Running   0          56s
      cnfs-nas-daemon-dkf4d   1/1     Running   0          56s
      cnfs-nas-daemon-s2btk   1/1     Running   0          56s

      Important

      When a cnfs-nas-daemon pod restarts, it also restarts the related NAS or CPFS client process:

      • During this restart period, I/O operations on the mount point are temporarily blocked or delayed.

      • After the restart, I/O operations resume automatically, typically without service interruption.

5. Modify the csi-plugin configuration to enable cnfs-nas-daemon:

   1. Locate the csi-plugin and click Configuration.

   2. Add AlinasMountProxy=true to FeatureGate.

      After you enable this feature gate, Container Storage Interface (CSI) uses cnfs-nas-daemon for mounting.