All Products
Search
Document Center

Container Service for Kubernetes:Manage the cnfs-nas-daemon component

Last Updated:Mar 26, 2026

cnfs-nas-daemon integrates the client tools required to mount File Storage NAS and Cloud Parallel File Storage (CPFS) volumes in ACK clusters, enabling their advanced features without installing client tools directly on Kubernetes nodes. This topic describes how to install and enable the cnfs-nas-daemon component.

Considerations

Review the following before installing cnfs-nas-daemon:

Pod restart impact on I/O

When a cnfs-nas-daemon pod restarts, it also restarts the related NAS or CPFS client process. During the restart, I/O operations on the mount point are temporarily blocked or delayed. After the restart completes, I/O operations automatically resume without service disruption in most cases.

Upgrade strategy

cnfs-nas-daemon defaults to updateStrategy: OnDelete to prevent mass disruption to pods with mounted volumes during upgrades. To complete an upgrade under this strategy, manually delete the original pods. Alternatively, change updateStrategy to RollingUpdate for automated rolling updates.

Prerequisites

Before you begin, ensure that you have:

Install cnfs-nas-daemon

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

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

  3. Click the Storage tab.

  4. Find cnfs-nas-daemon and click Install.

  5. Configure the DaemonSet parameters as needed, then click OK.

    The system automatically deploys a DaemonSet in the cluster after installation.

  6. Verify that all cnfs-nas-daemon pods are running:

    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
  7. Enable cnfs-nas-daemon in csi-plugin:

    1. Find the csi-plugin component and click Configuration.

    2. Add AlinasMountProxy=true to FeatureGate.

    After this feature gate is set, Container Storage Interface (CSI) will use cnfs-nas-daemon for mounting.

What's next