Container Service for Kubernetes:ossfs versions

How ossfs works

ossfs is a user space file system used to mount OSS buckets to local file systems in Linux. ossfs allows you to access and manage OSS objects in the same way as you manage local files. You can manage and share OSS objects seamlessly. ossfs provides the following features:

• Supports most features described in POSIX standards, such as file and directory uploads and downloads, and user permission management.

• Uses multipart upload and resumable upload to upload OSS objects by default.

• Supports MD5 verification to ensure data integrity.

• Supports all S3FS features because ossfs is developed based on S3FS.

For more information about ossfs, see ossfs.

ossfs versions

ossfs versions are displayed in the x.yy.z format.

• x.yy indicates a version developed based on open source s3fs. You can configure CSI environment variables to roll back to a historical x.yy version.

• z indicates an iterated version of ossfs. The version may involve optimizations to the OSS and ACK environments. For example, the version may introduce new monitoring, authentication, and encryption features. For more information, see csi-plugin.

• To distinguish between open source ossfs versions and ACK ossfs versions, the .ack.1 prefix is appended to ACK ossfs versions, such as 1.80.6.ack.1.

ossfs major version release notes

View the ossfs version

• In CSI versions that are not containerized (CSI versions earlier than 1.28, excluding 1.26.6), ossfs runs on nodes. You can log on to any ossfs node and run the following command to query the ossfs version:

  /usr/local/bin/ossfs --version

• In containerized CSI versions (1.26.6, 1.28.1, and later), ossfs runs in containers. After OSS volumes are mounted, the CSI component automatically creates pods in the kube-system namespace (CSI versions earlier than 1.30.4) or ack-csi-fuse namespace (CSI versions 1.30.4 and later). You can use the following method to query the ossfs version.

  1. Run the following command to query pods that are running.

     If the CSI version is earlier than 1.30.4:

     kubectl -n kube-system get pod | grep csi-fuse-ossfs

     If the CSI version is 1.30.4 or later:

     kubectl -n ack-csi-fuse get pod | grep csi-fuse-ossfs

  2. Run the following command to query the ossfs version.

     If the CSI version is earlier than 1.30.4:

     kubectl -n kube-system exec -it <csi-fuse-ossfs-xxxx> -- ossfs --version

     If the CSI version is 1.30.4 or later:

     kubectl -n ack-csi-fuse exec -it <csi-fuse-ossfs-xxxx> -- ossfs --version

Switch to ossfs 1.91 or later

Method 1: Update the CSI version

In CSI versions 1.30.4 and later, by default, ossfs uses version 1.91 and later. You can change the ossfs version by upgrading CSI.

Method 2: Enable the feature gate

To switch to ossfs 1.91 or later, you must enable the UpdatedOssfsVersion feature gate. To do this, perform the following steps:

1. Make sure that the version of csi-plugin is 1.30.1 or later.

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

   2. On the Clusters page, find the cluster that you want to manage and click its name. In the left-side navigation pane, choose Operations > Add-ons.

   3. On the Add-ons page, find csi-plugin and view its version.

      If the csi-plugin version is earlier than 1.30.1, click Upgrade in the lower-right corner to update the component to the latest version.

2. Use the console or kubectl to enable the UpdatedOssfsVersion feature gate.

   Note

   If you use the console to enable the feature gate, the FeatureGate parameters overwrite the existing settings. If you cannot confirm whether kubectl is already used to enable other feature gates, we recommend that you use kubectl to enable the preceding feature gate.

   Use the console

   1. After the csi-plugin component is updated, click Configuration in the lower-right corner of the card.

   2. On the csi-plugin Parameters page, set the FeatureGate parameter UpdatedOssfsVersion=true and click OK.

      If other feature gates are enabled before you add the parameter, set the parameter in the xxxxxx=true,yyyyyy=false,UpdatedOssfsVersion=true format.

   Use kubectl

   1. Run the following command to modify the DaemonSet file of csi-plugin:

   kubectl -n kube-system edit ds csi-plugin

   2. Add --feature-gates=UpdatedOssfsVersion=true to the args filed of the csi-plugin containers (not init containers). The modified args field:

   Note

   If other feature gates are enabled before you add the parameter, set the parameter in the --feature-gates=xxxxxx=true,yyyyyy=false,UpdatedOssfsVersion=true format.

         - args:
           - --endpoint=$(CSI_ENDPOINT)
           - --v=2
           - --driver=oss,nas,disk
           - --feature-gates=UpdatedOssfsVersion=true

References

For more information about the new features in ossfs 1.91 and later and stress tests, see New features in ossfs 1.91 and later and stress tests.