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:
A cluster running Kubernetes 1.26 or later. Upgrade the cluster if needed.
The csi-plugin component V1.33.1 or later installed. To upgrade, see Manage the csi-plugin and csi-provisioner components.
Install cnfs-nas-daemon
Log on to the ACK console. In the left navigation pane, click Clusters.
On the Clusters page, click the name of the target cluster. In the left navigation pane, click Add-ons.
Click the Storage tab.
Find cnfs-nas-daemon and click Install.
Configure the DaemonSet parameters as needed, then click OK.
The system automatically deploys a DaemonSet in the cluster after installation.
Verify that all cnfs-nas-daemon pods are running:
kubectl get pods -n cnfs-system -l app=cnfs-nas-daemonExpected 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 56sEnable cnfs-nas-daemon in csi-plugin:
Find the csi-plugin component and click Configuration.
Add
AlinasMountProxy=trueto FeatureGate.
After this feature gate is set, Container Storage Interface (CSI) will use cnfs-nas-daemon for mounting.