aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: aa965f7e2fc74d6858d7b9f1e50117aa78f72a5a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
# Devtool for ONAP

This project pretends to collect information about a way to developing/building
services for [ONAP project](https://www.onap.org/) providing an automated
development environment.

### Problem Being Solved

* Reduce the barrier of entry to allow new ONAP developers to ramp up on to
active development quickly
* Reduce the cost to the community in responding to simple environment setup
questions faced by new developers

---

| Component        | Requirement                           |
|------------------|---------------------------------------|
| Vagrant          | >= 1.8.6                              |
| Provider         | VirtualBox, Libvirt or OpenStack      |
| Operating System | Linux, Mac OS or Windows              |
| Hard Disk        | > 8 GB of free disk                   |
| Memory           | > 12 GB                               |

---

## Execution:

#### Deploying a single application

* Windows

    PS C:\> cd devtool
    PS C:\devtool> Set-ExecutionPolicy Bypass -Scope CurrentUser
    PS C:\devtool> .\tools\Run.ps1 <app_name>

* Linux or Mac OS

    $ cd devtool
    $ ./tools/run.sh <app_name>

current options include:

| app_name   | description                         |
|:----------:|-------------------------------------|
| aai        | Active and Available Inventory      |
| appc       | Application Controller              |
| ccsdk      | Common Controller SDK               |
| dcae       | Data Collection Analytics & Events  |
| dmaap      | Data Movement as a Platform         |
| mr         | Message Router                      |
| mso        | Master Service Orchestrator         |
| msb        | Microservices Bus Project           |
| multicloud | Multi Cloud                         |
| oom        | ONAP Operations Manager             |
| policy     | Policy                              |
| portal     | Portal                              |
| robot      | Robot                               |
| sdc        | Service Design & Creation           |
| sdnc       | Software Defined Network Controller |
| vfc        | Virtual Function Controller         |
| vid        | Virtual Infrastructure Development  |
| vnfsdk     | VNF SDK                             |
| vvp        | VNF Validation Program              |

| app_name   | description                              |
|:----------:|------------------------------------------|
| all_in_one | All ONAP services in a VM (experimental) |
| testing    | Unit Test VM                             |

| app_name   | description          |
|:----------:|----------------------|
| openstack  | OpenStack Deployment |

#### Generating documentation

The documentation of this project was written in reStructuredText
format which is located under the [docs folder](../blob/master/doc/source/index.rst).
It's possible to format these documents to HTML using Sphinix python
tool.

    $ tox -e docs

This results in the creation of a new *doc/build/html* folder with
the documentation converted in HTML pages that can be viewed through
the preferred Web Browser.

## Contributing

Bug reports and patches are most welcome.
See the [contribution guidelines](CONTRIBUTING.md).

## License

Apache-2.0