Goal

Migrate PNF PNP workflow to Building Blocks (BBs/GR_API).
Include newly created BBs in Service-Macro-Create flow.
Leave legacy implementation using VNF_API intact.

By PNF PNP workflow we understand 2 BPMNs:

CreateAndActivatePnfResource
ConfigurePnfResource

Both included in CreateVcpeResCustService_simplified BPMN

JIRA

SO-2556: Migrate PNF PNP workflow to Building Blocks (CreateAndActivatePnfResource only)Closed

SO-2785: Migrate PNF PNP workflow to Building Blocks (Guilin enhancements)Closed

VID-693: VID support for PNF PnP: use Modern UIClosed

Involved parties

Lukasz Grech, Damian Nowak - PNF PNP workflow migration to BBs
Oskar Malm - ConfigurePnfResource.bpmn (previous, non-BB implementation)
Henry Xie - SO-CDS integration, new API for calling CDS from SO
Yuriy Malakov - CDS, SO-CDS integration
Rahul Tyagi - PNF SW upgrade, SO-CDS integration

Proposed building blocks

AssignPnfBB

Responsibility:
- Creates PNF entry in AAI (with PNF name chosen by user)
- Additionally stores PNF model-related parameters in AAI (SO-2640: AssignPnfBB - store model related PNF parameters in AAIClosed):
  - model-customization-id
  - model-invariant-id
  - model-version-id
- Makes a link in AAI between Service entry and PNF entry
- Sets PNF orchestration status in AAI to Assigned
Currently implemented in CreateAndActivatePnfResource.bpmn

WaitForPnfReadyBB

Responsibility:
- Waits for "PNF ready" event sent from PRH to DMaaP
  - pnfCorrelationId from the event must match PNF instance name provided by the user during service instantiation
- Sets PNF orchestration status in AAI to:
  - Register - when starting to wait for PNF ready event
  - Registered - when PNF ready event is successfully received
Currently implemented in CreateAndActivatePnfResource.bpmn

Support for config assign (ControllerExecutionBB, action: configAssign)

SO-2646: Support for PNF config assignClosed

Responsibility:
- Runs config assign via CDS
Currently implemented in ConfigurePnfResource.bpmn
We will reuse generic BPMN for calling CDS (ControllerExecutionBB)
Things to consider:
- SkipPostInstantiationConfiguration should be taken into account

Support for config deploy (ControllerExecutionBB, action: configDeploy)

SO-2647: Support for PNF config deployClosed

Responsibility:
- Runs config deploy via CDS
Currently implemented in ConfigurePnfResource.bpmn
We will reuse generic BPMN for calling CDS (ControllerExecutionBB)
Things to consider:
- SkipPostInstantiationConfiguration should be taken into account

ActivatePnfBB

Responsibility:
- Sets PNF orchestration status in AAI as Active

Sequence in Service-Macro-Create flow

AssignServiceInstanceBB
CreateNetworkCollectionBB
AssignNetworkBB
AssignVnfBB
AssignVolumeGroupBB
AssignVfModuleBB
AssignPnfBB
WaitForPnfReadyBB
ControllerExecutionBB (action: configAssign, scope: pnf)
ControllerExecutionBB (action: configDeploy, scope: pnf)
ActivatePnfBB
ConfigAssignVnfBB
CreateNetworkBB
ActivateNetworkBB
CreateVolumeGroupBB
ActivateVolumeGroupBB
CreateVfModuleBB
ActivateVfModuleBB
ConfigDeployVnfBB
ActivateVnfBB
ActivateNetworkCollectionBB
ActivateServiceInstanceBB

SO - required changes

API handler

GR API

SO API currently doesn't allow to send PNF information in user data section.

Here's the proposed request which includes PNFs:

{
    "requestDetails":{
        "modelInfo":{
            "modelInvariantId":service_model_invariant_uuid,
            "modelVersionId":service_model_uuid,
            "modelName":service_model_name,
            "modelType":"service",
            "modelVersion":"1.0"
        },
        "owningEntity":{
            "owningEntityId":"3fa3e96c-dd51-4c77-818d-f130b613f1f8",
            "owningEntityName":"OE-Demonstration"
        },
        "subscriberInfo":{
            "globalSubscriberId":"Demonstration"
        },
        "requestInfo":{
            "instanceName":service_instance_name,
            "productFamilyId":"ff9262e1-5e31-48dc-aa71-e3f0a7ba1b8c",
            "source":"VID",
            "suppressRollback": False,
            "requestorId":"demo"
        },
        "requestParameters":{
            "subscriptionServiceType":"vFW",
            "aLaCarte": False,
            "userParams":[
                {
                    "service":{
                        "modelInfo":{
                            "modelVersionId":service_model_uuid,
                            "modelName":service_model_name,
                            "modelType":"service"
                        },
                        "instanceName":service_instance_name,
                        "instanceParams":[],
                        "resources":{
                            "pnfs":[
                                {
                                    "modelInfo":{
                                        "modelCustomizationName":nf_resource_name,
                                        "modelCustomizationId":nf_resource_uuid,
                                        "modelInvariantId":nf_model_invariant_uuid,
                                        "modelVersionId":nf_model_uuid,
                                        "modelName":nf_model_name,
                                        "modelType":"pnf",
                                        "modelVersion":"1.0"
                                    },
                                    "platform":{
                                        "platformName":"Platform-Demonstration"
                                    },
                                    "lineOfBusiness":{
                                        "lineOfBusinessName":"LOB-Demonstration"
                                    },
                                    "productFamilyId":"ff9262e1-5e31-48dc-aa71-e3f0a7ba1b8c",
                                    "instanceParams":[],
                                    "instanceName":nf_instance_name
                                }
                            ]
                        }
                    }
                },
                {
                    "Homing_Solution":"none"
                }
            ]
        }
    }
}

Building Block framework

Service decomposition (Retrieve BB Execution List)

PNFs should be recognized in service model and proper BBs should be assigned for execution.

GeneralBuildingBlock initialization (BB Input Setup)

PNF resources should be properly initialized in GeneralBuildingBlock→ServiceInstance

Generic controller BB working with PNFs

Update will be needed for BBInputSetup and WorkflowAction to support BBs which do not contain PNF in its name. Similarly as it was done for VNFs:
- https://gerrit.onap.org/r/c/so/+/106108
- https://gerrit.onap.org/r/c/so/+/106637

PNF PNP workflow integration with CDS

VID - required changes