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>

8 files changed, 153 insertions, 0 deletions

diff --git a/ci/nbp-ansible/README.md b/ci/nbp-ansible/README.md
new file mode 100644
index 0000000..391bcc3
--- /dev/null
+++ b/ci/nbp-ansible/README.md
@@ -0,0 +1,47 @@
+# nbp-ansible

+This is an installation tool for opensds northbound plugins using ansible.

+

+## Install work

+

+### Pre-config (Ubuntu 16.04)

+First download some system packages:

+```

+sudo apt-get install -y openssh-server git

+```

+Then config ```/etc/ssh/sshd_config``` file and change one line:

+```conf

+PermitRootLogin yes

+```

+Next generate ssh-token:

+```bash

+ssh-keygen -t rsa

+ssh-copy-id -i ~/.ssh/id_rsa.pub <ip_address> # IP address of the target machine of the installation

+```

+

+### Install docker

+If use a standalone cinder as backend, you also need to install docker to run cinder service. Please see the [docker installation document](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/) for details.

+

+### Install ansible tool

+```bash

+sudo add-apt-repository ppa:ansible/ansible # This step is needed to upgrade ansible to version 2.4.2 which is required for the ceph backend.

+sudo apt-get update

+sudo apt-get install ansible

+ansible --version # Ansible version 2.4.2 or higher is required for ceph; 2.0.0.2 or higher is needed for other backends.

+```

+

+### Check if the hosts can be reached

+```bash

+sudo ansible all -m ping -i nbp.hosts

+```

+

+### Run opensds-ansible playbook to start deploy

+```bash

+sudo ansible-playbook site.yml -i nbp.hosts

+```

+

+## Uninstall work

+

+### Run nbp-ansible playbook to clean the environment

+```bash

+sudo ansible-playbook clean.yml -i nbp.hosts

+```

diff --git a/ci/nbp-ansible/clean.yml b/ci/nbp-ansible/clean.yml
new file mode 100644
index 0000000..6e5f629
--- /dev/null
+++ b/ci/nbp-ansible/clean.yml
@@ -0,0 +1,12 @@
+---

+# Defines some clean processes when banishing the cluster.

+

+- name: destory all opensds nbp files

+  hosts: worker-nodes

+  remote_user: root

+  vars_files:

+    - group_vars/common.yml

+  gather_facts: false

+  become: True

+  roles:

+    - cleaner

diff --git a/ci/nbp-ansible/group_vars/common.yml b/ci/nbp-ansible/group_vars/common.yml
new file mode 100644
index 0000000..344cab7
--- /dev/null
+++ b/ci/nbp-ansible/group_vars/common.yml
@@ -0,0 +1,23 @@
+---

+# Variables here are applicable to all host groups NOT roles

+

+# This sample file generated by generate_group_vars_sample.sh

+

+# Dummy variable to avoid error because ansible does not recognize the

+# file as a good configuration file when no variable in it.

+dummy:

+

+# You can override default vars defined in defaults/main.yml here,

+# but I would advice to use host or group vars instead

+

+

+###########

+# GENERAL #

+###########

+

+# These fields are not suggested to be modified

+nbp_download_url: https://github.com/opensds/nbp/releases/download/v0.1.0/opensds-k8s-linux-amd64.tar.gz

+nbp_tarball_url: /opt/opensds-k8s-linux-amd64.tar.gz

+nbp_dir: /opt/opensds-k8s-linux-amd64

+

+flexvolume_plugin_dir: /usr/libexec/kubernetes/kubelet-plugins/volume/exec/opensds.io~opensds

diff --git a/ci/nbp-ansible/nbp.hosts b/ci/nbp-ansible/nbp.hosts
new file mode 100644
index 0000000..84d0dc6
--- /dev/null
+++ b/ci/nbp-ansible/nbp.hosts
@@ -0,0 +1,2 @@
+[worker-nodes]

+localhost ansible_connection=local
\ No newline at end of file
diff --git a/ci/nbp-ansible/roles/cleaner/tasks/main.yml b/ci/nbp-ansible/roles/cleaner/tasks/main.yml
new file mode 100644
index 0000000..38678b0
--- /dev/null
+++ b/ci/nbp-ansible/roles/cleaner/tasks/main.yml
@@ -0,0 +1,21 @@
+---

+- name: clean opensds flexvolume plugins binary file

+  file:

+    path: "{{ flexvolume_plugin_dir }}"

+    state: absent

+    force: yes

+  ignore_errors: yes

+

+- name: clean nbp release files

+  file:

+    path: "{{ nbp_dir }}"

+    state: absent

+    force: yes

+  ignore_errors: yes

+

+- name: clean nbp release tarball file

+  file:

+    path: "{{ nbp_tarball_url }}"

+    state: absent

+    force: yes

+  ignore_errors: yes

diff --git a/ci/nbp-ansible/roles/common/tasks/main.yml b/ci/nbp-ansible/roles/common/tasks/main.yml
new file mode 100644
index 0000000..b612e24
--- /dev/null
+++ b/ci/nbp-ansible/roles/common/tasks/main.yml
@@ -0,0 +1,24 @@
+---

+- name: Run the equivalent of "apt-get update" as a separate step

+  apt:

+    update_cache: yes

+

+- name: check for nbp release files existed

+  stat:

+    path: "{{ nbp_dir }}"

+  ignore_errors: yes

+  register: releasesexisted

+

+- name: download nbp release files

+  get_url:

+    url={{ nbp_download_url }}

+    dest={{ nbp_tarball_url }}

+  when:

+    - releasesexisted.stat.exists is undefined or releasesexisted.stat.exists == false

+

+- name: extract the nbp release tarball

+  unarchive:

+    src={{ nbp_tarball_url }}

+    dest=/opt/

+  when:

+    - releasesexisted.stat.exists is undefined or releasesexisted.stat.exists == false

diff --git a/ci/nbp-ansible/roles/flexvolume/tasks/main.yml b/ci/nbp-ansible/roles/flexvolume/tasks/main.yml
new file mode 100644
index 0000000..0bba93b
--- /dev/null
+++ b/ci/nbp-ansible/roles/flexvolume/tasks/main.yml
@@ -0,0 +1,11 @@
+---

+- name: Create flexvolume plugin directory if not existed

+  file:

+    path: "{{ flexvolume_plugin_dir }}"

+    state: directory

+    mode: 0755

+

+- name: Copy opensds flexvolume plugin binary file into flexvolume plugin dir

+  copy:

+    src: "{{ nbp_dir }}/flexvolume/opensds"

+    dest: "{{ flexvolume_plugin_dir }}/opensds"

diff --git a/ci/nbp-ansible/site.yml b/ci/nbp-ansible/site.yml
new file mode 100644
index 0000000..42c0790
--- /dev/null
+++ b/ci/nbp-ansible/site.yml
@@ -0,0 +1,13 @@
+---

+# Defines deployment design and assigns role to server groups

+

+- name: deploy opensds flexvolume plugin in all kubelet nodes

+  hosts: worker-nodes

+  remote_user: root

+  vars_files:

+    - group_vars/common.yml

+  gather_facts: false

+  become: True

+  roles:

+    - common

+    - flexvolume