Update release documentation
overview/release_process.rst
----------------------------
o Document nuances with branch/tag creation and tagnames for release
Signed-off-by: Joey Armstrong <jarmstrong@linuxfoundation.org>
Change-Id: Id300addca04025f5d6e22f8f2b8fbef4c50bb2bc
diff --git a/VERSION b/VERSION
index 5850a50..1700434 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2.12.45-dev1
+2.12.45-dev2
diff --git a/overview/release_process.rst b/overview/release_process.rst
index 1b687c1..ae4d6e1 100644
--- a/overview/release_process.rst
+++ b/overview/release_process.rst
@@ -18,8 +18,9 @@
release candidate (RC) for the release.
A release can be considered ready if the tests on Jenkins pass with no issue, both on hardware and bbsim jobs.
-Component releasing and Lazy Branching
---------------------------------------
+Component releasing and Lazy Branching (legacy)
+-----------------------------------------------
+
In VOLTHA for a release we release components (services) and lazy branch when/if needed.
Once a component (service) is ready to be released we increase the version in the VERSION file,
going from the -dev or released version x.y.z to either a higher number in minor version (y) or in bug version (z).
@@ -32,8 +33,9 @@
-dev suffix because chart publishing requires that every new chart version be unique and using un-suffixed SemVer is a
better release numbering pattern.
-If a repository is branched the `.gitreview` file needs to be changed, adding `defaultorigin=voltha-X.Y` at the end.
-
+If a repository is branched the :doc:`.gitreview <howto/release/post-release/gitreview.html>`
+file needs to be changed, adding `defaultorigin=voltha-X.Y` at the end.
+
.. note::
Given the dependency of the containers on the protos and the library, if the voltha-protos and/or voltha-lib-go or
omci-lib-go need to be released, it should be done first and then updated in the components:
@@ -55,7 +57,6 @@
- `Openolt Adapter <https://github.com/opencord/voltha-openolt-adapter>`_
- `Openolt Agent <https://github.com/opencord/openolt>`_
- `ONOS controller <https://github.com/opencord/voltha-onos>`_ (Note, only do it after releasing all the apps below)
-- `BBSIM <https://github.com/opencord/bbsim>`_
- `BBSIM Sadis Server <https://github.com/opencord/bbsim-sadis-server>`_
Libraries and APIs:
@@ -66,6 +67,7 @@
Tools:
+- `BBSIM <https://github.com/opencord/bbsim>`_
- `voltctl <https://github.com/opencord/voltctl>`_
Configuration:
@@ -94,6 +96,7 @@
- jdkDistro: java-11-amazon-corretto
2. Wait for build to complete
+
3. Merge the component patches on gerrit
- `View <https://gerrit.opencord.org/q/owner:do-not-reply%2540opennetworking.org>`_
- Two pull requests are created modifying pom.xml.
@@ -146,6 +149,47 @@
- `Sadis <https://github.com/opencord/sadis>`_
+Component releasing and Branching (variations)
+----------------------------------------------
+
+- Tagnames
+
+ .. list-table:: Tagnames
+ :widths: 10, 40
+
+ * - Format
+ - Description
+ * - 1.2.3.4
+ - Default tagname syntax is a semver
+ * - v1.2.3.4
+ - Repos that contain golang code use tagname {vee}{semver}
+
+- branch-then-tag
+
+ - Only for "primary" repositories: ci, docs, helm & test
+ - Step[1] - create a branch named voltha-X.Y
+ - Step[2] - tag repository attached to branch voltha-X.Y
+
+- tag-then-branch
+
+ - Default/non-primary VOLTHA repos and ONOS components.
+ - Step[1] - tag repository attached to master branch.
+ - Step[2] - create a branch named attached to the release tag.
+
+
+Lazy Branching
+--------------
+
+Since the v2.11 release all VOLTHA repositories have been branched/tags
+during release. Explicitly branching all repositoreis provides two benefits,
+first explict release branching helps avoid blocking on branch creation
+while creating hotfix branches. Second benefit is all branch/tagged
+repositories are dated to a release timeframe rather than posted dated
+when hotfix patch creation is needed.
+
+- Primary repos (ci, docs, helm, test)
+
+
Creating the release
--------------------