diff options
author | 2017-02-07 13:23:37 -0600 | |
---|---|---|
committer | 2017-02-07 13:23:37 -0600 | |
commit | 572ce78c886cf49bd617a2ff3d96491b22a66f88 (patch) | |
tree | d32e4c9d727ece871ec89f1d47005756ddc2b3c7 /docs/development/overview | |
parent | c04ffff59b770ae32c4691bdc3d3b4363604db78 (diff) |
Updated to use new docs structure WIP
JIRA: COPPER-1
WIP - not sure how to fill in the docs/release/scenarios section
Change-Id: I8684e4647e7b943ca05dc77131a54338ff932b78
Signed-off-by: Aimee Ukasick <aimeeu.opensource@gmail.com>
Diffstat (limited to 'docs/development/overview')
-rw-r--r-- | docs/development/overview/index.rst | 13 | ||||
-rw-r--r-- | docs/development/overview/overview.rst | 94 |
2 files changed, 107 insertions, 0 deletions
diff --git a/docs/development/overview/index.rst b/docs/development/overview/index.rst new file mode 100644 index 0000000..e9c69e0 --- /dev/null +++ b/docs/development/overview/index.rst @@ -0,0 +1,13 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International +.. License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) 2015-2017 AT&T Intellectual Property, Inc + +============================ +OPNFV Copper Danube Overview +============================ + +.. toctree:: + :maxdepth: 1 + + overview.rst diff --git a/docs/development/overview/overview.rst b/docs/development/overview/overview.rst new file mode 100644 index 0000000..2a27e49 --- /dev/null +++ b/docs/development/overview/overview.rst @@ -0,0 +1,94 @@ +============================================== +OPNFV Danube Copper Overview +============================================== + +.. contents:: + :depth: 3 + :local: + +Introduction +------------ + +The `OPNFV Copper <https://wiki.opnfv.org/copper>`_ project aims to help ensure +that virtualized infrastructure and application deployments comply with goals of +the NFV service provider or the VNF designer/user. + +This is the third ("Danube") release of the Copper project. The documentation +provided here focuses on the overall goals of the Copper project and the +specific features supported in the Colorado release. + +Overall Goals for Configuration Policy +-------------------------------------- + +As focused on by Copper, configuration policy helps ensure that the NFV service +environment meets the requirements of the variety of stakeholders which will +provide or use NFV platforms. + +These requirements can be expressed as an *intent* of the stakeholder, +in specific terms or more abstractly, but at the highest level they express: + + * what I want + * what I don't want + +Using road-based transportation as an analogy, some examples of this are shown +below: + +.. list-table:: Configuration Intent Example + :widths: 10 45 45 + :header-rows: 1 + + * - Who I Am + - What I Want + - What I Don't Want + * - user + - a van, wheelchair-accessible, electric powered + - someone driving off with my van + * - road provider + - keep drivers moving at an optimum safe speed + - four-way stops + * - public safety + - shoulder warning strips, center media barriers + - speeding, tractors on the freeway + +According to their role, service providers may apply more specific configuration +requirements than users, since service providers are more likely to be managing +specific types of infrastructure capabilities. + +Developers and users may also express their requirements more specifically, +based upon the type of application or how the user intends to use it. + +For users, a high-level intent can be also translated into a more or less specific +configuration capability by the service provider, taking into consideration +aspects such as the type of application or its constraints. + +Examples of such translation are: + +.. list-table:: Intent Translation into Configuration Capability + :widths: 40 60 + :header-rows: 1 + + * - Intent + - Configuration Capability + * - network security + - firewall, DPI, private subnets + * - compute/storage security + - vulnerability monitoring, resource access controls + * - high availability + - clustering, auto-scaling, anti-affinity, live migration + * - disaster recovery + - geo-diverse anti-affinity + * - high compute/storage performance + - clustering, affinity + * - high network performance + - data plane acceleration + * - resource reclamation + - low-usage monitoring + +Although such intent-to-capability translation is conceptually useful, it is +unclear how it can address the variety of aspects that may affect the choice of +an applicable configuration capability. + +For that reason, the Copper project will initially focus on more specific +configuration requirements as fulfilled by specific configuration capabilities, +as well as how those requirements and capabilities are expressed in VNF and service +design and packaging or as generic policies for the NFV Infrastructure. |