From 1dc4e57ae38ea5a4989aeb382c3450a26363ead5 Mon Sep 17 00:00:00 2001 From: leonwang Date: Thu, 25 Jan 2018 09:01:40 +0000 Subject: 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 --- ci/nbp-ansible/README.md | 47 ++++++++++++++++++++++++++ ci/nbp-ansible/clean.yml | 12 +++++++ ci/nbp-ansible/group_vars/common.yml | 23 +++++++++++++ ci/nbp-ansible/nbp.hosts | 2 ++ ci/nbp-ansible/roles/cleaner/tasks/main.yml | 21 ++++++++++++ ci/nbp-ansible/roles/common/tasks/main.yml | 24 +++++++++++++ ci/nbp-ansible/roles/flexvolume/tasks/main.yml | 11 ++++++ ci/nbp-ansible/site.yml | 13 +++++++ 8 files changed, 153 insertions(+) create mode 100644 ci/nbp-ansible/README.md create mode 100644 ci/nbp-ansible/clean.yml create mode 100644 ci/nbp-ansible/group_vars/common.yml create mode 100644 ci/nbp-ansible/nbp.hosts create mode 100644 ci/nbp-ansible/roles/cleaner/tasks/main.yml create mode 100644 ci/nbp-ansible/roles/common/tasks/main.yml create mode 100644 ci/nbp-ansible/roles/flexvolume/tasks/main.yml create mode 100644 ci/nbp-ansible/site.yml (limited to 'ci') 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 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 -- cgit 1.2.3-korg