bootstrap/vagrant-onap/README.md

   1 # ONAP on Vagrant
   2
   3 This vagrant project pretends to collect information about a way to deploy
   4 and build [ONAP project](https://www.onap.org/) into a development environment.
   5
   6 ### Problem Being Solved
   7
   8 * Reduce the barrier of entry to allow new ONAP developers to ramp up on to
   9 active development quickly
  10 * Reduce the cost to the community in responding to simple environment setup
  11 questions faced by new developers
  12
  13 ---
  14
  15 | Component        | Requirement                           |
  16 |------------------|---------------------------------------|
  17 | Vagrant          | >= 1.8.6                              |
  18 | Provider         | VirtualBox, Libvirt or OpenStack      |
  19 | Operating System | Linux, Mac OS or Windows              |
  20 | Hard Disk        | > 8 GB of free disk                   |
  21 | Memory           | > 12 GB                               |
  22
  23 ---
  24
  25 ## Execution:
  26
  27 #### deploying a single application
  28
  29 * Windows
  30
  31     PS C:\> cd integration\bootstrap\vagrant-onap
  32     PS C:\integration\bootstrap\vagrant-onap> Set-ExecutionPolicy Bypass -Scope CurrentUser
  33     PS C:\integration\bootstrap\vagrant-onap> .\tools\Run.ps1 <app_name>
  34
  35 * Linux or Mac OS
  36
  37     $ cd integration/bootstrap/vagrant-onap
  38     $ ./tools/run.sh <app_name>
  39
  40 current options include:
  41
  42 | app_name   | description                         |
  43 |:----------:|-------------------------------------|
  44 | aai        | Active and Available Inventory      |
  45 | appc       | Application Controller              |
  46 | ccsdk      | Common Controller SDK               |
  47 | dcae       | Data Collection Analytics & Events  |
  48 | mr         | Message Router                      |
  49 | mso        | Master Service Orchestrator         |
  50 | msb        | Microservices Bus Project           |
  51 | multicloud | Multi Cloud                         |
  52 | oom        | ONAP Operations Manager             |
  53 | policy     | Policy                              |
  54 | portal     | Portal                              |
  55 | robot      | Robot                               |
  56 | sdc        | Service Design & Creation           |
  57 | sdnc       | Software Defined Network Controller |
  58 | vfc        | Virtual Function Controller         |
  59 | vid        | Virtual Infrastructure Development  |
  60 | vnfsdk     | VNF SDK                             |
  61 | vvp        | VNF Validation Program              |
  62 |:----------:|-------------------------------------|
  63 | all_in_one | All ONAP services in a VM           |
  64 | testing    | Unit Test VM                        |
  65 |:----------:|-------------------------------------|
  66 | openstack  | OpenStack Deployment                |
  67
  68 #### Generating documentation
  69
  70 The documentation of this project was written in reStructuredText
  71 format which is located under the [docs folder](../blob/master/doc/source/index.rst).
  72 It's possible to format this documents to HTML using Sphinix python
  73 tool.
  74
  75     $ tox -e docs
  76
  77 This results in the creation of a new *doc/build/html* folder with
  78 the documentation converted in HTML pages that can be viewed through
  79 the preferred Web Browser.
  80
  81 ## Contributing
  82
  83 Bug reports and patches are most welcome.
  84 See the [contribution guidelines](CONTRIBUTING.md).
  85
  86 ## License
  87
  88 Apache-2.0