You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 69 Next »

Update

20191107:   Linux Foundation Jenkins CI tutorial: Defining Automated Jenkins Jobs for O-RAN SC Repos

Introduction


PTLs: Please include the following status information for each project

  1. The list of repos that are to be included in Amber release under your project.
  2. For each repo, provide the following information:
    1. License Status:
      1. What license for each repo, Apache 2 or O-RAN?
      2. Whether the LICENSES.txt is included at the root of the repo and whether each code file has a license and copyright claim header?
      3. NOT including any contributing company proprietary information?
    2. Code status:
      1. Is the code available (code MUST be in by code freeze date of 11/04)?
      2. Is the code build-able?
      3. Is the building and artifact generation integrated with LF Jenkins? We can mark this item as "yes" if a particular repo implements a (a) verify, (b) merge and (c) daily release job. The group maintaining a repo needs to implement this. 
    3. Documentation status:
      1. Following the documentation format, structure, and template provided by DOC project?
        1. It is sufficient to generate the release notes bases on docs/release-notes.rst in your repo as per https://wiki.o-ran-sc.org/display/DOC#DocumentationHome-RequiredFiles  ans as per these templates https://wiki.o-ran-sc.org/display/DOC#DocumentationHome-Templates  Other files you may also generate already now if you think this can be done in the remaining Amber timeframe (deadline = Nov-13, 8am ET): docs/installation-guides.rst,  docs/developer-guide.rst , docs/api-docs.rst. The file docs/index.rst is also needed as seen in the next step (2.c.ii) below.  For Amber release the minimum requirement is the release note file. There is no need to publish README.md file from your repo in readthedocs.io . We need to figure out aclever way to maintain it in the root directory (for github& co), but also to correctly trigger the general CI job that generates documentation.

      2. Documentation buildable by the DOC project?
        1. Also implement a Jenkins job for pushing these to https://readthedocs.org/projects/o-ran-sc-doc/  (scroll down to see "Sub projects" on the right hand side). Instructions on how to publish them to via an automatic Jenkins job are here: Configure Repo for Documentation.  (the doc-template directory under the doc repo already contains all the necessary files).
      3. Prepared a video demo for how to build and run your project.

Status

(Near Realtime) RICAPP

PTL: Matti Hiltunen

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN

Claims

included

Proprietary

info removed

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo 

RICAPPric-app/adminApache 2yesyesyesyesyesyesalmost there
RICAPPric-app/mcApache 2yesyesyesyes
yesyessoon
RICAPPric-app/mlApache 2yes

yes


yes

yesyesyes (some editing required)
RICAPPcom/gs-liteApache 2yesyesyesyes

N/A

(library used by MC)




(Near Realtime) RIC Platform

PTL: Thoralf Czichy

(A) Project

(B) Repos

(C) License and Open Source Status

(D) Code and Building Status(E) Documentation

(C.1) Apache2

or O-RAN 

(C.2) Claims

included?

(C.3) Proprietary

info removed?

(D.1) Code

available

(D.2) Buildable

(D.3) LF CI

integrated

(E.1) Follow

DOC

(E.2) DOC

buildable

(E.3) Video

demo

RICPcom/logApache2yesyesyesyesyesyesno

no

RICPcom/gologApache2yesyesyesyesyesyesnono
RICPcom/pylogApache2yesyesyesyesyesyesnono
RICPric-plt/a1Apache2yesyesyesyesyesyesyesno
RICPric-plt/appmgrApache2yesyesyesyesyesno - only README in reponono
RICPric-plt/dbaasApache2yesyesyesyesyesYes (release-notes is done)Yesno
RICPric-plt/e2Apache2yesyesyesyesyesyesnono
RICPric-plt/e2mgrApache2Yesyesyesyesyesyesnono
RICPric-plt/lib/rmrApache2yesyesyesyesyesyesyes - standard man pages built into dev package and RTD 'hooks' in docs/no
RICPric-plt/nodeb-rnibApache2yesyesyesyes
yes (empty)nono
RICPric-plt/rtmgrApache2yesyesyesyesyesOnly READMEnono
RICPric-plt/sdlApache2yesyesyesyesyesYes (release-notes is done)yesno
RICPric-plt/sdlgoApache2yesyesyesyesyes (verification only as this is a importable go module)Yes (release-notes is done)Yesno
RICPric-plt/submgrApache2Licence header missing in two files. Generated ASN1 codes are not under 3dparty directory.yesyesyesyes - includes only build job. No unit test available in the code.Only READMEnono
RICPric-plt/jaegeradapterApache2yesyesyesNothing to build in this repoNo, repo contains only helm chart for testing purposesyesnono
RICPric-plt/tracelibcppApache2yesyesyesyesyesyesnono
RICPric-plt/tracelibgoApache2yesyesyesyesyesyesnono
RICPric-plt/vespamgrApache2yesyesyesyesyesyesnono
RICPric-plt/xapp-frameApache2yesyesyesyesN/A (Go library)

no
RICPric-plt/asn1-documentsCreative Commons License, Attribution 4.0 Intl.not applicablenot applicablenot applicableno, only documentationno, not neededyes
no
RICPric-plt/streaming-protobufsCreative Commons License, Attribution 4.0 Intl.yesyesyesno, not needed. Definitions to be used by other reposno, planned for release B as a set of "unit tests". There's no CI/CD artifact resulting from this repo.no, not neededno, not neededno
RICPric-plt/resource-status-managerApache2yesyesyesyesyesyesnono























































NONRTRIC

PTL: John Keeney

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

NONRTRICnonrtricApache 2.0YesNo proprietary informationYesYesIn progressIn progress

Soon


OAM

PTL: Martin Skorupski

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

OAMgerrit.o-ran-sc.org/r/q/oamApache  2.0Yes, file LICENSES.txt is in repo root; yes every code file has an appropriate headerNo company proprietary infoYes code is available in LF gerritYes code is buildable




gerrit.o-ran-sc.org/r/admin/repos/scp/oam/modelingO-RAN
No company proprietary infon/a for modelingn/a for modelingn/a for modelingn/a for modelingn/a for modelingn/a for modeling

Apache  2.0Yes, file LICENSES.txt is in repo root; yes every code file has an appropriate headerNo company proprietary infoYes code is available in LF gerritYes code is buildableYes the continuous integration (build) is performed in LF JenkinsYes documentation follows the format, structure and template of DOC

Yes documentation is included when the DOC project builds


OCU

PTL: user-a934b

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

OCUhttps://gerrit.o-ran-sc.org/r/scp/ocu/openlteO-RANnot yetNo company proprietary info

will upload before 11/04

working on the code upload now.

not yetNonot yetnot yetno


ODUHIIGH


PTL: Sachin Srivastava

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

ODUHIGH

https://gerrit.o-ran-sc.org/r/admin/repos/o-du/l2

Apache2

Yes.

LICENSE.txt is included at the root of the repo and each code file has a license and copyright claim header

Yes, company proprietary info is not includedYesYesNoYesRelease notes doc has been placed inside doc folder of the o-du/l2 repo.

ODULOW

PTL: Zhimin Yuan

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

ODULOWhttps://gerrit.o-ran-sc.org/r/o-du/phy

Apache2

one file in external folder using MIT since gtest for unit test

YesYesYesYescan't do it since we need hard connection between two servers with 10G, 25G or 40G Nic, and configure them as a pair. just one docker can't do the testing.  not yetnono

INF

PTL: Xiaohua Zhang

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

INFhttps://gerrit.o-ran-sc.org/r/admin/repos/pti/rtpApache2YesYes, removed.YesYesOngoingNot yetNoNo

SIM

PTL: Alex Stancu

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo 

SIMsim/o1-interfaceApache2NoNo company proprietary infoYesYesNoNoNoNo

DOC

PTL: weichen ni

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo

DOCdocCC 4.0NoNo company proprietary infoN/AN/A
N/AIn progressno

INT

PTL: user-d3360

Project

Repos

License and Open Source Status

Code and Building StatusDocumentation

Apache2

or O-RAN 

Claims

included?

Proprietary

info removed?

Code

available

Buildable

LF CI

integrated

Follow

DOC

DOC

buildable

Video

demo 

INTit/depApache2YYYYYYY
INTit/testApache2YYYYYYY
INTit/devApache2YYYN/AN/AYYN/A
INTit/otfApache2YYYYYYY





  • No labels