From 5ac7f6a7e1054d96cbfe2f52142e16112a9ad617 Mon Sep 17 00:00:00 2001 From: thmsdt Date: Mon, 2 Aug 2021 14:33:13 +0200 Subject: Interactive ONAP Architecture Overview added Issue-ID: DOC-757 Signed-off-by: thmsdt Change-Id: I7946e9db32d899ab97039a7fb62a9c1b213de8f1 --- .../media/onap-architecture-overview-notes.txt | 64 + ...cture-overview-r9-istanbul-interactive-path.svg | 6288 ++++++++++++++++++++ ...chitecture-overview-r9-istanbul-interactive.svg | 3005 ++++++++++ ...ture-overview-r9-istanbul-labels-and-links.xlsx | Bin 0 -> 22974 bytes .../architecture/onap-architecture.rst | 16 +- 5 files changed, 9367 insertions(+), 6 deletions(-) create mode 100644 docs/guides/onap-developer/architecture/media/onap-architecture-overview-notes.txt create mode 100644 docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive-path.svg create mode 100644 docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive.svg create mode 100644 docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-labels-and-links.xlsx (limited to 'docs') diff --git a/docs/guides/onap-developer/architecture/media/onap-architecture-overview-notes.txt b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-notes.txt new file mode 100644 index 000000000..4e12cdd47 --- /dev/null +++ b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-notes.txt @@ -0,0 +1,64 @@ +ONAP ARCHITECTURE OVERVIEW NOTES + +Version 0.9, 2021-07-19 + +This file contains information about how the map and its interactive functions were realized in Inkscape and how it can be maintained. + +The map was designed in Inkscape 1.1 running on Ubuntu 20.04. + +The following fonts, styles and spacings are used: +sans-serif, bold, 18 pt +sans-serif, bold, 9 pt +sans-serif, normal, 18 pt +sans-serif, normal, 9 pt +spacing between baselines: 1,05 lines +spacing between letters: -0,35 px +spacing between words: -1,00 px + +Drawing: Rectangles have a stroke (width 2 or 4 mm). To avoid that the stroke rezizes in case you rezize the single rectangle, have a look at the Inkscape button "When scaling objects, scale the stroke width by the same proportion" and turn it off! But turn it on, if you like to scale the complete (grouped) map because you need it in a smaler size. + +Rezising: If you need to resize a grouped object (with a label) do not resize the full group because then also the label will resized and distorted. Select only the form you want to resize in the "Objects" window. Then rezize it according your needs. You do not have to ungroup label/form for this action! + +Text Alignment: Do not align text in a rectangle manually! Create a rectangle which has a stroke (2 mm, 4 mm) in the same color as the box, create text, format text, select both, box and text and choose menu "Text - Flow into Frame". Thats it! The stroke acts as a border. + +Open the "Objects" window (Objects - Objects) and use it as your central point to select objects. Try to avoid ungrouping objects. + +Open the "Objects Properties" window (Objects - Objects Properties) to see and change properties of the object. + +Text to Path: To avoid display problems caused of missing fonts you should release the map only when all characters are rendered as pathes. To do so, do all changes in the "master file" of this map. Save it, select all elemets (STRG-A) and choose "Path - Objects to Path" and save it again with a new name (e.g. map-path.svg). All character are now converted to pathes - and are not editable via the text edit tool anymore! But the map is expected to be rendered on every target system in the same way. Path conversion can not be undone - so store the "master file" carefully. Unfortunately the label-text in the map can not be searched anymore. + +Group the rectangle and the label first, then add the link. Otherwise the link is used only for the rectangle or the label and mouseover will not work properly. + +If you have added a link to a group, ungrouping deletes the link without a warning! Do not ungroup unless you are aware of what you will loose! + +Grouping / Link: To add a link to an object, first check that label and form are grouped before you add a link. Select the grouped object and use "Create Link" of the Context Menu. Now a new element/group is created. Rename it to something meaningful in the "Objects" window. Then use the "Objects attributes" window to add the link for this new element in the field "Href". +See also: +https://inkscape.org/doc/tutorials/tips/tutorial-tips.html +https://www.petercollingridge.co.uk/tutorials/svg/interactive/ + +Mouseover Text: Add mouseover-text to the field "Title:" in the "Objects attributes" window. + +Keep the structure of map elements clear and maintainable by using groups and proper labels for all of the objects. The name of an element or group must be changed manually in the "Objects" window. +Example elements and structure: ++---designtime group that groups all designtime elements (visible and non-visible) of the map (not visible, manually created for reasons of clarity) + +--- ... other elements + +---designtime.link group were values for interactivity (e.g. link, text, opacy effects) are assigned to (created by inkscape when you choose "Create Link") + +---designtime group for the label and rectangle (not visible, manually created, required to have interactivity for both elements - rectangle and label) + +---designtime.label label on top of the rectangle (visible, manually created) + +---designtime.form rectangle for the architecture element (visible, manually created) + +Interactive Links and Tooltip Text in "Object Attributes": +Href: +https://docs.onap.org/ +Title: +Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. + +Mouse-Over Effect in "Object Properties" at "Interactivity": +onmouseover: +style.opacity = 0.6; +onmouseout: +style.opacity = 1.0; + +NOT USED - Links in "Object Properties / Interactivity": +onlick: +window.open("https://docs.onap.org/","_blank"); diff --git a/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive-path.svg b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive-path.svg new file mode 100644 index 000000000..794c5590b --- /dev/null +++ b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive-path.svg @@ -0,0 +1,6288 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive.svg b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive.svg new file mode 100644 index 000000000..d952d10c4 --- /dev/null +++ b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-interactive.svg @@ -0,0 +1,3005 @@ + + + + + + + + + + + + + + + + + + + + + + + + + Unmaintained ONAP Component + + + + Entirety of ONAP Components + + + + Operations + + + + Orchestration & Management + + + + Design + + + + LEGEND + + + + + + + Managed Environment + + + + + IP + MPLS + + + + PublicCloud + + + + PrivateDC Cloud + + + + PrivateEdge Cloud + + + + + + Hypervisor / OS Layer + + + + OpenStack + + + + Commercial VIM + + + + Kubernetes + + + + Public Cloud + + + + + + Network Function Layer + + + + + PNF + + + + VNF + + + + + + External Systems + + + + 3rd Party Controllers + + + + sVNFM + + + + EMS + + + + + + + + + + + Utilities + + + + + + + ONAP Shared Utilities + + + + + + TOSCA Parser + + + + + + Model Utilities + + + + + + Common Controller SDK (CCSDK) + + + + + + + + + Manage ONAP + + + + + + ONAP Operation Manager (OOM) + + + + + + + + Design-Time + + + + + + + Service Design & Creation +(SDC) + + + + + + Catalog + + + + + + DCAE Design Studio + + + + + + Controller Design Studio (CDS) + + + + + + Workflow Designer + + + + + + xNF Onboarding + + + + + + Service/xNF Design + + + + + + + + VNF Validation + + + + + + VNF SDK + + + + + + VVP + + + + + + + + + Run-Time + + + + + + + Shared Services + + + + + + Config. Persistence Service (CPS) + + + + + + Multi-Site State (MUSIC) + + + + + + Audit (POMBA) + + + + + + Logging + + + + + + Optimization Framework (OOF) + + + + + + Appl. Authoriz. Framework (AAF) + + + + + + + Virtual Function +Controller +(VFC) + + + + + + Application +Controller +(APPC) + + + + + + SDN +Controller +(SDNC) + + + + + + Controller +Design Studio +(CDS) + + + + + + Infrastructure +Adaption +(Multi-VIM / Cloud) + + + + + + + Data Collection, +Analytics & Events +(DCAE) + + + + + + Collectors + + + + + + Correlation (Holmes) + + + + + + + Data Movement as a Platform (DMaaP) + + + + + + Microservice Bus (MSB) + + + + + + + Active & Available +Inventory (AAI) + + + + + + External System Register (ESR) + + + + + + + Service Orchestration (SO) + + + + + + + Policy +Framework + + + + + + Closed Loop Autom. +Platform (CLAMP) + + + + + + + + Interfaces + + + + + + CLI + + + + + + External APIs + + + + + + Use-Case UI (UUI) + + + + + + O&M Dashboard (VID) + + + + + + Portal + + + + + + + + Northbound Interface (NBI) towards OSS, BSS and other + + + + + RELEASE 9 »ISTANBUL« + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-labels-and-links.xlsx b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-labels-and-links.xlsx new file mode 100644 index 000000000..40afbb720 Binary files /dev/null and b/docs/guides/onap-developer/architecture/media/onap-architecture-overview-r9-istanbul-labels-and-links.xlsx differ diff --git a/docs/guides/onap-developer/architecture/onap-architecture.rst b/docs/guides/onap-developer/architecture/onap-architecture.rst index 6ced443f7..7907cf01c 100644 --- a/docs/guides/onap-developer/architecture/onap-architecture.rst +++ b/docs/guides/onap-developer/architecture/onap-architecture.rst @@ -99,19 +99,23 @@ Further, ONAP comes with a functional architecture with component definitions and interfaces, which provides a force of industry alignment in addition to the open source code. -ONAP Architecture -================= +Architecture Overview +===================== The ONAP architecture consists of a design time and run time functions, as well as functions for managing ONAP itself. -**Figure 1 provides a high-level view of the ONAP architecture with its -microservices-based platform components.** +.. tip:: Use the interactive features of the below ONAP Architecture Overview. + Hover with your mouse over an element in the figure for a short description. + Click the element to get forwarded to a more detailed description. -|image1| +.. raw:: html + :file: media/onap-architecture-overview-r9-istanbul-interactive-path.svg +**Figure 1: Interactive high-level view of the ONAP architecture with its +microservices-based platform components.** -Figure 2 below, provides a simplified functional view of the architecture, +The figure below provides a simplified functional view of the architecture, which highlights the role of a few key components: #. ONAP Design time environment provides onboarding services and resources -- cgit 1.2.3-korg