From 0d6313811530c5b6cead501eaecdbb351efb5b1d Mon Sep 17 00:00:00 2001
From: Pawel Wieczorek
Date: Fri, 10 Jan 2020 17:24:05 +0100
Subject: Add Hound code search environment quickstart documentation
Issue-ID: ONAPARC-540
Change-Id: I618fcd994f2c6575ee4e388a78606ec59ec4fd02
Signed-off-by: Pawel Wieczorek
---
bootstrap/codesearch/README.rst | 56 +++++++++++++++++++++++++++++++++++++++++
1 file changed, 56 insertions(+)
diff --git a/bootstrap/codesearch/README.rst b/bootstrap/codesearch/README.rst
index 8e3278d36..78262b268 100644
--- a/bootstrap/codesearch/README.rst
+++ b/bootstrap/codesearch/README.rst
@@ -15,3 +15,59 @@ future, though.
.. _Hound: https://github.com/hound-search/hound
.. _`Upstream Docker image`: https://hub.docker.com/r/etsy/hound
+
+
+Prerequisites
+-------------
+
+Virtualisation provider
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Environment has been tested using libvirt_ provider with vagrant-libvirt_ plugin. Plugin
+documentation provides detailed `installation instructions`_ that will guide through the process.
+
+.. note::
+ Remember to uncomment `deb-src` repositories for `apt-get build-dep` step on Debian/Ubuntu.
+
+.. _libvirt: https://libvirt.org
+.. _vagrant-libvirt: https://github.com/vagrant-libvirt/vagrant-libvirt
+.. _`installation instructions`: https://github.com/vagrant-libvirt/vagrant-libvirt#installation
+
+Virtual machine manager
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Environment has been tested using latest Vagrant_ as of writing this documentation (`v2.2.6`_). Some
+features (e.g. triggers_) might not be supported on older versions.
+
+.. _Vagrant: https://www.vagrantup.com/downloads.html
+.. _`v2.2.6`: https://github.com/hashicorp/vagrant/blob/v2.2.6/CHANGELOG.md#226-october-14-2019
+.. _triggers: https://www.vagrantup.com/docs/triggers/
+
+
+Running
+-------
+
+Additional `--provider` flag or setting `VAGRANT_DEFAULT_PROVIDER` environmental variable might be
+useful in case there are multiple providers available.
+
+.. note::
+ Following command should be executed within the directory where `Vagrantfile` is stored
+ (`integration/bootstrap/codesearch`).
+
+.. code-block:: sh
+ vagrant up --provider=libvirt
+
+This will:
+
+#. Start and prepare virtual machine
+#. Generate required authorization and configuration files
+#. Run Hound instance as a tmux_ session named `codesearch`
+
+.. _tmux: https://github.com/tmux/tmux/wiki
+
+
+Usage
+-----
+
+Once ready (cloning repositories and building index might initially take some time) code search will
+be available at http://localhost:6080
--
cgit 1.2.3-korg