summaryrefslogtreecommitdiffstats
path: root/docs/guides/onap-user/design/service-design/index.rst
blob: ce7fb9a3c9736a14fe84c553f29dbe490cbad43f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
.. This work is licensed under a Creative Commons Attribution 4.0
.. 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

|image1|

**Figure: Workflow for Service design**

**Steps**

   #. `Create Service`_
   #. `Create a Management Workflow [optional]`_
   #. `Create a Network Callflow [optional]`_
   #. `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`).

#. From the SDC HOME page, hover over Add and select *ADD SERVICE*.

   |image0|

#. In the General section, complete all fields.

   |image5|

#. Click Create.

   A message displays when Service creation is complete.

#. Click Composition.

   |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:

   #. Hover over an element and then hover over \ |image2|.

      Other elements that can connect to this element are highlighted.

   #. Drag to a highlighted element on the canvas.
   #. Select options for Requirements and Capabilities.
   #. Click Connect.

#. To add artifacts at the service level:

   #. Click an empty area in the canvas and click *Deployment Artifacts*
      (right pane).
   #. Click \ |image3|.
   #. Select the type.
   #. Click Browse, locate a file to upload, and click Open.
   #. Complete all other fields.
   #. Click Done.

   Use this function to add YANG artifacts for distribution to SDNC.

#. [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 Service is checked in and the
   Home page is displayed.

#. After creating a service and configuring optional fields, certify it
   (see `Certify Service`_).

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.

.. _doc_guide_user_des_ser-cre_wf:

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
VNF. In the workflow each of the Activity, represent API calls to
various ONAP components (such as OOF, SDN-C, App-C, etc) that perform a
business function needed.

Note: The information collected in this section is represented in BPMN
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 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.

   #. All the Tasks in the composition are expected to be ServiceTask
      for using Activities defined in SO.
   #. Select the Implementation in the Task "general" tab to Activity.
   #. Select the required ActivitySpec.

#. Mark the workflow as executable by selecting the Executable flag in
   the workflow "general" tab.
#. Click Save.
#. Certify the Workflow.

.. _doc_guide_user_des_ser-cre_nfw:

Create a Network Callflow [optional]
------------------------------------

Create a network callflow to model the interactions among VFs within a
service, such how VFs interact to deliver a service while the service is
being consumed. In the model, lifelines represent VFs.

Note: The information collected in this section is not distributed with
the service model.

**Prerequisites:** `Create service`_

#. 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.
#. Complete all fields.
#. Click Save.
#. In the new workflow pane, click the Lifelines icon.

   The LIFELINES/STEPS view displays.

#. To add a lifeline (component), do the following:

   #. Click LIFELINES to expand the pane.
   #. Click Add Lifeline.
   #. In the [Unnamed Lifeline field], enter a name for the lifeline.
   #. To add other lifelines to the workflow, repeat the actions above.

#. After creating all required lifelines, do the following to add a step
   (showing an action between two lifelines):

   #. Under STEPS (left pane), click Add Message.
      An unnamed step is added under STEPS.
   #. In the [Unnamed Message] field, enter a name or message for the
      step.
   #. From the component and arrow dropdown lists, select the two
      components that communicate in this step, and the arrow to show in
      which direction the communication flows.
   #. To add another step, repeat the actions above.

#. [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.

.. _doc_guide_user_des_ser-para_in:

Manage Service Properties [optional]
------------------------------------

Add new Service parameters and define as input fields
during Service instantiation.


**Prerequisites:** `Create service`_

#. From the SDC HOME page, click CATALOG and search for a service.
#. 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).

   |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.

Update the version of a VF referenced in the service whenever the VF is
updated (see step 4).

**Prerequisites:**

-  Create a service.
-  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 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.

#. To update artifacts at the service level:

   #. 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 Service`_).
#. [Optional] Click *Operations* to edit Service Operations.

   #. Create/Edit Operations
   #. Assign Workflow
   #. Click Save

#. [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 *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`_).

.. _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 Service`_

**Steps**

#. When a Service is ready for certification,
   click *CATALOG* and search for the checked-in Service.
#. Click the Service and click *Certify*.

#. Enter a comment and click *OK*.

#. A Message appears, that the Service is certified.


Import Service CSAR [optional]
------------------------------

Note: This step can be used, when a Service Model already exists

**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.

#. Continue with Service Design steps mentioned above

.. |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