summaryrefslogtreecommitdiffstats
path: root/ci/nbp-ansible/README.md
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 /ci/nbp-ansible/README.md
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 'ci/nbp-ansible/README.md')
-rw-r--r--ci/nbp-ansible/README.md47
1 files changed, 47 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
+```