[INTEGRATION] Add NF simulator documentation in read the docs 99/120599/1
authorKrzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com>
Fri, 16 Apr 2021 10:47:19 +0000 (12:47 +0200)
committerKrzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com>
Fri, 16 Apr 2021 10:47:19 +0000 (12:47 +0200)
fix indents and bullet points

Issue-ID: INT-1869
Signed-off-by: Krzysztof Kuzmicki <krzysztof.kuzmicki@nokia.com>
Change-Id: I1fae12aa024baf852bd9dc36b06a26a341d9dea2

docs/simulators/nf_simulator.rst

index 9ba295a..8b7fae8 100644 (file)
@@ -18,25 +18,25 @@ The simulator is expected to cover planned NF behaviour - receive the config cha
 
 **Figure 1. Architecture Overview**
 
-NF Simulator code is stored in https://github.com/onap/integration-simulators-nf-simulator and all it's sub repos are:
+1. NF Simulator code is stored in https://github.com/onap/integration-simulators-nf-simulator and all it's sub repos are:
 
-- for VES Client - https://github.com/onap/integration-simulators-nf-simulator-ves-client
-- for Netconf Server - https://github.com/onap/integration-simulators-nf-simulator-netconf-server
-- for AVCN Manager - https://github.com/onap/integration-simulators-nf-simulator-avcn-manager
-- for PM HTTPS Server - https://github.com/onap/integration-simulators-nf-simulator-pm-https-server
+   - for VES Client - https://github.com/onap/integration-simulators-nf-simulator-ves-client
+   - for Netconf Server - https://github.com/onap/integration-simulators-nf-simulator-netconf-server
+   - for AVCN Manager - https://github.com/onap/integration-simulators-nf-simulator-avcn-manager
+   - for PM HTTPS Server - https://github.com/onap/integration-simulators-nf-simulator-pm-https-server
 
-For above components have been prepared:
+2. For above components have been prepared:
 
-- docker images in ONAP Nexus:
+   - docker images in ONAP Nexus:
 
-     VES Client image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.vesclient
-     AVCN Manager image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.avcnmanager
-     PM HTTPS Server image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.pmhttpsserver
-     Netconf Server images - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.netconfserver
+     - VES Client image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.vesclient
+     - AVCN Manager image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.avcnmanager
+     - PM HTTPS Server image - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.pmhttpsserver
+     - Netconf Server images - nexus3.onap.org:10001/onap/org.onap.integration.nfsimulator.netconfserver
 
-- example helm charts:
+   - example helm charts:
 
-    - `Helm charts <https://github.com/onap/integration-simulators-nf-simulator/tree/master/helm>`_
+     - `Helm charts <https://github.com/onap/integration-simulators-nf-simulator/tree/master/helm>`_
 
 **VES Client, Netconf Server and PM HTTPS Server can be used and deployed separately depending on needs.**
 
@@ -45,67 +45,66 @@ Only AVCN Manger connects VES Client with Netconf Server in order to support O1
 1. VES Client:
 --------------
 
-   Application that generates VES events on demand.
+Application that generates VES events on demand.
 
-   **What does it do?**
-
-   - Supports both basic auth and TLS CMPv2 method of authentication.
-   - Allows to turn on and turn off hostname, verification in SSL.
-   - Allows to send one-time event and periodic events, based on event templates.
-   - Exposes API to manage VES Client
-   - Provides template mechanism (Template is a draft event. Merging event with patch will result in valid VES event.
-     Template itself should be a correct VES event as well as valid json object. )
-   - Patching - User is able to provide patch in request, which will be merged into template.
-   - Simulator supports corresponding keywords in templates: RandomInteger(start,end), RandomPrimitiveInteger(start,end), RandomInteger,
-     RandomString(length), RandomString, Timestamp, TimestampPrimitive, Increment
-   - In place variables support - Simulator supports dynamic keywords e.g. #dN to automatically substitute selected phrases in defined json schema.
-   - Logging - Every start of simulator will generate new logs that can be found in docker ves-client container.
-   - Swagger - Detailed view of simulator REST API is available via Swagger UI
-   - History - User is able to view events history.
+**What does it do?**
 
+- Supports both basic auth and TLS CMPv2 method of authentication.
+- Allows to turn on and turn off hostname, verification in SSL.
+- Allows to send one-time event and periodic events, based on event templates.
+- Exposes API to manage VES Client
+- Provides template mechanism (Template is a draft event. Merging event with patch will result in valid VES event.
+  Template itself should be a correct VES event as well as valid json object. )
+- Patching - User is able to provide patch in request, which will be merged into template.
+- Simulator supports corresponding keywords in templates: RandomInteger(start,end), RandomPrimitiveInteger(start,end), RandomInteger,
+  RandomString(length), RandomString, Timestamp, TimestampPrimitive, Increment
+- In place variables support - Simulator supports dynamic keywords e.g. #dN to automatically substitute selected phrases in defined json schema.
+- Logging - Every start of simulator will generate new logs that can be found in docker ves-client container.
+- Swagger - Detailed view of simulator REST API is available via Swagger UI
+- History - User is able to view events history.
 
 2. Netconf Server:
 ------------------
 
-   This server uses sysrepo to simulate network configuration.
-   It is based on sysrepo-netopeer2 image.
+This server uses sysrepo to simulate network configuration.
+It is based on sysrepo-netopeer2 image.
 
-   **What does it do?**
+**What does it do?**
 
-   Server allows to:
+Server allows to:
 
-   - install custom configuration models on start up.
-   - change configuration of that modules on runtime.
-   - use TLS custom certificates
-   - configure change subscription for particular YANG modules (Netconf server image run python application on the startup.)
-   - manage netconf server using REST interface, with endpoints:
+- install custom configuration models on start up.
+- change configuration of that modules on runtime.
+- use TLS custom certificates
+- configure change subscription for particular YANG modules (Netconf server image run python application on the startup.)
+- manage netconf server using REST interface, with endpoints:
 
-      - GET /healthcheck returns 200 "UP" if server is up and running
-      - POST /readiness return 200 "Ready" if server is ready, if not, returns 503 "Not Ready"
-      - POST /change_config/<path:module_name> changes configuration ad returns 202 "Accepted"
-      - GET /change_history returns 200 and change history as json
-      - GET /get_config/<path:module_name> returns 200 and current configuration
+  - GET /healthcheck returns 200 "UP" if server is up and running
+  - POST /readiness return 200 "Ready" if server is ready, if not, returns 503 "Not Ready"
+  - POST /change_config/<path:module_name> changes configuration ad returns 202 "Accepted"
+  - GET /change_history returns 200 and change history as json
+  - GET /get_config/<path:module_name> returns 200 and current configuration
 
 3. AVCN Manager:
 ----------------
 
-   Manager that fetches changes of configuration from kafka and sends them to VES client.
+Manager that fetches changes of configuration from kafka and sends them to VES client.
 
-   **What does it do?**
+**What does it do?**
 
-   The manager processes notifications from NETCONF server. It does this by being a subscriber of a Kafka topic that is fed
-   with NETCONF notifications. Incoming notifications are then processed and output of this processing is sent to VES client.
+The manager processes notifications from NETCONF server. It does this by being a subscriber of a Kafka topic that is fed
+with NETCONF notifications. Incoming notifications are then processed and output of this processing is sent to VES client.
 
 4. PM HTTPS Server:
 -------------------
 
-   Server that is used in Bulk PM usecases over HTTPS
+Server that is used in Bulk PM usecases over HTTPS
 
-   **What does it do?**
+**What does it do?**
 
-   - Supports TLS (CMPv2) method of authentication (used during connection to Data File Collector)
-   - Allows to use custom certificates
-   - Exposes REST API in order to manage PM files stored in HTTPS server
+- Supports TLS (CMPv2) method of authentication (used during connection to Data File Collector)
+- Allows to use custom certificates
+- Exposes REST API in order to manage PM files stored in HTTPS server
 
 
 Guides
@@ -113,30 +112,30 @@ Guides
 
 User And Developer Guide
 ------------------------
-User guides:
+1. User guides:
 
-- `VES Client user guide. <https://github.com/onap/integration-simulators-nf-simulator-ves-client/blob/master/README.md>`_
-- `AVCN Manager user guide. <https://github.com/onap/integration-simulators-nf-simulator-avcn-manager/blob/master/README.md>`_
-- `PM HTTPS Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-pm-https-server/blob/master/README.md>`_
-- `Netconf Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/README.md>`_
-- `Netconf Notification Application user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/src/python/README.md>`_
-- `NF Simulator CLI user guide <https://github.com/onap/integration-simulators-nf-simulator/blob/master/simulator-cli/README.md>`_
+   - `VES Client user guide. <https://github.com/onap/integration-simulators-nf-simulator-ves-client/blob/master/README.md>`_
+   - `AVCN Manager user guide. <https://github.com/onap/integration-simulators-nf-simulator-avcn-manager/blob/master/README.md>`_
+   - `PM HTTPS Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-pm-https-server/blob/master/README.md>`_
+   - `Netconf Server user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/README.md>`_
+   - `Netconf Notification Application user guide. <https://github.com/onap/integration-simulators-nf-simulator-netconf-server/blob/master/src/python/README.md>`_
+   - `NF Simulator CLI user guide <https://github.com/onap/integration-simulators-nf-simulator/blob/master/simulator-cli/README.md>`_
 
-Jenkins builds:
+2. Jenkins builds:
 
-- `VES Client jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-avcn-manager/>`_
-- `AVCN Manager jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/>`_
-- `PM HTTPS Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-pm-https-server/>`_
-- `Netconf Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-ves-client/>`_
+   - `VES Client jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-avcn-manager/>`_
+   - `AVCN Manager jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/>`_
+   - `PM HTTPS Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-pm-https-server/>`_
+   - `Netconf Server jenkins builds <https://jenkins.onap.org/view/integration-simulators-nf-simulator-ves-client/>`_
 
-NF Simulator CSIT test cases:
+3. NF Simulator CSIT test cases:
 
-- `Project integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites/>`_
-- `Project integration-simulators-nf-simulator-netconf-server-master-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-csit-testsuites/>`_
+   - `Project integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-verify-csit-testsuites/>`_
+   - `Project integration-simulators-nf-simulator-netconf-server-master-csit-testsuites <https://jenkins.onap.org/view/integration-simulators-nf-simulator-netconf-server/job/integration-simulators-nf-simulator-netconf-server-master-csit-testsuites/>`_
 
-NF Simulator sanity checks:
+4. NF Simulator sanity checks:
 
-- https://github.com/onap/integration-simulators-nf-simulator/tree/master/sanitycheck
+   - https://github.com/onap/integration-simulators-nf-simulator/tree/master/sanitycheck
 
 .. |image1| image:: ../files/simulators/NF-Simulator.png
    :width: 10in
\ No newline at end of file