Gitiles
Code Review Sign In
gerrit.nordix.org / onap / doc / 43f5aec27abb9828d2aabe17a7d14f09226c245a / . / docs / guides / onap-developer / settingup / index.rst
blob: 58883d730092a5c824979a2376091d0c71688a2d [file] [log] [blame]
Eric Debeau3cf9a632018-05-22 19:57:38 +0000[diff] [blame]1.. This work is licensed under
2.. a Creative Commons Attribution 4.0 International License.
Rich Bennetta4cf27d2017-11-12 23:11:28 -0500[diff] [blame]3.. http://creativecommons.org/licenses/by/4.0
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]4.. Copyright 2017-2018 AT&T Intellectual Property. All rights reserved.
5.. Modifications Copyright 2018 Orange
6.. Modifications Copyright 2018 Amdocs
7.. Modifications Copyright 2018 Huawei
Eric Debeau7e900412017-11-09 22:02:38 +0000[diff] [blame]8
Rich Bennetta4cf27d2017-11-12 23:11:28 -0500[diff] [blame]9Setting Up ONAP
10===============
Eric Debeau7e900412017-11-09 22:02:38 +0000[diff] [blame]11
Eric Debeau43f5aec2018-11-24 08:29:47 +0000[diff] [blame^]12.. _installing-onap:
13
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]14ONAP is deployed using the ONAP Operations Manager (OOM).
Rich Bennett52b5c092018-09-01 09:48:13 -0400[diff] [blame]15
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]16The recommended ONAP deployment is based on Kubernetes, Docker containers
17and Helm installer.
Rich Bennett52b5c092018-09-01 09:48:13 -0400[diff] [blame]18
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]19Requirements
20------------
Rich Bennett52b5c092018-09-01 09:48:13 -0400[diff] [blame]21
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]22The following is the recommended component version.
Rich Bennett52b5c092018-09-01 09:48:13 -0400[diff] [blame]23
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]24 =========== =========
25 Software Version
26 =========== =========
27 Kubernetes 1.11.2
28 Helm 2.9.1
29 kubectl 1.11.2
30 Docker 17.03.x
31 =========== =========
Rich Bennett52b5c092018-09-01 09:48:13 -0400[diff] [blame]32
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]33The ONAP full installation is validated with the following footprint:
34 - 14 VM (1 Rancher, 13 K8s nodes)
35 - 8 vCPU
36 - 16 GB RAM
37 - 160 GB Storage
38
39Installation
40------------
41
42Creation of Kubernetes cluster is described here:
Eric Debeau3cf9a632018-05-22 19:57:38 +0000[diff] [blame]43
Rich Bennetta4cf27d2017-11-12 23:11:28 -0500[diff] [blame]44.. toctree::
45 :maxdepth: 1
46 :titlesonly:
Eric Debeau7e900412017-11-09 22:02:38 +0000[diff] [blame]47
Eric Debeau0f2c2832018-11-19 19:47:29 +0000[diff] [blame]48 ../../../../submodules/oom.git/docs/oom_cloud_setup_guide.rst
49
50ONAP installation is described here:
51
52.. toctree::
53 :maxdepth: 1
54 :titlesonly:
55
56 ../../../../submodules/oom.git/docs/oom_quickstart_guide.rst
57
58NodePorts
59---------
60
61NodePorts are used to allow client applications, that run outside of
62Kubernetes, access to ONAP components deployed by OOM.
63A NodePort maps an externally reachable port to an internal port of an ONAP
64microservice.
65It should be noted that the use of NodePorts is temporary.
66An alternative solution is currently being scoped for the Dublin Release.
67
68* The list of node ports used by ONAP is documented
69 in `ONAP Node Port List <https://wiki.onap.org/display/DW/OOM+NodePort+List>`_.
70
71.. note::
72 Prior to deployment of ONAP, there is no need to download manually any Docker container.
73 The OOM deployment takes care to automatically download the Docker containers.
74
75 It is also possible to deploy a subset of ONAP components on a single VM.
76 The VM flavor to be used depends on the number of ONAP components to be
77 deployed.
78
79.. note::
80 For test purposes, it is possible to use other installations:
81
82.. toctree::
83 :maxdepth: 1
84 :titlesonly:
85
Rich Bennett52b5c092018-09-01 09:48:13 -0400[diff] [blame]86 onap_heat.rst
87 onap_individual.rst