From f28ab8c57e6864917de344d3bf1b867a67933b99 Mon Sep 17 00:00:00 2001 From: Rich Bennett Date: Tue, 16 Jan 2018 16:32:53 -0500 Subject: Create use case example and structure Change-Id: Ia4eff37921ee6d38b86fc3c50176757ef9d56ff8 Signed-off-by: Rich Bennett Issue-ID: DOC-223 --- docs/index.rst | 1 + docs/use-cases/index.rst | 14 +++++++ docs/use-cases/vfw.rst | 99 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 114 insertions(+) create mode 100644 docs/use-cases/index.rst create mode 100644 docs/use-cases/vfw.rst diff --git a/docs/index.rst b/docs/index.rst index 32d9b93f6..fbcb897a9 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -11,6 +11,7 @@ ONAP Documentation release/index guides/onap-developer/index guides/onap-user/index + use-cases/index diff --git a/docs/use-cases/index.rst b/docs/use-cases/index.rst new file mode 100644 index 000000000..cc076b1c5 --- /dev/null +++ b/docs/use-cases/index.rst @@ -0,0 +1,14 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. Copyright 2017 AT&T Intellectual Property. All rights reserved. + +ONAP Use Cases +============== + +Example uses case descriptions and sequence diagrams illustrating +interactions between platform components. + +.. toctree:: + :maxdepth: 1 + + vfw.rst diff --git a/docs/use-cases/vfw.rst b/docs/use-cases/vfw.rst new file mode 100644 index 000000000..bc216502d --- /dev/null +++ b/docs/use-cases/vfw.rst @@ -0,0 +1,99 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. Copyright 2017 AT&T Intellectual Property. All rights reserved. + +vFirewall +========= + +Description +----------- + +Onboarding +---------- + + +.. uml:: + + @startuml + title vFW and vDNS VNF Onboarding (R1)\nvFW and vDNS use the same flows but they are separate VNFs/Services + ONAP_User -> SDC : vFW_vDNS resource onboarding (HEAT) + note right : vFW ( vpg, vfw, vsn)\nvDNS (vpg, vlb,vdns) + DNSScaling (vdns)\nCLAMP not shown + ONAP_User -> SDC : vFW_vDNS service onboarding + ONAP_User -> SDC : vFW_vDNS distribution + ||| + ONAP_User -> SDC : vFW2_vDNS2 resource onboarding (TOSCA) + ONAP_User -> SDC : vFW2_vDNS2 service onboarding + ONAP_User -> SDC : vFW2_vDNS2 distribution + ||| + SDC -> SO : artifact distribution + SDC -> AAI : artifact distribution + SDC -> APPC : artifact distribution + SDC -> SDNC : VNF preload data (vFW_vDNS and vFW2_vDNS2) ? + SDC -> DCAE : Telemetry to Collect and CLAMP triggers + SDC -> Policy : Control Loop Policies (see CLAMP flow) + note left: policy may cut through to Policy GUI + @enduml + +Instantiation +------------- + +.. uml:: + + @startuml + title vFW vDNS Instantiation (R1)\nvFW and vDNS use the same flows but they are separate VNFs/Services + participant UseCaseUI + participant ONAP_User + Participant SDC + Participant VID + Participant SO + UseCaseUI -> AAI : populate cloud inventory + ONAP_User -> VID : vFW_vDNS deployment + VID -> SDC : Lookup VNF artifacts + VID -> AAI : Lookup cloud locations, subscriber + VID -> SO : vFW_vDNS instantiation\n(base modules) + SO -> AAI : inventory update + SO -> SDNC : Generic VNF API\n(reserved) + SO -> Multi_VIM : vFW_vDNS Heat template + ENV file + Multi_VIM -> CloudAPI : vFW_vDNS Heat template + ENV file or\n ARM Tempalte + Parameters + LinuxExtensionScripts + CloudAPI -> Hypervisor : vFW_vDNS Infrastructure instantiation + Hypervisor -> vFW_vDNS : Nova/Neutron Instantiation + Hypervisor -> CloudAPI : complete + CloudAPI -> Multi_VIM : complete + Multi_VIM -> SO : complete + note right : SO may poll for completion + SO -> SDNC: Generic VNF API\n(activated) + note right : on failure from Openstack SO issues rollback to SDNC + SDNC -> AAI : L3 Network resource update + SO -> VID : complete + note right : VID will poll for competion + SO -> Multi_VIM : Replaces Robot HEATBridge to pull data from cloud + Multi_VIM -> CloudAPI : VM data from cloud\n(public cloud will be less than if owner operated) + Multi_VIM -> SO : cloud data + SO -> AAI : Update with cloud data + ||| + ONAP_User -> VID : vFW2_vDNS2 deployment (TOCA based) + VID -> SDC : Lookup VNF artifacts + VID -> AAI : Lookup cloud locations, subscriber + VID -> SO : vFW2_vDNS2 instantiation\n(base modules) + SO -> AAI : inventory update + SO -> SDNC : Generic VNF API\n(reserved) + SO -> Multi_VIM : vFW2_vDNS2 TOSCA template + ENV file + Multi_VIM -> CloudAPI : vFW_vDNS TOSCA template + ENV file or\n ARM Template + Parameters + LinuxExtensionScripts + CloudAPI -> Hypervisor : vFW2_vDNS2 Infrastructure instantiation + Hypervisor -> vFW2_vDNS2 : Nova/Neutron Instantiation + Hypervisor -> CloudAPI : complete + CloudAPI -> Multi_VIM : complete + Multi_VIM -> SO : complete + note right : SO may poll for completion + SO -> SDNC: Generic VNF API\n(activated) + note right : on failure from Openstack SO issues rollback to SDNC + SDNC -> AAI : L3 Network resource update + SO -> VID : complete + note right : VID will poll for competion + SO -> Multi_VIM : Replaces Robot HEATBridge to pull data from cloud + Multi_VIM -> CloudAPI : VM data from cloud\n(public cloud will be less than if owner operated) + Multi_VIM -> SO : cloud data + SO -> AAI : Update with cloud data + @enduml + + -- cgit 1.2.3-korg