Adds helm chart to app version matrix

* Previously, there was not an easy way to correlate the app version to a helm chart version. Many people ask this question in public slack channel or must get data themselves. This adds a script to produce the desired matrix data as a table, json, or yaml output to help folks who are upgrading. Signed-off-by: Corey Osman <[email protected]>
linkerd · Nov 21, 2023 · 1f21c46 · 1f21c46
1 parent a611443
commit 1f21c46
Show file tree

Hide file tree

Showing 5 changed files with 329 additions and 0 deletions.
diff --git a/Makefile b/Makefile
@@ -140,10 +140,20 @@ replace-env-%: has-env-% tmp-sites
 		sed 's/$*/$($*)/g' < $$fname > /tmp/__sed && mv /tmp/__sed $$fname; \
 	done
 
+.PHONY: build-release-matrix
+build-release-matrix:
+	@# Build release matrix
+	./bin/generate_release_matrix.py --format=table --update_repo > linkerd.io/content/releases/release-matrix-table.md
+	./bin/generate_release_matrix.py --format=json > linkerd.io/content/releases/release-matrix.json
+	./bin/generate_release_matrix.py --format=yaml > linkerd.io/content/releases/release-matrix.yaml
+
+
 .PHONY: has-env-%
 has-env-%:
 	@if [ ! $${$*:-} ]; then printf "You must define: $*\n" && exit 1; fi
 
 .PHONY: clean
 clean:
 	rm -rf tmp
+
+
diff --git a/linkerd.io/content/releases/_index.md b/linkerd.io/content/releases/_index.md
@@ -36,6 +36,63 @@ bugfixes or enhancements.
 Commercial providers of Linkerd (e.g. [Buoyant](https://buoyant.io)) may
 provide stronger support guarantees.
 
+### Helm Version Matrix
+The following version matrices include only the latest versions of the stable releases along with corresponding app and helm versions for linkerd and extensions.  Use these to guide you to the right helm chart version or to automate workflows you might have.
+
+* [YAML matrix](./release-matrix.yaml)
+* [JSON matrix](./release-matrix.json)
+
+
+--------------------------------------------------------------------
+| App Version   | Chart Name                     | Chart Version   |
+|---------------|--------------------------------|-----------------|
+| stable-2.14.4 | linkerd2/linkerd-control-plane | 1.16.5          |
+| stable-2.14.4 | linkerd2/linkerd2-crds         | 1.8.0           |
+| stable-2.14.4 | linkerd2/linkerd-jaeger        | 30.12.5         |
+| stable-2.14.4 | linkerd2/linkerd-multicluster  | 30.11.5         |
+| stable-2.14.4 | linkerd2/linkerd-viz           | 30.12.5         |
+| stable-2.14.4 | linkerd2/linkerd2-cni          | 30.12.1         |
+
+
+| App Version   | Chart Name                     | Chart Version   |
+|---------------|--------------------------------|-----------------|
+| stable-2.13.7 | linkerd2/linkerd-control-plane | 1.12.7          |
+| stable-2.13.7 | linkerd2/linkerd2-crds         | 1.6.1           |
+| stable-2.13.7 | linkerd2/linkerd-jaeger        | 30.8.7          |
+| stable-2.13.7 | linkerd2/linkerd-multicluster  | 30.7.7          |
+| stable-2.13.7 | linkerd2/linkerd-viz           | 30.8.7          |
+| stable-2.13.7 | linkerd2/linkerd2-cni          | 30.8.5          |
+
+
+| App Version   | Chart Name                     | Chart Version   |
+|---------------|--------------------------------|-----------------|
+| stable-2.12.6 | linkerd2/linkerd-control-plane | 1.9.8           |
+| stable-2.12.6 | linkerd2/linkerd2-crds         | 1.6.1           |
+| stable-2.12.6 | linkerd2/linkerd-jaeger        | 30.4.8          |
+| stable-2.12.6 | linkerd2/linkerd-multicluster  | 30.2.8          |
+| stable-2.12.6 | linkerd2/linkerd-viz           | 30.3.8          |
+| stable-2.12.6 | linkerd2/linkerd2-cni          | 30.3.8          |
+
+
+| App Version   | Chart Name                    | Chart Version   |
+|---------------|-------------------------------|-----------------|
+| stable-2.11.5 | linkerd2/linkerd-jaeger       | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd2             | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd-multicluster | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd-viz          | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd2-cni         | 2.11.5          |
+
+
+| App Version   | Chart Name                    | Chart Version   |
+|---------------|-------------------------------|-----------------|
+| stable-2.10.2 | linkerd2/linkerd-jaeger       | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd2             | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd-multicluster | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd-viz          | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd2-cni         | 2.10.2          |
+
+
+
 ## Edge (latest version: {{% latestedge %}})
 
 Edge releases are frequent (usually, weekly) and can be used to work with the

diff --git a/linkerd.io/content/releases/release-matrix-table.md b/linkerd.io/content/releases/release-matrix-table.md
@@ -0,0 +1,48 @@
+| App Version   | Chart Name                     | Chart Version   |
+|---------------|--------------------------------|-----------------|
+| stable-2.14.4 | linkerd2/linkerd-control-plane | 1.16.5          |
+| stable-2.14.4 | linkerd2/linkerd2-crds         | 1.8.0           |
+| stable-2.14.4 | linkerd2/linkerd-jaeger        | 30.12.5         |
+| stable-2.14.4 | linkerd2/linkerd-multicluster  | 30.11.5         |
+| stable-2.14.4 | linkerd2/linkerd-viz           | 30.12.5         |
+| stable-2.14.4 | linkerd2/linkerd2-cni          | 30.12.1         |
+
+
+| App Version   | Chart Name                     | Chart Version   |
+|---------------|--------------------------------|-----------------|
+| stable-2.13.7 | linkerd2/linkerd-control-plane | 1.12.7          |
+| stable-2.13.7 | linkerd2/linkerd2-crds         | 1.6.1           |
+| stable-2.13.7 | linkerd2/linkerd-jaeger        | 30.8.7          |
+| stable-2.13.7 | linkerd2/linkerd-multicluster  | 30.7.7          |
+| stable-2.13.7 | linkerd2/linkerd-viz           | 30.8.7          |
+| stable-2.13.7 | linkerd2/linkerd2-cni          | 30.8.5          |
+
+
+| App Version   | Chart Name                     | Chart Version   |
+|---------------|--------------------------------|-----------------|
+| stable-2.12.6 | linkerd2/linkerd-control-plane | 1.9.8           |
+| stable-2.12.6 | linkerd2/linkerd2-crds         | 1.6.1           |
+| stable-2.12.6 | linkerd2/linkerd-jaeger        | 30.4.8          |
+| stable-2.12.6 | linkerd2/linkerd-multicluster  | 30.2.8          |
+| stable-2.12.6 | linkerd2/linkerd-viz           | 30.3.8          |
+| stable-2.12.6 | linkerd2/linkerd2-cni          | 30.3.8          |
+
+
+| App Version   | Chart Name                    | Chart Version   |
+|---------------|-------------------------------|-----------------|
+| stable-2.11.5 | linkerd2/linkerd-jaeger       | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd2             | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd-multicluster | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd-viz          | 2.11.5          |
+| stable-2.11.5 | linkerd2/linkerd2-cni         | 2.11.5          |
+
+
+| App Version   | Chart Name                    | Chart Version   |
+|---------------|-------------------------------|-----------------|
+| stable-2.10.2 | linkerd2/linkerd-jaeger       | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd2             | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd-multicluster | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd-viz          | 2.10.2          |
+| stable-2.10.2 | linkerd2/linkerd2-cni         | 2.10.2          |
+
+
diff --git a/linkerd.io/content/releases/release-matrix.json b/linkerd.io/content/releases/release-matrix.json
@@ -0,0 +1,124 @@
+{
+    "stable-2.13.7": {
+        "linkerd-control-plane": {
+            "chart_name": "linkerd2/linkerd-control-plane",
+            "chart_version": "1.12.7"
+        },
+        "linkerd2-crds": {
+            "chart_name": "linkerd2/linkerd2-crds",
+            "chart_version": "1.6.1"
+        },
+        "linkerd-jaeger": {
+            "chart_name": "linkerd2/linkerd-jaeger",
+            "chart_version": "30.8.7"
+        },
+        "linkerd-multicluster": {
+            "chart_name": "linkerd2/linkerd-multicluster",
+            "chart_version": "30.7.7"
+        },
+        "linkerd-viz": {
+            "chart_name": "linkerd2/linkerd-viz",
+            "chart_version": "30.8.7"
+        },
+        "linkerd2-cni": {
+            "chart_name": "linkerd2/linkerd2-cni",
+            "chart_version": "30.8.5"
+        }
+    },
+    "stable-2.14.4": {
+        "linkerd-control-plane": {
+            "chart_name": "linkerd2/linkerd-control-plane",
+            "chart_version": "1.16.5"
+        },
+        "linkerd2-crds": {
+            "chart_name": "linkerd2/linkerd2-crds",
+            "chart_version": "1.8.0"
+        },
+        "linkerd-jaeger": {
+            "chart_name": "linkerd2/linkerd-jaeger",
+            "chart_version": "30.12.5"
+        },
+        "linkerd-multicluster": {
+            "chart_name": "linkerd2/linkerd-multicluster",
+            "chart_version": "30.11.5"
+        },
+        "linkerd-viz": {
+            "chart_name": "linkerd2/linkerd-viz",
+            "chart_version": "30.12.5"
+        },
+        "linkerd2-cni": {
+            "chart_name": "linkerd2/linkerd2-cni",
+            "chart_version": "30.12.1"
+        }
+    },
+    "stable-2.12.6": {
+        "linkerd-control-plane": {
+            "chart_name": "linkerd2/linkerd-control-plane",
+            "chart_version": "1.9.8"
+        },
+        "linkerd2-crds": {
+            "chart_name": "linkerd2/linkerd2-crds",
+            "chart_version": "1.6.1"
+        },
+        "linkerd-jaeger": {
+            "chart_name": "linkerd2/linkerd-jaeger",
+            "chart_version": "30.4.8"
+        },
+        "linkerd-multicluster": {
+            "chart_name": "linkerd2/linkerd-multicluster",
+            "chart_version": "30.2.8"
+        },
+        "linkerd-viz": {
+            "chart_name": "linkerd2/linkerd-viz",
+            "chart_version": "30.3.8"
+        },
+        "linkerd2-cni": {
+            "chart_name": "linkerd2/linkerd2-cni",
+            "chart_version": "30.3.8"
+        }
+    },
+    "stable-2.10.2": {
+        "linkerd-jaeger": {
+            "chart_name": "linkerd2/linkerd-jaeger",
+            "chart_version": "2.10.2"
+        },
+        "linkerd2": {
+            "chart_name": "linkerd2/linkerd2",
+            "chart_version": "2.10.2"
+        },
+        "linkerd-multicluster": {
+            "chart_name": "linkerd2/linkerd-multicluster",
+            "chart_version": "2.10.2"
+        },
+        "linkerd-viz": {
+            "chart_name": "linkerd2/linkerd-viz",
+            "chart_version": "2.10.2"
+        },
+        "linkerd2-cni": {
+            "chart_name": "linkerd2/linkerd2-cni",
+            "chart_version": "2.10.2"
+        }
+    },
+    "stable-2.11.5": {
+        "linkerd-jaeger": {
+            "chart_name": "linkerd2/linkerd-jaeger",
+            "chart_version": "2.11.5"
+        },
+        "linkerd2": {
+            "chart_name": "linkerd2/linkerd2",
+            "chart_version": "2.11.5"
+        },
+        "linkerd-multicluster": {
+            "chart_name": "linkerd2/linkerd-multicluster",
+            "chart_version": "2.11.5"
+        },
+        "linkerd-viz": {
+            "chart_name": "linkerd2/linkerd-viz",
+            "chart_version": "2.11.5"
+        },
+        "linkerd2-cni": {
+            "chart_name": "linkerd2/linkerd2-cni",
+            "chart_version": "2.11.5"
+        }
+    }
+}
diff --git a/linkerd.io/content/releases/release-matrix.yaml b/linkerd.io/content/releases/release-matrix.yaml
@@ -0,0 +1,90 @@
+stable-2.10.2:
+    linkerd-jaeger:
+        chart_name: linkerd2/linkerd-jaeger
+        chart_version: 2.10.2
+    linkerd-multicluster:
+        chart_name: linkerd2/linkerd-multicluster
+        chart_version: 2.10.2
+    linkerd-viz:
+        chart_name: linkerd2/linkerd-viz
+        chart_version: 2.10.2
+    linkerd2:
+        chart_name: linkerd2/linkerd2
+        chart_version: 2.10.2
+    linkerd2-cni:
+        chart_name: linkerd2/linkerd2-cni
+        chart_version: 2.10.2
+stable-2.11.5:
+    linkerd-jaeger:
+        chart_name: linkerd2/linkerd-jaeger
+        chart_version: 2.11.5
+    linkerd-multicluster:
+        chart_name: linkerd2/linkerd-multicluster
+        chart_version: 2.11.5
+    linkerd-viz:
+        chart_name: linkerd2/linkerd-viz
+        chart_version: 2.11.5
+    linkerd2:
+        chart_name: linkerd2/linkerd2
+        chart_version: 2.11.5
+    linkerd2-cni:
+        chart_name: linkerd2/linkerd2-cni
+        chart_version: 2.11.5
+stable-2.12.6:
+    linkerd-control-plane:
+        chart_name: linkerd2/linkerd-control-plane
+        chart_version: 1.9.8
+    linkerd-jaeger:
+        chart_name: linkerd2/linkerd-jaeger
+        chart_version: 30.4.8
+    linkerd-multicluster:
+        chart_name: linkerd2/linkerd-multicluster
+        chart_version: 30.2.8
+    linkerd-viz:
+        chart_name: linkerd2/linkerd-viz
+        chart_version: 30.3.8
+    linkerd2-cni:
+        chart_name: linkerd2/linkerd2-cni
+        chart_version: 30.3.8
+    linkerd2-crds:
+        chart_name: linkerd2/linkerd2-crds
+        chart_version: 1.6.1
+stable-2.13.7:
+    linkerd-control-plane:
+        chart_name: linkerd2/linkerd-control-plane
+        chart_version: 1.12.7
+    linkerd-jaeger:
+        chart_name: linkerd2/linkerd-jaeger
+        chart_version: 30.8.7
+    linkerd-multicluster:
+        chart_name: linkerd2/linkerd-multicluster
+        chart_version: 30.7.7
+    linkerd-viz:
+        chart_name: linkerd2/linkerd-viz
+        chart_version: 30.8.7
+    linkerd2-cni:
+        chart_name: linkerd2/linkerd2-cni
+        chart_version: 30.8.5
+    linkerd2-crds:
+        chart_name: linkerd2/linkerd2-crds
+        chart_version: 1.6.1
+stable-2.14.4:
+    linkerd-control-plane:
+        chart_name: linkerd2/linkerd-control-plane
+        chart_version: 1.16.5
+    linkerd-jaeger:
+        chart_name: linkerd2/linkerd-jaeger
+        chart_version: 30.12.5
+    linkerd-multicluster:
+        chart_name: linkerd2/linkerd-multicluster
+        chart_version: 30.11.5
+    linkerd-viz:
+        chart_name: linkerd2/linkerd-viz
+        chart_version: 30.12.5
+    linkerd2-cni:
+        chart_name: linkerd2/linkerd2-cni
+        chart_version: 30.12.1
+    linkerd2-crds:
+        chart_name: linkerd2/linkerd2-crds
+        chart_version: 1.8.0
+