From 44beaa34486d0624175c42cc3899a0b53befd9a8 Mon Sep 17 00:00:00 2001 From: shivasubedi Date: Mon, 13 Sep 2021 15:16:30 +0100 Subject: Create Preliminary Documentation for CPS-Core & NCMP Create Preliminary documentation for Istanbul release of the CPS-Core. Added new plugins in POM to generate swagger doc for design page. Added latest conf.py file from http://gerrit.onap.org/r/doc Followed template from work done by Chaker here https://wiki.onap.org/display/DW/Component+Documentation+Template Issue-ID: CPS-633 Change-Id: I431776e4d052ec65bf1e1d7709d12d0100592cd5 Signed-off-by: DylanB95EST Signed-off-by: shivasubedi --- docs/release-notes.rst | 130 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 130 insertions(+) (limited to 'docs/release-notes.rst') diff --git a/docs/release-notes.rst b/docs/release-notes.rst index f213c7e4d..797a11cf5 100755 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -1,5 +1,6 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 +.. Copyright (C) 2021 Nordix Foundation .. DO NOT CHANGE THIS LABEL FOR RELEASE NOTES - EVEN THOUGH IT GIVES A WARNING .. _release_notes: @@ -10,11 +11,140 @@ CPS Release Notes ================= +.. warning:: draft + .. contents:: :depth: 2 .. +.. ======================== +.. * * * ISTANBUL * * * +.. ======================== + +Version: 2.0.0 +============== + +Abstract +-------- + +This document provides the release notes for Istanbul release. + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:2.0.0 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 2.0.0 Istanbul | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2021-14-10 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Features +-------- +* Register DMI Plugins with NCMP for CM Handle registrations. +* Update, Create and Remove CM Handles. +* Add support for retrieving and writing CM Handle data through NCMP datastores. +* Automatic retrieval and caching of model information for CM Handles within NCMP. + +.. _istanbul_deliverable: + +Deliverables +------------ + +Software Deliverables + +.. csv-table:: + :header: "Repository", "SubModules", "Version & Docker Image (if applicable)" + :widths: auto + + "cps", "", "onap/cps-and-ncmp-proxy:2.0.0" + +Bug Fixes +--------- + + - `CPS-316 `_ Xpath cannot be created for augmentation data node + - `CPS-336 `_ Ends-with functionality in cpsPath does not conform with standard xPath behavior + - `CPS-367 `_ Get descendent does not support xpaths that end in list values + - `CPS-377 `_ Init ran model validation is failing, error details are not provided + - `CPS-422 `_ REST 404 response returned instead of 400 for POST/PUT/PATCH request types + - `CPS-450 `_ Datanode query using full path to node causes NPE + - `CPS-466 `_ Concurrent requests to create schema sets for the same yang model are not supported + - `CPS-479 `_ Get Nodes API does not always return the object from the root + - `CPS-501 `_ Put DataNode API has missing transaction and error handling for concurrency issues + - `CPS-504 `_ Checkstyle rules are not enforced for cps-ncmp-dmi-plugin + - `CPS-515 `_ Maven build is not failing when test containers are not able to run + - `CPS-520 `_ Fix docker profile in cps-temporal and cps-ncmp-dmi-plugin + - `CPS-524 `_ Issue with CPSData API to add an item to an existing list node + - `CPS-560 `_ Response from cps query using text() contains escape characters + - `CPS-566 `_ Can't access grandparent node through ancestor axis + - `CPS-586 `_ App username and password environment variables are missing from temporal docker compose + +This document provides the release notes for Istanbul release. + +Summary +------- + +Following CPS components are available with default ONAP/CPS installation. + + + * Platform components + + - CPS (Helm charts) + + * Service components + + - CPS Core and NCMP + - CPS Temporal + - DMI Plugin + + * Additional resources that CPS utilizes deployed using ONAP common charts + + - Postgres Database + + +Below service components (mS) are available to be deployed on-demand. + - CPS-TBDMT + + +Under OOM (Kubernetes) all CPS component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster. + +Known Limitations, Issues and Workarounds +----------------------------------------- + - `CPS-524 `_ Issue with CPSData API to add an item to an existing list node + +*System Limitations* + +Limitations to the amount of child nodes that can be added to the fix above. The current limit is 3. + +*Known Vulnerabilities* + +None + +*Workarounds* + +Add recursive method to save list node data to loop through all corresponding child nodes. + +Security Notes +-------------- + +*Fixed Security Issues* + + - `CPS-249 `_ Exception stack trace is exposed + - `CPS-581 `_ Remove security vulnerabilities + +*Known Security Issues* + +Test Results +------------ + * `Integration tests` .. ======================== .. * * * HONOLULU * * * -- cgit 1.2.3-korg