Overview
| Project Name | Enter the name of the project |
|---|---|
| Target Release Name | Dublin |
| Project Lifecycle State | Incubation |
| Participating Company | ARM, Orange, Amdocs, Huawei |
Scope
What is this release trying to address?
During the Dublin Release, CIA will put in practice the best practices and principles identified and validated during Casablanca.
By applying such best practices the project aims at alleviating two ONAP pain points
1. High resource consumption due to large large container images
2. Long build and deploy times due to large container images
3. The inability to run ONAP on more than one hardware platform (cpu architecture) and cloud infrastructure
Use Cases
This release is targeting ONAP's Minimal Environment and, as a stretch goal, the vFW use case.
Minimum Viable Product
The MVP for this release will be delivered in an incremental and iterative approach.
The work will be approached in phases:
Phase 1: Minimize the footprint of container images used on ONAP Minimal Environment
Phase 2: Build platform-agnostic container images (i.e. multi-cpu architecture support) for ONAP minimal environment
Phase 3: Minimize the footprint of container images used on the vFW use case.
Phase 4: Build platform-agnostic container images (i.e. multi-cpu architecture support) for ONAP minimal environment vFW use case.
Phase 5: Review Dockerfiles for the vFW use case, identify patterns and propose re-usable Dockerfile templates.
Functionalities
List the functionalities that this release is committing to deliver by providing a link to JIRA Epics and Stories. In the JIRA Priority field, specify the priority (either High, Medium, Low). The priority will be used in case de-scoping is required. Don't assign High priority to all functionalities.
Epics
Stories
Longer term roadmap
Working on the vFW use case will provide the foundation for the optimization of the entire onap container base.
The lessons learned during Casablanca will be put to use and refined during this release.
The next logical step is to expand, on futures releases, the containers and use cases that can benefit from producing efficient vendor-agnostic container images.
Release Deliverables
Indicate the outcome (Executable, Source Code, Library, API description, Tool, Documentation, Release Note...) of this release.
| Deliverable Name | Deliverable Description |
|---|---|
| Source code | Contributions in the form of: -modifications to the Dockerfile that generate container images. -modifications to Maven Docker plugin files -when appropriate, modifications to the build process |
Architecture
High level architecture diagram
Changes introduced to the code base by this project, as described above, fit within the ONAP architecture diagram.
Platform Maturity
Refering to CII Badging Security Program and Platform Maturity Requirements, fill out the table below by indicating the actual level , the targeted level for the current release and the evidences on how you plan to achieve the targeted level.
| Area | Actual Level | Targeted Level for current Release | How, Evidences | Comments |
|---|---|---|---|---|
| Manageability | Depends on each project and container image. | Level 2. | Container images show reduction in size. |
|
API Incoming Dependencies
No API dependencies are expected.
API Outgoing Dependencies
No API dependencies are expected and this project does not deliver APIs to other projects.
Third Party Products Dependencies
| Name | Description | Version |
|---|---|---|
| Docker | Docker engine | Linux/Intel version that supports docker manifest Linux/aarch64 version that supports docker manifest |
| Docker | Docker registry | Version that supports fat manifest. Current version of the ONAP registry has been reported to lack support for fat manifests. |
| Alpine | Alpine Linux | Latest version |
Testing and Integration Plan
Depending on the artifacts available on the code base of each project, changes made to the container build artifacts could undergo three levels of testing.
Sanity check
Contributors will verify that- The local build process completes successfully; with not container build errors.
- The build changes result in a structurally sound container image.
- Libraries and dependencies are resolved correctly.
Unit test
Contributors will verify that the container runs on their local development environment.
When available, contributors will execute test harnesses and unit tests provided by the project teamIntegration test
Contributed changes will be subject to the integration tests designed and executed by the project team.
CIA contributors have no control over these tests but could get involved to resolve any issue.
Gaps
This section is used to document a limitation on a functionality or platform support. We are currently aware of this limitation and it will be delivered in a future Release.
List identified release gaps (if any), and its impact.
| Gaps identified | Impact |
|---|---|
| ONAP Docker registry does not support manifest lists. | Multi-cpu architecture images can't be pushed to the ONAP registry. |
| LF arm-based build process/servers is work in progress. | Multi-cpu architecture images can't be built and delivered. |
Risks
List the risks identified for this release along with the plan to prevent the risk to occur (mitigation) and the plan of action in the case the risk would materialized (contingency).
| Risk identified | Mitigation Plan | Contingency Plan |
|---|---|---|
ONAP Docker registry does not support manifest lists. | Request an upgrade to the registry server to the LF team. | Use an alternative Docker registry server that supports manifest lists. |
Contributors are not committers and can't control modifications to the code base. | Meet project teams, make them aware of: -the S3P requirements -the contributions CIA is expected to bring -discuss testing options and artifacts -seek their buy in and collaboration | TBD |
Resources
Fill out the Resources Committed to the Release centralized page.
Release Milestone
The milestones are defined at the Release Level and all the supporting project agreed to comply with these dates.
Documentation, Training
- Highlight the team contributions to the specific document related to he project (Config guide, installation guide...).
- Highlight the team contributions to the overall Release Documentation and training asset
- High level list of documentation, training and tutorials necessary to understand the release capabilities, configuration and operation.
- Documentation includes items such as:
- Installation instructions
- Configuration instructions
- Developer guide
- End User guide
- Admin guide
- ...
Note
The Documentation project will provide the Documentation Tool Chain to edit, configure, store and publish all Documentation asset.
Other Information
Vendor Neutral
If this project is coming from an existing proprietary code base, ensure that all proprietary trademarks, logos, product names, etc. have been removed. All ONAP deliverables must comply with this rule and be agnostic of any proprietary symbols.
Free and Open Source Software
FOSS activities are critical to the delivery of the whole ONAP initiative. The information may not be fully available at Release Planning, however to avoid late refactoring, it is critical to accomplish this task as early as possible.
List all third party Free and Open Source Software used within the release and provide License type (BSD, MIT, Apache, GNU GPL,... ).
In the case non Apache License are found inform immediately the TSC and the Release Manager and document your reasoning on why you believe we can use a non Apache version 2 license.
Each project must edit its project table available at Project FOSS.
Charter Compliance
The project team comply with the ONAP Charter.l