CSI driver utilizing TrueNAS for volume management.

Warning: in BETA state.

For deployment, see truenas-csi-chart.

TL;DR see examples.

The driver needs configuration to access one or more TrueNAS instances. Check config.go for full configuration structure.

The configuration has yaml syntax, must be passed to the application with -controller-config argument. This enables controller services.

The configuration file format is:

truenas-1: <truenas-config>
backup: <truenas-config>
default: <truenas-config>

A truenas-config has the structure:

apiurl: <url of truenas api>
[username: <username for api access>]
[password: <password for api access>]
[apikey: <api key for api access>]
[nfs: <nfs configuration>]
[iscsi: <iscsi configuration>]
configurations:
  sub-config-1: <configuration>
  default: <configuration>

apikey is recommended over username+password.

nfs configuration has the strucure:

server: <server address>
[allowedhosts: [array of allowed hosts to access share]]
[allowednetworks: [array of allowed networks to access share]]

iscsi configuration has the structure:

portal: <portal address>
portalid: <portal id in TrueNAS>

Each configuration section has the structure:

dataset: <root dataset>
deletePolicy: [delete|retain]
[sparse: [true|false]]
[nfs: <nfs sub-configuration>]
[iscsi: <iscsi sub-configuration>]

During volume create, evaluating capability requests, the driver makes a decision to create an nfs or an iscsi share.

Then a dataset is created under the selected configuration section. If nfs was chosen, an nfs export is created according to the selected configuration's nfs section. If iscsi was chosen, a new secret/target is created according to the selected configuration's iscsi section. Then, connection parameters are returned in the volume_context.

On CreateVolume request, parameters may specify which TrueNAS to use, and may select its sub-configuration. Any of these parameters may be omitted, then default entries are looked up.

• Use TrueNAS API only.
• Meet CSI requirements as much as can
  • idempotency during volume operations
  • implement as much capabilities

The following capabilities are supported from CSI Specification 1.3.0:

Plugin:

• online volume expansion

Controller:

• create/delete volume
• expand-volume

Node:

• stage-unstage volume
• get volume stats
• expand volume

• Snapshot handling

• TrueNAS itself is the NAS solution
• democratic-csi is an existing implementation
• ganeti-extstorage-csi is a Ganeti external storage driver utilizing CSI