1 ============================================
2 ONAP Integration > Bootstrap > Code search
3 ============================================
5 This directory contains a set of Vagrant scripts that will automatically set up a Hound_ instance
6 with config generator to index all ONAP code.
8 This is intended to show a beginning ONAP developer how to set up and configure an environment that
9 allows to search through ONAP code repositories quickly. It is not intended to be used as
10 a production code search solution.
12 `Upstream Docker image` has not been used due to lack of project activity. This environment
13 (together with daemon configuration generator) might be migrated to a new Docker image recipe in
16 .. _Hound: https://github.com/hound-search/hound
17 .. _`Upstream Docker image`: https://hub.docker.com/r/etsy/hound
23 Virtualisation provider
24 ~~~~~~~~~~~~~~~~~~~~~~~
26 Environment has been tested using libvirt_ provider with vagrant-libvirt_ plugin. Plugin
27 documentation provides detailed `installation instructions`_ that will guide through the process.
30 Remember to uncomment `deb-src` repositories for `apt-get build-dep` step on Debian/Ubuntu.
32 .. _libvirt: https://libvirt.org
33 .. _vagrant-libvirt: https://github.com/vagrant-libvirt/vagrant-libvirt
34 .. _`installation instructions`: https://github.com/vagrant-libvirt/vagrant-libvirt#installation
36 Virtual machine manager
37 ~~~~~~~~~~~~~~~~~~~~~~~
39 Environment has been tested using latest Vagrant_ as of writing this documentation (`v2.2.6`_). Some
40 features (e.g. triggers_) might not be supported on older versions.
42 .. _Vagrant: https://www.vagrantup.com/downloads.html
43 .. _`v2.2.6`: https://github.com/hashicorp/vagrant/blob/v2.2.6/CHANGELOG.md#226-october-14-2019
44 .. _triggers: https://www.vagrantup.com/docs/triggers/
50 Additional `--provider` flag or setting `VAGRANT_DEFAULT_PROVIDER` environmental variable might be
51 useful in case there are multiple providers available.
54 Following command should be executed within the directory where `Vagrantfile` is stored
55 (`integration/bootstrap/codesearch`).
59 vagrant up --provider=libvirt
63 #. Start and prepare virtual machine
64 #. Generate required authorization and configuration files
65 #. Run Hound instance as a tmux_ session named `codesearch`
67 .. _tmux: https://github.com/tmux/tmux/wiki
73 Once ready (cloning repositories and building index might initially take some time) code search will
74 be available at http://localhost:6080