Table of Contents |
---|
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
- The list of repos that are to be included in Amber release under your project.
- For each repo, provide the following information:
- License Status:
- What license for each repo, Apache 2 or O-RAN?
- Whether the LICENSES.txt is included at the root of the repo and whether each code file has a license and copyright claim header?
- NOT including any contributing company proprietary information?
- Code status:
- Is the code available (code MUST be in by code freeze date of 11/04)?
- Is the code build-able?
- 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.
- Documentation status:
- Following the documentation format, structure, and template provided by DOC project?
It is sufficient to have these files 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 as 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/release-notes.rst, docs/developer-guide.rst , docs/api-docs.rst. (The file docs/index.rst is also needed , but coming from the next step below)as. 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 a clever way to maintain it in the root directory (for github& co), but also to correctly trigger the general CI job that generates documentation. You pass this item (2.c.ii) if you can successfully run "tox -e docs,docs-linkcheck" on your repo/subproject and it generates HTML that includes release notes.
- Documentation buildable by the DOC project?
- Also implement a the input for the centralized Jenkins job for pushing these to https:/that pushes the documentation to readthedocs.io (https://readthedocs.org/projects/o-ran-sc.readthedocs.io/en/latest/-doc/ (scroll down to see "Sub projects" on the right hand side)). Instructions on how to publish them to via an automatic thus centralized Jenkins job are here: Configure Repo for Documentation. (the doc-template directory under the doc repo already contains all the necessary files).
- Prepared a video demo for how to build and run your project.
- Following the documentation format, structure, and template provided by DOC project?
Documentation Home:
https://docs.o-ran-sc.org/en/latest/
Status
(Near Realtime) RICAPP
PTL: Matti Hiltunen
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included | Proprietary info removed | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||
RICAPP | ric-app/admin | Apache 2 | yes | yes | yes | yes | yes | yes | yes | raw video available, needs editing |
RICAPP | ric-app/mc | Apache 2 | yes | yes | yes | yes | yes | yes | yes | yes |
RICAPP | ric-app/ml | Apache 2 | yes | yes | yes | yes | yes |
yes | yes | yes (some editing required) |
RICAPP | com/gs-lite | Apache 2 | yes | yes | yes | yes | N/A (library used by MC) | yes | yes | no |
RICAPP | ric-app/kpimon | Apache2 | yes | yes | yes | yes | yes | yes | yes | no |
(Near Realtime) RIC Platform
...
(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 | ||||||||||||||||||||||||||
RICP | com/log | Apache2 | yes | yes | yes | yes | yes | no - only README in repo | noyes | yes | no | |||||||||||||||||||||||
RICP | com/golog | Apache2 | yes | yes | yes | yes | yes | no - only README in repo | noyes | yes | no | |||||||||||||||||||||||
RICP | com/pylog | Apache2 | yes | yes | yes | yes | yes | no - only README in repo | noyes | yes | no | |||||||||||||||||||||||
RICP | ric-plt/a1 | Apache2 | yes | yes | yes | yes | yes | noyes | noyes | no | ||||||||||||||||||||||||
RICP | ric-plt/appmgr | Apache2 | yes | yes | yes | yes | yes | no - only README in repo | no | no | ||||||||||||||||||||||||
RICP | ric-plt/dbaas | Apache2 | yes | yes | yes | yes | yes | no - only README.md in repo root | noYes | Yes | no | |||||||||||||||||||||||
RICP | ric-plt/ | dbaas/hiredis-vipApache2 | Repo remains intentionally empty in Amber | n/a | n/a | n/a | n/a | n/a | n/a | n/a | RICP | ric-plt/e2 | Apache2 | yes | yes | yes | yes | yes | yes | (empty)no | no | |||||||||||||
RICP | ric-plt/e2mgr | Apache2 | Yes | yes | yes | yes | yes | yes | (empty)no | no | ||||||||||||||||||||||||
RICP | ric-plt/lib/rmr | Apache2 | yes | yes | yes | yes | yes | no (standard unix man pages)yes | yes - standard man pages built into dev package and RTD 'hooks' in docs/ | no | ||||||||||||||||||||||||
RICP | ric-plt/nodeb-rnib | Apache2 | yes | yes | yes | yes | N/A (Go code) | yes (empty) | no | no | ||||||||||||||||||||||||
RICP | ric-plt/rtmgr | Apache2 | yes | yes | yes | yes | yes | Yes | yes | no | ||||||||||||||||||||||||
RICP | ric-plt/sdl | Apache2 | yes | yes | yes | yes | yes | - includes only compilation and unit tests currently (library not yet available in PackageCloud.io)Yes | yes | no - only README.md and doxygen API documentation exists | yes - with doxygenno | |||||||||||||||||||||||
RICP | ric-plt/sdlgo | Apache2 | yes | yes | yes | yes | yes (verification only as this is a importable go module) | no (follows go documentation guidelines) | yes - go documentationYes | Yes | no | |||||||||||||||||||||||
RICP | ric-plt/ | sdlpysubmgr | Apache2 | Repo remains intentionally empty in Amber. | n/a | Repo remains intentionally empty in Amber. | Repo remains intentionally empty in Amber. | Repo remains intentionally empty in Amber. | no | RICP | ric-plt/submgr | Apache2 | yes | no | RICP | ric-plt/utils | Apache2 | Intentionally empty in Release A | Intentionally empty in Release A | Intentionally empty in Release A | Intentionally empty in Release A | Licence header missing in two files. Generated ASN1 codes are not under 3dparty directory. | yes | yes | yes | yes - includes only build job. No unit test available in the code. | Only README | no | no | |||||
RICP | ric-plt/jaegeradapter | Apache2 | yes | yes | yes | Nothing to build in this repo | No, repo contains only helm chart for testing purposes | Only READMEyes | noyes | no | ||||||||||||||||||||||||
RICP | ric-plt/tracelibcpp | Apache2 | yes | yes | yes | yes | yes | Only READMEyes | noyes | no | ||||||||||||||||||||||||
RICP | ric-plt/tracelibgo | Apache2 | yes | yes | yes | yes | yes | Only READMEyes | noyes | no | ||||||||||||||||||||||||
RICP | ric-plt/vespamgr | Apache2 | yes | yes | yes | yes | yes | Only READMEyes | noyes | no | ||||||||||||||||||||||||
RICP | ric-plt/xapp-frame | Apache2 | yes | yes | yes | yes | N/A (Go library) | no | ||||||||||||||||||||||||||
RICP | ric-plt/asn1-documents | Creative Commons License, Attribution 4.0 Intl. | not applicable | not applicable | not applicable | no, only documentation | no, not needed | yes | no | |||||||||||||||||||||||||
RICP | ric-plt/streaming-protobufs | Creative Commons License, Attribution 4.0 Intl. | yes | yes | yes | no, not needed. Definitions to be used by other repos | no, planned for release B as a set of "unit tests". There's no CI/CD artifact resulting from this repo. | no, not needed | no, not neededYes | Yes | no | |||||||||||||||||||||||
RICP | ric-plt/resource-status-manager | Apache2 | yes | yes | yes | yes | yes | yes | (empty)no | RICP | ric-plt/ric-test | Apache2 | remains intentionally empty in Amber | remains intentionally empty in Amber | no | , not neededno | RICP | ric-plt/ric-dep | Apache2 | remains intentionally empty in Amber | remains intentionally empty in Amber | no, not needed | no | RICP | ric-plt/demo1 | Creative Commons License, Attribution 4.0 Intl. | not yet, to be filled by Nov-14 | not yet, to be filled by Nov-14 | not yet, to be filled by Nov-14 | not yet, but eventually within documentation timeline (Nov-14) | not yet, but eventually within documentation timeline (Nov-14 | no | ||
NONRTRIC
PTL: John Keeney
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | |||
NONRTRIC | nonrtric | Apache 2.0 | Yes | No proprietary | infomationinformation | Yes | Yes | Yes | Yes | Yes | TBC |
OAM
PTL: Martin Skorupski
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||
OAM | gerrit.o-ran-sc.org/r/q/oam | Apache 2.0 | Yes, file LICENSES.txt is in repo root; yes every code file has an appropriate header | No company proprietary info | Yes code is available in LF gerrit | Yes code is buildable | n/a | Yes | Yes | not yet A demo is scheduled for first week of December including capturing of videos. |
OAM | gerrit.o-ran-sc.org/r/admin/repos/scp/oam/modeling | O-RAN | No company proprietary info | n/a for modeling | n/a for modeling | n/a for modeling | n/a for modeling | n/a for modeling | n/a for modeling | |
OAM (Portal RIC) | Apache 2.0 | Yes, file LICENSES.txt is in repo root; yes every code file has an appropriate header | No company proprietary info | Yes code is available in LF gerrit | Yes code is buildable | Yes the continuous integration (build) is performed in LF Jenkins | Yes 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 Status | Documentation | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | |||||||
OCU | https://gerrit.o-ran-sc.org/r/scp/ocu/openlte | O-RAN | not yetYes, file LICENSES.txt is in repo root; every code file has the claim | No company proprietary info | will upload before 11/04 working on the code upload now. | not yet | No | not yet | not yet | Yes | Yes | Yes* (sandbox buildable, helpdesk ticket to LF) | Yes | Yes | no |
ODUHIIGH
PTL: Sachin Srivastava
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||
ODUHIGH | 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 included | Yes | Yes | NoYes | Yes | Release 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 Status | Documentation | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||||
ODULOW | https://gerrit.o-ran-sc.org/r/o-du/phy | Apache2 | not yet LICENSE.txt is in the sub folder of the root of repo, need change the location | Yes | Yes | Yes | Yes | NoYes | not yetyes | noyes | no |
INF
PTL: Xiaohua Zhang
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||
INF | https://gerrit.o-ran-sc.org/r/admin/repos/pti/rtp | Apache2 | Yes | Yes |
Yes | Yes |
Yes* (waiting for LF merge) | Yes | Yes | No |
SIM
PTL: Alex Stancu
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | |||||||||||||||||||||||||||||||||||||||||
SIM | sim | Apache2 | No | No company proprietary info | No | SIM | sim/a1/o1-interface | Apache2 | NoYes | No company proprietary info. | NoYes | SIM | sim/e1-interface | Apache2 | No | No company proprietary info | No | Yes | Yes | SIM | sim/e2-interface | Apache2 | No | No company proprietary info | No | SIM | sim/f1-interface | Apache2 | No | No company proprietary info | No | SIM | sim/fh-interface | Apache2 | No | No company proprietary info | No | SIM | sim/o1-interface | Apache2 | No | No company proprietary info | Yes | Yes | No | No | No | No | not yet A demo is scheduled for first week of December including capturing of videos. |
DOC
PTL: weichen ni
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||
DOC | doc | CC 4.0 | No | No company proprietary info | N/A | N/A | N/A | In progress | no |
...
Project | Repos | License and Open Source Status | Code and Building Status | Documentation | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Apache2 or O-RAN | Claims included? | Proprietary info removed? | Code available | Buildable | LF CI integrated | Follow DOC | DOC buildable | Video demo | ||
INT | it/dep | Apache2 | Y | Y | Y | Y | PartiallyY | Y | Y | |
INT | it/test | Apache2 | Y | Y | Y | Y | Y | Y | Y | |
INT | it/dev | Apache2 | Y | Y | Y | N/A | N/A | Y | Y | N/A |
INT | it/otf | Apache2 | Y | Y | Y | Y | PartiallyY | Y | Y |