1 .. This work is licensed under a Creative Commons Attribution 4.0
2 .. International License. http://creativecommons.org/licenses/by/4.0
3 .. Copyright 2019 ONAP Contributors. All rights reserved.
5 .. _doc_guide_user_des_ser-des:
10 **Goal:** Add models and other artifacts required to create, configure,
11 instantiate, and manage services. Validate and certify the services.
12 Besides the manual creation of a Service Model, an existing model can
13 be imported via a CSAR file
17 **SDC user roles:** Designer
21 **Figure: Workflow for Service design**
26 #. `Create a Management Workflow [optional]`_
27 #. `Create a Network Callflow [optional]`_
28 #. `Manage Service Properties [optional]`_
29 #. `Update Service [optional]`_
31 #. `Import Service CSAR [optional]`_
33 .. _doc_guide_user_des_ser-cre_serv:
38 **Prerequisites:** Create VF/PNFs required for this service (see :ref:`doc_guide_user_des_vf-cre`).
40 #. From the SDC HOME page, hover over Add and select *ADD SERVICE*.
44 #. In the General section, complete all fields.
50 A message displays when Service creation is complete.
52 #. Click Composition in the left pane.
56 For a description of the Composition section (see SDC User Guide ).
58 #. Drag one or more elements from the Elements palette to the canvas.
59 #. To connect elements:
61 #. Hover over an element and then hover over \ |image2|.
63 Other elements that can connect to this element are highlighted.
65 #. Drag to a highlighted element on the canvas.
66 #. Select options for Requirements and Capabilities.
69 #. To add artifacts at the service level:
71 #. Click an empty area in the canvas and click *Deployment Artifacts*
75 #. Click Browse, locate a file to upload, and click Open.
76 #. Complete all other fields.
79 Use this function to add YANG artifacts for distribution to SDNC.
81 #. [Optional] At any time before checking in the Service, click
82 these options to update Service information:
84 .. note:: These tasks can be done only before certifying the Service.
86 - **General->Icon** change the icon associated with the Service
87 - **TOSCA Artifacts** view and edit artifacts, such as the .csar file
89 - **Composition** view or edit the graphical representation of the
90 service-level TOSCA model
91 - **Activity Log** view activity related to the Service
92 (displays the action, date, user, status, and any comments related to each
94 - **Management Workflow** model service lifecycle workflows for execution
95 in SO (see `Create a Management Workflow [optional]`_)
96 - **Network Call Flow** model interactions among VFs (see
97 `Create a Network Callflow [optional]`_)
98 - **Deployment** view HEAT modules in VSPs
99 - **Properties Assignment** define or update properties,
100 policies and input parameters used during Service instantiation.
103 #. Click *Check In* to save changes.
105 A box displays for confirming the changes.
107 #. Enter a comment and click OK.
109 A message displays when the Service is checked in and the
110 Home page is displayed.
112 #. After creating a service and configuring optional fields, certify it
113 (see `Certify Service`_).
115 Note: Create Service can also be invoked via External SDC API.
116 Refer SDC REST API reference for details of the API.
117 Currently, only a 'Partner Domain Service' category is supported
118 which cannot be created manually from SDC portal.
120 .. _doc_guide_user_des_ser-cre_wf:
122 Create a Management Workflow [optional]
123 ---------------------------------------
125 Create a workflow to model the SO recipes of the service life cycle such
126 as instantiation, upgrade, termination, or suspension of a service or
127 VNF. In the workflow each of the Activity, represent API calls to
128 various ONAP components (such as OOF, SDN-C, App-C, etc) that perform a
129 business function needed.
131 Note: The information collected in this section is represented in BPMN
132 format and included in distributed service model.
134 **Prerequisites:** All the required ActivitySpec as supported by SO
135 are registered in SDC.
137 #. From the SDC HOME page, click CATALOG and search for a service.
138 #. Click the service and click *Check Out*.
139 #. Select the panel *Management Workflow*.
140 #. Click *Add Workflow*.
141 #. The *Create New Workflow* box displays.
142 #. Complete all fields.
147 #. Specify Inputs & Outputs of Workflow
148 #. Define the Composition of Workflow.
150 #. All the Tasks in the composition are expected to be ServiceTask
151 for using Activities defined in SO.
152 #. Select the Implementation in the Task "general" tab to Activity.
153 #. Select the required ActivitySpec.
155 #. Mark the workflow as executable by selecting the Executable flag in
156 the workflow "general" tab.
158 #. Certify the Workflow.
160 .. _doc_guide_user_des_ser-cre_nfw:
162 Create a Network Callflow [optional]
163 ------------------------------------
165 Create a network callflow to model the interactions among VFs within a
166 service, such how VFs interact to deliver a service while the service is
167 being consumed. In the model, lifelines represent VFs.
169 Note: The information collected in this section is not distributed with
172 **Prerequisites:** `Create service`_
174 #. From the SDC HOME page, click CATALOG and search for the service.
175 #. Click the service and click *Check Out*.
176 #. Click Network Call Flow.
177 #. Click Add Workflow.
178 The Create New Workflow box displays.
179 #. Complete all fields.
181 #. In the new workflow pane, click the Lifelines icon.
183 The LIFELINES/STEPS view displays.
185 #. To add a lifeline (component), do the following:
187 #. Click LIFELINES to expand the pane.
188 #. Click Add Lifeline.
189 #. In the [Unnamed Lifeline field], enter a name for the lifeline.
190 #. To add other lifelines to the workflow, repeat the actions above.
192 #. After creating all required lifelines, do the following to add a step
193 (showing an action between two lifelines):
195 #. Under STEPS (left pane), click Add Message.
196 An unnamed step is added under STEPS.
197 #. In the [Unnamed Message] field, enter a name or message for the
199 #. From the component and arrow dropdown lists, select the two
200 components that communicate in this step, and the arrow to show in
201 which direction the communication flows.
202 #. To add another step, repeat the actions above.
204 #. [Optional] Change the order of steps by clicking a step and dragging
205 it to the preferred position.
206 #. Click *Save*. You will be redirected to the Network Call Flow page.
207 #. Go to the General tab and click on *Check In* to save changes.
208 #. If needed, certify the service again (see `Certify Service`_).
210 .. _doc_guide_user_des_ser-para_in:
212 Manage Service Properties [optional]
213 ------------------------------------
215 Add new Service parameters and define as input fields
216 during Service instantiation.
219 **Prerequisites:** `Create service`_
221 #. From the SDC HOME page, click CATALOG and search for a service.
222 #. Click the service and click *Check Out*.
223 #. Click *Properties Assignment*.
227 #. From the *Composition* pane, select the *SELF* object
228 representing the service.
229 #. In the *Properties* the existing Service properites are shown
230 #. With *+Add Property* you can add a new property
231 #. To set a property as *Input* parameter, select the parameter
232 by clicking the check box in each row as required.
233 Note: Do not select inputs that are already in the ENV file (this
234 overwrites values specified in the ENV).
238 #. Click *Declare Input* to add the selected parameter to the
239 Service *Input* pane.
240 #. Click *Check In* to save changes.
241 #. After adding Service Inputs, certify it (see `Certify Service`_).
243 .. _doc_guide_user_des_ser-upd_serv:
245 Update Service [optional]
246 -------------------------
248 Update service information and artifacts.
250 Update the version of a VF referenced in the service whenever the VF is
251 updated (see step 4).
256 - If a VF included in the service was updated:
257 see :ref:`doc_guide_user_des_vf-cre_vf-upd`
259 #. From the SDC HOME page, click CATALOG and search for the service.
260 #. Click the service and click *Check Out*.
261 #. Click Composition.
262 #. To update the version of a VF referenced in the service:
264 #. Click Composition.
265 #. Click the VF in the canvas.
266 #. On the *General Info* tab (right pane), select the VF version.
268 #. To update artifacts at the service level:
270 #. Click an empty area in the canvas and click *Deployment Artifacts*
272 #. View, add, delete, or download artifacts as required.
274 #. [Optional] Add, edit, or remove VFs that comprise the service
275 reference architecture (see steps 4 to 6 in \ `Create Service`_).
276 #. [Optional] Click *Operations* to edit Service Operations.
278 #. Create/Edit Operations
282 #. [Optional] Click *Management Workflow* to edit, upload, or delete
283 associated deployment artifacts
284 (see `Create a Management Workflow [optional]`_).
285 #. [Optional] Click *Network Callflow* to edit the interactions among VFs
286 that comprise the service (see `Create a Network Callflow [optional]`_).
287 #. [Optional] Click *Properties Assignement* to select parameters as
288 input fields during Service instantiation.
289 #. Click *Check In* to save changes.
290 #. After updating a service and configuring optional fields, certify it
291 (see `Certify Service`_).
293 .. _doc_guide_user_des_ser-cfy_serv:
298 Note: A service cannot be submitted for testing if the reference
299 architecture contains uncertified resources.
301 **Prerequisites:** `Create Service`_
305 #. When a Service is ready for certification,
306 click *CATALOG* and search for the checked-in Service.
307 #. Click the Service and click *Certify*.
309 #. Enter a comment and click *OK*.
311 #. A Message appears, that the Service is certified.
314 Import Service CSAR [optional]
315 ------------------------------
317 Note: This step can be used, when a Service Model already exists
321 #. From the SDC HOME page, hover over IMPORT and select *IMPORT SERVICE CSAR*.
325 #. In the File Upload Dialog, select the csar file and press *Open*.
329 #. In the General section, complete all fields.
335 A message displays when Service creation is complete.
337 #. Continue with Service Design steps mentioned above
339 .. |image0| image:: media/sdc-home.png
340 .. |image1| image:: media/sdc-service-workflow.png
341 .. |image2| image:: media/design_asdccanvas_connect_elements.png
342 .. |image3| image:: media/design_service_adddeploymentartifact.png
343 .. |image4| image:: media/design_service_inputs_move.png
344 .. |image5| image:: media/sdc-service-general.png
345 .. |image6| image:: media/sdc-service-composition.png
346 .. |image7| image:: media/sdc-service-workflow.png
347 .. |image8| image:: media/sdc-service-properties.png
348 .. |image9| image:: media/sdc-service-properties-input.png
349 .. |image10| image:: media/sdc-service-import.png
350 .. |image11| image:: media/sdc-service-general-import.png