*** PROPOSAL FOR DISCUSSION ***
Target
Increase transparency on software modules (repositories) included in an ONAP release to enable effective and efficient ...
- security management
ONAP must not depend on unmaintained software modules / projects
- release management
- documentation management
Provide reliable information for an ONAP release ...
- which software module (repository) is included (was used to build the docker container)
- which version of the software module is included (was used to build the docker container)
Current Situation
- A deployable ONAP release consists of 'maintained' an 'unmaintained' software modules (used to build the docker container)
- Only 'projects' are managed in the release process
- But a 'project' consists of 1-n repositories. Repositories are not managed in the release process.
- Only 'maintained' projects are managed in the release process.
- But "unmaintained" software modules (docker container) are added to the list of deployed software modules in the end of the release process
- The management of 'release participation' is limited (projects/repositories), distributed (relmgr, oom, sec, doc) and is not done in an end-to-end manner
- Information about the lifecycle state of projects and repositories and their release participation is distributed, manually maintained and not in sync (GIT:active|readonly, INFO.YAML, WIKI:release participation, WIKI:project lifecycle state, WIKI:documentation, ...)
Proposal
The information about software modules included in an ONAP release must be managed ...
- from the start of the release process (planning phase)
- to the end of the release process
- building the deployable release
- building the release specific documentation
- consistently (one single source) for all stakeholder (rel mgr, projects, oom, sec, doc, ...)
- with a high grade of automation
To participate in a ONAP release, a software module ...
- must be in the 'maintained' state
- must have created a release branch
- must have updated their documentation to reflect the current state of development
- must have up-to-date release notes (on sub-project level or in main project)
Stakeholders (relmgr, oom, sec, doc) are only using/managing maintained software components / projects.
The release process ensures the compliance and provides appropriate means to check and react in a timely manner.
Additional Information
Excel Spreadsheet
onap_tables_211108_master_istanbul_updates_only.xlsx
conf.py (istanbul) showing the current situation for documentation