cephfs

README

CephFS Volume Provisioner for Kubernetes 1.5+

Using Ceph volume client

Test instruction

Compile the provisioner

make

Make the container image and push to the registry

make push

• Start Kubernetes local cluster

• Create a Ceph admin secret

ceph auth get client.admin 2>&1 |grep "key = " |awk '{print  $3'} |xargs echo -n > /tmp/secret
kubectl create secret generic ceph-secret-admin --from-file=/tmp/secret --namespace=kube-system

• Start CephFS provisioner

The following example uses cephfs-provisioner-1 as the identity for the instance and assumes kubeconfig is at /root/.kube. The identity should remain the same if the provisioner restarts. If there are multiple provisioners, each should have a different identity.

docker run -ti -v /root/.kube:/kube -v /var/run/kubernetes:/var/run/kubernetes --privileged --net=host  cephfs-provisioner /usr/local/bin/cephfs-provisioner -master=http://127.0.0.1:8080 -kubeconfig=/kube/config -id=cephfs-provisioner-1

Alternatively, start a deployment:

kubectl create -f deployment.yaml

• Create a CephFS Storage Class

Replace Ceph monitor's IP in class.yaml with your own and create storage class:

kubectl create -f class.yaml

• Create a claim

kubectl create -f claim.yaml

• Create a Pod using the claim

kubectl create -f test-pod.yaml

Known limitations

• Kernel CephFS doesn't work with SELinux, setting SELinux label in Pod's securityContext will not work.
• Kernel CephFS doesn't support quota or capacity, capacity requested by PVC is not enforced or validated.
• Currently each Ceph user created by the provisioner has allow r MDS cap to permit CephFS mount.

Acknowledgement

Inspired by CephFS Manila provisioner and conversation with John Spray