Table of Contents
1- Brief Project Overview (brief as it should be known)
This The use case (
, Jira server ONAP JIRA serverId 425b2b0a-557c-3c0c-b515-579789cceedb key REQ-400
) intends to demonstrate the ETSI-Aligned modeling, package distribution, and orchestration by conforming to ETSI NFV. This use case shall support: Jira server ONAP JIRA serverId 425b2b0a-557c-3c0c-b515-579789cceedb key ONAPARC-648
...
- SDC supports SOL004 Package onboarding
- SDC supports SOL007 Design
- SOL007 Onboarding is not yet supported in Honolulu
- ETSI Catalog Manager receives SDC Package notification
- ETSI Catalog Manager gets the original vendor ETSI NS and VNF packages and stores them into its database
- ETSI Catalog Manager sends the package onboarding notification to its subscribers (SO NFVO, SOL003 Adapter, in the future SOL005 Adapter)
- If the SOL004 VNF package embeds Container Images, ETSI Catalog Manager pushes the images to CIR via Docker Registry APIs
- Currently, ETSI Catalog Manager defined this Container Image handling as a stretch goal goal
- If not (due to SDC 2MB Image file size limitation), ETSI Catalog Manager does not handle Container Images. In that case, the operator will upload Container Image(s) to the CIR component directly
- In this case, SOL004 Package metadata will references reference Container Image file(s)
- CIR will be realized by Nexus with Docker Registry (GitHub is under consideration)
- CIR component can be delivered part of ONAP or the operator can leverage their CIR component(s)
- Multiple CIR instances can be used
- Registration CIR into AAI for ETSI Catalog Manager to find a proper instance of CIR
- Access APIs to CIR will be Docker Registry APIs, by conforming to ETSI IFA040/SOL018
- K8S CISM and CIS need to have their own way to find a proper CIR instance to pull Container Images.
- CIR component can be delivered part of ONAP or the operator can leverage their CIR component(s)
- K8S CISM will obtain information on Container Image(s) thru Docker Registry APIs
- K8S CIS will pull Container Image(s) thru Docker Registry APIs
- The Interface between VNFM and K8S CISM will follow K8S APIs
- Interface between VNFM and CISM: use k8s APIs, potential to leverage an alignment with O2-DMS
- Interface between MultiCloud K8s Plugin and CISM: use k8s APIs, potential to leverage alignment with O2-DMS
- VNFM Enhancement (PoC) to invoke CISM on O-Cloud through O2-DMS
- Note: support O2-DMS is a stretch goal; most likely use K8S APIs
- Architecture wiki page: ETSI-Aligned CNF Support - Honolulu
1.2 ONAP SO CNF Orchestration Support
...
- ETSI-Alignment path
- Following ETSI NFV IFA specifications for CNF
- Leveraging and extending existing ONAP ETSI-Alignment Architecture
- Direct Path
- Some think there is no need for the full VNFD for LCM, just Helm Charts and Images; delegate LCM to CISM; it may work for simple CNFs
- Note: there are several cases where a more complete VNFD will be needed, such as 5G Core NFs.
- Collaboration Areas:
- Unified Modeling, Packaging & Onboarding (SDC) – optional VNFD?
- Package Distribution (SDC – ETSI Catalog Manager – CIR)
- Common Components (e.g., CIR, A&AI, CDS)
- Note: CIR will be realized by Nexus with Docker Registry (possibly migrate it to Github), and CIR access APIs will be based on Docker Registry APIs.
...
- SDC
- Enhancements related to ETSI 3.3.1 SOL004 compliant VNF / CNF package onboarding and distribution
- Supports ETSI 3.3.1 VNF with minimum CNF enhancements from 4.1.1
- VNF/CNF Data Model Based on ETSI v3.3.1 SOL001 plus CNF Enhancements
- CSAR Models: ETSI-Alignment VNFD and Example(s)
- Enhancements related to ETSI 3.3.1 SOL007 compliant NSD package Design and Distribution
- Enhancements related to ETSI 3.3.1 SOL004 VNF and SOL007 NS package security
- Architecture Diagram for ETSI package handling and distribution
- SO / SO NFVO
- SO NFVO continues to support the same SOL005 APIs API scope as Guilin: Create NS, Instantiate NS, Terminate NS, Delete NS and Get NS Operation Status.
- In addition, It it will support NSD subscription and notification, interacting with ETSI Catalog Manager
- However, SO NFVO will upgraded ETSI v3.3.1 SOL005 LCM APIs from ETSI v2.7.1 SOL005 LCM APIs
ETSI v3.3.1 SOL005 API swagger
- Use the latest SOL005 API swagger from https://forge.etsi.org/jenkins/view/All+jobs/job/NFV+-+Network+Functions+Virtualisation/job/sol005-master/lastSuccessfulBuild/artifact/build/
- SOL005-NSLifecycleManagement-API.json
- SOL005-NSLifecycleManagementNotification-API.json
- SOL005-NSPackageManagement-API.json
- SOL005-NSPackageMaangementNotification-API.json
- ETSI v3.3.1 SOL003 API swagger
- Use the latest SOL003 API swagger from https://forge.etsi.org/jenkins/view/All%20jobs/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/
- SOL003-VNFLifecycleManagement-API.json
- SOL003-VNFLifecycleManagementNotification-API.json
- SOL003-VNFPackageManagement-API.json
- SOL003-VNFPackageManagementNotification-API.json
- SO NFVO and SOL003 Adapter CSIT will be supported to assist SO E2E Integration testing
- Epics and User Stories: ONAP SO Hierarchical Orchestration (SO NFVO) - Honolulu#EpicandUserStory
- SO NFVO Honolulu Architecture Highlights
- SO NFVO will be invoked by Curl Commands (as SO NFVO Client) since the SOL005 Adapter enhancements are out of scope
- SO NFVO NS Workflow BPMNs and business logic will be packaged as a war file and deployed to ONAP SO Standalone/Clustered Camunda Engine
- Dynamic Orchestration support is a trial goal for Honolulu. In that case, NS Workflow BPMNs and business logic (with Embedded Camunda engine) will be part of SO NFVO, as is
- SO NFVO and SOL003 Adapter communications will be treated as an internal communication via HTTP
- SO NFVO interacts with ETSI Catalog Manager thru MSB for NSD subscription and notification
- Architecture Diagram: ONAP SO Hierarchical Orchestration (SO NFVO) - Honolulu#HonoluluSONFVOTesting
- SO NFVO continues to support the same SOL005 APIs API scope as Guilin: Create NS, Instantiate NS, Terminate NS, Delete NS and Get NS Operation Status.
- SO Interface Update
- The following diagram depicts SO interfaces. The interactions with ETSI Catalog Manager (a.k.a. Modeling etsicalog) are added
- See the link for details, ARC Service Orchestrator Component Description - Honolulu-R8
- ETSI Catalog Manager
- Enhancements related to direct SDC Package distribution support thru SDCE-6
- Enhancements related to NSD Subscription and Notification
- Architectural Relationships and Interfaces support: ARC Modeling Component Description – Honolulu-R8
- Architecture Diagram:
- Enhancements related to Container Image handling is a stretch goal
- Most likely due to SDC 2MB file size limitation, Container Images will be uploaded to the CIR component by the Admin
- i.e., in that case, no impact on ETSI Catalog Manager in Honolulu for Container Image handling
- AAI
- No impacts since the SO NFVO does not support Scaling or Healing
- AAI impacts will be analyzed for the Istanbul release
...
4- If they are modified, are they backwards compatible?
- SDC Onboarding supports one-level backward compatibility.
- For Honolulu release, SDC supports ETSI v3.3.1 and v2.7.1/2.6.1
- SDC data model does not have the version support, the SDC data models will be super-set data structures to hold both versions
- SDC data model version support would be an Istanbul release consideration
6- Interface naming (point to an example)
...
Project | API Dependency | Notes | APi Specs (Swagger) |
---|---|---|---|
SO / SO NFVO | ETSI Catalog Manager Package Management APIs for NS | ETSI Catalog Manager APIs | https://wiki.onap.org/download/attachments/79200593/etsicatalog_API_v1.yaml?version=1&modificationDate=1579574658000&api=v2 |
SOL003 Adapter | ETSI Catalog Manager Package Management APIs for VNF | ETSI Catalog Manager APIs | https://wiki.onap.org/download/attachments/79200593/etsicatalog_API_v1.yaml?version=1&modificationDate=1579574658000&api=v2 |
8- Published API
Project | API | Notes | APi Specs (Swagger) |
---|---|---|---|
SOL003 Adapter | ETSI SOL003 Package Management & LCM APIs | Support APIs for VNFM | https://forge.etsi.org/jenkins/view/All%20jobs/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/ |
9- Reference to the interfaces.
...