Skip to content

Commit 881a7cf

Browse files
committed
fill in the Upgrade from 24.7 section
1 parent 65a8425 commit 881a7cf

File tree

1 file changed

+125
-1
lines changed

1 file changed

+125
-1
lines changed

modules/ROOT/pages/release-notes.adoc

Lines changed: 125 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,11 +197,135 @@ These OpenShift versions are no longer supported:
197197
198198
==== Using stackablectl
199199
200+
Uninstall the `24.7` release
201+
202+
[source,console]
203+
----
204+
$ stackablectl release uninstall 24.7
205+
206+
Uninstalled release '24.7'
207+
208+
Use "stackablectl release list" to list available releases.
209+
# ...
210+
----
211+
212+
Afterwards you will need to upgrade the CustomResourceDefinitions (CRDs) installed by the Stackable Platform.
213+
The reason for this is that helm will uninstall the operators but not the CRDs. This can be done using `kubectl replace`.
214+
215+
[source]
216+
----
217+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/airflow-operator/24.11.0/deploy/helm/airflow-operator/crds/crds.yaml
218+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/commons-operator/24.11.0/deploy/helm/commons-operator/crds/crds.yaml
219+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/druid-operator/24.11.0/deploy/helm/druid-operator/crds/crds.yaml
220+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hbase-operator/24.11.0/deploy/helm/hbase-operator/crds/crds.yaml
221+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hdfs-operator/24.11.0/deploy/helm/hdfs-operator/crds/crds.yaml
222+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hello-world-operator/24.11.0/deploy/helm/hello-world-operator/crds/crds.yaml
223+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hive-operator/24.11.0/deploy/helm/hive-operator/crds/crds.yaml
224+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/kafka-operator/24.11.0/deploy/helm/kafka-operator/crds/crds.yaml
225+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/listener-operator/24.11.0/deploy/helm/listener-operator/crds/crds.yaml
226+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/nifi-operator/24.11.0/deploy/helm/nifi-operator/crds/crds.yaml
227+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/opa-operator/24.11.0/deploy/helm/opa-operator/crds/crds.yaml
228+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/secret-operator/24.11.0/deploy/helm/secret-operator/crds/crds.yaml
229+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/spark-k8s-operator/24.11.0/deploy/helm/spark-k8s-operator/crds/crds.yaml
230+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/superset-operator/24.11.0/deploy/helm/superset-operator/crds/crds.yaml
231+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/trino-operator/24.11.0/deploy/helm/trino-operator/crds/crds.yaml
232+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/zookeeper-operator/24.11.0/deploy/helm/zookeeper-operator/crds/crds.yaml
233+
----
234+
235+
[source,console]
236+
----
237+
customresourcedefinition.apiextensions.k8s.io "airflowclusters.airflow.stackable.tech" replaced
238+
customresourcedefinition.apiextensions.k8s.io "airflowdbs.airflow.stackable.tech" replaced
239+
customresourcedefinition.apiextensions.k8s.io "authenticationclasses.authentication.stackable.tech" replaced
240+
customresourcedefinition.apiextensions.k8s.io "s3connections.s3.stackable.tech" replaced
241+
...
242+
----
243+
244+
Install the `24.11` release
245+
246+
[source,console]
247+
----
248+
$ stackablectl release install 24.11
249+
250+
Installed release '24.11'
251+
252+
Use "stackablectl operator installed" to list installed operators.
253+
----
254+
200255
==== Using Helm
201256
257+
Use `helm list` to list the currently installed operators.
258+
259+
You can use the following command to uninstall all operators that are part of the `24.3` release:
260+
261+
[source,console]
262+
----
263+
$ helm uninstall airflow-operator commons-operator druid-operator hbase-operator hdfs-operator hello-world-operator hive-operator kafka-operator listener-operator nifi-operator opa-operator secret-operator spark-k8s-operator superset-operator trino-operator zookeeper-operator
264+
release "airflow-operator" uninstalled
265+
release "commons-operator" uninstalled
266+
...
267+
----
268+
269+
Afterward you will need to upgrade the CustomResourceDefinitions (CRDs) installed by the Stackable Platform.
270+
The reason for this is that helm will uninstall the operators but not the CRDs. This can be done using `kubectl replace`:
271+
272+
[source]
273+
----
274+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/airflow-operator/24.11.0/deploy/helm/airflow-operator/crds/crds.yaml
275+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/commons-operator/24.11.0/deploy/helm/commons-operator/crds/crds.yaml
276+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/druid-operator/24.11.0/deploy/helm/druid-operator/crds/crds.yaml
277+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hbase-operator/24.11.0/deploy/helm/hbase-operator/crds/crds.yaml
278+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hdfs-operator/24.11.0/deploy/helm/hdfs-operator/crds/crds.yaml
279+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hello-world-operator/24.11.0/deploy/helm/hello-world-operator/crds/crds.yaml
280+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/hive-operator/24.11.0/deploy/helm/hive-operator/crds/crds.yaml
281+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/kafka-operator/24.11.0/deploy/helm/kafka-operator/crds/crds.yaml
282+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/listener-operator/24.11.0/deploy/helm/listener-operator/crds/crds.yaml
283+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/nifi-operator/24.11.0/deploy/helm/nifi-operator/crds/crds.yaml
284+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/opa-operator/24.11.0/deploy/helm/opa-operator/crds/crds.yaml
285+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/secret-operator/24.11.0/deploy/helm/secret-operator/crds/crds.yaml
286+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/spark-k8s-operator/24.11.0/deploy/helm/spark-k8s-operator/crds/crds.yaml
287+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/superset-operator/24.11.0/deploy/helm/superset-operator/crds/crds.yaml
288+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/trino-operator/24.11.0/deploy/helm/trino-operator/crds/crds.yaml
289+
kubectl replace -f https://raw.githubusercontent.com/stackabletech/zookeeper-operator/24.11.0/deploy/helm/zookeeper-operator/crds/crds.yaml
290+
----
291+
292+
[source,console]
293+
----
294+
customresourcedefinition.apiextensions.k8s.io "airflowclusters.airflow.stackable.tech" replaced
295+
customresourcedefinition.apiextensions.k8s.io "airflowdbs.airflow.stackable.tech" replaced
296+
customresourcedefinition.apiextensions.k8s.io "authenticationclasses.authentication.stackable.tech" replaced
297+
customresourcedefinition.apiextensions.k8s.io "s3connections.s3.stackable.tech" replaced
298+
...
299+
----
300+
301+
Install the `24.11` release
302+
303+
[source,console]
304+
----
305+
helm repo add stackable-stable https://repo.stackable.tech/repository/helm-stable/
306+
helm repo update stackable-stable
307+
helm install --wait airflow-operator stackable-stable/airflow-operator --version 24.11.0
308+
helm install --wait commons-operator stackable-stable/commons-operator --version 24.11.0
309+
helm install --wait druid-operator stackable-stable/druid-operator --version 24.11.0
310+
helm install --wait hbase-operator stackable-stable/hbase-operator --version 24.11.0
311+
helm install --wait hdfs-operator stackable-stable/hdfs-operator --version 24.11.0
312+
helm install --wait hive-operator stackable-stable/hive-operator --version 24.11.0
313+
helm install --wait kafka-operator stackable-stable/kafka-operator --version 24.11.0
314+
helm install --wait listener-operator stackable-stable/listener-operator --version 24.11.0
315+
helm install --wait hello-world-operator stackable-stable/hello-world-operator --version 24.11.0
316+
helm install --wait nifi-operator stackable-stable/nifi-operator --version 24.11.0
317+
helm install --wait opa-operator stackable-stable/opa-operator --version 24.11.0
318+
helm install --wait secret-operator stackable-stable/secret-operator --version 24.11.0
319+
helm install --wait spark-k8s-operator stackable-stable/spark-k8s-operator --version 24.11.0
320+
helm install --wait superset-operator stackable-stable/superset-operator --version 24.11.0
321+
helm install --wait trino-operator stackable-stable/trino-operator --version 24.11.0
322+
helm install --wait zookeeper-operator stackable-stable/zookeeper-operator --version 24.11.0
323+
----
324+
202325
==== Known upgrade issues
203326
204-
===== All operators
327+
> todo: mention JMX Exporter?
328+
> todo: do we mention NiFi 2.0.0 (experimental)? because NiFi 1.27.0 -> 2.0.0 requires manual intervention (basically same as in the 24.7 note)
205329
206330
== Release 24.7
207331

0 commit comments

Comments
 (0)