nfs

README

NFS Driver

Status: Not for production, experimental only

This driver provides an example deployment of an NFS server onto Kuberntes. It is based on NFS-Ganesha and exports over NFS the /exports directory inside the container.

Requirements

The container used to deploy NFS-Ganesha starts up rpc.bind and therefore cannot run multiple versions of this NFS implementation on a single host. Keep in mind that this is an experimental implementation.

Deployment

The file examples/nfs/cluster.yml contains an example deployment of two nfs servers. The file has been setup to work with the demo Kuberntes deployment, but you can change the number of servers and node names according to your Kuberntes cluster.

$ kubectl create -f examples/nfs/cluster.yaml

Since NFS does not support dynamic provisioning, the deployment will create a persistent volume (PV) for every entry storage node. You can check the status of the storage cluster, storage nodes, and pvs by running the following commands:

$ kubectl get storagecluster -o yaml
$ kubectl get storagenodes -o yaml
$ kubectl get pods
$ kubectl get pv

Example Application

The file examples/nfs/nginx-demo.yaml contains an example application set which will utilize one of the PVs created. To run the application type:

$ kubectl create -f examples/nfs/nginx-demo.yaml

This application runs a set of pods which write a index.html file with the date and the host name. To see the output of the application, determine the NodePort of the nginx service. Here is an example application output:

$ kubectl get svc my-nginx-svc -o yaml | grep nodePort
  - nodePort: 31823
$ curl http://<ip of a Kubernetes node>:31823
Mon Mar 20 19:37:30 UTC 2017
nfs-busybox-2t80g

Documentation

Index

• func New(client kubernetes.Interface, qm restclient.Interface) (qmstorage.StorageType, error)
• type NfsStorage
  • func (st *NfsStorage) AddNode(s *spec.StorageNode) (*spec.StorageNode, error)
  • func (st *NfsStorage) DeleteNode(s *spec.StorageNode) error
  • func (st *NfsStorage) Init() error
  • func (st *NfsStorage) MakeDeployment(s *spec.StorageNode, old *v1beta1.Deployment) (*v1beta1.Deployment, error)
  • func (st *NfsStorage) Type() spec.StorageTypeIdentifier
  • func (st *NfsStorage) UpdateNode(s *spec.StorageNode) (*spec.StorageNode, error)

Functions

func New

func New(client kubernetes.Interface, qm restclient.Interface) (qmstorage.StorageType, error)

Types

type NfsStorage

type NfsStorage struct {
	// contains filtered or unexported fields
}

func (*NfsStorage) AddNode

func (st *NfsStorage) AddNode(s *spec.StorageNode) (*spec.StorageNode, error)

func (*NfsStorage) DeleteNode

func (st *NfsStorage) DeleteNode(s *spec.StorageNode) error

func (*NfsStorage) Init

func (st *NfsStorage) Init() error

func (*NfsStorage) MakeDeployment

func (st *NfsStorage) MakeDeployment(s *spec.StorageNode,
	old *v1beta1.Deployment) (*v1beta1.Deployment, error)

func (*NfsStorage) Type

func (st *NfsStorage) Type() spec.StorageTypeIdentifier

func (*NfsStorage) UpdateNode

func (st *NfsStorage) UpdateNode(s *spec.StorageNode) (*spec.StorageNode, error)