From c0de5820c2c8141ac8090d1d4bd7c9c7c7464d25 Mon Sep 17 00:00:00 2001 From: krishnaa96 Date: Wed, 20 May 2020 18:47:29 +0530 Subject: Update documentation Issue-ID: OPTFRA-566 Issue-ID: OPTFRA-495 Issue-ID: OPTFRA-543 Issue-ID: OPTFRA-409 Signed-off-by: krishnaa96 Change-Id: If48ec9e054c1bb7e323e23de04930759beb5fcef --- docs/sections/example.rst | 348 +++++++++++++++++++++++++++++----------------- 1 file changed, 218 insertions(+), 130 deletions(-) (limited to 'docs/sections/example.rst') diff --git a/docs/sections/example.rst b/docs/sections/example.rst index a3dd55b..0339236 100644 --- a/docs/sections/example.rst +++ b/docs/sections/example.rst @@ -4,142 +4,230 @@ Example Conductor Templates Example 1 --------- -.. code:: yaml +.. code:: json - name: yyy-yyy-yyyy - files: {} - timeout: 600 - limit: 1 - template: - homing_template_version: '2018-02-01' - parameters: - service_name: '' - service_id: d61b2543-5914-4b8f-8e81-81e38575b8ec - customer_lat: 32.89748 - customer_long: -97.040443 - locations: - customer_loc: - latitude: - get_param: customer_lat - longitude: - get_param: customer_long - demands: - vGMuxInfra: - - inventory_provider: aai - inventory_type: service - service_type: vGMuxInfra-xx - attributes: - customer-id: '' - orchestration-status: '' - model-invariant-id: b3dc6465-942c-42af-8464-2bf85b6e504b - model-version-id: ba3b8981-9a9c-4945-92aa-486234ec321f - service-type: vGMuxInfra-xx - equipment-role: '' - global-customer-id: SDN-ETHERNET-INTERNET - vG: - - inventory_provider: aai - inventory_type: cloud - service_type: 71d563e8-e714-4393-8f99-cc480144a05e - constraints: - affinity_vCPE: - type: zone - demands: - - vGMuxInfra - - vG - properties: - category: complex - qualifier: same - optimization: - minimize: - sum: - - product: - - '1' - - distance_between: - - customer_loc - - vGMuxInfra - - product: - - '1' - - distance_between: - - customer_loc - - vG + { + "name": "yyy-yyy-yyyy", + "files": {}, + "timeout": 600, + "limit": 1, + "num_solutions": 10, + "template": { + "homing_template_version": "2018-02-01", + "parameters": { + "service_name": "", + "service_id": "d61b2543-5914-4b8f-8e81-81e38575b8ec", + "customer_lat": 32.89748, + "customer_long": -97.040443 + }, + "locations": { + "customer_loc": { + "latitude": { + "get_param": "customer_lat" + }, + "longitude": { + "get_param": "customer_long" + } + } + }, + "demands": { + "vGMuxInfra": [ + { + "inventory_provider": "aai", + "inventory_type": "service", + "service_type": "vGMuxInfra-xx", + "attributes": { + "customer-id": "", + "orchestration-status": "", + "model-invariant-id": "b3dc6465-942c-42af-8464-2bf85b6e504b", + "model-version-id": "ba3b8981-9a9c-4945-92aa-486234ec321f", + "service-type": "vGMuxInfra-xx", + "equipment-role": "", + "global-customer-id": "SDN-ETHERNET-INTERNET" + } + } + ], + "vG": [ + { + "inventory_provider": "aai", + "inventory_type": "cloud", + "service_type": "71d563e8-e714-4393-8f99-cc480144a05e" + } + ] + }, + "constraints": { + "affinity_vCPE": { + "type": "zone", + "demands": [ + "vGMuxInfra", + "vG" + ], + "properties": { + "category": "complex", + "qualifier": "same" + } + } + }, + "optimization": { + "minimize": { + "sum": [ + { + "product": [ + "1", + { + "distance_between": [ + "customer_loc", + "vGMuxInfra" + ] + } + ] + }, + { + "product": [ + "1", + { + "distance_between": [ + "customer_loc", + "vG" + ] + } + ] + } + ] + } + } + } + } -Example 1 +The example template is for the placement of vG and vGMuxInfra. It has +an affinity constraint which specifies that both the vnfs must be in +the same complex. The optimiation here is to minimize the sum of the +distances of the vnfs from the customer location. + +Example 2 --------- -.. code:: yaml +.. code:: json + + { + "files": {}, + "limit": 1, + "num_solutions": 10, + "name": "a2e3e0cc-3a97-44fc-8a08-1b86143fbdd3", + "template": { + "constraints": { + "affinity_vCPE": { + "demands": [ + "vgMuxAR", + "vGW" + ], + "properties": { + "category": "complex", + "qualifier": "same" + }, + "type": "zone" + }, + "distance-vGMuxAR": { + "demands": [ + "vgMuxAR" + ], + "properties": { + "distance": "< 500 km", + "location": "customer_loc" + }, + "type": "distance_to_location" + }, + "distance-vGW": { + "demands": [ + "vGW" + ], + "properties": { + "distance": "< 1500 km", + "location": "customer_loc" + }, + "type": "distance_to_location" + } + }, + "demands": { + "vGW": [ + { + "attributes": { + "model-invariant-id": "782c87a6-b712-47d1-9c5b-1ea2cd9a2dd5", + "model-version-id": "9877dbbe-8ada-40a2-8adb-f6f26f1ad9ab" + }, + "inventory_provider": "aai", + "inventory_type": "cloud", + "service_type": "c3e0e82b-3367-48ce-ab00-27dc2e91a34a" + } + ], + "vgMuxAR": [ + { + "attributes": { + "global-customer-id": "SDN-ETHERNET-INTERNET", + "model-invariant-id": "565d5b75-11b8-41be-9991-ee03a0049159", + "model-version-id": "61414c6c-6082-4e03-9824-bf53c3582b78" + }, + "inventory_provider": "aai", + "inventory_type": "service", + "service_type": "46b29078-8442-4ea3-bea6-9199a7d514d4" + } + ] + }, + "homing_template_version": "2017-10-10", + "locations": { + "customer_loc": { + "latitude": { + "get_param": "customer_lat" + }, + "longitude": { + "get_param": "customer_long" + } + } + }, + "optimization": { + "minimize": { + "sum": [ + { + "product": [ + "1", + { + "distance_between": [ + "customer_loc", + "vgMuxAR" + ] + } + ] + }, + { + "product": [ + "1", + { + "distance_between": [ + "customer_loc", + "vGW" + ] + } + ] + } + ] + } + }, + "parameters": { + "customer_lat": 32.89748, + "customer_long": 97.040443, + "service_id": "0dbb9d5f-27d9-429b-bc36-293e9fab7731", + "service_name": "" + } + }, + "timeout": 600 + } + +This is similar to the first example except that it has an additional distance +constraint which specifies that the distance of each vnf from the customer +location must be less than 500km. - files: {} - limit: 1 - name: a2e3e0cc-3a97-44fc-8a08-1b86143fbdd3 - template: - constraints: - affinity_vCPE: - demands: - - vgMuxAR - - vGW - properties: - category: complex - qualifier: same - type: zone - distance-vGMuxAR: - demands: - - vgMuxAR - properties: - distance: "< 500 km" - location: customer_loc - type: distance_to_location - distance-vGW: - demands: - - vGW - properties: - distance: "< 1500 km" - location: customer_loc - type: distance_to_location - demands: - vGW: - - attributes: - model-invariant-id: 782c87a6-b712-47d1-9c5b-1ea2cd9a2dd5 - model-version-id: 9877dbbe-8ada-40a2-8adb-f6f26f1ad9ab - inventory_provider: aai - inventory_type: cloud - service_type: c3e0e82b-3367-48ce-ab00-27dc2e91a34a - vgMuxAR: - - attributes: - global-customer-id: SDN-ETHERNET-INTERNET - model-invariant-id: 565d5b75-11b8-41be-9991-ee03a0049159 - model-version-id: 61414c6c-6082-4e03-9824-bf53c3582b78 - inventory_provider: aai - inventory_type: service - service_type: 46b29078-8442-4ea3-bea6-9199a7d514d4 - homing_template_version: '2017-10-10' - locations: - customer_loc: - latitude: - get_param: customer_lat - longitude: - get_param: customer_long - optimization: - minimize: - sum: - - product: - - '1' - - distance_between: - - customer_loc - - vgMuxAR - - product: - - '1' - - distance_between: - - customer_loc - - vGW - parameters: - customer_lat: 32.89748 - customer_long: 97.040443 - service_id: 0dbb9d5f-27d9-429b-bc36-293e9fab7731 - service_name: '' - timeout: 600 - Contact ------- Shankar Narayanan shankarpnsn@gmail.com -a \ No newline at end of file +a -- cgit 1.2.3-korg