...
| Project | API Dependency | Notes |
|---|---|---|
| AAF | v2.1.21 | |
| Dmaap | v1.1.11 | |
| SDC | 1.6.5 - sdc-tosca 1.4.1 - sdc-distribution-client | |
| AAI | aai-schema 1.7.2 | |
| 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 | 01.41.45 | TODOGRPC Library |
Published API - These projects use the policy libraries to build their code
...
2. For any new changes to be done post-Release. Then the we must update to the next SNAPSHOT version:
| Release Order | Repo (released version) | Notes | Example Commit(s) for upgrading versions |
|---|---|---|---|
| 1 | policy/parent 3.4.3 |
Update version of parent-resources in parent-integration in a previous review. all pom.xml's version.properties |
| 2a | policy/docker 2. |
3.1 | No maven artifacts are released. Release docker images all pom.xml's version.properties In main pom.xml change the following properties
In db-migrator Dockerfile
Update Dockerfile in all repos with new version Use this command to find Dockerfiles | https://gerrit.onap.org/r/c/policy/docker/+/124851 https://gerrit.onap.org/r/c/policy/docker/+/124866 |
https://gerrit.onap.org/r/c/policy/docker/+/124973 | |
| 2b | policy/common 1. |
9. |
1 | all pom.xml's version.properties In main pom.xml change the following properties
|
https://gerrit.onap.org/r/c/policy/common/+/124867 https://gerrit.onap.org/r/c/policy/common/+/124879 | |
| 3 | policy/models 2. |
5. |
1 | all pom.xml's version.properties In main pom.xml change the following properties
|
https://gerrit.onap.org/r/c/policy/models/+/124917 | |
| 4a | policy/api 2. |
5. |
1 | all pom.xml's version.properties In main pom.xml change the following properties
In Dockerfile
|
https://gerrit.onap.org/r/c/policy/api/+/124952 https://gerrit.onap.org/r/c/policy/api/+/124957 https://gerrit.onap.org/r/c/policy/api/+/124966 | |
| 4b | policy/pap 2. |
5. |
1 | all pom.xml's version.properties In main pom.xml change the following properties
In Dockerfile
|
https://gerrit.onap.org/r/c/policy/pap/+/124956 https://gerrit.onap.org/r/c/policy/pap/+/124965 https://gerrit.onap.org/r/c/policy/pap/+/124968 | |
| 4c | policy/drools-pdp 1. |
9. |
1 | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:
In Dockerfile
Update policy/drools-applications dockerfile to pull this image (see below) Update policy/drools-applications files:
| https://gerrit.onap.org/r/c/policy/drools-pdp/+/124898 https://gerrit.onap.org/r/c/policy/drools-pdp/+/124920 https://gerrit.onap.org/r/c/policy/drools-pdp/+/124925 https://gerrit.onap.org/r/c/policy/drools-pdp/+/124976 |
| 4d | policy/apex-pdp 2. |
6. |
1 | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:
In Dockerfile
|
https://gerrit.onap.org/r/c/policy/apex-pdp/+/124915 https://gerrit.onap.org/r/c/policy/apex-pdp/+/124945 https://gerrit.onap.org/r/c/policy/apex-pdp/+/124950 | |
| 4e | policy/xacml-pdp 2. |
5. |
1 | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:
In Dockerfile
| https://gerrit.onap.org/r/c/policy/xacml-pdp/+/124899 |
https://gerrit.onap.org/r/c/policy/xacml-pdp/+/124978 | |
| 4f | policy/distribution 2. |
6. |
1 | all pom.xml's version.properties In main pom.xml change the following properties
In Dockerfile
| https://gerrit.onap.org/r/c/policy/distribution/+/124904 https://gerrit.onap.org/r/c/policy/distribution/+/124954 https://gerrit.onap.org/r/c/policy/distribution/+/124958 |
| 4g | policy/clamp 6. |
1. |
3 | all pom.xml's version.properties In main pom.xml change the following properties
In Dockerfile
| https://gerrit.onap.org/r/c/policy/clamp/+/124903 https://gerrit.onap.org/r/c/policy/clamp/+/124922 https://gerrit.onap.org/r/c/policy/clamp/+/124947 |
| 4h | policy/gui 2.1.1 | all pom.xml's version.properties In main pom.xml consider changing the policy.common.version property:
In Dockerfile
| https://gerrit.onap.org/r/c/policy/gui/+/124902 https://gerrit.onap.org/r/c/policy/gui/+/124916 https://gerrit.onap.org/r/c/policy/gui/+/124941 https://gerrit.onap.org/r/c/policy/gui/+/124963 |
| 5 - Dependent only on policy/drools-pdp | policy/drools-applications 1. |
9. |
1 | all pom.xml's version.properties In main pom.xml change the following properties
| https://gerrit.onap.org/r/c/policy/drools-applications/+/124901 https://gerrit.onap.org/r/c/policy/drools-applications/+/124959 https://gerrit.onap.org/r/c/policy/drools-applications/+/124982 https://gerrit.onap.org/r/c/policy/drools-applications/+/124988 |
https://gerrit.onap.org/r/c/policy/drools-applications/+/124998 |
When branching, its easiest to update the .gitreview file ON the new branch in order to ensure that new gerrit submissions are tracked on that branch.
If this is not done, then one should specify the branch when submitting the git review. 'git review guilinhonolulu'
| Code Block |
|---|
[gerrit] host=gerrit.onap.org port=29418 project=policy/engine.git defaultbranch=guilinhonolulu |
When tagging for a release, the following commands can be used:
| Code Block |
|---|
git tag -sm "89.0.0-ONAP Release" 89.0.0-ONAP <optional-commit-id> git push origin 89.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.
...
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 “honolulu” “istanbul” branch. |
Once the branch is created, bump the master branch to next minor version using the same maven command, update the dependencies to the new SNAPSHOT versions, and raise a review |
| Finally go to honolulu istanbul branch and change the .gitreview file to point to honolulu istanbul as default branch and raise the review. |
...