Container Storage Interface (CSI) Storage Plugin Release 1.0 (Loopback NFS)

These notes describe release 1.0.x of the Container Storage Interface (CSI) Storage Plugin for Loopback NFS.

You may also be interested in the Kubernetes Release Notes. For the latest 1.0.x version, see the mapr-csi github repository.

Version 1.0.x
Release Date November 2020
MapR Version Interoperability Compatible with release 6.1.0 and later.
Kubernetes Compatibility Kubernetes 1.17.0 and later.*
OpenShift Compatibility 4.4 and later.
CSI Driver Downloads See Downloads (CSI) for more information.
Documentation
Related Resources https://www.hpe.com/us/en/resource-library.html

* Kubernetes alpha features are not supported.

New in this Release

This first release of the Container Storage Interface (CSI) Storage Plugin for NFS includes .yaml configuration files that can be installed onto a Kubernetes cluster. Once installed, these containers provide an NFS-based CSI Driver for the file-system volume plug-in and a Kubernetes Dynamic Volume Provisioner that permit static and dynamic provisioning of data-fabric storage from Kubernetes.

You can access the csi-nfsplugin by installing the custom resource definition (CRD) using the csi-maprnfskdf-v<version>.yaml file. Or you can build your own container and point to the plugin on the Docker hub at maprtech/csi-nfsplugin:<version>. For installation information, see Installing, Uninstalling, and Upgrading the Container Storage Interface (CSI) Storage Plugin.

Release 1.0.x also includes support for dynamic and static provisioning of raw block volumes. For more information, see Raw Block Volumes.

Patches

None.

Limitations

Note the following limitations:

  • CSI Driver version 1.0.x does not support coexistence with the FlexVolume Driver on the same Kubernetes cluster.
  • All nodes in the Kubernetes cluster must use the same Linux OS. Configuration files are available to support the following Linux distributions:
    • CentOS
    • RHEL (use CentOS configuration file)
    • Ubuntu
  • The CSI Driver does not include support for inline volumes in pods. It supports only PersistentVolumes.

Known Issues

Note the following known issues:

  • Snapshot restore fails if the snapshot contains symlinks to other files in the directory.

Resolved Issues

Issue Description
CSI-30

Enable memory profiling for fuse process w/ trackMemory : true option

CSI-241 Support volume clone for dynamic provisioning
CSI-242 Support snapshot restore for dynamic provisioning
CSI-243 Support for OpenShift 4.4, 4.5, 4.6+ & Kubernetes 1.17, 1.18, 1.19+
CSI-248 Retain fuse logs after pod delete w/ retainLogs: true option
REL-301 Update kdfplugin image w/ 6.2 release bits on centos8
CSI-254 Option 'numrpcthreads' added to configure Number of Client RPC threads (default:1, max:4).
CSI-258 DF client fixes & updates
CSI-259 Reduce verbose logging on CSI logfiles
CSI-262 [BETA] Support ticket-based authentication to apiserver. You can use MAPR_CLUSTER_TICKET instead of MAPR_CLUSTER_USER and MAPR_CLUSTER_PASSWORD. See REST Secrets.
BDP-2631 Update to livenessprobe v2.2.0 image to remove level5 messages