aboutsummaryrefslogtreecommitdiffstats
path: root/docs/architecture/NBI_R1_Developer_Guide.rst
diff options
context:
space:
mode:
authorRene Robert <rene.robert@orange.com>2018-04-26 12:08:30 +0000
committerRene Robert <rene.robert@orange.com>2018-04-26 12:08:30 +0000
commit615546d8f9eab9a925f304298f1b42e3b4dbc4d0 (patch)
tree904be3211e3c105ac88cf15f75e1ba882f898b10 /docs/architecture/NBI_R1_Developer_Guide.rst
parentace06bb0c86ea0a26cd098f1c04bd1b5d1a1f746 (diff)
correct rst files
Issue-ID: EXTAPI-74 Change-Id: Ib03bdda0f7f8493d3b3b6cac9f603076bc7bf62b Signed-off-by: Rene Robert <rene.robert@orange.com>
Diffstat (limited to 'docs/architecture/NBI_R1_Developer_Guide.rst')
-rw-r--r--docs/architecture/NBI_R1_Developer_Guide.rst28
1 files changed, 14 insertions, 14 deletions
diff --git a/docs/architecture/NBI_R1_Developer_Guide.rst b/docs/architecture/NBI_R1_Developer_Guide.rst
index e855fea..2c9c549 100644
--- a/docs/architecture/NBI_R1_Developer_Guide.rst
+++ b/docs/architecture/NBI_R1_Developer_Guide.rst
@@ -3,18 +3,18 @@
.. Copyright 2018 ORANGE
-============
+=====================
NBI - Developer Guide
-============
-***************
+=====================
+************
Introduction
-***************
+************
NBI is a Java 8 web application built over Spring Framework. Using Spring Boot 1.5.10 dependencies, it runs as a standalone application with an embedded Tomcat server.
-***************
+************
Dependencies
-***************
+************
This project use various framework which are managed with Maven dependency management tool (see *pom.xml* file at root level) :
- Swagger annotations
@@ -24,31 +24,31 @@ This project use various framework which are managed with Maven dependency manag
- `Wiremock <https://github.com/tomakehurst/wiremock>`_ to perform testing over HTTP mocked response
-***************
+*************
Configuration
-***************
+*************
A configuration file, *src/main/resources/application-localhost.properties* list all the component interface that can be configured depending on the environment were the app is deployed.
By default, the application runs with an embedded both MongoDB and MariaDB local instance.
This file also list configurations of all the REST interface maid from NBI to other ONAP component such as SDC, AA&I and SO.
-***************
+***********
Source tree
-***************
+***********
This application provides ServiceOrder, ServiceCatalag and ServiceInventory as main functional resources and HealthCheck. Each resource is implemented independently in a package corresponding to its name.
*commons , configuration, and exceptions* are shared technical classes that provided for all the application.
-***************************************
+***********************************
Running and testing the application
-***************************************
+***********************************
**Locally**
Ensure that you have a MongoDB and MariaDB instance running and properly configured in *application.properties* file.
Run *Application.java* class in your favorite IDE
-Or through a terminal, ensure that your maven installation is works and run *mvn spring-boot:run* command to start the appication.
+Or through a terminal, ensure that your maven installation is works and run *mvn spring-boot:run* command to start the application.
**Docker**
@@ -66,7 +66,7 @@ You can view the log output of the application with the following command:
`$ docker-compose logs -f nbi`
**Testing**
-When the app is running, you can access the API at http://yourhostname:8080/nbi/api/v1/ and fill the url with the name of the resources you asking for (/serviceSpecification, /service, /serviceOrder or /status)
+When the app is running, you can access the API at \http://yourhostname:8080/nbi/api/v1/ and fill the url with the name of the resources you asking for (/serviceSpecification, /service, /serviceOrder or /status)
You can run a test by using `VisualStudio RestClient plugin <https://github.com/Huachao/vscode-restclient>`_
See the *restclient* package at root level to find *.vscode/settings.json* configuration file and */json/* package with samples requests that can be run.
You can also trigger these endpoints with any RESTful client or automation framework.