summaryrefslogtreecommitdiffstats
path: root/tutorials
diff options
context:
space:
mode:
authorleonwang <wanghui71@huawei.com>2018-01-25 09:01:40 +0000
committerleonwang <wanghui71@huawei.com>2018-01-26 00:23:33 +0000
commit1dc4e57ae38ea5a4989aeb382c3450a26363ead5 (patch)
tree514ef1f93a040cde7aeef3406c364f998f54fd19 /tutorials
parentc032cadb1e645bf60cfd9276ed2660cc602a0e25 (diff)
Add nbp-ansible script to deploy opensds northbound plugins
In this patch, I created another ansible script to deploy opensds northbound plugins. Since we plan to integrate opensds with k8s using flexvolume, I only add flexvolume role to work on it. But the framework is extensible for adding more roles to integrate with k8s in other ways. Besides, I drafted the installation doc of integrating stor4nfv with k8s in docs directory so that Compass team can work on it more easily. Change-Id: Ifbd6cc38bf1789de0fcb132e6aa3cfcd9072a11b Signed-off-by: leonwang <wanghui71@huawei.com>
Diffstat (limited to 'tutorials')
-rw-r--r--tutorials/flexvolume-plugin.md108
1 files changed, 108 insertions, 0 deletions
diff --git a/tutorials/flexvolume-plugin.md b/tutorials/flexvolume-plugin.md
new file mode 100644
index 0000000..450acd5
--- /dev/null
+++ b/tutorials/flexvolume-plugin.md
@@ -0,0 +1,108 @@
+## Prerequisite ##
+### ubuntu
+* Version information
+
+ ```
+ root@proxy:~# cat /etc/issue
+ Ubuntu 16.04.2 LTS \n \l
+ ```
+### docker
+* Version information
+
+ ```
+ root@proxy:~# docker version
+ Client:
+ Version: 1.12.6
+ API version: 1.24
+ Go version: go1.6.2
+ Git commit: 78d1802
+ Built: Tue Jan 31 23:35:14 2017
+ OS/Arch: linux/amd64
+
+ Server:
+ Version: 1.12.6
+ API version: 1.24
+ Go version: go1.6.2
+ Git commit: 78d1802
+ Built: Tue Jan 31 23:35:14 2017
+ OS/Arch: linux/amd64
+ ```
+
+### [kubernetes](https://github.com/kubernetes/kubernetes) local cluster
+* Version information
+ ```
+ root@proxy:~# kubectl version
+ Client Version: version.Info{Major:"1", Minor:"9+", GitVersion:"v1.9.0-beta.0-dirty", GitCommit:"a0fb3baa71f1559fd42d1acd9cbdd8a55ab4dfff", GitTreeState:"dirty", BuildDate:"2017-12-13T09:22:09Z", GoVersion:"go1.9.2", Compiler:"gc", Platform:"linux/amd64"}
+ Server Version: version.Info{Major:"1", Minor:"9+", GitVersion:"v1.9.0-beta.0-dirty", GitCommit:"a0fb3baa71f1559fd42d1acd9cbdd8a55ab4dfff", GitTreeState:"dirty", BuildDate:"2017-12-13T09:22:09Z", GoVersion:"go1.9.2", Compiler:"gc", Platform:"linux/amd64"}
+ ```
+* You can startup the k8s local cluster by executing commands blow:
+
+ ```
+ cd $HOME
+ git clone https://github.com/kubernetes/kubernetes.git
+ cd $HOME/kubernetes
+ git checkout v1.9.0
+ make
+ echo alias kubectl='$HOME/kubernetes/cluster/kubectl.sh' >> /etc/profile
+ RUNTIME_CONFIG=settings.k8s.io/v1alpha1=true AUTHORIZATION_MODE=Node,RBAC hack/local-up-cluster.sh -O
+ ```
+
+
+### [opensds](https://github.com/opensds/opensds) local cluster
+* For testing purposes you can deploy OpenSDS local cluster referring to ```ansible/README.md```. Besides, you need to deploy opensds flexvolume plugin refering to ```nbp-ansible/README.md```.
+
+## Testing steps ##
+
+* Create service account, role and bind them.
+ ```
+ cd /opt/opensds-k8s-linux-amd64/provisioner
+ kubectl create -f serviceaccount.yaml
+ kubectl create -f clusterrole.yaml
+ kubectl create -f clusterrolebinding.yaml
+ ```
+
+* Change the opensds endpoint IP in pod-provisioner.yaml
+The IP (192.168.56.106) should be replaced with the OpenSDS osdslet actual endpoint IP.
+ ```yaml
+ kind: Pod
+ apiVersion: v1
+ metadata:
+ name: opensds-provisioner
+ spec:
+ serviceAccount: opensds-provisioner
+ containers:
+ - name: opensds-provisioner
+ image: opensdsio/opensds-provisioner
+ securityContext:
+ args:
+ - "-endpoint=http://192.168.56.106:50040" # should be replaced
+ imagePullPolicy: "IfNotPresent"
+ ```
+
+* Create provisioner pod.
+ ```
+ kubectl create -f pod-provisioner.yaml
+ ```
+
+* You can use the following cammands to test the OpenSDS FlexVolume and Proversioner functions.
+
+ ```
+ kubectl create -f sc.yaml # Create StorageClass
+ kubectl create -f pvc.yaml # Create PVC
+ kubectl create -f pod-application.yaml # Create busybox pod and mount the block storage.
+ ```
+
+ Execute the `findmnt|grep opensds` to confirm whether the volume has been provided.
+
+## Clean up steps ##
+
+```
+kubectl delete -f pod-application.yaml
+kubectl delete -f pvc.yaml
+kubectl delete -f sc.yaml
+
+kubectl delete -f pod-provisioner.yaml
+kubectl delete -f clusterrolebinding.yaml
+kubectl delete -f clusterrole.yaml
+kubectl delete -f serviceaccount.yaml
+``` \ No newline at end of file