docs/sections/architecture.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. _architecture:
   3
   4 Architecture
   5 =============================================
   6
   7 Technology Choices
   8 ------------------
   9 Minizinc provides an open source constraint modeling language/platform for specifying optimization applications.
  10 It contains direct interfaces to COIN-OR CBC, Gurobi and IBM ILOG CPLEX. Additionally, many optimization projects
  11 support minizinc via FlatZinc interfaces. The Minizinc standard library provides a subset of constraints form the
  12 global constraint catalogue as a high-level abstraction that have efficient algorithms implemented by several solvers.
  13
  14 Components of the Core Framework
  15 --------------------------------------------
  16
  17 .. image:: ./diagrams/OSDF-components.png
  18
  19 An overview of the components of the core optimization framework. The OOF utilizes the open source project Minizinc,
  20 which has a solver-independent modeling language and has interfaces to various open source and commercial solvers.
  21 One of the additional benefits of this approach is that by developing a focused set of ONAP-related components,
  22 we can utilize ongoing advances in optimization technologies, as well as adapt other currently available extensions to
  23 Minizinc and related projects. The OOF project aims to build these components with a focus on minimal viable product
  24 for Beijing Release in order to support initial applications and use cases, with subsequent focus on expanding the
  25 platform.
  26
  27 Data Adapter Library
  28 ----------------------
  29
  30 The OOF will provide a library of adapters for common ONAP systems. These can be directly used in data specification
  31 templates of the applications. In the initial release, these will include adapters to Policy, A&AI, Multi-Cloud, and
  32 SDC (additional "stretch goals" for this release include SDN-C, Microservice Bus). As new use cases are implemented,
  33 this library will be augmented by new adapters to other services.
  34
  35 Translation Modules
  36 --------------------------------------------
  37
  38 The OOF will provide modules for translating policies into constraints for the optimization environment. When an
  39 underlying minizinc model is used for optimization, it is translated into a minizinc constraint (either via a data
  40 specification template or directly from policy). For custom optimizers, these constraints will be translated to the
  41 input format expected by the optimizer via the data specification template. The Homing and Allocation Service (HAS;
  42 described in the next section) uses a custom optimization module and hence uses the data specification template approach.
  43
  44 Modeling Support
  45 ----------------------
  46
  47 The OOF provides simple templating system through which users can specify links to different ONAP components, including policy,
  48 A&AI, SDC, etc.
  49
  50
  51 Execution Environment
  52 ------------------------------------------------------------------------
  53
  54 The OOF execution environment contains the minizinc system, along with data/template rendering system that leverages
  55 the adapters to various systems. The flow of execution can be configured via the configuration file for the application
  56 and supports a choice of specific solver or invocations to custom/external solvers.