From b857497690e83a04ff496edb2a0ec582ac67e394 Mon Sep 17 00:00:00 2001 From: Hagop Bozawglanian Date: Mon, 12 Aug 2019 21:31:58 +0000 Subject: VNFRQTS - Changing diagrams to PlantUML Issue-ID: VNFRQTS-695 Signed-off-by: Hagop Bozawglanian Change-Id: Ib4261b63307cddace7d5b41eef22fec2dfec821e --- docs/index.rst | 1 + docs/manual_use_case.rst | 173 ++++++++++++++++++++++++++++++++++++++++++++--- 2 files changed, 165 insertions(+), 9 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index 81f5afc..cac7090 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -18,6 +18,7 @@ VNF Provider Use Cases .. toctree:: :titlesonly: + :numbered: manual_use_case diff --git a/docs/manual_use_case.rst b/docs/manual_use_case.rst index 6bf2023..ce0cafc 100644 --- a/docs/manual_use_case.rst +++ b/docs/manual_use_case.rst @@ -12,19 +12,178 @@ See the License for the specific language governing permissions and limitations under the License. -.. contents:: - :local: - Manual Scale Out Use Case ========================= +.. contents:: Table of Contents + :depth: 4 + :backlinks: entry + + +Overview +-------- + In the Casablanca release, ONAP will support the ability to both manually and automatically scale out a VNF component. Below is the sequence diagram for how scaling will work. -|scale_out_design_time| -|scale_out_run_time| +Design Time Diagram +^^^^^^^^^^^^^^^^^^^ + +.. uml:: + :align: center + :caption: **Scale Out Sequence Diagram** - Design Time + + @startuml + + title Message Style - Scale Out Sequence Diagram - Design Time + + skinparam sequenceMessageAlign center + + Participant "Service Designer" as SD + Participant SDC + Participant CLAMP + Participant CDT + Participant APPC + Participant SDNC + Participant Policy + Participant SO + Participant DCAE + + SD -> SDC: Onboarding Package + SD -> SDC: Set Scaling Parameters + + SDC -> SO: Send Heat Templates and Image Files + SDC -> SDNC: Send Heat Templates and Image Files + SDC -> SDNC: Send Preload files + SDC -> DCAE: Threshold Scaling Events + + SD -> CLAMP: Gaurd Policies + SD -> CLAMP: Operational Policies + SD -> CLAMP: Configuration Data + + CLAMP -> Policy: Send Policies to Policy Engine Including VNF Configuration Data and VF_Module Name + + SD -> CDT: Parameter definition template for each LCM action (ConfigScaleOut, Healthcheck) + + CDT -> APPC: Save Parameter Definition Template to APPC + + @enduml + + + +Run Time Diagram +^^^^^^^^^^^^^^^^ + +.. uml:: + :align: center + :caption: **Scaling Use Case Sequence Diagram** - Run Time + + @startuml + + title Message Style - Scaling Use Case Sequence Diagram - Run Time + + skinparam sequenceMessageAlign center + + Participant DCAE + Participant Policy + Participant VID + Participant SO + Participant Controller + Participant SDNC + Participant AAI + Participant VNF + + group Manual Scaling + VID -> SO: Manual Scale Out Request\n(Via DMaaP) + end + + group Closed Loop Scaling + DCAE -> Policy: Trigger Scale Out Event + activate Policy + ||| + Policy -> Policy: Sanity Check (Guard Policies) + ||| + Policy -> SO: Closed Loop Scale Out Request + deactivate Policy + activate SO + end + + group Healthcheck + SO -> AAI: Retrieve VNF Level ipv4-oam-address + note left + Prerequisite: Heatbridge will update + AAI with all IP addresses on initial + instantiation + end note + AAI -> SO: Return VNF Level ipv4-oam-address + ||| + SO -> SO: Controller Look up + activate Controller + SO -> Controller: Healthcheck + Controller -> VNF: Healthcheck (REST) + deactivate Controller + end + + group Instantiation + SO -> AAI: Create VF-Module in AAI + note left + Homing and Capacity is + not shown in this + diagram. If H&C check is + done then SO will call + OOF prior to calling + SDNC for resource + assignment. + end note + activate AAI + deactivate AAI + SO -> SDNC: VF-Module Resource Assignment + activate SDNC + SDNC -> SDNC: Heat & Resource Assignment + ||| + SDNC -> AAI: Create VF-Module Relationship & Retrieve Networks + deactivate SDNC + SO -> VNF: Create VF_Module in Cloud environment via Heatstack + note left + SO will call the Rainy Day + Handling and/or Manual + Handling building blocks + whenever it detects a + failure in the WorkFlow + end note + SO -> AAI: Update the Heatstack ID + end + + group Configuration + SO -> SDNC: Request Configuration Parameter Values + SDNC -> SO: Return Configuration Parameter Values + ||| + SO -> SO: Build ConfigScaleOut Payload + SO -> SO: Contoller Look up + SO -> Controller: ConfigScaleOut + activate Controller + Controller -> Controller: Construct VNF ScaleOut Request + Controller -> VNF: Configure VNF (Netconf) + deactivate Controller + end + + group Healthcheck + SO -> AAI: Retrieve VNF Level ipv4-oam-address + AAI -> SO: Return VNF Level ipv4-oam-address + ||| + SO -> SO: Controller Look up + activate Controller + SO -> Controller: Healthcheck + Controller -> VNF: Healthcheck (REST) + deactivate Controller + deactivate SO + end + + @enduml + + Description of Workflow ----------------------- @@ -85,7 +244,3 @@ support the following functionality: 3. Configuration of the VNF must be done via NETCONF, Chef, or Ansible as described in the :ref:`vnf_configuration_management` - -.. |scale_out_design_time| image:: manual_scale_out_design_time.png - -.. |scale_out_run_time| image:: manual_scale_out_run_time.png -- cgit 1.2.3-korg