From c0152a7e6313ba555d887578db0d816137be678d Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 20 Mar 2025 13:18:54 +0100 Subject: [PATCH 1/5] Add VMWare Tanzu notes. Also differentiate between supported and tested k8s --- modules/ROOT/nav1.adoc | 1 + modules/ROOT/pages/kubernetes/huawei-cloud.adoc | 4 +++- modules/ROOT/pages/kubernetes/ibm-cloud.adoc | 4 +++- modules/ROOT/pages/kubernetes/index.adoc | 4 ++++ modules/ROOT/pages/kubernetes/microk8s.adoc | 4 +++- modules/ROOT/pages/kubernetes/vmware_tanzu.adoc | 5 +++++ modules/ROOT/pages/product-information.adoc | 7 ++++++- .../ROOT/partials/supported-kubernetes-distributions.adoc | 7 ++++--- modules/ROOT/partials/tested-kubernetes-distributions.adoc | 5 +++++ 9 files changed, 34 insertions(+), 7 deletions(-) create mode 100644 modules/ROOT/pages/kubernetes/vmware_tanzu.adoc create mode 100644 modules/ROOT/partials/tested-kubernetes-distributions.adoc diff --git a/modules/ROOT/nav1.adoc b/modules/ROOT/nav1.adoc index 5b280941b..2d27c7d02 100644 --- a/modules/ROOT/nav1.adoc +++ b/modules/ROOT/nav1.adoc @@ -10,4 +10,5 @@ ** xref:kubernetes/microk8s.adoc[] ** xref:kubernetes/openshift.adoc[] ** xref:kubernetes/ske.adoc[] +** xref:kubernetes/vmware_tanzu.adoc[] * xref:getting-started.adoc[] diff --git a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc index 36263794f..a4798f0f1 100644 --- a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc @@ -1,3 +1,5 @@ = Huawei cloud -Huawei cloud uses a non-standard Kubelet state directory. Therefore installing secret-operator on Huawei cloud requires special treatment. Please read on the xref:secret-operator:installation.adoc#_huawei_cloud[secret-operator installation guide] for details. +Huawei cloud uses a non-standard Kubelet state directory. +Therefore installing secret-operator and listener-operator on Huawei cloud requires a special treatment. +Please read on the xref:secret-operator:installation.adoc#_huawei_cloud[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_huawei_cloud[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc index 9627c1fac..73cab91ff 100644 --- a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc @@ -1,3 +1,5 @@ = IBM cloud -IBM cloud uses a non-standard Kubelet state directory. Therefore installing secret-operator on IBM cloud requires a special treatment. Please read on the xref:secret-operator:installation.adoc#_ibm_cloud[secret-operator installation guide] for details. +IBM cloud uses a non-standard Kubelet state directory. +Therefore installing secret-operator and listener-operator on IBM cloud requires a special treatment. +Please read on the xref:secret-operator:installation.adoc#_ibm_cloud[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_ibm_cloud[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/kubernetes/index.adoc b/modules/ROOT/pages/kubernetes/index.adoc index 6f1187418..9ee9e6511 100644 --- a/modules/ROOT/pages/kubernetes/index.adoc +++ b/modules/ROOT/pages/kubernetes/index.adoc @@ -14,6 +14,10 @@ The following distributions are supported for a production setup of the Stackabl include::partial$supported-kubernetes-distributions.adoc[] +Kubernetes distributions tested either by us or by other users are listed below; + +include::partial$tested-kubernetes-distributions.adoc[] + In case a Kubernetes provider needs some special tuning or we have some tips for it, it has a subpage below this page. Consult the xref:release_notes.adoc[release notes] to find out which specific Kubernetes versions are supported for the Stackable Data Platform you are using. diff --git a/modules/ROOT/pages/kubernetes/microk8s.adoc b/modules/ROOT/pages/kubernetes/microk8s.adoc index 1b98e74c4..a5b86e4f1 100644 --- a/modules/ROOT/pages/kubernetes/microk8s.adoc +++ b/modules/ROOT/pages/kubernetes/microk8s.adoc @@ -1,3 +1,5 @@ = Microk8s -Microk8s uses a non-standard Kubelet state directory. Therefore installing secret-operator on Microk8s requires a special treatement. Please read on the xref:secret-operator:installation.adoc#_microk8s[secret-operator installation guide] for details. +Microk8s uses a non-standard Kubelet state directory. +Therefore installing secret-operator and listener-operator on Microk8s requires a special treatment. +Please read on the xref:secret-operator:installation.adoc#_microk8s[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_microk8s[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc new file mode 100644 index 000000000..e8f201e2f --- /dev/null +++ b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc @@ -0,0 +1,5 @@ += VMware Tanzu + +VMware Tanzu uses a non-standard Kubelet state directory. +Therefore installing secret-operator and listener-operator on VMware Tanzu requires a special treatment. +Please read on the xref:secret-operator:installation.adoc#_vmware_tanzu[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_vmware_tanzu[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/product-information.adoc b/modules/ROOT/pages/product-information.adoc index 6b41fd2f2..5996eeb88 100644 --- a/modules/ROOT/pages/product-information.adoc +++ b/modules/ROOT/pages/product-information.adoc @@ -107,10 +107,15 @@ The supported Kubernetes versions for each platform release can be found here: xref:release-notes.adoc[SDP Release notes] -There are various Kubernetes distributions. Stackable supports: +There are various Kubernetes distributions. +The following distributions are supported for a production setup of the Stackable Data Platform: include::partial$supported-kubernetes-distributions.adoc[] +Kubernetes distributions tested either by us or by other users are listed below; + +include::partial$tested-kubernetes-distributions.adoc[] + === Product specific dependencies The following products have required external components to run: diff --git a/modules/ROOT/partials/supported-kubernetes-distributions.adoc b/modules/ROOT/partials/supported-kubernetes-distributions.adoc index 1ab516658..be2d31495 100644 --- a/modules/ROOT/partials/supported-kubernetes-distributions.adoc +++ b/modules/ROOT/partials/supported-kubernetes-distributions.adoc @@ -1,9 +1,10 @@ -* https://aws.amazon.com/eks/[Amazon Elastic Kubernetes Service] +* xref:kubernetes/eks.adoc[Amazon Elastic Kubernetes Service] * xref:kubernetes/aks.adoc[Azure Kubernetes Service] * xref:kubernetes/gke.adoc[Google Kubernetes Engine] * xref:kubernetes/ionos-managed-k8s.adoc[IONOS Managed Kubernetes] * xref:kubernetes/ionos-managed-stackable.adoc[IONOS Managed Stackable] +* https://kind.sigs.k8s.io/[kind] +* xref:kubernetes/microk8s.adoc[MicroK8s] * xref:kubernetes/openshift.adoc[Red Hat OpenShift] -* xref:kubernetes/ske.adoc[STACKIT Kubernetes Engine] (with the exception of missing public NodePorts) -* https://www.rancher.com/products/rancher[SUSE Rancher] * https://www.suse.com/products/k3s/[SUSE K3S] +* https://www.rancher.com/products/rancher[SUSE Rancher] diff --git a/modules/ROOT/partials/tested-kubernetes-distributions.adoc b/modules/ROOT/partials/tested-kubernetes-distributions.adoc new file mode 100644 index 000000000..4eb3b563f --- /dev/null +++ b/modules/ROOT/partials/tested-kubernetes-distributions.adoc @@ -0,0 +1,5 @@ +* xref:kubernetes/huawei-cloud.adoc[Huawei Cloud] +* xref:kubernetes/ibm-cloud.adoc[IBM Cloud] +* xref:kubernetes/ske.adoc[STACKIT Kubernetes Engine] (with the exception of missing public NodePorts) +* xref:kubernetes/vmware_tanzu.adoc[VMware Tanzu] +* https://www.oracle.com/cloud/cloud-native/kubernetes-engine/[Oracle Kubernetes Engine (OKE)] From 96ebc78e1797cffbc81ca123ed03db754d6f81d8 Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 20 Mar 2025 13:42:39 +0100 Subject: [PATCH 2/5] Update modules/ROOT/pages/kubernetes/index.adoc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Natalie Klestrup Röijezon --- modules/ROOT/pages/kubernetes/index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/kubernetes/index.adoc b/modules/ROOT/pages/kubernetes/index.adoc index 9ee9e6511..b477f818b 100644 --- a/modules/ROOT/pages/kubernetes/index.adoc +++ b/modules/ROOT/pages/kubernetes/index.adoc @@ -14,7 +14,7 @@ The following distributions are supported for a production setup of the Stackabl include::partial$supported-kubernetes-distributions.adoc[] -Kubernetes distributions tested either by us or by other users are listed below; +Kubernetes distributions tested either by us or by other users are listed below: include::partial$tested-kubernetes-distributions.adoc[] From 07757b629aa806279503a198e98fe4853ccc0772 Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 20 Mar 2025 14:02:11 +0100 Subject: [PATCH 3/5] Wording Co-authored-by: Lars Francke --- modules/ROOT/pages/kubernetes/huawei-cloud.adoc | 6 +++--- modules/ROOT/pages/kubernetes/ibm-cloud.adoc | 6 +++--- modules/ROOT/pages/kubernetes/microk8s.adoc | 4 ++-- modules/ROOT/pages/kubernetes/vmware_tanzu.adoc | 4 ++-- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc index a4798f0f1..52437ade5 100644 --- a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc @@ -1,5 +1,5 @@ = Huawei cloud -Huawei cloud uses a non-standard Kubelet state directory. -Therefore installing secret-operator and listener-operator on Huawei cloud requires a special treatment. -Please read on the xref:secret-operator:installation.adoc#_huawei_cloud[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_huawei_cloud[listener-operator installation guide] for details. +Huawei Cloud uses a non-standard Kubelet state directory. +Therefore, installing the secret-operator and listener-operator on Huawei Cloud requires special handling. +Please refer to the xref:secret-operator:installation.adoc#_huawei_cloud[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_huawei_cloud[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc index 73cab91ff..4d975fb96 100644 --- a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc @@ -1,5 +1,5 @@ = IBM cloud -IBM cloud uses a non-standard Kubelet state directory. -Therefore installing secret-operator and listener-operator on IBM cloud requires a special treatment. -Please read on the xref:secret-operator:installation.adoc#_ibm_cloud[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_ibm_cloud[listener-operator installation guide] for details. +IBM Cloud uses a non-standard Kubelet state directory. +Therefore, installing the secret-operator and listener-operator on IBM Cloud requires special handling. +Please refer to the xref:secret-operator:installation.adoc#_ibm_cloud[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_ibm_cloud[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/kubernetes/microk8s.adoc b/modules/ROOT/pages/kubernetes/microk8s.adoc index a5b86e4f1..0b3e55493 100644 --- a/modules/ROOT/pages/kubernetes/microk8s.adoc +++ b/modules/ROOT/pages/kubernetes/microk8s.adoc @@ -1,5 +1,5 @@ = Microk8s Microk8s uses a non-standard Kubelet state directory. -Therefore installing secret-operator and listener-operator on Microk8s requires a special treatment. -Please read on the xref:secret-operator:installation.adoc#_microk8s[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_microk8s[listener-operator installation guide] for details. +Therefore, installing the secret-operator and listener-operator on Microk8s requires special handling. +Please refer to the xref:secret-operator:installation.adoc#_microk8s[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_microk8s[listener-operator installation guide] for details. diff --git a/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc index e8f201e2f..144e518a7 100644 --- a/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc +++ b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc @@ -1,5 +1,5 @@ = VMware Tanzu VMware Tanzu uses a non-standard Kubelet state directory. -Therefore installing secret-operator and listener-operator on VMware Tanzu requires a special treatment. -Please read on the xref:secret-operator:installation.adoc#_vmware_tanzu[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_vmware_tanzu[listener-operator installation guide] for details. +Therefore, installing the secret-operator and listener-operator on VMware Tanzu requires special handling. +Please refer to the xref:secret-operator:installation.adoc#_vmware_tanzu[secret-operator installation guide] and the xref:listener-operator:installation.adoc#_vmware_tanzu[listener-operator installation guide] for details. From 3ccb05cf1cfd536de87af3b3775f571cfe00775e Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 20 Mar 2025 14:05:30 +0100 Subject: [PATCH 4/5] Add plusserver --- modules/ROOT/partials/tested-kubernetes-distributions.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/modules/ROOT/partials/tested-kubernetes-distributions.adoc b/modules/ROOT/partials/tested-kubernetes-distributions.adoc index 4eb3b563f..4c7ee1237 100644 --- a/modules/ROOT/partials/tested-kubernetes-distributions.adoc +++ b/modules/ROOT/partials/tested-kubernetes-distributions.adoc @@ -1,5 +1,6 @@ * xref:kubernetes/huawei-cloud.adoc[Huawei Cloud] * xref:kubernetes/ibm-cloud.adoc[IBM Cloud] +* https://www.plusserver.com/en/product/managed-kubernetes/[plusserver Kubernetes as a Service] * xref:kubernetes/ske.adoc[STACKIT Kubernetes Engine] (with the exception of missing public NodePorts) * xref:kubernetes/vmware_tanzu.adoc[VMware Tanzu] * https://www.oracle.com/cloud/cloud-native/kubernetes-engine/[Oracle Kubernetes Engine (OKE)] From ecbdfd7dc6dc41e00f30450f49f1a3ba8296b71c Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 20 Mar 2025 14:07:03 +0100 Subject: [PATCH 5/5] Apply suggestions from code review Co-authored-by: Lars Francke --- modules/ROOT/pages/kubernetes/index.adoc | 2 +- modules/ROOT/pages/product-information.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/kubernetes/index.adoc b/modules/ROOT/pages/kubernetes/index.adoc index b477f818b..a7d904186 100644 --- a/modules/ROOT/pages/kubernetes/index.adoc +++ b/modules/ROOT/pages/kubernetes/index.adoc @@ -14,7 +14,7 @@ The following distributions are supported for a production setup of the Stackabl include::partial$supported-kubernetes-distributions.adoc[] -Kubernetes distributions tested either by us or by other users are listed below: +These Kubernetes distributions are not officially tested by us but based on community feedback have been known to work. Some might require extra steps, please refer to the detailed pages for more information. Please contact us if you're interested in official support for any of these: include::partial$tested-kubernetes-distributions.adoc[] diff --git a/modules/ROOT/pages/product-information.adoc b/modules/ROOT/pages/product-information.adoc index 5996eeb88..6e95ed14b 100644 --- a/modules/ROOT/pages/product-information.adoc +++ b/modules/ROOT/pages/product-information.adoc @@ -112,7 +112,7 @@ The following distributions are supported for a production setup of the Stackabl include::partial$supported-kubernetes-distributions.adoc[] -Kubernetes distributions tested either by us or by other users are listed below; +These Kubernetes distributions are not officially tested by us but based on community feedback have been known to work. Some might require extra steps, please refer to the detailed pages for more information. Please contact us if you're interested in official support for any of these: include::partial$tested-kubernetes-distributions.adoc[]