Newer
Older

Dimitrios Giannopoulos
committed
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../testing_services/test_inventory.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Testing Inventory

Dimitrios Giannopoulos
committed
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</li>

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<li class="md-nav__item md-nav__item--nested">

Dimitrios Giannopoulos
committed
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="0">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Service as a Product

Dimitrios Giannopoulos
committed
</span>
<span class="md-nav__icon md-icon"></span>
</label>

Dimitrios Giannopoulos
committed
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_7">

Dimitrios Giannopoulos
committed
<span class="md-nav__icon md-icon"></span>

Dimitrios Giannopoulos
committed
Service as a Product

Dimitrios Giannopoulos
committed
</label>
<ul class="md-nav__list" data-md-scrollfix>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../product_model/product_spec.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Product Specification

Dimitrios Giannopoulos
committed
</span>
</a>
</li>
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../product_model/product_catalogs.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Product Catalogs

Dimitrios Giannopoulos
committed
</span>
</a>
</li>
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../product_model/product_inventory.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Product Inventory

Dimitrios Giannopoulos
committed
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</li>

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<li class="md-nav__item md-nav__item--nested">

Dimitrios Giannopoulos
committed
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="0">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Assurance services

Dimitrios Giannopoulos
committed
</span>
<span class="md-nav__icon md-icon"></span>
</label>

Dimitrios Giannopoulos
committed
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_8">

Dimitrios Giannopoulos
committed
<span class="md-nav__icon md-icon"></span>

Dimitrios Giannopoulos
committed
Assurance services

Dimitrios Giannopoulos
committed
</label>
<ul class="md-nav__list" data-md-scrollfix>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../assurance_services/intro.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Introduction

Dimitrios Giannopoulos
committed
</span>
</a>
</li>
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../assurance_services/alarms_actions.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
Alarms and Actions
</span>
</a>
</li>
</ul>
</nav>
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item md-nav__item--nested">

Dimitrios Giannopoulos
committed
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="0">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
Design & Architecture
</span>
<span class="md-nav__icon md-icon"></span>
</label>

Dimitrios Giannopoulos
committed
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_9">

Dimitrios Giannopoulos
committed
<span class="md-nav__icon md-icon"></span>
Design & Architecture
</label>
<ul class="md-nav__list" data-md-scrollfix>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../architecture/architecture/" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Architecture

Dimitrios Giannopoulos
committed
</span>
</a>
</li>

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<li class="md-nav__item md-nav__item--nested">

Dimitrios Giannopoulos
committed
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_2" >

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<label class="md-nav__link" for="__nav_9_2" id="__nav_9_2_label" tabindex="0">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Cloud native support

Dimitrios Giannopoulos
committed
</span>
<span class="md-nav__icon md-icon"></span>
</label>

Dimitrios Giannopoulos
committed
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_9_2">

Dimitrios Giannopoulos
committed
<span class="md-nav__icon md-icon"></span>

Dimitrios Giannopoulos
committed
Cloud native support

Dimitrios Giannopoulos
committed
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../architecture/CRIDGE_cloud_native_intro.md" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Introduction

Dimitrios Giannopoulos
committed
</span>
</a>
</li>
<li class="md-nav__item">

Dimitrios Giannopoulos
committed
<a href="../../architecture/CRIDGE/CRIDGEforDevelopers/" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
CRIDGE for Developers

Dimitrios Giannopoulos
committed
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</li>

Dimitrios Giannopoulos
committed
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
<li class="md-nav__item">
<a href="../../architecture/messagebus/" class="md-nav__link">
<span class="md-ellipsis">
Message bus
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../architecture/osom/" class="md-nav__link">
<span class="md-ellipsis">
OSOM
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../architecture/oauth/" class="md-nav__link">
<span class="md-ellipsis">
Authentication
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item md-nav__item--nested">

Dimitrios Giannopoulos
committed
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9_6" >

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<label class="md-nav__link" for="__nav_9_6" id="__nav_9_6_label" tabindex="0">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
APIs
</span>
<span class="md-nav__icon md-icon"></span>
</label>

Dimitrios Giannopoulos
committed
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_9_6_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_9_6">

Dimitrios Giannopoulos
committed
<span class="md-nav__icon md-icon"></span>
APIs
</label>
<ul class="md-nav__list" data-md-scrollfix>

Dimitrios Giannopoulos
committed
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
<li class="md-nav__item">
<a href="../../architecture/tmfapi/" class="md-nav__link">
<span class="md-ellipsis">
TMF API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../architecture/nfvapi/" class="md-nav__link">
<span class="md-ellipsis">
NFV API
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</li>

Dimitrios Giannopoulos
committed
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
<li class="md-nav__item">
<a href="../../architecture/issuemgt/" class="md-nav__link">
<span class="md-ellipsis">
Issue management
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../architecture/centrallog/" class="md-nav__link">
<span class="md-ellipsis">
Central logging
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">

Dimitrios Giannopoulos
committed
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_10" checked>

Dimitrios Giannopoulos
committed

Dimitrios Giannopoulos
committed
<label class="md-nav__link" for="__nav_10" id="__nav_10_label" tabindex="0">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">

Dimitrios Giannopoulos
committed
Contributing to OSL

Dimitrios Giannopoulos
committed
</span>
<span class="md-nav__icon md-icon"></span>
</label>

Dimitrios Giannopoulos
committed
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_10_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_10">

Dimitrios Giannopoulos
committed
<span class="md-nav__icon md-icon"></span>

Dimitrios Giannopoulos
committed
Contributing to OSL

Dimitrios Giannopoulos
committed
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Developing
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
Developing
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#general-requirements" class="md-nav__link">
<span class="md-ellipsis">
General requirements
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#versionrelease-management" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
Version/release management
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#getting-started" class="md-nav__link">
<span class="md-ellipsis">
Getting Started
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#contribute-to-a-subsystem" class="md-nav__link">
<span class="md-ellipsis">
Contribute to a subsystem

Dimitrios Giannopoulos
committed
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#examples-of-developing-on-specific-subsystems" class="md-nav__link">
<span class="md-ellipsis">
Examples of developing on specific subsystems
</span>
</a>
<nav class="md-nav" aria-label="Examples of developing on specific subsystems">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#vnfnsd-catalog-management-and-nsd-deployment-api-service" class="md-nav__link">
<span class="md-ellipsis">
VNF/NSD Catalog Management and NSD Deployment API service
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#vnfnsd-catalog-management-and-nsd-deployment-web-ui-service" class="md-nav__link">
<span class="md-ellipsis">
VNF/NSD Catalog Management and NSD Deployment WEB UI service
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#reach-us" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
Reach us
</span>
</a>
<nav class="md-nav" aria-label="Reach us">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#slack" class="md-nav__link">
<span class="md-ellipsis">
Slack
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#e-mail" class="md-nav__link">
<span class="md-ellipsis">
E-mail

Dimitrios Giannopoulos
committed
</span>
</a>
</li>
</ul>
</nav>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#wishlist" class="md-nav__link">
<span class="md-ellipsis">
Wishlist
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</li>
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
<li class="md-nav__item">
<a href="../documenting/" class="md-nav__link">
<span class="md-ellipsis">
Documenting
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="../../terminology/" class="md-nav__link">
<span class="md-ellipsis">
Terminology
</span>
</a>
</li>

Dimitrios Giannopoulos
committed
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#general-requirements" class="md-nav__link">
<span class="md-ellipsis">
General requirements
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#versionrelease-management" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
Version/release management
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#getting-started" class="md-nav__link">
<span class="md-ellipsis">
Getting Started
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#contribute-to-a-subsystem" class="md-nav__link">
<span class="md-ellipsis">
Contribute to a subsystem

Dimitrios Giannopoulos
committed
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#examples-of-developing-on-specific-subsystems" class="md-nav__link">
<span class="md-ellipsis">
Examples of developing on specific subsystems
</span>
</a>
<nav class="md-nav" aria-label="Examples of developing on specific subsystems">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#vnfnsd-catalog-management-and-nsd-deployment-api-service" class="md-nav__link">
<span class="md-ellipsis">
VNF/NSD Catalog Management and NSD Deployment API service
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#vnfnsd-catalog-management-and-nsd-deployment-web-ui-service" class="md-nav__link">
<span class="md-ellipsis">
VNF/NSD Catalog Management and NSD Deployment WEB UI service
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#reach-us" class="md-nav__link">

Dimitrios Giannopoulos
committed
<span class="md-ellipsis">
Reach us
</span>
</a>
<nav class="md-nav" aria-label="Reach us">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#slack" class="md-nav__link">
<span class="md-ellipsis">
Slack
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#e-mail" class="md-nav__link">
<span class="md-ellipsis">
E-mail

Dimitrios Giannopoulos
committed
</span>
</a>
</li>
</ul>
</nav>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
<li class="md-nav__item">
<a href="#wishlist" class="md-nav__link">
<span class="md-ellipsis">
Wishlist
</span>
</a>

Dimitrios Giannopoulos
committed
</li>

Dimitrios Giannopoulos
committed
</ul>
</nav>
</div>

Dimitrios Giannopoulos
committed
</div>

Dimitrios Giannopoulos
committed
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">

Dimitrios Giannopoulos
committed
<h1 id="developing">Developing</h1>
<p>OpenSlice backend services are mainly implemented with Java 17 or above and Spring Boot.</p>
<p>OpenSlice uses various subsystems and depending on the module would you like to work, other subsystems must be present <em>(you can disable them though in the code, e.g. at docker-compose.yaml file)</em>.</p>
<h2 id="general-requirements">General requirements</h2>
<ul>
<li>Docker should be installed in your development environment</li>
<li>Run the core subsystems (see <a href="#contribute-to-a-subsystem">related</a> section)</li>
</ul>
<h2 id="versionrelease-management">Version/release management</h2>
<p>Check <a href="https://nvie.com/posts/a-successful-git-branching-model/">this</a> nice article on how we develop and release versions.</p>
<p>We develop in the <code>develop</code> branch and follow a issue driven development model.</p>
<h2 id="getting-started">Getting Started</h2>
<p>To get the latest development branch, execute:</p>

Dimitrios Giannopoulos
committed
<pre><code class="language-bash">wget https://labs.etsi.org/rep/osl/code/org.etsi.osl.main/-/raw/develop/compose/deploy.sh
sudo ./deploy.sh develop #[or replace develop with another branch name]

Dimitrios Giannopoulos
committed
</code></pre>
<p>You may follow the <a href="https://osl.etsi.org/documentation/develop/deployment/">installation process</a>, as described at <code>develop</code> tagged documentation.</p>
<h2 id="contribute-to-a-subsystem">Contribute to a subsystem</h2>
<p>To work on a specific subsystem e.g. <code>org.etsi.osl.tmf.api</code>, you must:</p>
<ol>
<li>
<p>Deploy only the core necessary subsystems through:</p>
<p><code>bash
sudo docker compose --profile dev down;sudo docker compose --profile dev up -d --build</code></p>

Dimitrios Giannopoulos
committed
<blockquote>

Dimitrios Giannopoulos
committed
<p>Note <strong>--profile dev</strong> that will only deploy the core dependency subsystems, instead of the whole OpenSlice.</p>

Dimitrios Giannopoulos
committed
</blockquote>
<p><em>OR</em></p>
<p>Alternatively, comment out the respective container from the <code>docker-compose.yaml</code> file, so as to deploy the whole OpenSlice, except the subsystem you want to work on, following the provided installation steps.</p>
</li>
<li>
<p>Clone the respective repository, for example: <a href="https://labs.etsi.org/rep/osl/code/org.etsi.osl.tmf.api/-/tree/develop">https://labs.etsi.org/rep/osl/code/org.etsi.osl.tmf.api/-/tree/develop</a> (the clone URLs are available at this link)</p>
</li>
<li>
<p>Code! 😊</p>
</li>
</ol>

Dimitrios Giannopoulos
committed
<h2 id="examples-of-developing-on-specific-subsystems">Examples of developing on specific subsystems</h2>
<h3 id="vnfnsd-catalog-management-and-nsd-deployment-api-service">VNF/NSD Catalog Management and NSD Deployment API service</h3>
<p>You need to:</p>