X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fguides%2Fonap-user%2Fdesign%2Fservice-design%2Findex.rst;h=ce7fb9a3c9736a14fe84c553f29dbe490cbad43f;hb=295d3210ec42389a39b9052a0ef81b7942ef2c86;hp=dcc6b9c629238bd1eca21aa4693f45502496545d;hpb=b1a0c9d80ecf994f3f086196dab26a8824736041;p=doc.git diff --git a/docs/guides/onap-user/design/service-design/index.rst b/docs/guides/onap-user/design/service-design/index.rst index dcc6b9c62..ce7fb9a3c 100644 --- a/docs/guides/onap-user/design/service-design/index.rst +++ b/docs/guides/onap-user/design/service-design/index.rst @@ -2,15 +2,19 @@ .. International License. http://creativecommons.org/licenses/by/4.0 .. Copyright 2019 ONAP Contributors. All rights reserved. +.. _doc_guide_user_des_ser-des: + Service Design ============== **Goal:** Add models and other artifacts required to create, configure, instantiate, and manage services. Validate and certify the services. +Besides the manual creation of a Service Model, an existing model can +be imported via a CSAR file **Tool:** SDC -**SDC user roles:** Designer, Tester +**SDC user roles:** Designer |image1| @@ -18,34 +22,38 @@ instantiate, and manage services. Validate and certify the services. **Steps** - #. `Create a Service`_ - #. `Create a Workflow [optional]`_ + #. `Create Service`_ + #. `Create a Management Workflow [optional]`_ #. `Create a Network Callflow [optional]`_ - #. `Select VID Inputs [optional]`_ - #. `Update a Service [optional]`_ - #. `Submit a Service for Testing`_ - #. `Test a Service`_ - #. `Assign an IP Address Plan`_ + #. `Manage Service Properties [optional]`_ + #. `Update Service [optional]`_ + #. `Certify Service`_ + #. `Import Service CSAR [optional]`_ + +.. _doc_guide_user_des_ser-cre_serv: + +Create Service +-------------- + +**Prerequisites:** Create VF/PNFs required for this service (see :ref:`doc_guide_user_des_vf-cre`). -Create a Service ----------------- +#. From the SDC HOME page, hover over Add and select *ADD SERVICE*. -**Prerequisites:** Create VFs required for this service (see :ref:`vfcreation-and-testing`). + |image0| -#. From the SDC HOME page, hover over Add and select Add Service. #. In the General section, complete all fields. - Note: Use the letters "Svc" in the name to indicate that the - component is a service. + |image5| #. Click Create. - A message displays when VF creation is complete. + A message displays when Service creation is complete. #. Click Composition. - For a description of the Composition section (see \ `Composition - (Service design) `__ ). + |image6| + + For a description of the Composition section (see SDC User Guide ). #. Drag one or more elements from the Elements palette to the canvas. #. To connect elements: @@ -60,7 +68,7 @@ Create a Service #. To add artifacts at the service level: - #. Click an empty area in the canvas and click Deployment Artifacts + #. Click an empty area in the canvas and click *Deployment Artifacts* (right pane). #. Click \ |image3|. #. Select the type. @@ -70,37 +78,50 @@ Create a Service Use this function to add YANG artifacts for distribution to SDNC. -#. Click Check In to save changes. +#. [Optional] At any time before checking in the Service, click + these options to update Service information: + + .. note:: These tasks can be done only before certifying the Service. + + - **General->Icon** change the icon associated with the Service + - **TOSCA Artifacts** view and edit artifacts, such as the .csar file + and TOSCA template + - **Composition** view or edit the graphical representation of the + service-level TOSCA model + - **Activity Log** view activity related to the Service + (displays the action, date, user, status, and any comments related to each + action) + - **Management Workflow** model service lifecycle workflows for execution + in SO (see `Create a Management Workflow [optional]`_) + - **Network Call Flow** model interactions among VFs (see `Create a + Network Callflow [optional]`_) + - **Deployment** view HEAT modules in VSPs + - **Properties Assignment** define or update properties, + policies and input parameters used during Service instantiation + (see `Add Service Inputs [optional]`_). + - **Monitoring** ... + +#. Click *Check In* to save changes. A box displays for confirming the changes. #. Enter a comment and click OK. - A message displays when the VF is checked in. + A message displays when the Service is checked in and the + Home page is displayed. -#. [Optional] At any time before submitting the service for testing, - click these options to update service information: +#. After creating a service and configuring optional fields, certify it + (see `Certify Service`_). - - Icon — change the icon associated with the service - - TOSCA Artifacts — view and edit artifacts, such as the .csar file - and TOSCA template - - Composition — view or edit the graphical representation of the - service-level TOSCA model - - Activity Log — view activity related to the service - - Workflow — model service lifecycle workflows for execution in SO - (see `Create a Workflow [optional]`_) - - Network Call Flow — model interactions among VFs (see `Create a - Network Callflow [optional]`_) - - Deployment — view HEAT modules in VSPs - - Inputs — select parameters as input fields during VID - instantiation (see `Select VID Inputs [optional]`_). +Note: Create Service can also be invoked via External SDC API. +Refer SDC REST API reference for details of the API. +Currently, only a 'Partner Domain Service' category is supported +which cannot be created manually from SDC portal. -#. After creating a service and configuring optional fields, submit it - for testing (see `Submit a Service for Testing`_). +.. _doc_guide_user_des_ser-cre_wf: - -Create a Workflow [optional] ----------------------------- +Create a Management Workflow [optional] +--------------------------------------- Create a workflow to model the SO recipes of the service life cycle such as instantiation, upgrade, termination, or suspension of a service or @@ -114,11 +135,16 @@ format and included in distributed service model. **Prerequisites:** All the required ActivitySpec as supported by SO are registered in SDC. -#. From the SDC HOME page, click WORKFLOW. -#. Click Add Workflow. -#. The Create New Workflow box displays. +#. From the SDC HOME page, click CATALOG and search for a service. +#. Click the service and click *Check Out*. +#. Select the panel *Management Workflow*. +#. Click *Add Workflow*. +#. The *Create New Workflow* box displays. #. Complete all fields. #. Click Create. + + |image7| + #. Specify Inputs & Outputs of Workflow #. Define the Composition of Workflow. @@ -132,6 +158,8 @@ format and included in distributed service model. #. Click Save. #. Certify the Workflow. +.. _doc_guide_user_des_ser-cre_nfw: + Create a Network Callflow [optional] ------------------------------------ @@ -142,10 +170,10 @@ being consumed. In the model, lifelines represent VFs. Note: The information collected in this section is not distributed with the service model. -**Prerequisites:** `Create a service`_ +**Prerequisites:** `Create service`_ -#. From the SDC HOME page, click CATALOG and search for a service. -#. Click the service and click Check Out. +#. From the SDC HOME page, click CATALOG and search for the service. +#. Click the service and click *Check Out*. #. Click Network Call Flow. #. Click Add Workflow. The Create New Workflow box displays. @@ -176,35 +204,45 @@ the service model. #. [Optional] Change the order of steps by clicking a step and dragging it to the preferred position. -#. Click Save. -#. Click Check In to save changes. +#. Click *Save*. +#. Click *Check In* to save changes. + +.. _doc_guide_user_des_ser-para_in: -Select VID Inputs [optional] ----------------------------- +Manage Service Properties [optional] +------------------------------------ -Select parameters as input fields during -`VID `__ -instantiation. +Add new Service parameters and define as input fields +during Service instantiation. -Note: For questions about how to use this section, contact the Service -Design and Creation team (see \ `Mailing -Lists `__). -**Prerequisites:** `Create a service`_ +**Prerequisites:** `Create service`_ #. From the SDC HOME page, click CATALOG and search for a service. -#. Click the service and click Check Out. -#. Click Inputs. -#. From the Resource instance inputs pane, expand the name of a - resource. -#. Select inputs by clicking the check box in each row as required. +#. Click the service and click *Check Out*. +#. Click *Properties Assignment*. + + |image8| + +#. From the *Composition* pane, select the *SELF* object + representing the service. +#. In the *Properties* the existing Service properites are shown +#. With *+Add Property* you can add a new property +#. To set a property as *Input* parameter, select the parameter + by clicking the check box in each row as required. Note: Do not select inputs that are already in the ENV file (this overwrites values specified in the ENV). -#. Click \ |image4| to move selected inputs to the Service inputs pane. -#. Click Check In to save changes. -Update a Service [optional] ---------------------------- + |image9| + +#. Click *Declare Input* to add the selected parameter to the + Service *Input* pane. +#. Click *Check In* to save changes. + +.. _doc_guide_user_des_ser-upd_serv: + +Update Service [optional] +------------------------- Update service information and artifacts. @@ -214,85 +252,99 @@ updated (see step 4). **Prerequisites:** - Create a service. -- If a VF included in the service was updated: see "Update a VF - [optional]" and "Test a VF". +- If a VF included in the service was updated: + see :ref:`doc_guide_user_des_vf-cre_vf-upd` -#. From the SDC HOME page, click CATALOG and search for a service. -#. Click the service and click Check Out. +#. From the SDC HOME page, click CATALOG and search for the service. +#. Click the service and click *Check Out*. #. Click Composition. #. To update the version of a VF referenced in the service: #. Click Composition. #. Click the VF in the canvas. - #. On the General Info tab (right pane), select the VF version. + #. On the *General Info* tab (right pane), select the VF version. #. To update artifacts at the service level: - #. Click an empty area in the canvas and click Deployment Artifacts + #. Click an empty area in the canvas and click *Deployment Artifacts* (right pane). #. View, add, delete, or download artifacts as required. #. [Optional] Add, edit, or remove VFs that comprise the service - reference architecture (see steps 4 to 6 in \ `Create a Service`_). -#. [Optional] Click Operations to edit Service Operations. + reference architecture (see steps 4 to 6 in \ `Create Service`_). +#. [Optional] Click *Operations* to edit Service Operations. #. Create/Edit Operations #. Assign Workflow #. Click Save -#. [Optional] Click Management Callflow to edit, upload, or delete - associated deployment artifacts (see "Create a Management Workflow [optional]"). -#. [Optional] Click Network Callflow to edit the interactions among VFs +#. [Optional] Click *Management Workflow* to edit, upload, or delete + associated deployment artifacts + (see `Create a Management Workflow [optional]`_). +#. [Optional] Click *Network Callflow* to edit the interactions among VFs that comprise the service (see `Create a Network Callflow [optional]`_). -#. [Optional] Click Inputs to select parameters as input fields during - VID instantiation (see `Select VID Inputs [optional]`_). -#. Click Check In to save changes. -#. After updating a service and configuring optional fields, submit it - for testing (see `Submit a Service for Testing`_). +#. [Optional] Click *Properties Assignement* to select parameters as + input fields during Service instantiation + (see `Add Service Inputs [optional]`_). +#. Click *Check In* to save changes. +#. After updating a service and configuring optional fields, certify it + (see `Certify Service`_). -Submit a Service for Testing ----------------------------- +.. _doc_guide_user_des_ser-cfy_serv: + +Certify Service +--------------- Note: A service cannot be submitted for testing if the reference architecture contains uncertified resources. -**Prerequisites:** `Create a Service`_ +**Prerequisites:** `Create Service`_ -#. When a service is ready for testing, click CATALOG and search for the - service. -#. Click the service and click Submit for Testing. - A box displays for sending a message to the testers. -#. Enter a message for the testers asking that they begin service - certification and click OK. +**Steps** - The default mail client launches with a draft email containing the - message from step 2. +#. When a Service is ready for certification, + click *CATALOG* and search for the checked-in Service. +#. Click the Service and click *Certify*. -#. Add the email addresses of the people on the Certification Group with - the Tester role and send the email. +#. Enter a comment and click *OK*. -Test a Service --------------- +#. A Message appears, that the Service is certified. -Test the design and associated artifacts of a service. -**Prerequisites:** `Submit a Service for Testing`_. +Import Service CSAR [optional] +------------------------------ -#. Sign in to SDC as a Tester. -#. From the HOME page, select Ready For Testing under Active Projects. -#. In the right pane, click the service to test. -#. Click Start Testing. -#. Test the service. -#. When testing is complete, click Accept. +Note: This step can be used, when a Service Model already exists -Assign an IP Address Plan -------------------------- +**Steps** + +#. From the SDC HOME page, hover over IMPORT and select *IMPORT SERVICE CSAR*. + + |image0| + +#. In the File Upload Dialog, select the csar file and press *Open*. + + |image10| + +#. In the General section, complete all fields. + + |image11| + +#. Click Create. + + A message displays when Service creation is complete. -Assigning an IP address plan is specific to each OpenECOMP installation. -The object: to assign a Service's key to a "plan" for allocating IP -addresses. +#. Continue with Service Design steps mentioned above -.. |image1| image:: media/design_service_workflow.png +.. |image0| image:: media/sdc-home.png +.. |image1| image:: media/sdc-service-workflow.png .. |image2| image:: media/design_asdccanvas_connect_elements.png .. |image3| image:: media/design_service_adddeploymentartifact.png .. |image4| image:: media/design_service_inputs_move.png +.. |image5| image:: media/sdc-service-general.png +.. |image6| image:: media/sdc-service-composition.png +.. |image7| image:: media/sdc-service-workflow.png +.. |image8| image:: media/sdc-service-properties.png +.. |image9| image:: media/sdc-service-properties-input.png +.. |image10| image:: media/sdc-service-import.png +.. |image11| image:: media/sdc-service-general-import.png