[VOL-5009] - Update release notes
[VOL-5061]
overview/releases.rst
---------------------
o Correct start/end release dates for v2.10-v2.12 to reflect reality.
release_notes/voltha_2.12.rst
-----------------------------
o Populate the onos apps grid with versioned artifact and VCS urls.
o Component kafka the only holdout
howto/release/checklist.rst
howto/release/components/index.rst
howto/release/index.rst
howto/release/voltha-docs/index.rst
howto/release/voltha-docs/release_notes.rst
howto/release/branching/
howto/release/components/igmpproxy/
howto/release/components/kafka/
howto/release/components/maclearner/
howto/release/components/pppoeagent/
howto/release/voltha-docs/release_history.rst
---------------------------------------------
o Add more random content and links for release dependencies and tasks.
Change-Id: I31338488a4e626a97435429a36e200d54cf6267e
diff --git a/howto/release/branching/index.rst b/howto/release/branching/index.rst
new file mode 100644
index 0000000..ae389f0
--- /dev/null
+++ b/howto/release/branching/index.rst
@@ -0,0 +1,6 @@
+Release Branching Tasks
+=======================
+- `VOL-5063 <https://jira.opencord.org/browse/VOL-5063>`_
+
+ - Freeze version of voltctl captured by the build docker image target.
+
diff --git a/howto/release/checklist.rst b/howto/release/checklist.rst
index 789d779..206ac9d 100644
--- a/howto/release/checklist.rst
+++ b/howto/release/checklist.rst
@@ -55,7 +55,46 @@
Helm Charts
-----------
+voltha-infra
+^^^^^^^^^^^^
+
Once dependent packages are built update helm charts: charts/index
+- Verify by `installation <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts>`_
+
+.. code:: bash
+
+ helm upgrade --install --create-namespace -n infra --version 2.8.0 voltha-infra onf/voltha-infra
+
+voltha-stack
+^^^^^^^^^^^^
+
+.. code:: bash
+
+ helm upgrade --install --create-namespace \
+ -n voltha voltha onf/voltha-stack \
+ --set global.stack_name=voltha \
+ --set global.voltha_infra_name=voltha-infra \
+ --set global.voltha_infra_namespace=infra
+
+Verify DT & TT
+^^^^^^^^^^^^^^
+
+`deploying-a-different-workflow <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts#deploying-a-different-workflow>`_
+
+Update
+https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts/+/refs/heads/master/voltha-stack/Chart.yaml
+
+
+Misc
+^^^^
+
+.. code:: bash
+
+ helm upgrade --install -n voltha bbsim0 onf/bbsim --set olt_id=10
+
+ # https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts#deploying-a-different-workflow
+ kubectl get pods --all-namespaces
+
Voltha with golang source
-------------------------
@@ -115,3 +154,7 @@
- Update go mod files
Review `voltha-helm-charts <https://gerrit.opencord.org/plugins/gitiles/voltha-helm-charts>`_
+
+Release voltha-protos & friends in order
+----------------------------------------
+https://docs.voltha.org/master/overview/release_process.html?highlight=charts%20yaml
diff --git a/howto/release/components/igmpproxy/index.rst b/howto/release/components/igmpproxy/index.rst
new file mode 100644
index 0000000..d6c96f4
--- /dev/null
+++ b/howto/release/components/igmpproxy/index.rst
@@ -0,0 +1,17 @@
+ONOS Component: mcast
+=====================
+
+Repository: igmpproxy
+App: igmpproxy
+
+Dependencies (pom.xml)
+----------------------
+
+- sadis
+
+Dependencies (Maven plugins)
+----------------------------
+
+- spotbugs-maven-plugin v4.7.3.4
+- findsecbugs-plugin v1.12.0
+
diff --git a/howto/release/components/index.rst b/howto/release/components/index.rst
index 3910d27..7001c48 100644
--- a/howto/release/components/index.rst
+++ b/howto/release/components/index.rst
@@ -4,6 +4,14 @@
.. toctree::
:maxdepth: 1
+ igmpproxy/index
+ kafka/index
+ maclearner/index
+ mcast/index
+ olt/index
+ olttopology/index
+ pppoeagent/index
+
onos_components
onos_dependencies
maven_plugins
@@ -19,13 +27,6 @@
atomix/index
onos/index
- maclearner/index
- mcast/index
- olt/index
- olttopology/index
- pppoeagent/index
-
-
See Also
--------
`VOLTHA and ONOS update procedures <https://docs.voltha.org/master/operations/software-upgrade.html?highlight=set%20global%20image>`_.
diff --git a/howto/release/components/kafka/index.rst b/howto/release/components/kafka/index.rst
new file mode 100644
index 0000000..113f6a4
--- /dev/null
+++ b/howto/release/components/kafka/index.rst
@@ -0,0 +1,21 @@
+ONOS Component: mcast
+=====================
+
+Repository: kafka-onos (ssh://gerrit.opencord.org:29418/kafka-onos)
+App: kafka
+
+Dependencies (pom.xml)
+----------------------
+
+- sadis
+- onlab-junit
+
+Dependencies (Maven plugins)
+----------------------------
+
+- spotbugs-maven-plugin v4.7.3.4
+- findsecbugs-plugin v1.12.0
+- `org.apache.servicemix.bundles.kafka-clients <https://mvnrepository.com/artifact/org.apache.servicemix.bundles/org.apache.servicemix.bundles.kafka-clients>`_
+
+ - 3.4.0_1
+ - 1.1.1_1
diff --git a/howto/release/components/maclearner/index.rst b/howto/release/components/maclearner/index.rst
index 5020439..05327d6 100644
--- a/howto/release/components/maclearner/index.rst
+++ b/howto/release/components/maclearner/index.rst
@@ -1,6 +1,9 @@
ONOS Component: maclearner
==========================
+Repository: mac-learning
+App: maclearner
+
Dependencies (pom.xml)
----------------------
@@ -10,4 +13,14 @@
`gerrit:mac-learning <https://gerrit.opencord.org/plugins/gitiles/mac-learning/+/refs/tags/1.2.1>`_
`maven central:maclearner <https://central.sonatype.com/artifact/org.opencord/maclearner/1.2.1>`_
+
pom.xml:maclearner
+==================
+- sadis
+- onlab-junit
+
+Dependencies (Maven plugins)
+----------------------------
+
+- spotbugs-maven-plugin v4.7.3.4
+- findsecbugs-plugin v1.12.0
diff --git a/howto/release/components/pppoeagent/index.rst b/howto/release/components/pppoeagent/index.rst
index 9e81c46..4de5f77 100644
--- a/howto/release/components/pppoeagent/index.rst
+++ b/howto/release/components/pppoeagent/index.rst
@@ -12,3 +12,15 @@
- Components
- sadis
+
+- Repository
+
+ `pppoeagent <https://gerrit.opencord.org/plugins/gitiles/pppoeagent>`_
+ `gerrit:122 <https://gerrit.opencord.org/plugins/gitiles/pppoeagent/+/refs/tags/1.2.2>`_
+ `github:122 <https://github.com/opencord/pppoeagent/tree/1.2.2>`_
+
+- `Maven Central <https://central.sonatype.com/search?q=pppoeagent>`_
+
+ - `pkg:121 <https://central.sonatype.com/artifact/org.opencord/pppoeagent/1.2.1>`_
+ - `api:121 <https://central.sonatype.com/artifact/org.opencord/pppoeagent-api/1.2.1>`_
+ - `app:121 <https://central.sonatype.com/artifact/org.opencord/pppoeagent-app/1.2.1>`_
diff --git a/howto/release/index.rst b/howto/release/index.rst
index e1d998c..06b7d39 100644
--- a/howto/release/index.rst
+++ b/howto/release/index.rst
@@ -7,6 +7,7 @@
preparation
release-notes
+ branching/index
ci-management/index
components/index
hierarchy/index
diff --git a/howto/release/release-notes.rst b/howto/release/release-notes.rst
index 6e762dc..c9f1c23 100644
--- a/howto/release/release-notes.rst
+++ b/howto/release/release-notes.rst
@@ -28,7 +28,7 @@
- Add `release_notes/voltha_2.12.rst <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/release_notes/voltha_2.11.rst>`_ in the index file `release_notes/index.rst <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/release_notes/index.rst>`_
-- Modify `config.py <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/conf.py#308>`_ so ``make linkcheck`` will not fail on yet-to-be-generated html release notes file.
+- Modify `config.py <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/conf.py>`_ so ``make linkcheck`` will not fail on yet-to-be-generated html release notes file.
- Release notes: content and hilights:
diff --git a/howto/release/voltha-docs/index.rst b/howto/release/voltha-docs/index.rst
index 2d3441b..3b2534f 100644
--- a/howto/release/voltha-docs/index.rst
+++ b/howto/release/voltha-docs/index.rst
@@ -10,4 +10,5 @@
:maxdepth: 1
release_notes
+ release_history
create_lts_view
diff --git a/howto/release/voltha-docs/release_history.rst b/howto/release/voltha-docs/release_history.rst
new file mode 100644
index 0000000..f65fd91
--- /dev/null
+++ b/howto/release/voltha-docs/release_history.rst
@@ -0,0 +1,15 @@
+docs.voltha.org VOLTHA Releases
+===============================
+
+Intent
+------
+
+Update the VOLTHA Releases page to note date of release, end-of-support
+date and LTS, Long Term Support release candidates.
+
+Source
+------
+
+- `overview/releases.html <https://docs.voltha.org/master/overview/releases.html>`_
+- `overview/releases.rst <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/overview/releases.rst>`_
+
diff --git a/howto/release/voltha-docs/release_notes.rst b/howto/release/voltha-docs/release_notes.rst
index 544fb06..869e022 100644
--- a/howto/release/voltha-docs/release_notes.rst
+++ b/howto/release/voltha-docs/release_notes.rst
@@ -14,3 +14,31 @@
- Naviagate to the `release_notes <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/release_notes/>`_ folder.
- Copy the last voltha_X.Y.rst document name name it for the upcoming release.
- Update `index.rst <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/release_notes/index.rst>`_ so documents are displayed in order.
+
+Release Notes
+-------------
+
+- Sections at the top Hilights, Features, Bug Fixes are normally written by TSTs with help from community members.
+- Now search for the "Component Versions in VOLTHA" section.
+
+ - All of the pkg/api/app version strings will need to be captured in a grid.
+ - If an upgrade wiki page was maintained during release builds the task
+ is easy, just copy build status info from the wiki.
+ - If information was not tracked while packages were built, this step will become all manual lookup activity.
+
+Component Versions in VOLTHA 2.12 release
+
+See Also
+--------
+
+- Release tracking
+
+ - `jira tickets <https://jira.opencord.org/browse/VOL-5019>`_
+ - `Wiki(s) <https://wiki.opennetworking.org/display/VOLTHA/v2.12>`_
+
+ - `Published artifact and versions <https://wiki.opennetworking.org/display/VOLTHA/v2.12+Deployments>`_
+
+- Release notes template
+
+ - Rendered html `docs.voltha.org <https://docs.voltha.org/master/release_notes/template.html>`_
+ - Markup source `rst <https://gerrit.opencord.org/plugins/gitiles/voltha-docs/+/refs/heads/master/release_notes/template.rst>`_