Table of Contents
ETSI Standard Conformation
This proposal conforms to the following ETSI v2.7.1 specifications.
- SOL005: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/02.07.01_60/gs_NFV-SOL005v020701p.pdf
- SOL003: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/02.07.01_60/gs_NFV-SOL003v020701p.pdf
- SOL002: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/02.07.01_60/gs_NFV-SOL002v020701p.pdf
- SOL004: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/004/02.07.01_60/gs_NFV-SOL004v020701p.pdf
- SOL007: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/007/02.07.01_60/gs_NFV-SOL007v020701p.pdf
- SOL001: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/001/02.07.01_60/gs_NFV-SOL001v020701p.pdf
Resource commitment:
- Ericsson: primary contact Byung-Woo Jun
- CMCC: primary contact Yan Yang, Yuanhong Deng
- Verizon: primary contact Former user (Deleted)
- Samsung: primary contact Miroslaw Medrek
Requirement:
- Ericsson: primary contact Byung-Woo Jun
- CMCC: primary contact Yan Yang, Yuanhong Deng
- Verizon: primary contact Former user (Deleted)
- Samsung: primary contact Miroslaw Medrek
- Huawei: primary contact Seshu Kumar Mudiganti
ONAP SO Hierarchical Orchestration Architecture
Rationale & Benefits
Rationale
Many operators have their own ETSI-compliant NFVOs, and there is a strong desire for us to have both ETSI- and ONAP-compliant NFVO. So, we propose the ONAP SO NFVO "platform", which is based on ONAP and leveraging modular and extensible plugin-based microservice API management, such as an enhanced MSB, Gravitee, Kong or Kubernetes. Once we build this NFVO platform in ONAP, operators including us can focus on the proprietary development of truly differentiating value-added capabilities on top of the NFVO platform. We believe this approach provides cost saving over implementation of proprietary code, both for initial development, ongoing standardization support and enhancements.
Note: VFC would be still a valid NFVO reference implementation. And, we want to have this NFVO platform which provides modular and extensible capabilities.
Benefits
- Boosts industry compatibility by leveraging ETSI compliant models, interfaces and package management
- Provides pluggable NFVO functional blocks that are modular and extensible
- Enables Operators to focus on the proprietary development of truly differentiating value-added capabilities on top of ONAP SO NFVO
- Provides cost saving over implementation in proprietary code, both for initial development, ongoing standardization support and enhancements
Hierarchical Orchestration Architecture
The following diagram depicts ONAP SO hierarchical orchestration architecture.
ONAP SO NFVO Function Overlap View in ETSI MANO
- The following diagram depicts the SO NFVO position in ETSI MANO.
NSD Structure that is supported by NS LCM
- The following diagram depicts the NSD structure that NS LCM supports.
- VNF-FG is out of scope from Guilin.
ONAP SO NFVO Architecture & Functions
Target Component Diagram (Not all will be implemented in Guilin)
The following diagram depicts the NFVO component architecture
- NFVO Microservice Plugin Platform provides Microservice registration, discovery and routing.
- Microservice registration will be performed by configuration.
Note:
- we are not building the Microservice service registration, aggregation, discovery and routing engine itself, but we are leveraging the engine's capability (e.g., MSB, API Fabric, Kong, or Kubernetes & service discovery) to offer configuration of NFVO Microservice components access. So, the NFVO Microservice Plugin Platform is the engine + NFVO component configuration.
- If dynamic BPMN deployment is not available in Guilin, it is possible the NS Workflows embed Camunda Engine for Guilin, as a Microservice.
- In the dynamic BPMN deployment case, the NS Workflows would be a WAR file, containing NS BPMNs + Business Logic, and deployed into Camunda Engine.
SO NFVO Sub-Components
- SOL005 NBI Handler
- NS LCM Manager
- NS Workflows & Business Logic
- Shared Camunda Engine
- RIM (Resource Infra Management) Manager
- SOL003 Adapter
- Inventory DB Adapter (for AAI)
- NS LCM DB
- Catalog DB Adapter (for ETSI Catalog Manager)
- MultiCloud Adapter (for MultiCloud)
- Configuration Adapter (not for Guilin)
- Policy Adapter (not for Guilin)
- FM/PM Event Manager (not for Guilin)
- K8S Adapter (not for Guilin)
ONAP SO NFVO Component for Guilin
The following diagram diagram depicts ONAP SO NFVO Component for Guilin.
ONAP SO NFVO Component Deployment View
The following diagrams depict a deployment view of ONAP SO NFVO. There are Plan A and B. The Plan B provides a simpler deployment option and will support the NS Workflow BPMNs migration to the Stand-Alone shared Camunda engine (when ONAP SO support custom Workflow deployment).
Deployment View for Guilin
In the Guilin, SO NFVO will consist of the following PODs:
- NS LCM Mgr
- SOL003 Adapter
- NS LCM DB Mgr (not for Guilin; designed to reuse the VFC NS LCM DB Mgr Microservice, but the VFC Microservice is not yet available for Guilin)
- In Guilin, NFVO database follows ONAP SO Database mechanism.
- Resource Infra Management Mgr (not for Guilin; designed to handle OOF-based resource granting and Or-Vi management, but the OOF-based granting is not available for Guilin)
Guilin SO NFVO Testing
The UUI - SO - E2E Workflows - NS Workflows - SOL005 Adapter sequences are not ready for Guilin. As a result, the Curl Command as the SO NFVO client allows to send SOL005-compliant requests to SO NFVO directly.
Microservice Component Registration
TBD
SOL003 Adapter Registration
The SOL003 Adapter registers itself in the OOM installation
[oom.git] / kubernetes / so / charts / so-vnfm-adapter / templates / service.yaml
1 # Copyright © 2019 Nordix Foundation
2 #
3 # Licensed under the Apache License, Version 2.0 (the "License");
4 # you may not use this file except in compliance with the License.
5 # You may obtain a copy of the License at
6 #
7 # http://www.apache.org/licenses/LICENSE-2.0
8 #
9 # Unless required by applicable law or agreed to in writing, software
10 # distributed under the License is distributed on an "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 # See the License for the specific language governing permissions and
13 # limitations under the License.
14 apiVersion: v1
15 kind: Service
16 metadata:
17 name: {{ include "common.servicename" . }}
18 namespace: {{ include "common.namespace" . }}
19 labels:
20 app: {{ include "common.name" . }}
21 chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
22 release: {{ include "common.release" . }}
23 heritage: {{ .Release.Service }}
24 annotations:
25 msb.onap.org/service-info: '[
26 {
27 "serviceName": "{{ include "common.servicename" . }}",
28 "version": "v1",
29 "url": "/so/vnfm-adapter/v1",
30 "protocol": "REST",
31 "port": "{{.Values.service.externalPort}}",
32 "visualRange":"1"
33 }
34 ]'
35 spec:
36 type: {{ .Values.service.type }}
37 ports:
38 {{if eq .Values.service.type "NodePort" -}}
39 - port: {{ .Values.service.internalPort }}
40 nodePort: {{ .Values.global.nodePortPrefixExt | default .Values.nodePortPrefixExt }}{{ .Values.service.nodePort }}
41 name: {{ .Values.service.portName }}
42 {{- else -}}
43 - port: {{ .Values.service.externalPort }}
44 targetPort: {{ .Values.service.internalPort }}
45 name: {{ .Values.service.portName }}
46 {{- end}}
47 selector:
48 app: {{ include "common.name" . }}
49 release: {{ include "common.release" . }}
Also, it registers itself with MSB.
metadata:
name: {{ include "common.servicename" . }}
namespace: {{ include "common.namespace" . }}
labels:
app: {{ include "common.name" . }}
chart: {{ .Chart.Name }}-{{ .Chart.Version | replace "+" "_" }}
release: {{ include "common.release" . }}
heritage: {{ .Release.Service }}
annotations:
{
"serviceName": "{{ include "common.servicename" . }}",
"version": "v1",
"url": "/so/vnfm-adapter/v1",
"protocol": "REST",
"port": "{{.Values.service.externalPort}}",
"visualRange":"1"
}
]'
Component Interfaces
The following diagram depicts component interfaces.
Note: the blue lines represent interfaces within SO NFVO, and the black lines represent NFVO component interfaces with other ONAP components.
Architecture Presentation Slide Deck and Approval
ONAP Architecture Subcommittee approved this architecture on June 16th 2020.
Implementation Plan For Guilin
Requirements
Support for ETSI NFV NFVO Orchestrator in ONAP SO (ONAP SO ETSI-Aligned Hierarchical Orchestration)
Executive Summary - Enable E2E workflows by orchestrating ETSI NFV compliant Network Services and VNFs. This NFVO should provide an ETSI NFV SOL005 v2.7.1 NBI which can onboard ETSI NFV SOL004 and ETSI NFV SOL007 v2.7.1 compliant packages which then can be Life Cycle Managed and monitored. This NFVO should use an ETSI SOL003 v2.7.1 SBI to invoke an external VNF Manager.
Business Impact - Enables operators and service providers to use Industry standard Orchestration to deploy, manage and monitor network services. Industry compatibility.
Business Markets - All operators and service providers that are developing ETSI compatible Network Services especially for 5G Slicing where each Slice Subnet is associated with a Network Service
Funding/Financial Impacts - Reduction in operations expense from using industry standard ETSI Orchestration.
Organization Mgmt, Sales Strategies -There is no additional organizational management or sales strategies for this requirement outside of a service providers "normal" ONAP deployment and its attendant organizational resources from a service provider.
ONAP SO NFVO Requirements for Guilin
ONAP SO NFVO is a sub-component of SO and provides ETSI NFV-compliant NFVO functions in ONAP, such as ETSI NFVO MANO 1) SOL007, SOL004 and SOL001 Modeling and Package, 2) SOL005-compliant NBI, 3) NS LCM and 4) SOL003-compliant SBI for VNFM invocation.
Note:
For the ONAP SO NFVO, we plan to build:
1) the NFVO platform foundation,
2) SOL005 NBI (based on the forge.etsi.org SOL005 swagger files; we believe it is easy to upgrade for ETSI specification changes),
3) NS LCM Manager leveraging Camunda BPMN with custom workflows support (in the future, possibly design workflows from SDC and associate them with NS models – model-driven),
4) leveraging VFC NS Instance DB microservice and NS LCM business logic, and
5) CNF support hook. Since ONAP SO already has the SOL003 Adapter, for our project, at this time we don’t need VFC gVNFM and VNFM adapting mechanism.
P1: Phase 1 (for Guilin)
P2: Phase 2 (post Guilin)
P3: Phase 3 (future release)
Requirement # | Requirement | Component | Phase |
---|---|---|---|
NFVO.R1 | Provides a NFVO function Microservice plugin framework for hosting NFVO function components by configuration. Note: we are not building the Microservice service registration, aggregation, discovery and routing engine itself, but we are leveraging the engine's capability (e.g., MSB, API Fabric, Kong, or Kubernetes & service discovery) to offer configuration of NFVO Microservice components access. Note: the engine choice is under discussion
| Microservice Plugin Framework (configuration) | P1 |
NFVO.R2 | Supports SOL005-compliant NS LCM (Network Service Lifecycle Management) NBI interfaces for its client such as ONAP SO or SOL005-compliant clients. In Guilin, the following operations will be supported
| SOL005 NBI | P1 |
NFVO.R3 | Supports the ETSI-compliant NS LCM. In Guilin, the following operations will be supported
| NS LCM | P1 |
NFVO.R4 | Sends SOL005-compliant NS LCM notifications to its subscriber, such as ONAP SO or SOL005-compliant clients
| SOL005 NBI | P1 |
NFVO.R5 | Manages (as a client) virtualized resources via interfaces (Or-Vi) exposed by the VIM
| NS RIM Manager | P1 |
NFVO.R6 | Supports Virtual Links and VNF-FG - NS LCM
| NS LCM | P1 |
NFVO.R7 | Manages (as a client) virtualized resource management interfaces (SOL003) thru the existing SOL003 Adapter
| NS LCM, SOL003 Adapter | P1 |
NFVO.R8 | Supports VNF Granting interfaces (SOL003) to the SOL003 Adapter
| NS LCM, NS RIM Manager, SOL003 Adapter | P1 |
NFVO.R9 | Supports VNF lifecycle management (LCM) notifications (SOL003) to the SOL003 Adapter
| NS LCM, SOL003 Adapter | P1 |
NFVO.R10 | Interfaces with ETSI Catalog Manager for SOL004 VNF/PNF and SOL007 NS packages
| NS LCM | P1 |
NFVO.R11 | Supports package management notification interfaces to ETSI Catalog Manager
| NS LCM | |
NFVO.R12 | Supports Communication Security, conforming SOL005 specification
| NS LCM, SOL005 NBI | P1 |
ONAP SO and SOL005 Adapter Requirements
Requirement # | Requirement | Component | Phase |
---|---|---|---|
SOL005.A.R1 | ONAP SO receives E2E (OSS Service-level) requests and parse them and invoke NS workflows per NS Sends SOL005 requests to the ONAP SO NFVO, as one of the choices (SO NFVO, VFC, External NFVO) | SOL005 Adapter | P1 |
SOL005.A.R2 | Subscribes to ONAP SO NFVO for notifications
| SOL003 Adapter | P1 |
SOL005.A.R3 | Provides notification endpoint(s) to receive notifications
| SOL003 Adapter | P1 |
SOL003 Adapter Requirements
Requirement # | Requirement | Component | Phase |
---|---|---|---|
SOL003.A.R1 | SOL003 Adapter will be invoked by SO NFVO | SOL003 Adapter, NS LCM | P1 |
Note:
|
SOL002 Adapter Requirements
Requirement # | Requirement | Component | Phase |
---|---|---|---|
Note:
|
ETSI Catalog Manager Requirements
Requirement # | Requirement | Component | Phase |
---|---|---|---|
ETSI.CATALOG.R1 | ETSI Catalog Manager supports ETSI v.2.7.1 specification
| ETSI Catalog Manager | P1 |
Out of Scope Features from Guilin
The following features are out of scope from Guilin:
- Container Image Management (P2)
- Resource Management, validation and authorization of NFVI resource requests (P2)
- VNF-FGs (P2)
Container Image Management (P2)
- Virtualized Resources Information Management (P2)
Virtualized Resources Capacity Management (P2)
- Virtualized Resources Management (P2)
Virtualized Resources Change Management (P2)
- Virtualized Resources Reservation Management (P2)
Virtualized Resource Quota Management (P2)
- Virtualized Resource Performance Management (P2)
Virtualized Resource Fault Management (P2)
- Network Forwarding Path (NFP) Management (P2)
- Scale NS (POST “/api/nslcm/v1/ns_instances/{nsInstanceId}/scale”) – (P2)
- Heal NS (“POST ”/api/nslcm/v1/ns_instances/{nsInstanceId}/heal”) – (P2)
- VNF Modify (ModifyVnfInfo) (P2)
- VNF Heal (P2)
- VNF Query (P2)
- SOL003 NBI enhancements for GNFC-ready (P2)
- SOL003 Modify, Heal and Scale (P2)
- K8S Adapter (P2)
- FM/PM Event Adapter (P2)
Use Cases
- As a start, vCPE NS use cases plan to be used
- For simplicity, vCPE NS use cases without nested NSDs will be used for initial component testing.
- Network Slicing use cases will be defined for official testing
- TBD
Master Requirement
Support for ETSI NFV NFVO Orchestrator in ONAP SO (ONAP SO ETSI-Aligned Hierarchical Orchestration) | Executive Summary - Enable E2E workflows by orchestrating ETSI NFV compliant Network Services and VNFs. This NFVO should provide an ETSI NFV SOL005 v2.7.1 NBI which can onboard ETSI NFV SOL004 and ETSI NFV SOL007 v2.7.1 compliant packages which then can be Life Cycle Managed and monitored. This NFVO should use an ETSI SOL003 v2.7.1 SBI to invoke an external VNF Manager. Business Impact - Enables operators and service providers to use Industry standard Orchestration to deploy, manage and monitor network services. Industry compatibility. Business Markets - All operators and service providers that are developing ETSI compatible Network Services especially for 5G Slicing where each Slice Subnet is associated with a Network Service Funding/Financial Impacts - Reduction in operations expense from using industry standard ETSI Orchestration. Organization Mgmt, Sales Strategies -There is no additional organizational management or sales strategies for this requirement outside of a service providers "normal" ONAP deployment and its attendant organizational resources from a service provider. | Yes |
---|
Epic and User Story
Epic | User Story | Sub-Task | Description | In Guilin? | JIRA | Size |
---|---|---|---|---|---|---|
Support for NFVO Microservice Plugin (P1) | Support SO NFVO function Microservice plugin capabilities, leveraging MSB, SpringBoot and Kubernetes, for hosting NFVO function components by configuration. So, the SO NFVO can be customized in a future by operators.
Note: we are not building the Microservice service registration, aggregation, discovery and routing engine itself, but we are leveraging the engine's capability (e.g., MSB, API Fabric, Kong, or Kubernetes & service discovery) to offer configuration of NFVO Microservice components access. In Guilin, the following will be supported
| Yes | ||||
<requirements for each SO-NFVO Microservice>
| Support for NFVO Service Registration | Supports NFVO Micro-Service Registration for plugging in microservices
| Yes | |||
<requirements for finding SO-NFVO sub-microservices>
| Support for NFVO Service Discovery | Supports NFVO Micro-Service Discovery with version control
| Yes | |||
<requirements for communication between SO-NFVO sub-microservices>
| Support for NFVO Inter-Service Communication | Supports for NFVO Inter-Service Communication
| Yes | |||
Support for SOL005 NBI API Handler | Preconditions:
Provides SOL005-compliant Restful Northbound APIs for SO/SOL005 Adapter (P1)
| Yes | ||||
Create NS NBI |
Note: secure communication is handled by a separate user story, SO-3165. | Yes | ||||
Instantiate NS NBI |
Note: secure communication is handled by a separate user story, SO-3165. | Yes | ||||
Terminate NS NBI |
Note: secure communication is handled by a separate user story, SO-3165. | Yes | ||||
Delete NS NBI |
Note: secure communication is handled by a separate user story, SO-3165. | Yes | ||||
Get NS Operation Status NBI |
Note: Instantiate NS and Terminate NS use the GET individual NS LCM operation occurrence Note: secure communication is handled by a separate user story, SO-3165. | Yes (Stretch goal; possible to move it to Honolulu) | ||||
Support for SOL005 NBI Subscription APIs | Supports SOL005-compliant Restful Northbound Subscription and Notification APIs for SO/SOL005 Adapter
| No | ||||
Create NS Subscription NBI |
| No | ||||
Get NS Subscription NBI |
| No | ||||
Delete NS Subscription NBI |
| No | ||||
Send NS Notifications (As a Client) |
| No | ||||
Support for secured communication of SOL005 NBI API Handler | Support for secured communication of SOL005 NBI API Handler
| Yes | ||||
Support for NS LCM and Workflows Management | Supports NS LCM and Workflows in SO NFVO(P1)
| Yes | ||||
Create NS LCM and Workflows | Supports the Create NS backend operations and workflows which do the following sequence: <Create NS: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Instantiate NS | Supports the Instantiate NS backend operations and workflows which do the following sequence: <Instantiate NS: note: the following workflow is a template, and it can be enhanced as needed.>
curl -X POST /api/parser/v1/parsernsd' \ -H 'Content-Type: application/json' \ --data-raw '{ "csarId": "csarid", "packageType": "ns", "inputs": "[]" }'
| Yes | ||||
Terminate NS | Supports the Terminate NS backend operations and workflows which do the following sequence: <Terminate NS: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Delete NS | Supports the Delete NS backend operations and workflows which do the following sequence: <Delete NS: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Get NS Operation Status | Supports the Get NS Operation Status operation and workflows which do the following sequence: <Get NS Operation Status: note: the following workflow is a template, and it can be enhanced as needed.> Note: the following workflow is for illustration purpose. Since the operation sequence (sending a query to a database and get the NsLcmOpOcc data, the work flow is not necessary
| Yes | ||||
Create NS Subscription | Supports the Create NS Subscription operation and workflows which do the following sequence: <Create NS Subscription: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Get NS Subscription | Supports the Get NS Subscription operation and workflows which do the following sequence: <Get NS Subscription: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Delete NS Subscription | Supports the Delete NS Subscription operation and workflows which do the following sequence: <Delete NS Subscription: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Send NS Notifications | Supports the Send NS Notification operation and workflows which do the following sequence: <Send NS Notification: note: the following workflow is a template, and it can be enhanced as needed.>
| Yes | ||||
Support for Create VLs | Supports the Create VLs operation and workflows which do the following sequence:
| Yes | ||||
Support for Delete VLs | Supports the Delete VLs operation and workflows which do the following sequence:
| Yes | ||||
Support for Get VLs | Supports the Get VLs operation and workflows which do the following sequence:
| No (could be a stretch goal) | ||||
Support for granting VNF (non OOF-based one) | Supports the granting VNF (non OOF-based one) operation and workflows which do the following sequence:
| Yes | ||||
Support for NS Catalog DB Adapter |
| Yes | ||||
Support for queries for VNF/PNF/NS package management |
| Yes | ||||
Support for notification endpoint for ETSI Catalog Manager notification |
| Yes | ||||
Support for NS Inventory (AAI) Adapter |
| Yes | ||||
Support for NS AAI APIs (CRUD) |
| Yes | ||||
Support for Network AAI APIs (CRUD) |
| Yes | ||||
Support for VNF AAI APIs (CRUD) |
| Yes | ||||
Support for Vserver AAI APIs (CRUD) |
| Yes | ||||
Support for Customer AAI APIs (CRUD) |
| |||||
Support for NS LCM Database Management |
id = models.CharField(db_column='ID', primary_key=True, max_length=200)
nfinstid = models.CharField(db_column='NFINSTID', max_length=200, primary_key=True)
vlinstanceid = models.CharField(db_column='VLINSTANCEID', max_length=255, primary_key=True)
jobid = models.CharField(db_column='JOBID', primary_key=True, max_length=255)
request_id = models.CharField(db_column='REQUESTID', max_length=255)
subscription_id = models.CharField(db_column='SUBSCRIPTIONID', max_length=255, primary_key=True)
id = models.CharField(db_column='ID', max_length=255, primary_key=True)
pnfId = models.CharField(db_column='PNFID', primary_key=True, max_length=255)
service_id = models.CharField(db_column='serviceId', max_length=255, primary_key=True)
service_id = models.CharField(db_column='serviceId', max_length=255)
service_id = models.CharField(db_column='serviceId', max_length=255, primary_key=True) | Yes | ||||
Support for MultiCloud Adapter (P1) |
| Yes | ||||
Support for Create Network to VIM API |
| Yes | ||||
Support for Delete Network (VL) from VIM API |
| Yes | ||||
Package and dynamically deploy NS LCM Workflows with business logic | When ONAP SO support Dynamic BPMN, package and deploy NS LCM workflows with business logic as a WAR file.
| Yes | ||||
Package and deploy default NS LCM workflows with business logic |
| Yes | ||||
Support for UI and REST interfaces for custom workflow war deployment |
| Yes | ||||
Support for NS Resource Infra Management (RIM) Manager (P1 partial) |
| No | ||||
Support for OOF-based Granting VNF |
| No | ||||
Support for Software Image Management |
| No | ||||
Enhance NFVO invocation sequences from UUI to SOL005 Adapter to make ONAP SO SOL005 compliant | SOL005 Adapter supports interfaces to/from ONAP SO NFVO
Note: assign to Verizon | Yes | ||||
<for Future Release> | ||||||
Support for Configuration Adapter (P2) |
| No | ||||
Support for Policy Adapter (P2) |
| No | ||||
Support for OOF Adapter (P1) |
| No | ||||
Supports for Notification Manager (P2) |
| No | ||||
Support for FM/PM Event Adapter (P3) |
| No | ||||
Support for K8S client (P3) |
| No | ||||
ONAP SO NFVO Invocation Sequence
The following SOL005-based Operation sequence flow depicts the SO NFVO invocation architecture.
Create/Instantiate NS Sequences
The following diagram depicts the Create/Instantiate NS.
CreateNS
- Register ONAP SO NFVO into AAI through ESR
- From VID/UUI, invoke the NS LCM
- CreateVFCNSResource.bpmn
- CreateVFCNSResource.groovy
- preProcessRequest()
- Select vfcAdapter/SOL005 Adapter
createNetworkService()
- Populate String reqBody ="""{ "nsServiceName":"${nsServiceName}",
"nsServiceDescription":"${nsServiceDescription}",
"nsServiceModelUUID":"${nsServiceModelUUID}",
"nsOperationKey":${nsOperationKey},
"nsParameters":{
"locationConstraints":${locationConstraints},
"additionalParamForNs":${requestInputs}
}
}""" - Send a request to vfcAdapter/SOL005 Adapter
- vfcAdapterUrl + "/ns/" with reqBody
- Populate String reqBody ="""{ "nsServiceName":"${nsServiceName}",
- preProcessRequest()
- CreateVFCNSResource.groovy
- SOL005Adapter
- createNS()
- Create createNsRequest data
- from the additionalParamForNS, get the NFVO orchestrator
- Query AAI to get a proper NFVO instance
- Prepare CreateNs request header
Map<String, String> requestHeader = new HashMap<>();
requestHeader.put("GLOBALCUSTOMERID", segInput.getNsOperationKey().getGlobalSubscriberId());
requestHeader.put("SERVICETYPE", segInput.getNsOperationKey().getServiceType());
- Send a CreateNS request to ONAP SO NFVO
- Get an nsInstanceId response from SOL005 Adapter
- Save resource operation information
- Add relation between Service and NS in AAI
InstantiateNS
- Register ONAP SO NFVO into AAI through ESR
- From VID/UUI, invoke the NS LCM
- CreateVFCNSResource.bpmn
- CreateVFCNSResource.groovy
- preProcessRequest()
- Select vfcAdapter/SOL005 Adapter
instantiateNetworkService()
Populate String reqBody ="""{
"nsServiceName":"${nsServiceName}",
"nsServiceDescription":"${nsServiceDescription}",
"nsOperationKey":${nsOperationKey},
"nsParameters":${nsParameters}
}"""Send a request to vfcAdapter/SOL005 Adapter
- vfcAdapterUrl + "/ns/" + nsInstanceId + "/instantiate" with reqBody
- preProcessRequest()
- CreateVFCNSResource.groovy
- SOL005Adapter
- instantiateNS()
- Create instantiateNsRequest data
- set VnfLocationConstraint if any
- set additionalParamsForNs
- from the additionalParamForNS, get the NFVO orchestrator
- Query AAI to get a proper NFVO instance
- Prepare CreateNs request header
Map<String, String> requestHeader = new HashMap<>();
requestHeader.put("GLOBALCUSTOMERID", segInput.getNsOperationKey().getGlobalSubscriberId());
requestHeader.put("SERVICETYPE", segInput.getNsOperationKey().getServiceType());
- Send a instantiateNS request to ONAP SO NFVO
- Create instantiateNsRequest data
- Get an response status from SOL005 Adapter
- if 202 successful, get an Job id
- Save resource operation information
- Add relation between Service and NS in AAI
- Get an response status from SOL005 Adapter
Terminate/Delete NS Sequences
The following diagram depicts the Terminate / Delete NS.
Terminate and Delete NS
- Register ONAP SO NFVO into AAI through ESR
- From VID/UUI, invoke the NS LCM
- DeleteVFCNSResource.bpmn
- DeleteVFCNSResource.groovy
- preProcessRequest()
- DoDeleteVFCNetworkServiceInstance.groovy
- preProcessRequest()
- Select vfcAdapter/SOL005 Adapter
String nsOperationKey = """{
"globalSubscriberId":"${globalSubscriberId}",
"serviceType":"${serviceType}",
"serviceId":"${serviceId}",
"operationId":"${operationId}",
"nodeTemplateUUID":"${nodeTemplateUUID}"
}"""
- deleteNSRelationship()
- delete relation between service and resource from AAI
- terminateNetworkService()
- POST vfcAdapterUrl + "/ns/" + nsInstanceId + "/terminate" with nsOperationKey
- preProcessRequest()
- DoDeleteVFCNetworkServiceInstance.groovy
- preProcessRequest()
- Select vfcAdapter/SOL005 Adapter
- String nsOperationKey = """{
"globalSubscriberId":"${globalSubscriberId}",
"serviceType":"${serviceType}",
"serviceId":"${serviceId}",
"operationId":"${operationId}",
"nodeTemplateUUID":"${nodeTemplateUUID}"
}"""
deleteNetworkService()
Send a request to vfcAdapter/SOL005 Adapter
- DELETE vfcAdapterUrl + "/ns/" with nsInstanceId
- preProcessRequest()
- DeleteVFCNSResource.groovy
- SOL005Adapter
- terminateNS()
- Send a terminateNS request to ONAP SO NFVO, with reqBody (terminationTime)
- add operation status to database
- deleteNS()
- Send a deleteNS request to ONAP SO NFVO
- add operation status to database
- deleteNS()
Gaps and Issues
CreateNsRequest
For the Create NS, the CreateNsRequest is sent to SO NFVO.
- nsdId
- nsName
- nsDescription
Also, the current SOL005 Adapter passes the following attributes through HTTP header. This is a workaround, not part of ETSI specification. Maybe, ETSI SOL005 specification needs to be enhanced to allow additional parameters?
- GLOBALCUSTOMERID
- SERVICETYPE
InstantiateNsRequest
For the Instantiate NS, the InstantiateNsRequest is sent to SO NFVO. As part of the InstantiateNsRequest, additionalParamsForNs is passed, but additionalParamsForVnf is NOT passed from the SOL005 Adapter to NFVO. According to ETSI SOL005 specification, multiple additionalParamsForVnf (data type: ParamsForVnf) can be passed. It seems that currently the additionalParams for VNF is constructed based on the vnf properties in NSD.
====================================================================================================================================================================================
Additional Info
ONAP SO NFVO Architecture & Functions
The following diagram depicts the NFVO component architecture
NFVO Microservice Plugin Framework - high priority
- Provides the NFVO function Microservice plugin framework for supporting service registration, discovery and routing by configuration.
- Note: we are not building the Microservice service registration, aggregation, discovery and routing engine itself, but we are leveraging the engine's capability (e.g., MSB, API Fabric, Kong, or Kubernetes & service discovery) to offer configuration of NFVO Microservice components access.
- Default function plugins support (following default plugins will be registered to the Framework; routing will be configured):
- SOL005 NBI (API Handler)
- NS LCM Manager
- ETSI Catalog DB Adapter (for ETSI Catalog Manager)
- Camunda Workflow Engine
- NS Workflows and Logic
- Resource Infra Management (RIM) Manager
- Configuration Adapter
- MultiCloud Adapter
- Inventory DB Adapter
- Notification Manager
- FM/PM Event Adapter (for DCAE)
- K8S Adapter
- Substitution of existing function plugins
- Registration of a new substitution Microservice with version control (leverage a mechanism like AAI ESR/MSR/API Fabric/MSB/Kubernetes/Kong - TBD)
- Plug-in a substitution Microservice
- Dynamic dispatching/launching a new plugin instance based on configuration/policy
- Extension of existing function plugins
- Default function plugin extension with version control
- Dynamic dispatching/launching an extended plugin instance based on configuration/policy
SOL005 NBI (API Handler)- high priority
- Provides SOL005-compliant Restful Northbound APIs for SO/SOL005 Adapter
- Supports NS Lifecycle Management (LCM) APIs
- Create NS (POST “/api/nslcm/v1/ns_instances”)
- Instantiate NS (POST “/api/nslcm/v1/ns_instances/{nsInstanceId}/instantiate”)
- Terminate NS (“/api/nslcm/v1/ns_instances/{nsInstanceId}/terminate”)
- Delete NS (DELETE “/api/nslcm/v1/ns_instances/{nsInstanceId}”)
Scale NS (POST “/api/nslcm/v1/ns_instances/{nsInstanceId}/scale”) – stretch goalHeal NS (“POST ”/api/nslcm/v1/ns_instances/{nsInstanceId}/heal”) – stretch goal- Query NS (GET “/api/nslcm/v1/ns_instances”, “/api/nslcm/v1/ns_instances/{nsInstanceId}”)
- Subscription (POST ”/subscriptions”)
- Notification (SO SOL005 Adapter client-provided; POST notification based on the callbackUrl from the subscription)
- Support NS Fault Management API (stretch goal)
Support NS Performance Management APIs (stretch goal)
- Leverages SOL005 Swagger Files
- https://forge.etsi.org/jenkins/view/All+jobs/job/NFV+-+Network+Functions+Virtualisation/job/sol005-master/
- Provides interfaces with DCAE and Policy for Close Loop Automation
- This API Handler focuses on the SOL005 APIs, and its business logic is supplied by the NS LCM Microservice
- Supports NS Lifecycle Management (LCM) APIs
NS Workflows & Business Logic - high priority
- Provides Workflow engines (stand-alone/clustered Camunda engine) for the NS workflow management
- Supports Stand-Alone/clustered Camunda engine(s) deployment
Allows hot deployment of custom workflow packages while ONAP NFVO is running
- Provides NS workflows
- Provides default NS workflows (part of ONAP NFVO deployment)
- CreateNS bpmn files with business logic
- InstantiateNS bpmn files with business logic
- TerminateNS bpmn files with business logic
- DeleteNS bpmn files with business logic
- Allows custom NS workflows deployment (Hot deployment)
- The Operators build their own workflows and business logic as war files
- The Operators drop off custom workflows war files into the Camunda deployment directory
- UI for the custom workflow war deployment would be supported
- Provides default NS workflows (part of ONAP NFVO deployment)
ETSI Package Onboarding for NFVO - enhancements of current capabilities
- ONAP NFVO leverages the ETSI Catalog Manager as the run-time Catalog Database service provider.
- ETSI NS/VNF/PNF Packages are onboarded and distributed from SDC à ETSI Catalog Manager (note: this is NOT part of NFVO; it is a separate effort)
- ONAP NFVO queries ETSI NS/VNF/PNF Packages from the ETSI Catalog Manager
NS LCM Database - high priority
- Use the VFC NS LCM database
SOL003 Adapter for SVNFMs - leveraging existing capabilities
- Provides SOL003-compliant (Or-Vnfm) Southbound APIs towards SVNFMs
- Supports VNF Lifecycle Management (LCM)
- Create VNF
- Instantiate VNF
- Terminate VNF
- Delete VNF
- Scale VNF
- Heal VNF
- Query VNF
- ModifyInfo VNF
- Subscription
- Notification
- Granting with HPA
- It is a Microservice and part of ONAP SO NFVO
- It is launched by NS Workflows for VNF LCM
- It locates the VNFM instance by leveraging AAI ESR
- Supports VNF Lifecycle Management (LCM)
Resource Infra Management (RIM) Manager - high priority
- Provides Resource Granting Information through OOF (Policy, MultiCloud, A&AI)
- Supports interfaces with OOF to collect Granting information
Collects Homing information from OOF and provides the information to other NFVO components
- Supports Or-Vi Interfaces that provided by VIM, Infrastructure Manager, VIM or CaaS manager (note: for Guilin, many of them would be stretch goals)
- Software Image Management (P1)
Container Image Management (P2)
- Virtualized Resources Information Management (P2)
Virtualized Resources Capacity Management (P2)
- Virtualized Resources Management (P2)
Virtualized Resources Change Management (P2)
- Virtualized Resources Reservation Management (P2)
Virtualized Resource Quota Management (P2)
- Virtualized Resource Performance Management (P2)
Virtualized Resource Fault Management (P2)
- Network Forwarding Path (NFP) Management (P2)
Notification Adapter (not for Guilin)
- Supports general-purpose notification services to its clients such as ONAP SO or SOL005 compliant clients
- TBD
FM/PM Event Adapter (not for Guilin)
TBD
ONAP SO, SOL005 Adapter and NFVO Interaction
Descriptions | |
---|---|
Existing SO E2E Business Logic for VFC/SOL005 Adapter |
|
New ONAP SO NFVO Path |
|
ONAP SO Refactoring for NFVO Function Extraction
Note: to analyze the following further (extracting NS-related operations)
ONAP SO | NFVO |
---|---|
Asdc-controller (scope: Service, NS, VNF, VF-Module) | Asdc-controller for NS, leveraging ETSI Catalog Manager |
API Handler | SOL005 API Handler |
BPMN Infra (scope: Service, NS, VNF, VF-Module) including Workflows with embedded Camunda Workflow engine | NS LCM + Default NS Workflows (with business logic) + Custom NS Workflows (with business logic) Stand-Alone/Clustered Camunda Workflow Engine |
VFC / SOL005 Adapter | Not Applicable |
SOL003 Adapter in SO | SOL003 Adapter in NFVO (move its home) |
Catalog DB Adapter | Leverage ETSI Catalog Manager |
Request DB Adapter (scope: service, NS, VNF, VF-Module) | Request DB Adapter for NS scope |
APPC Orchestrator | Configuration Manager Client |
ve-vnfm-adapter (SOL002 Adapter) | TBD |
sdnc-adapter | TBD |
nssmf-adapter | TBD |
Openstack adapter / MultiCloud adapter | Resource Infra Management (RIM) Manager |
VNF Adapter | Not Applicable (SOL003 Adapter delegates VNF operations to SVNFM) |
K8S Client (PoC) | K8S Adapter |
SO-monitoring | SO-monitoring for NS and VNF |
Common (beans and utils common for all the projects) | Leverage Common as needed |
Close Loop Handling | FM/PM Event Adapter |
Communication Security
- ONAP SO NFVO NBI supports HTTPs and Authentication/Authorization towards SO/SOL005 Adapter.
- ONAP SO NFVO SBI (through SOL003 Adapter) supports HTTPs and Authentication/Authorization towards SVNFMs.
- TBD
Create / Instantiate NS
The following diagram depicts the Create/Instantiate NS.
Create NS
Request
CreateNsRequest
- nsdId
- nsName
- nsDescription
Response
NsInstance
- see NsInstance from ETSI GS NFV-SOL 005 v2.7.1
NS LCM Manager Design
VFC design
get nsdId, nsName and nsDescription, context (globalCustomerId, serivceType) parameters
- get a ns package by the given nsdId from ETSI Catalog Manager
- check if ns instance exists from the NFVO_NSINST database table
- if it exists, log it exists
- create an ns instance id (uuid) and store it with other nsd info, status (NOT_INSTANTIATED) to NFVO_NSINST database table
- create an ns instance record (service-instance-id, service-instance-name, service-type, service-role) in AAI
- get nsInstance from GetNSInfoService
- return 201 Created with the NsInstance
- Send NsIdentifierCreationNotification
Proposal
The following diagram depicts the Create NS procedure.
Instantiate NS
Request
InstantiateRequest
Response
201 Accepted
NsLcmOperationOccurrenceNotification (Start/Processing/Completed)
NS LCM Manager Design
VFC Design
- Get an ns instance id from the parameter
- create a job for the ns instance id
- create an occ id for the ns instance id
- Update the ns instance id row of the NFVO_NSINST database table for status (= INSTANTIATING)
- get a ns instance data from the NFVO_NSINST for the ns instance id
- get and store additional Parameters for NS
- get an VIM id from the cloud owner and cloud region parameters
- get an VNF VIM from he location constraints
- set the job status with 'Start Query NSD'
- get and parse a nsd for the ns package id
- modify nsd state
- get VNF list from the nsd
- for each VNF,
- get vnfd_id, vnfm_type, vimId, s_vimId (with "cloud_owner"_"cloud_regionid")
- select VNFM by leveraging AAI ESR
- store VNF pararms in collection, with vnf info including vnfmInstanceId
- set vl vim id
- for each VNF
- if VNF has dependencies, for each dependency
- add VNF properties and id into vl_vnf array
- if VNF has dependencies, for each dependency
- for each VLs
- get vnfdId and vimId
- add vimId into VL array
- for each VNF
- update NFVO_NSINST with the nsd model
- get PNF parameters
- get VNF parameters (from VNF params above)
- set up Plan Input with job_id, ns_inst_id, tosca plan, additional NS params, VNF params, PNF params)
- start workflows with the job_id, ns_inst, plan_input, occ_id)
- get service template id from ETSI Catalog Manager
- get process id from ETSI Catalog Manager
- workflow run with data (process id, params = plan input)
- createVL
- createVNF
- createSFC (Service Function Chain)
Proposal
The following diagram depicts the Instantiate NS.
Terminate / Delete NS
The following diagram depicts the Terminate / Delete NS.
Terminate NS
Request
TerminateNsRequest
- terminateTime
Response
201 Accepted
NsLcmOperationOccurrenceNotification (Start/Processing/Completed)
NS LCM Manager Design
VFC Design
- Get an ns_inst_d, job_id and request_data from the parameters
- if there no matching ns_inst_id from the NFVO_NSINT database table, consider there is nothing to terminate, and return
- set job status as "Starting terminate..."
- update the ns_inst_id row from the NFVO_NSINST database table with the status = TERMINATING
- cancel SFC list
- get sfc inst array
- for each sfc inst
- DELETE /api/nslcm/v1/ns/sfcs/{instId}
- cancel VNF list
- get vnf inst list array from NFVO_NFINST
- for each vnf inst
- delete_vnf (nf_instid)
- POST /api/nslcm/v1/ns/terminateVnf/{instId}
- delete_vnf (nf_instid)
- for each vnf inst
- get vnf inst list array from NFVO_NFINST
- cancel VL list
- get VL Inst array
- for each VL inst
- DELETE /api/nslcm/v1/ns/vls/{instId}
- cancel PNF list
- get pnf inst array
- for each pnf inst
- DELETE /api/nslcm/v1/pnfs/{instId}
- modify the ns_inst_id row state from the NFVO_NSINST database table
- modify NFVO_NSINST status = NOT_INSTANTIATED
- set job status = NS terminate ends
- Update NsLcmOpOCC to COMPLETED
- Send nsLcmOperationOccurrenceNotification
Proposal
The following diagram depicts the Terminate NS.
Delete NS
Request
- No; just parameter nsInstanceId
Response
- 204 No Content
Notification
- Send NsIdentifierDeletionNotification
NS LCM Manager Design
VFC_Design
- get ns_inst_id
- delete ns instance in AAI
- get ns_instances from NFVO_NSINST database table
- invoke delete_ns_aai with global_customer_id, service_type, ns_inst_id, resource_version
- formulate the resource url with parameters
- call_aaI (resource, "DELETE")
- delete ns_inst_id row from the NFVO_NSINST database table
- delete ns_inst_id row from the NFVO_INPutParamMapping database table
- delete ns_inst_id row from the DefPkgMapping database table
- delete ns_inst_id row from the ServiceBaseInfo database table
- return 204 No Content
- Send NsIdentifierDeletionNotification
Proposal
The following diagram depicts the Delete NS.
Subscription NS
Subscription NS
Request
- LccnSubscriptionRequest
- subscriptionId. for GET and DELETE
Response
- 204 No Content
- 201 Created (LccnSubscription)
- 200 OK (LccnSubscription[])
- 200 OK (LccnSubscription)
Subscription Filter Request
The following table describes the Subscription filter request.
attribute name | data type | cardinality | description |
---|---|---|---|
nsdIds | Identifier | 0..N | If present, match NS instances that were created based on an NSD identified by one of the nsdId values listed in this attribute. See note 1. |
vnfdIds | Identifier | 0..N | If present, match NS instances that contain VNF instances that were created based on a VNFD identified by one of the vnfdId values listed in this attribute. See note 1. |
pnfdIds | Identifier | 0..N | If present, match NS instances that contain PNFs that are represented by a PNFD identified by one of the pnfdId values listed in this attribute. See note 1. |
nsInstanceId | Identifier | 0..N | If present, match NS instances with an instance identifier listed in this attribute. See note 2. |
nsInstanceNames | String | 0..N | If present, match NS instances with an NS Instance Name listed in this attribute. See note 2. |
NOTE 1: The attributes "nsdIds", "vnfdIds" and "pnfdIds" are alternatives to reference to NS instances that are created based on certain NSDs, or contain VNF instances that are based on certain VNFDs, or contain PNFs that are based on certain PNFDs in a filter. They should not be used together in the same filter instance, but one alternative should be chosen. NOTE 2: The attributes "nsInstanceIds" and "nsInstanceNames" are alternatives to reference to particular NS Instances in a filter. They should not be used both in the same filter instance, but one alternative should be chosen. |
NS LCM Manager Design
VFC Design
- create subscription id
- check callback Uri
- check filter types
- save subscription request to database
- return response with subscription
Proposal
The following diagram depicts the Subscription NS.