From: Rene Robert Date: Mon, 23 Apr 2018 15:39:19 +0000 (+0000) Subject: correct links and add infos X-Git-Tag: 2.0.0-ONAP~34 X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=798e4b41b1a10368c4ed43259c9dfa5a03681d81;p=externalapi%2Fnbi.git correct links and add infos Issue-ID: EXTAPI-74 Change-Id: Ic219585f889ca9c5fb03e1452c2583753e517d39 Signed-off-by: Rene Robert --- diff --git a/docs/architecture/architecture.rst b/docs/architecture/architecture.rst index b777f0f..8e7b9b9 100644 --- a/docs/architecture/architecture.rst +++ b/docs/architecture/architecture.rst @@ -28,7 +28,7 @@ Following illustration provides a global view about nbi architecture,integration Developer Guide *************** -Technical information about NBI (dependancies, configuration, running & testing) could be found here: :doc:`NBI_R1_Developer_Guide <../NBI_R1_Developer_Guide>` +Technical information about NBI (dependancies, configuration, running & testing) could be found here: :doc:`NBI_R1_Developer_Guide ` -API Flow illustration (with example messages) is described in this document: :download:`nbicallflow.pdf ` +API Flow illustration (with example messages) is described in this document: :download:`nbicallflow.pdf <../offeredapis/pdf/nbicallflow.pdf>` diff --git a/docs/offeredapis/images/ONAP External ID Beijing.jpg b/docs/architecture/images/ONAP_External_ID_Beijing.jpg similarity index 100% rename from docs/offeredapis/images/ONAP External ID Beijing.jpg rename to docs/architecture/images/ONAP_External_ID_Beijing.jpg diff --git a/docs/configuration/configuration.rst b/docs/configuration/configuration.rst index ba586aa..fb777a5 100644 --- a/docs/configuration/configuration.rst +++ b/docs/configuration/configuration.rst @@ -11,68 +11,62 @@ By default, the application runs with an embedded both MongoDB and MariaDB local This file also list configurations of all the REST interface maid from NBI to other ONAP component such as SDC, AA&I and SO. +************** Default values -============== - -**SERVER** - -server.contextPath=/nbi/api/v1 -server.port = 8080 - -**LOGGING** - -logging.level.=INFO - -**ONAP** - -onap.lcpCloudRegionId=RegionOne -onap.tenantId=6e97a2bd51d74f6db5671d8dc1517d82 -onap.cloudOwner=CloudOwner - -**NBI** - -nbi.url=http://localhost:8080/nbi/api/v1 -nbi.callForVNF=false - -**SDC** - -sdc.host=http://10.0.3.1:8080 -sdc.header.ecompInstanceId=demo -sdc.header.authorization=Basic YWFpOktwOGJKNFNYc3pNMFdYbGhhazNlSGxjc2UyZ0F3ODR2YW9HR21KdlV5MlU= - -**AAI** - -aai.host=https://10.0.1.1:8443 -aai.header.authorization=Basic QUFJOkFBSQ== -aai.api.id=AAI - -**SO** - -so.host=http://10.0.5.1:8080 -so.header.authorization=Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA== -so.api.id=SO - -**MONGO** - -spring.data.mongodb.host=localhost -spring.data.mongodb.port=27017 -spring.data.mongodb.database=ServiceOrderDB - -**MYSQL** - -spring.datasource.url=jdbc:mariadb://localhost:3306/nbi -spring.datasource.username=root -spring.datasource.password=secret -spring.datasource.testWhileIdle=true -spring.datasource.validationQuery=SELECT 1 -spring.datasource.driver-class-name=org.mariadb.jdbc.Driver -spring.jpa.show-sql=false -spring.jpa.hibernate.ddl-auto=update -spring.jpa.hibernate.naming-strategy=org.hibernate.cfg.ImprovedNamingStrategy - - +************** + +:: + + # SERVER + server.contextPath=/nbi/api/v1 + server.port = 8080 + + # LOGGING + logging.level.=INFO + + # ONAP + onap.lcpCloudRegionId=RegionOne + onap.tenantId=6e97a2bd51d74f6db5671d8dc1517d82 + onap.cloudOwner=CloudOwner + + # NBI + nbi.url=http://localhost:8080/nbi/api/v1 + nbi.callForVNF=false + + # SDC + sdc.host=http://10.0.3.1:8080 + sdc.header.ecompInstanceId=demo + sdc.header.authorization=Basic YWFpOktwOGJKNFNYc3pNMFdYbGhhazNlSGxjc2UyZ0F3ODR2YW9HR21KdlV5MlU= + + # AAI + aai.host=https://10.0.1.1:8443 + aai.header.authorization=Basic QUFJOkFBSQ== + aai.api.id=AAI + + # SO + so.host=http://10.0.5.1:8080 + so.header.authorization=Basic SW5mcmFQb3J0YWxDbGllbnQ6cGFzc3dvcmQxJA== + so.api.id=SO + + # MONGO + spring.data.mongodb.host=localhost + spring.data.mongodb.port=27017 + spring.data.mongodb.database=ServiceOrderDB + + # MYSQL + spring.datasource.url=jdbc:mariadb://localhost:3306/nbi + spring.datasource.username=root + spring.datasource.password=secret + spring.datasource.testWhileIdle=true + spring.datasource.validationQuery=SELECT 1 + spring.datasource.driver-class-name=org.mariadb.jdbc.Driver + spring.jpa.show-sql=false + spring.jpa.hibernate.ddl-auto=update + spring.jpa.hibernate.naming-strategy=org.hibernate.cfg.ImprovedNamingStrategy + +************** Changing values -=============== +************** To adapt application parameters to your context, you need to set up some environment attributes. For example : diff --git a/docs/consumedapis/consumedapis.rst b/docs/consumedapis/consumedapis.rst index 6962e02..8cd885a 100644 --- a/docs/consumedapis/consumedapis.rst +++ b/docs/consumedapis/consumedapis.rst @@ -16,9 +16,12 @@ SDC API this API is used to provide Service Catalog information Information are retrieved in SDC (and in Tosca "service template" file) - Only GET operation is provided - this API DID NOT UPDATE SDC - SDC_ROOT_URL = "/sdc/v1/catalog/services/"; - SDC_GET_PATH = "/metadata"; - SDC_TOSCA_PATH = "/toscaModel"; + SDC_ROOT_URL = "/sdc/v1/catalog/services/" + + SDC_GET_PATH = "/metadata" + + SDC_TOSCA_PATH = "/toscaModel" + *************** AAI API @@ -27,16 +30,18 @@ AAI API this API is used to provide Service Inventory information This API retrieves service(s) in the AAI inventory. Only following attributes will be retrieve in service inventory: id, name and type (no state or startDate available ) - AAI_GET_TENANTS_PATH = "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/$onap.cloudOwner/$onap.lcpCloudRegionId/tenants"; - AAI_GET_CUSTOMER_PATH = "/aai/v11/business/customers/customer/"; - AAI_GET_SERVICES_FOR_CUSTOMER_PATH = - "/aai/v11/business/customers/customer/$customerId/service-subscriptions"; - AAI_PUT_SERVICE_FOR_CUSTOMER_PATH = - "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/"; - AAI_GET_SERVICE_FOR_CUSTOMER_PATH = - "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/service-instance/$serviceId"; - AAI_GET_SERVICE_INSTANCES_PATH = - "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/"; + AAI_GET_TENANTS_PATH = "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/$onap.cloudOwner/$onap.lcpCloudRegionId/tenants" + + AAI_GET_CUSTOMER_PATH = "/aai/v11/business/customers/customer/" + + AAI_GET_SERVICES_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions" + + AAI_PUT_SERVICE_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/ + + AAI_GET_SERVICE_FOR_CUSTOMER_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/service-instance/$serviceId" + + AAI_GET_SERVICE_INSTANCES_PATH = "/aai/v11/business/customers/customer/$customerId/service-subscriptions/service-subscription/$serviceSpecName/service-instances/" + *************** @@ -46,6 +51,9 @@ SO API this API is used to perform Service Order and thus instantiate a service - MSO_CREATE_SERVICE_INSTANCE_PATH = "/ecomp/mso/infra/serviceInstance/v4"; - MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v4/"; - MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/"; + MSO_CREATE_SERVICE_INSTANCE_PATH = "/ecomp/mso/infra/serviceInstance/v4" + + MSO_GET_REQUEST_STATUS_PATH = "/ecomp/mso/infra/orchestrationRequests/v4/" + + MSO_DELETE_REQUEST_STATUS_PATH = "/ecomp/mso/infra/serviceInstances/" + diff --git a/docs/delivery/delivery.rst b/docs/delivery/delivery.rst index 7ef857a..ebd9874 100644 --- a/docs/delivery/delivery.rst +++ b/docs/delivery/delivery.rst @@ -6,4 +6,29 @@ Delivery ======== +NBI Dockers Containers Structure +================================ + +Below is a diagram of the ExternalAPI/NBI project docker containers and the connections between them. + +.. blockdiag:: + + + blockdiag delivery { + node_width = 170; + orientation = portrait; + MongoDB[shape = flowchart.database] + MariaDB[shape = flowchart.database] + NBI -> MongoDB, MariaDB; + group bi_group { + color = yellow; + label = "Business Layer" + NBI; + } + group data_storage_group { + color = orange; + label = "Data Storage Layer" + MongoDB; MariaDB; + } + }