From 3094a4e7fde1426c2e816bf8df92fa1e8c96b144 Mon Sep 17 00:00:00 2001 From: Razvan-Daniel Mihai <84674+razvan@users.noreply.github.com> Date: Mon, 25 Mar 2024 11:01:10 +0100 Subject: [PATCH 01/10] Update version in antora.yml to 24.3.0 --- antora.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/antora.yml b/antora.yml index ef3036437..a765f5aae 100644 --- a/antora.yml +++ b/antora.yml @@ -1,5 +1,5 @@ name: home -version: "nightly" +version: "24.3" title: Stackable Documentation nav: - modules/ROOT/nav1.adoc @@ -13,7 +13,7 @@ nav: - modules/ROOT/nav3.adoc # this is for the extra bits at the end of the menu # The prerelease setting affects version sorting. # Set to 'true' for nightly and false otherwise. -prerelease: true +prerelease: false # The attributes below are specific to this component and version # https://docs.antora.org/antora/latest/component-attributes/#hard-set asciidoc: @@ -21,7 +21,7 @@ asciidoc: # Keep this version in line with the 'version' key above # The versions for the CRD docs are either 'nightly' or # a full major.minor.patch version like 23.7.1 - crd-docs-version: "nightly" + crd-docs-version: "24.3.0" # use the attributes below to link to the CRD docs crd-docs-base-url: "https://crds.stackable.tech" crd-docs: "{crd-docs-base-url}/{crd-docs-version}" From a760bc68e01269ce7f21d77bb18e326020552ef3 Mon Sep 17 00:00:00 2001 From: Razvan-Daniel Mihai <84674+razvan@users.noreply.github.com> Date: Mon, 25 Mar 2024 12:50:27 +0100 Subject: [PATCH 02/10] update getting started guide --- modules/ROOT/pages/getting-started.adoc | 28 ++++++++++++------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/modules/ROOT/pages/getting-started.adoc b/modules/ROOT/pages/getting-started.adoc index 61073e9d1..9df966dc9 100644 --- a/modules/ROOT/pages/getting-started.adoc +++ b/modules/ROOT/pages/getting-started.adoc @@ -30,11 +30,11 @@ Install the Stackable command line utility xref:management:stackablectl:index.ad The Stackable operators are components that translate the service definitions deployed via Kubernetes into deploy services on the worker nodes. These can be installed on any node that has access to the Kubernetes control plane. In this example we will install them on the controller node. -Stackable operators can be installed using `stackablectl`. Run the following commands to install ZooKeeper, Kafka and NiFi from the Stackable 23.11 release. +Stackable operators can be installed using `stackablectl`. Run the following commands to install ZooKeeper, Kafka and NiFi from the Stackable 24.3 release. [source,bash] ---- -stackablectl release install -i commons -i secret -i listener -i zookeeper -i kafka -i nifi 23.11 +stackablectl release install -i commons -i secret -i listener -i zookeeper -i kafka -i nifi 24.3 ---- .Using Helm instead @@ -53,12 +53,12 @@ Install the operators: [source,bash] ---- -helm install zookeeper-operator stackable-stable/zookeeper-operator --version=23.11.0 -helm install kafka-operator stackable-stable/kafka-operator --version=23.11.0 -helm install secret-operator stackable-stable/secret-operator --version=23.11.0 -helm install listener-operator stackable-stable/listener-operator --version=23.11.0 -helm install commons-operator stackable-stable/commons-operator --version=23.11.0 -helm install nifi-operator stackable-stable/nifi-operator --version=23.11.0 +helm install zookeeper-operator stackable-stable/zookeeper-operator --version=24.3.0 +helm install kafka-operator stackable-stable/kafka-operator --version=24.3.0 +helm install secret-operator stackable-stable/secret-operator --version=24.3.0 +helm install listener-operator stackable-stable/listener-operator --version=24.3.0 +helm install commons-operator stackable-stable/commons-operator --version=24.3.0 +helm install nifi-operator stackable-stable/nifi-operator --version=24.3.0 ---- ==== @@ -67,12 +67,12 @@ You can check which operators are installed using `stackablectl operator install [source,console] ---- OPERATOR VERSION NAMESPACE STATUS LAST UPDATED -commons 23.11.0 default deployed 2023-11-30 17:58:32.916032854 +0100 CET -kafka 23.11.0 default deployed 2023-11-30 17:58:55.036115353 +0100 CET -listener 23.11.0 default deployed 2023-11-30 17:59:18.136775259 +0100 CET -nifi 23.11.0 default deployed 2023-11-30 17:59:51.927081648 +0100 CET -secret 23.11.0 default deployed 2023-11-30 18:00:05.060241771 +0100 CET -zookeeper 23.11.0 default deployed 2023-11-30 18:00:08.425686918 +0100 CET +commons 24.3.0 default deployed 2024-03-30 17:58:32.916032854 +0100 CET +kafka 24.3.0 default deployed 2024-03-30 17:58:55.036115353 +0100 CET +listener 24.3.0 default deployed 2024-03-30 17:59:18.136775259 +0100 CET +nifi 24.3.0 default deployed 2024-03-30 17:59:51.927081648 +0100 CET +secret 24.3.0 default deployed 2024-03-30 18:00:05.060241771 +0100 CET +zookeeper 24.3.0 default deployed 2024-03-30 18:00:08.425686918 +0100 CET ---- == Deploying Stackable Services From 94b2498e98639927a36ab55502dbc99b7f6161b3 Mon Sep 17 00:00:00 2001 From: Razvan-Daniel Mihai <84674+razvan@users.noreply.github.com> Date: Tue, 26 Mar 2024 09:49:44 +0100 Subject: [PATCH 03/10] fix: mention arm64 in release notes (#573) --- modules/ROOT/pages/release-notes.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/ROOT/pages/release-notes.adoc b/modules/ROOT/pages/release-notes.adoc index 1483830f8..7ef80719a 100644 --- a/modules/ROOT/pages/release-notes.adoc +++ b/modules/ROOT/pages/release-notes.adoc @@ -147,6 +147,11 @@ The following are selected product features provided by new versions available i ** Also, starting from release 440, there is now row filtering and column masking in Open Policy Agent. * Apache ZooKeeper: Security and bug fixes. +Support for the ARM architecture:: +During the development of this release, we started introducing support for the arm64 architecture. +Currently support is experimental, and we only provide arm64 images for the previous release (23.11). +For more information on how to use the ARM images, refer to the xref:concepts:arm64-support.adoc[documentation]. + === Product versions ==== New versions From 96f10426b2da2a431447ee804ef9d4ce2f87dc16 Mon Sep 17 00:00:00 2001 From: Maxi Wittich Date: Tue, 2 Apr 2024 17:12:23 +0200 Subject: [PATCH 04/10] Backporting changes for multi-architecture to 24.3 --- modules/concepts/pages/arm64-support.adoc | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/modules/concepts/pages/arm64-support.adoc b/modules/concepts/pages/arm64-support.adoc index 831dfe32d..99bec5945 100644 --- a/modules/concepts/pages/arm64-support.adoc +++ b/modules/concepts/pages/arm64-support.adoc @@ -4,18 +4,25 @@ WARNING: This is an experimental feature of the Stackable Data Platform (SDP) and still under https://github.com/stackabletech/issues/issues/463[development]. +NOTE: 24.3.0 has been released as a multi-architecture release. We encountered certain limitations as Superset 3.1.0 hasn't been build yet and only Airflow 2.6.3 is currently available. + == Early access SDP release 23.11.0 has been ported to the ARM64 architecture. +With 24.3.0 we enabled multi-architecture. These images are stored within the `stackable-experimental` organization in our https://repo.stackable.tech/#browse/browse:docker:v2%2Fstackable-experimental[Docker repository]. === Available releases The only release currently available for ARM64 is the early access version mentioned above. -Each product image is built using ARM-specific tags to keep them distinct from development/nightly images. +23.11.0 only brought `arm64` as early access feature, as of 24.3.0 we support multi-architecture ( mixed architectures on clusters ). + +Each product image is built using architecture-specific tags to keep them distinct from development/nightly images. In the future they may be bundled as a manifest list using an automated workflow. +24.7.0 will be released as part of the usual release process directly as multi-architecture release. + === Operators According to our https://docs.stackable.tech/home/stable/airflow/getting_started/installation#_helm[installation guide] you can install ARM64 operators e.g. for the commons operator as follows: From 54859ea54b92dadab7163b2c28522f474d3c9800 Mon Sep 17 00:00:00 2001 From: Felix Hennig Date: Thu, 4 Apr 2024 16:52:05 +0200 Subject: [PATCH 05/10] feat: add end-of-life flag --- antora.yml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/antora.yml b/antora.yml index a765f5aae..91173f6b8 100644 --- a/antora.yml +++ b/antora.yml @@ -22,9 +22,13 @@ asciidoc: # The versions for the CRD docs are either 'nightly' or # a full major.minor.patch version like 23.7.1 crd-docs-version: "24.3.0" + # Whether this version is already end of life. + # If true, a banner will be displayed informing the user. + end-of-life: false # use the attributes below to link to the CRD docs crd-docs-base-url: "https://crds.stackable.tech" - crd-docs: "{crd-docs-base-url}/{crd-docs-version}" - # this attribute is an annoying little hack to make the versioned - # link accessible to the UI template. + crd-docs: "{crd-docs-base-url}/{crd-docs-version}" + # to make attributes accessible to the UI template, they need to + # be prefixed with "page-" page-crd-docs: "{crd-docs}" + page-end-of-life: "{end-of-life}" From 27107aa5e2bb1c669f1d7b8dbf47b1ad4fa62506 Mon Sep 17 00:00:00 2001 From: Razvan-Daniel Mihai <84674+razvan@users.noreply.github.com> Date: Thu, 4 Apr 2024 17:33:52 +0200 Subject: [PATCH 06/10] fix: update OpenShift release notes --- modules/ROOT/pages/release-notes.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/release-notes.adoc b/modules/ROOT/pages/release-notes.adoc index 7ef80719a..51804dfb0 100644 --- a/modules/ROOT/pages/release-notes.adoc +++ b/modules/ROOT/pages/release-notes.adoc @@ -223,10 +223,13 @@ These Kubernetes versions are no longer supported: === Supported OpenShift versions -This release supports the following OpenShift versions: +This release is available in the RedHat Certified Operator Catalog for the following OpenShift versions: * `4.15` * `4.14` +* `4.13` +* `4.12` +* `4.11` === Breaking changes From 5c3e1c4f10c82fe171b1396840149d221f9b2f1d Mon Sep 17 00:00:00 2001 From: Paulien van Alst Date: Wed, 19 Jun 2024 14:26:17 +0200 Subject: [PATCH 07/10] Fix typo German instead of English (#622) --- modules/concepts/pages/overrides.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/concepts/pages/overrides.adoc b/modules/concepts/pages/overrides.adoc index b670a5b60..4336137d6 100644 --- a/modules/concepts/pages/overrides.adoc +++ b/modules/concepts/pages/overrides.adoc @@ -129,4 +129,4 @@ The `podOverrides` will be merged onto the following resources the operators dep They will *not* be applied to: -* Jobs, that are used to setup systems the product depends on e.g. create a database schema for Superset oder Airflow. +* Jobs, that are used to setup systems the product depends on e.g. create a database schema for Superset or Airflow. From a35aeabf2d43191df6807f4e9f957e27ff16e32b Mon Sep 17 00:00:00 2001 From: xeniape Date: Thu, 1 Aug 2024 14:35:39 +0200 Subject: [PATCH 08/10] remove home component reference --- modules/concepts/pages/overview.adoc | 2 +- modules/concepts/pages/stackable_resource_requests.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/concepts/pages/overview.adoc b/modules/concepts/pages/overview.adoc index 845ef984a..f0129eb25 100644 --- a/modules/concepts/pages/overview.adoc +++ b/modules/concepts/pages/overview.adoc @@ -47,7 +47,7 @@ Learn more about roles: xref:roles-and-role-groups.adoc[] [#deployment] == Deployment -All operators and products run as containers in a xref:home::kubernetes.adoc[Kubernetes cluster]. The operators are deployed with stackablectl (the Stackable CLI) or Helm. +All operators and products run as containers in a xref:kubernetes.adoc[Kubernetes cluster]. The operators are deployed with stackablectl (the Stackable CLI) or Helm. image::deployment.drawio.svg[] diff --git a/modules/concepts/pages/stackable_resource_requests.adoc b/modules/concepts/pages/stackable_resource_requests.adoc index 7a1ba58bd..563c096a0 100644 --- a/modules/concepts/pages/stackable_resource_requests.adoc +++ b/modules/concepts/pages/stackable_resource_requests.adoc @@ -1,7 +1,7 @@ // This is meant to be inlined using the "include" directive in other pages. // WARNING: do not add headers here as they can break the structure of pages // that include this file. -Stackable operators handle resource requests in a sligtly different manner than Kubernetes. Resource requests are defined on role or group level. See xref:home:concepts:roles-and-role-groups.adoc[] for details on these concepts. On a role level this means that e.g. all workers will use the same resource requests and limits. This can be further specified on role group level (which takes priority to the role level) to apply different resources. +Stackable operators handle resource requests in a sligtly different manner than Kubernetes. Resource requests are defined on role or group level. See xref:concepts:roles-and-role-groups.adoc[] for details on these concepts. On a role level this means that e.g. all workers will use the same resource requests and limits. This can be further specified on role group level (which takes priority to the role level) to apply different resources. This is an example on how to specify CPU and memory resources using the Stackable https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/[Custom Resources]: From 7bbb4a360c64ffeae6eb9e27eda0d0aee9df49a0 Mon Sep 17 00:00:00 2001 From: Nick <10092581+NickLarsenNZ@users.noreply.github.com> Date: Fri, 2 Aug 2024 03:41:31 +1200 Subject: [PATCH 09/10] fix: invalid reference (#636) Co-authored-by: Lars Francke --- modules/concepts/pages/overview.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/concepts/pages/overview.adoc b/modules/concepts/pages/overview.adoc index f0129eb25..01067e679 100644 --- a/modules/concepts/pages/overview.adoc +++ b/modules/concepts/pages/overview.adoc @@ -47,7 +47,7 @@ Learn more about roles: xref:roles-and-role-groups.adoc[] [#deployment] == Deployment -All operators and products run as containers in a xref:kubernetes.adoc[Kubernetes cluster]. The operators are deployed with stackablectl (the Stackable CLI) or Helm. +All operators and products run as containers in a xref:ROOT:kubernetes.adoc[Kubernetes cluster]. The operators are deployed with stackablectl (the Stackable CLI) or Helm. image::deployment.drawio.svg[] @@ -66,4 +66,4 @@ image::common_objects.drawio.svg[] These objects can be reused by all operators that support this feature. The S3 bucket only needs to be described once, and then it can be referenced in all products that support reading and/or writing from/to S3. Learn more about S3 configuration: xref:s3.adoc[]. -Similarly for the OpenPolicyAgent (OPA). Configuring it looks the same across all products. Learn more: xref:opa.adoc[]. \ No newline at end of file +Similarly for the OpenPolicyAgent (OPA). Configuring it looks the same across all products. Learn more: xref:opa.adoc[]. From 2f8dc63f39f1dad3b71c766aa66a1f21c5a6c4f4 Mon Sep 17 00:00:00 2001 From: Techassi Date: Fri, 25 Jul 2025 10:59:04 +0200 Subject: [PATCH 10/10] chore: Set 24.3 to end of life --- antora.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/antora.yml b/antora.yml index 91173f6b8..2eb748416 100644 --- a/antora.yml +++ b/antora.yml @@ -24,7 +24,7 @@ asciidoc: crd-docs-version: "24.3.0" # Whether this version is already end of life. # If true, a banner will be displayed informing the user. - end-of-life: false + end-of-life: true # use the attributes below to link to the CRD docs crd-docs-base-url: "https://crds.stackable.tech" crd-docs: "{crd-docs-base-url}/{crd-docs-version}"