Skip to content

Commit 0e82631

Browse files
NickLarsenNZTechassiadwk67
authored
chore(tracking): Release Notes for SDP 24.11.1 (#704)
* chore: Release notes for 24.11.1 * chore: add release-note about secret-operator migration jobs * chore: add patch upgrade instructions * docs: Fix typo * docs: Fix fragment links * docs: Add inline code * Update versions in getting-started * Apply suggestions from code review Co-authored-by: Andrew Kenworthy <1712947+adwk67@users.noreply.github.com> * Revert to standard upgrade procedure --------- Co-authored-by: Techassi <git@techassi.dev> Co-authored-by: Andrew Kenworthy <1712947+adwk67@users.noreply.github.com>
1 parent 26ccbda commit 0e82631

File tree

2 files changed

+165
-14
lines changed

2 files changed

+165
-14
lines changed

‎modules/ROOT/pages/getting-started.adoc

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -55,12 +55,12 @@ Install the operators:
5555
5656
[source,bash]
5757
----
58-
helm install zookeeper-operator stackable-stable/zookeeper-operator --version=24.11.0
59-
helm install kafka-operator stackable-stable/kafka-operator --version=24.11.0
60-
helm install secret-operator stackable-stable/secret-operator --version=24.11.0
61-
helm install listener-operator stackable-stable/listener-operator --version=24.11.0
62-
helm install commons-operator stackable-stable/commons-operator --version=24.11.0
63-
helm install nifi-operator stackable-stable/nifi-operator --version=24.11.0
58+
helm install zookeeper-operator stackable-stable/zookeeper-operator --version=24.11.1
59+
helm install kafka-operator stackable-stable/kafka-operator --version=24.11.1
60+
helm install secret-operator stackable-stable/secret-operator --version=24.11.1
61+
helm install listener-operator stackable-stable/listener-operator --version=24.11.1
62+
helm install commons-operator stackable-stable/commons-operator --version=24.11.1
63+
helm install nifi-operator stackable-stable/nifi-operator --version=24.11.1
6464
----
6565
====
6666

@@ -69,12 +69,12 @@ You can check which operators are installed using `stackablectl operator install
6969
[source,console]
7070
----
7171
OPERATOR VERSION NAMESPACE STATUS LAST UPDATED
72-
commons 24.11.0 default deployed 2024-11-30 17:58:32.916032854 +0100 CET
73-
kafka 24.11.0 default deployed 2024-11-30 17:58:55.036115353 +0100 CET
74-
listener 24.11.0 default deployed 2024-11-30 17:59:18.136775259 +0100 CET
75-
nifi 24.11.0 default deployed 2024-11-30 17:59:51.927081648 +0100 CET
76-
secret 24.11.0 default deployed 2024-11-30 18:00:05.060241771 +0100 CET
77-
zookeeper 24.11.0 default deployed 2024-11-30 18:00:08.425686918 +0100 CET
72+
commons 24.11.1 default deployed 2024-11-30 17:58:32.916032854 +0100 CET
73+
kafka 24.11.1 default deployed 2024-11-30 17:58:55.036115353 +0100 CET
74+
listener 24.11.1 default deployed 2024-11-30 17:59:18.136775259 +0100 CET
75+
nifi 24.11.1 default deployed 2024-11-30 17:59:51.927081648 +0100 CET
76+
secret 24.11.1 default deployed 2024-11-30 18:00:05.060241771 +0100 CET
77+
zookeeper 24.11.1 default deployed 2024-11-30 18:00:08.425686918 +0100 CET
7878
----
7979

8080
== Deploying Stackable Services

‎modules/ROOT/partials/release-notes/release-24.11.adoc

Lines changed: 153 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,163 @@
22

33
=== 24.11.1
44

5+
Released on 2024-01-20.
6+
This patch release fixes two issues that were discovered since the <<_24_11_0>> release.
57

8+
==== Breaking Changes
9+
10+
Distinct ServiceAccounts are now used for the Stacklets so that multiple Stacklets of the same product can be deployed in one namespace.
11+
Existing Stacklets will use the newly created ServiceAccounts after restart.
12+
13+
WARNING: Manually adapted ServiceAccounts must be updated.
14+
15+
==== Other fixes
16+
17+
* Secret Operator Helm chart: The secret migration job required for upgrading from SDP 24.3 to 24.7 can now be omitted by setting the Helm value `secretMigrationJob.enabled` to false.
18+
* The following operators have been fixed to work correctly with OpenID Connect rootPaths with and without trailing slashes:
19+
** Nifi Operator
20+
** Trino Operator
21+
** Druid Operator
22+
** Airflow Operator
23+
** Superset Operator
24+
25+
==== Upgrade to the 24.11.1 patch release
26+
27+
[NOTE]
28+
====
29+
These instructions apply to upgrades from `24.7.0` and `24.11.0`.
30+
In the examples below, we will show an upgrade from `24.11.0`.
31+
====
32+
33+
===== Using stackablectl
34+
35+
Uninstall the `24.11` release
36+
37+
[source,console]
38+
----
39+
$ stackablectl release uninstall 24.11
40+
41+
Uninstalled release '24.11'
42+
43+
Use "stackablectl release list" to list available releases.
44+
# ...
45+
----
46+
47+
Afterwards you will need to upgrade the CustomResourceDefinitions (CRDs) installed by the Stackable Platform.
48+
The reason for this is that helm will uninstall the operators but not the CRDs.
49+
This can be done using `kubectl replace`.
50+
51+
[source]
52+
----
53+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/airflow-operator/24.11.1/deploy/helm/airflow-operator/crds/crds.yaml
54+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/commons-operator/24.11.1/deploy/helm/commons-operator/crds/crds.yaml
55+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/druid-operator/24.11.1/deploy/helm/druid-operator/crds/crds.yaml
56+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hbase-operator/24.11.1/deploy/helm/hbase-operator/crds/crds.yaml
57+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hdfs-operator/24.11.1/deploy/helm/hdfs-operator/crds/crds.yaml
58+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hive-operator/24.11.1/deploy/helm/hive-operator/crds/crds.yaml
59+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/kafka-operator/24.11.1/deploy/helm/kafka-operator/crds/crds.yaml
60+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/listener-operator/24.11.1/deploy/helm/listener-operator/crds/crds.yaml
61+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/nifi-operator/24.11.1/deploy/helm/nifi-operator/crds/crds.yaml
62+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/opa-operator/24.11.1/deploy/helm/opa-operator/crds/crds.yaml
63+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/secret-operator/24.11.1/deploy/helm/secret-operator/crds/crds.yaml
64+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/spark-k8s-operator/24.11.1/deploy/helm/spark-k8s-operator/crds/crds.yaml
65+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/superset-operator/24.11.1/deploy/helm/superset-operator/crds/crds.yaml
66+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/trino-operator/24.11.1/deploy/helm/trino-operator/crds/crds.yaml
67+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/zookeeper-operator/24.11.1/deploy/helm/zookeeper-operator/crds/crds.yaml
68+
----
69+
70+
[source,console]
71+
----
72+
customresourcedefinition.apiextensions.k8s.io "airflowclusters.airflow.stackable.tech" replaced
73+
customresourcedefinition.apiextensions.k8s.io "airflowdbs.airflow.stackable.tech" replaced
74+
customresourcedefinition.apiextensions.k8s.io "authenticationclasses.authentication.stackable.tech" replaced
75+
customresourcedefinition.apiextensions.k8s.io "s3connections.s3.stackable.tech" replaced
76+
...
77+
----
78+
79+
Install the `24.11` release
80+
81+
[source,console]
82+
----
83+
$ stackablectl release install 24.11
84+
85+
Installed release '24.11'
86+
87+
Use "stackablectl operator installed" to list installed operators.
88+
----
89+
90+
===== Using Helm
91+
92+
Use `helm list` to list the currently installed operators.
93+
94+
You can use the following command to uninstall all operators that are part of the `24.11` release:
95+
96+
[source,console]
97+
----
98+
$ helm uninstall airflow-operator commons-operator druid-operator hbase-operator hdfs-operator hive-operator kafka-operator listener-operator nifi-operator opa-operator secret-operator spark-k8s-operator superset-operator trino-operator zookeeper-operator
99+
release "airflow-operator" uninstalled
100+
release "commons-operator" uninstalled
101+
...
102+
----
103+
104+
Afterward you will need to upgrade the CustomResourceDefinitions (CRDs) installed by the Stackable Platform.
105+
The reason for this is that helm will uninstall the operators but not the CRDs. This can be done using `kubectl replace`:
106+
107+
[source]
108+
----
109+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/airflow-operator/24.11.1/deploy/helm/airflow-operator/crds/crds.yaml
110+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/commons-operator/24.11.1/deploy/helm/commons-operator/crds/crds.yaml
111+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/druid-operator/24.11.1/deploy/helm/druid-operator/crds/crds.yaml
112+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hbase-operator/24.11.1/deploy/helm/hbase-operator/crds/crds.yaml
113+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hdfs-operator/24.11.1/deploy/helm/hdfs-operator/crds/crds.yaml
114+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hive-operator/24.11.1/deploy/helm/hive-operator/crds/crds.yaml
115+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/kafka-operator/24.11.1/deploy/helm/kafka-operator/crds/crds.yaml
116+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/listener-operator/24.11.1/deploy/helm/listener-operator/crds/crds.yaml
117+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/nifi-operator/24.11.1/deploy/helm/nifi-operator/crds/crds.yaml
118+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/opa-operator/24.11.1/deploy/helm/opa-operator/crds/crds.yaml
119+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/secret-operator/24.11.1/deploy/helm/secret-operator/crds/crds.yaml
120+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/spark-k8s-operator/24.11.1/deploy/helm/spark-k8s-operator/crds/crds.yaml
121+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/superset-operator/24.11.1/deploy/helm/superset-operator/crds/crds.yaml
122+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/trino-operator/24.11.1/deploy/helm/trino-operator/crds/crds.yaml
123+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/zookeeper-operator/24.11.1/deploy/helm/zookeeper-operator/crds/crds.yaml
124+
----
125+
126+
[source,console]
127+
----
128+
customresourcedefinition.apiextensions.k8s.io "airflowclusters.airflow.stackable.tech" replaced
129+
customresourcedefinition.apiextensions.k8s.io "airflowdbs.airflow.stackable.tech" replaced
130+
customresourcedefinition.apiextensions.k8s.io "authenticationclasses.authentication.stackable.tech" replaced
131+
customresourcedefinition.apiextensions.k8s.io "s3connections.s3.stackable.tech" replaced
132+
...
133+
----
134+
135+
Install the `24.11` release
136+
137+
[source,console]
138+
----
139+
helm repo add stackable-stable https://repo.stackable.tech/repository/helm-stable/
140+
helm repo update stackable-stable
141+
helm install --wait airflow-operator stackable-stable/airflow-operator --version 24.11.1
142+
helm install --wait commons-operator stackable-stable/commons-operator --version 24.11.1
143+
helm install --wait druid-operator stackable-stable/druid-operator --version 24.11.1
144+
helm install --wait hbase-operator stackable-stable/hbase-operator --version 24.11.1
145+
helm install --wait hdfs-operator stackable-stable/hdfs-operator --version 24.11.1
146+
helm install --wait hive-operator stackable-stable/hive-operator --version 24.11.1
147+
helm install --wait kafka-operator stackable-stable/kafka-operator --version 24.11.1
148+
helm install --wait listener-operator stackable-stable/listener-operator --version 24.11.1
149+
helm install --wait nifi-operator stackable-stable/nifi-operator --version 24.11.1
150+
helm install --wait opa-operator stackable-stable/opa-operator --version 24.11.1
151+
helm install --wait secret-operator stackable-stable/secret-operator --version 24.11.1
152+
helm install --wait spark-k8s-operator stackable-stable/spark-k8s-operator --version 24.11.1
153+
helm install --wait superset-operator stackable-stable/superset-operator --version 24.11.1
154+
helm install --wait trino-operator stackable-stable/trino-operator --version 24.11.1
155+
helm install --wait zookeeper-operator stackable-stable/zookeeper-operator --version 24.11.1
156+
----
6157

7158
=== 24.11.0
8159

9160
Released on 2024-11-28.
10-
Also consult the release notes for the 24.11.1 patch release above.
161+
Also consult the release notes for the <<_24_11_1>> patch release above.
11162

12163
==== New platform features
13164

@@ -301,7 +452,7 @@ Use "stackablectl operator installed" to list installed operators.
301452

302453
Use `helm list` to list the currently installed operators.
303454

304-
You can use the following command to uninstall all operators that are part of the `24.3` release:
455+
You can use the following command to uninstall all operators that are part of the `24.7` release:
305456

306457
[source,console]
307458
----

0 commit comments

Comments
 (0)