Container Storage Interface (CSI) Storage Plugin Release 1.0

These notes describe the first release of the Container Storage Interface (CSI) Storage Plugin.

You may also be interested in the Kubernetes Release Notes.

Version	1.0
Release Date	February 2019
MapR Version Interoperability	Compatible with MapR 6.1.0 or later.
Kubernetes Compatibility	Kubernetes 1.13.0 and later.*
OpenShift Compatibility	4.1 and 4.2
CSI Driver Downloads	See Downloads (CSI) for more information.
Documentation	Container Storage Interface (CSI) Storage Plugin Overview
Related Resources	https://mapr.com/solutions/data-fabric/kubernetes/

* Kubernetes alpha features are not supported.

New in this Release

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

Fixes

None.

Limitations

Note the following limitations:

CSI Driver version 1.0 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
- Red Hat (use CentOS configuration file)
- Ubuntu
The Basic POSIX client package is included by default when you install the Container Storage Interface (CSI) Storage Plugin. The Platinum POSIX client can be enabled by specifying a parameter in the Pod spec. Only the FUSE-based POSIX client is supported. NFSv3 and NFSv4 are not supported.
The CSI Driver does not include support for inline volumes in pods. It only supports PersistentVolumes.

Known Issues

Note the following known issues:

On nodeplugin Pod restart or upgrade scenario, the existing POSIX client(s) running in the CSI Driver container are killed. The workaround is to move/stop the container workload using MapR CSI Storage Plugin, restart/update the MapR CSI Storage Plugin and start using the MapR CSI Storage Plugin again.
On Provisioner restart, Provisioner loses the information about the REST server where volume or snapshot should be deleted for existing volume and snapshots provisioned. The administrator must manually remove the volume and/or snapshot for provisioned volumes from the HPE Ezmeral Data Fabric.
Provisioned snapshot information is written to the provisioner log, but not available in the Kubernetes objects such as volumeSnapshots, VolumesnapshotContents etc.

If you want read-only behavior, specify readOnly in the volumeAttributes. For example, the following is supported:

csi:
    nodePublishSecretRef:
      name: "mapr-ticket-secret"
      namespace: "test-csi"
    driver: com.mapr.csi-kdf
    volumeHandle: pv-securepv-test-read-only-id
    volumeAttributes:
      volumePath: "/user/root"
      cluster: "clusterA"
      cldbHosts: "10.10.10.210"
      securityType: "secure"
      readOnly: "true"

The following is not supported:

csi:
    nodePublishSecretRef:
      name: "mapr-ticket-secret"
      namespace: "test-csi"
    driver: com.mapr.csi-kdf
    volumeHandle: pv-securepv-test-read-only-id
    readOnly: true
    volumeAttributes:
      volumePath: "/user/root"
      cluster: "clusterA"
      cldbHosts: "10.10.10.210"
      securityType: "secure"

Resolved Issues

None.