...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Completed
...
Completed
...
1.6.5 - sdc-tosca
1.4.1 - sdc-distribution-client
Consumed API from other projects
| Project | API Dependency | Notes |
|---|---|---|
| AAF | v2.1.21 | Completed |
| Dmaap | v1.1.11 | Completed |
| SDC | 1.6.5 - sdc-tosca 1.4.1 - sdc-distribution-client | Completed |
| AAI | aai-schema 1.7.2 | Completed |
| SO | REST - No direct link to any libraries | |
| VFC | REST - No direct link to any libraries | |
| SDNR | Dmaap - No direct link to any libraries | |
| SDNC | REST - No direct link to any libraries | |
| CDS | 0.4.4 | TODO |
Published API - These projects use the policy libraries to build their code
| Project | API | Notes |
|---|---|---|
| CLAMP | Policy Lifecycle API | implemented in own java code |
| OOF | Legacy Policy API | implemented in own python code |
| SDNC | Legacy Policy API | implemented in own code |
| DCAE | Policy Lifecycle API | Implemented own python code |
...
2. For any new changes to be done post-Release. Then the we must update to the next SNAPSHOT version:
Steps for Releasing and branching
| Release Order | Repo (released version) | Notes | Example Commit(s) for upgrading versions | ||||
|---|---|---|---|---|---|---|---|
| 1 | policy/parent 3.2.0 (TBD) | all pom.xml's version.properties | |||||
| 2a | policy/docker 2.1.1 | all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/parentdocker/+/104021114316 | ||||
| 2a2b | policy/ | dockercommon | 21.7.1 | .0 (TBD)all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/dockercommon/+/102678114285 | ||
| 2b3 | policy/ | commonmodels | 12. | 7.0 (TBD)3.5 | all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/ common104047 | |
| 34a | policy/modelsapi 2.3.0 (TBD)3 | all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/modelsapi/+/104232114288 | ||||
| 4a4b | policy/apipap 2.3.0 (TBD)3 | all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/apipap/+/104257114290 | ||||
| 4b4c | policy/papdrools-pdp 21.3.0 (TBD)7.4 | all pom.xml's version.properties In main pom.xml change the following propertiesconsider changing the policy.common.version property:
Update policy/drools-applications dockerfile to pull this image (see below) Update policy/drools-applications files:
| https://gerrit.onap.org/r/c/policy/ pap104262 | ||||
| 4c4d | policy/droolsapex-pdp 12.7.0 (TBD)4.4 | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:
Update policy/drools-applications dockerfile to pull this image (see below) Update policy/drools-applications files:
| https://gerrit.onap.org/r/c/policy/droolsapex-pdp/+/104291114292 | ||||
| 4d4e | policy/apexxacml-pdp 2.4.0 (TBD)3.3 | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:
| 4e | https://gerrit.onap.org/r/c/policy/xacml-pdp/+/114324 | |||
| 4f | policy/distribution 2.4.3.0 (TBD) | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:change the following properties
| https://gerrit.onap.org/r/c/policy/distribution/+/114291 | ||||
| 5 - Dependent only on policy/xacmldrools-pdp/+/104294 | 4f | policy/distributiondrools-applications 21.4.0 (TBD)7.5 | all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/distributiondrools-applications/+/104296 | 5 - Dependent only on policy/drools-pdp | policy/drools-applications 1.6.0 | https://gerrit.onap.org/r/c/policy/drools-applications/+/104408 |
When branching, its easiest to update the .gitreview file ON the new branch in order to ensure that new gerritt submissions are tracked on that branch.
If this is not done, then one should specify the branch when submitting the git review. 'git review guilin'
| Code Block |
|---|
[gerrit]
host=gerrit.onap.org
port=29418
project=policy/engine.git
defaultbranch=guilin |
When tagging for a release the following commands should be used:
| Code Block |
|---|
git tag -sm "7.0.0-ONAP Release" 7.0.0-ONAP
git push <remote-name> 7.0.0-ONAP |
When branching, its easiest to update the .gitreview file ON the new branch in order to ensure that new gerritt submissions are tracked on that branch.
If this is not done, then one should specify the branch when submitting the git review. 'git review guilin'
| Code Block |
|---|
[gerrit]
host=gerrit.onap.org
port=29418
project=policy/engine.git
defaultbranch=guilin |
When tagging for a release, the following commands can be used:
| Code Block |
|---|
git tag -sm "7.0.0-ONAP Release" 7.0.0-ONAP <optional-commit-id>
git push origin 7.0.0-ONAP |
Most likely you will need 'gpg2' installed and configured for git in order to sign the tags. NOTE: ONAP is requiring that the tags be signed.
Release tags are best to be applied against the last commit that was for an image release. However, sometimes that does not apply if an image did not require a new release. So its possible some tags will be on the same commit across releases (eg policy/docker is one repo where that is true). Depending on when branching happens, some tags may not be visible in a log for a specific branch. Best to use the online gerrit gui to see all the tags for a repo.
Steps for Releasing and branching |
|---|
Raise a review to refer released version of dependency (parent, common, models etc.) |
| Go to latest merged review of repo and comment “stage-release” |
It will trigger 2 Jenkins jobs - stage-master & docker-stage-master NOTE: The "docker-stage-master |
" job will fail for drools-applications |
Once the jobs are successful, create a yaml file for releasing maven artifacts first and raise a review |
. This file can typically be generated using this script: mkart.sh |
Once that is merged and build is successful, create another container.yaml file for releasing docker image and raise a review. This file can typically be generated using this script: mkdock.sh NOTE: Drools-applications will require a 2nd "stage-release" to be done |
due to the way it is built |
; the docker image requires the java artifacts to be released first, which are packaged into the image. |
| Once that is merged and build is successful, go to nexus3.onap.org & nexus.onap.org and verify that the image |
| & artifacts were released |
Bump the snapshot version to next patch version and raise a review - |
Use this command “mvn versions:set -DnewVersion= |
<snapshot-version>” Update the patch version in "version.properties" file. |
| Below steps are ONLY needed when we are branching and proceeding to new release |
| Once that is merged and build is successful, go to gerrit and create a |
| “guilin” branch. |
Once the branch is created, bump the master branch to next minor version using the same maven command and raise a review |
| Finally go to |
| guilin branch and change the .gitreview file to point to |
| guilin as default branch and raise the review. |