codenrhoden / csi-nfs Goto Github PK

CSI-NFS is a Container Storage Interface (CSI) plug-in that provides network filesystem (NFS) support.

This project may be compiled as a stand-alone binary using Golang that, when run, provides a valid CSI endpoint. This project can also be vendored or built as a Golang plug-in in order to extend the functionality of other programs.

You'll need a working Go installation. From there, download and installation is as simple as:

go get github.com/thecodeteam/csi-nfs

This will download the source to $GOPATH/src/github.com/thecodeteam/csi-nfs, and will build install the binary csi-nfs to $GOPATH/bin/csi-nfs.

In order to execute the binary, you must set the env var CSI_ENDPOINT. CSI is intended to only run over UNIX domain sockets, so a simple way to set this endpoint to a .sock file in the same directory as the project is

export CSI_ENDPOINT=unix://$(go list -f '{{.Dir}}' github.com/thecodeteam/csi-nfs)/csi-nfs.sock

With that in place, you can start the plugin (assuming that $GOPATH/bin is in your $PATH):

$ ./csi-nfs
INFO[0000] .Serve                                        name=csi-nfs

Use ctrl-C to exit.

You can enable debug logging (all logging goes to stdout) by setting the X_CSI_NFS_DEBUG env var. It doesn't matter what value you set it to, just that it is set. For example:

$ X_CSI_NFS_DEBUG= ./csi-nfs
INFO[0000] .Serve                                        name=csi-nfs
DEBU[0000] Added Controller Service
DEBU[0000] Added Node Service
^CINFO[0002] Shutting down server

The behavior of CSI-NFS can be modified with the following environment variables

Note that the Identity service is required to always be running, and that the default behavior is to also run both the Controller and the Node service

All communication with the plugin is done via gRPC. The easiest way to interact with a CSI plugin via CLI is to use the csc tool found in GoCSI.

You can install this tool with:

go get github.com/thecodeteam/gocsi
go install github.com/thecodeteam/gocsi/csc

With $GOPATH/bin in your $PATH, you can issue commands using the csc command. You will want to use a separate shell from where you are running the csi-nfs binary, and as such you will once again need to do:

export CSI_ENDPOINT=unix://$(go list -f '{{.Dir}}' github.com/thecodeteam/csi-nfs)/csi-nfs.sock

Here are some sample commands:

$ csc gets
0.0.0
$ csc getp -version 0.0.0
csi-nfs	0.1.0
$ csc cget -version 0.0.0
LIST_VOLUMES
$ showmount -e 192.168.75.2
Exports list on 192.168.75.2:
	/data                             192.168.75.1
$ mkdir /mnt/test
$ csc mnt -version 0.0.0 -targetPath /mnt/test -mode 1 host=192.168.75.2 export=/data
$ ls -al /mnt/test
total 1
drwxr-xr-x   2 root  wheel    18 Jul 22 20:25 .
drwxrwxrwt  85 root  wheel  2890 Aug 17 15:32 ..
-rw-r--r--   1 root  wheel     0 Jul 22 20:25 test
$ csc umount -version 0.0.0 -targetPath /mnt/test host=192.168.75.2 export=/data
$ ls -al /tmp/mnt
total 0
drwxr-xr-x   2 travis  wheel    68 Aug 16 15:01 .
drwxrwxrwt  85 root    wheel  2890 Aug 17 15:32 ..