From 9c5eeb66005f1e3f6732861c234490d181f60507 Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 20 Mar 2025 15:28:25 +0100 Subject: [PATCH 1/2] Add a internal page for every k8s distro --- modules/ROOT/nav1.adoc | 5 +++++ modules/ROOT/pages/kubernetes/aks.adoc | 4 ++-- modules/ROOT/pages/kubernetes/eks.adoc | 2 ++ modules/ROOT/pages/kubernetes/gke.adoc | 2 ++ .../ROOT/pages/kubernetes/huawei-cloud.adoc | 4 +++- modules/ROOT/pages/kubernetes/ibm-cloud.adoc | 8 +++++--- modules/ROOT/pages/kubernetes/kind.adoc | 3 +++ modules/ROOT/pages/kubernetes/microk8s.adoc | 2 ++ modules/ROOT/pages/kubernetes/oke.adoc | 3 +++ modules/ROOT/pages/kubernetes/openshift.adoc | 4 +++- modules/ROOT/pages/kubernetes/plusserver.adoc | 3 +++ modules/ROOT/pages/kubernetes/suse-k3s.adoc | 3 +++ .../ROOT/pages/kubernetes/suse-rancher.adoc | 3 +++ .../ROOT/pages/kubernetes/vmware_tanzu.adoc | 2 ++ .../supported-kubernetes-distributions.adoc | 20 +++++++++---------- .../tested-kubernetes-distributions.adoc | 12 +++++------ 16 files changed, 57 insertions(+), 23 deletions(-) create mode 100644 modules/ROOT/pages/kubernetes/kind.adoc create mode 100644 modules/ROOT/pages/kubernetes/oke.adoc create mode 100644 modules/ROOT/pages/kubernetes/plusserver.adoc create mode 100644 modules/ROOT/pages/kubernetes/suse-k3s.adoc create mode 100644 modules/ROOT/pages/kubernetes/suse-rancher.adoc diff --git a/modules/ROOT/nav1.adoc b/modules/ROOT/nav1.adoc index 2d27c7d02..d90e61015 100644 --- a/modules/ROOT/nav1.adoc +++ b/modules/ROOT/nav1.adoc @@ -7,8 +7,13 @@ ** xref:kubernetes/ibm-cloud.adoc[] ** xref:kubernetes/ionos-managed-k8s.adoc[] ** xref:kubernetes/ionos-managed-stackable.adoc[] +** xref:kubernetes/kind.adoc[] ** xref:kubernetes/microk8s.adoc[] +** xref:kubernetes/oke.adoc[] ** xref:kubernetes/openshift.adoc[] +** xref:kubernetes/plusserver.adoc[] ** xref:kubernetes/ske.adoc[] +** xref:kubernetes/suse-k3s.adoc[] +** xref:kubernetes/suse-rancher.adoc[] ** xref:kubernetes/vmware_tanzu.adoc[] * xref:getting-started.adoc[] diff --git a/modules/ROOT/pages/kubernetes/aks.adoc b/modules/ROOT/pages/kubernetes/aks.adoc index edd3bb9a7..60309d98b 100644 --- a/modules/ROOT/pages/kubernetes/aks.adoc +++ b/modules/ROOT/pages/kubernetes/aks.adoc @@ -1,9 +1,9 @@ = Azure Kubernetes Service (AKS) -Automatic Kubernetes clusters are not supported, as the xref:secret-operator:index.adoc[secret-operator] requires special privileges that are not granted in automatic Kubernetes clusters. - https://azure.microsoft.com/en-us/products/kubernetes-service +Automatic Kubernetes clusters are not supported, as the xref:secret-operator:index.adoc[secret-operator] requires special privileges that are not granted in automatic Kubernetes clusters. + . Create Kubernetes cluster + Choose an arbitrary name, the default configurations should be fine. diff --git a/modules/ROOT/pages/kubernetes/eks.adoc b/modules/ROOT/pages/kubernetes/eks.adoc index 1160120a1..75bc35d32 100644 --- a/modules/ROOT/pages/kubernetes/eks.adoc +++ b/modules/ROOT/pages/kubernetes/eks.adoc @@ -1,5 +1,7 @@ = Amazon Elastic Kubernetes Service (EKS) +https://aws.amazon.com/eks/ + Please make sure that you have a default StorageClass in your cluster, so that PVCs will be provisioned. You can list available StorageClasses using the command diff --git a/modules/ROOT/pages/kubernetes/gke.adoc b/modules/ROOT/pages/kubernetes/gke.adoc index 1760816b0..97169d4ee 100644 --- a/modules/ROOT/pages/kubernetes/gke.adoc +++ b/modules/ROOT/pages/kubernetes/gke.adoc @@ -1,5 +1,7 @@ = Google Kubernetes Engine (GKE) +https://cloud.google.com/kubernetes-engine + Autopilot clusters are not suported, as the xref:secret-operator:index.adoc[secret-operator] requires special privileges that are not granted in Autopilot clusters. Other than that no special steps are needed. diff --git a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc index 52437ade5..913ae0f82 100644 --- a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc @@ -1,4 +1,6 @@ -= Huawei cloud += Huawei Cloud Container Engine (CCE) + +https://www.huaweicloud.com/intl/en-us/product/cce.html Huawei Cloud uses a non-standard Kubelet state directory. Therefore, installing the secret-operator and listener-operator on Huawei Cloud requires special handling. diff --git a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc index 4d975fb96..80922edab 100644 --- a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc @@ -1,5 +1,7 @@ -= IBM cloud += IBM Cloud Kubernetes Service -IBM Cloud uses a non-standard Kubelet state directory. -Therefore, installing the secret-operator and listener-operator on IBM Cloud requires special handling. +https://www.ibm.com/products/kubernetes-service + +IBM Cloud Kubernetes Service uses a non-standard Kubelet state directory. +Therefore, installing the secret-operator and listener-operator on IBM Cloud Kubernetes Service 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/kind.adoc b/modules/ROOT/pages/kubernetes/kind.adoc new file mode 100644 index 000000000..c73db051f --- /dev/null +++ b/modules/ROOT/pages/kubernetes/kind.adoc @@ -0,0 +1,3 @@ += kind + +https://kind.sigs.k8s.io/ diff --git a/modules/ROOT/pages/kubernetes/microk8s.adoc b/modules/ROOT/pages/kubernetes/microk8s.adoc index 0b3e55493..7cdc56521 100644 --- a/modules/ROOT/pages/kubernetes/microk8s.adoc +++ b/modules/ROOT/pages/kubernetes/microk8s.adoc @@ -1,5 +1,7 @@ = Microk8s +https://microk8s.io/ + Microk8s uses a non-standard Kubelet state directory. 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/oke.adoc b/modules/ROOT/pages/kubernetes/oke.adoc new file mode 100644 index 000000000..ba8830e04 --- /dev/null +++ b/modules/ROOT/pages/kubernetes/oke.adoc @@ -0,0 +1,3 @@ += Oracle Kubernetes Engine (OKE) + +https://www.oracle.com/cloud/cloud-native/kubernetes-engine/ diff --git a/modules/ROOT/pages/kubernetes/openshift.adoc b/modules/ROOT/pages/kubernetes/openshift.adoc index 1e02ca2b3..37df71deb 100644 --- a/modules/ROOT/pages/kubernetes/openshift.adoc +++ b/modules/ROOT/pages/kubernetes/openshift.adoc @@ -1,4 +1,6 @@ -= OpenShift += Red Hat OpenShift + +https://www.redhat.com/en/technologies/cloud-computing/openshift SDP operators are certified for the OpenShift platform and can be installed from the OperatorHub. diff --git a/modules/ROOT/pages/kubernetes/plusserver.adoc b/modules/ROOT/pages/kubernetes/plusserver.adoc new file mode 100644 index 000000000..b3b869718 --- /dev/null +++ b/modules/ROOT/pages/kubernetes/plusserver.adoc @@ -0,0 +1,3 @@ += plusserver Kubernetes as a Service + +https://www.plusserver.com/en/product/managed-kubernetes/ diff --git a/modules/ROOT/pages/kubernetes/suse-k3s.adoc b/modules/ROOT/pages/kubernetes/suse-k3s.adoc new file mode 100644 index 000000000..e0345289f --- /dev/null +++ b/modules/ROOT/pages/kubernetes/suse-k3s.adoc @@ -0,0 +1,3 @@ += SUSE K3S + +https://www.suse.com/products/k3s/ diff --git a/modules/ROOT/pages/kubernetes/suse-rancher.adoc b/modules/ROOT/pages/kubernetes/suse-rancher.adoc new file mode 100644 index 000000000..380bf6f95 --- /dev/null +++ b/modules/ROOT/pages/kubernetes/suse-rancher.adoc @@ -0,0 +1,3 @@ += SUSE Rancher + +https://www.rancher.com/products/rancher diff --git a/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc index 144e518a7..b7ecf8657 100644 --- a/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc +++ b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc @@ -1,5 +1,7 @@ = VMware Tanzu +https://www.vmware.com/products/app-platform/tanzu + VMware Tanzu uses a non-standard Kubelet state directory. 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. diff --git a/modules/ROOT/partials/supported-kubernetes-distributions.adoc b/modules/ROOT/partials/supported-kubernetes-distributions.adoc index be2d31495..200fc245b 100644 --- a/modules/ROOT/partials/supported-kubernetes-distributions.adoc +++ b/modules/ROOT/partials/supported-kubernetes-distributions.adoc @@ -1,10 +1,10 @@ -* 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] -* https://www.suse.com/products/k3s/[SUSE K3S] -* https://www.rancher.com/products/rancher[SUSE Rancher] +* xref:kubernetes/eks.adoc[] +* xref:kubernetes/aks.adoc[] +* xref:kubernetes/gke.adoc[] +* xref:kubernetes/ionos-managed-k8s.adoc[] +* xref:kubernetes/ionos-managed-stackable.adoc[] +* xref:kubernetes/kind.adoc[] +* xref:kubernetes/microk8s.adoc[] +* xref:kubernetes/openshift.adoc[] +* xref:kubernetes/suse-k3s.adoc[] +* xref:kubernetes/suse-rancher.adoc[] diff --git a/modules/ROOT/partials/tested-kubernetes-distributions.adoc b/modules/ROOT/partials/tested-kubernetes-distributions.adoc index 4c7ee1237..b8c590cb4 100644 --- a/modules/ROOT/partials/tested-kubernetes-distributions.adoc +++ b/modules/ROOT/partials/tested-kubernetes-distributions.adoc @@ -1,6 +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)] +* xref:kubernetes/huawei-cloud.adoc[] +* xref:kubernetes/ibm-cloud.adoc[] +* xref:kubernetes/plusserver.adoc[] +* xref:kubernetes/ske.adoc[] (with the exception of missing public NodePorts) +* xref:kubernetes/vmware_tanzu.adoc[] +* xref:kubernetes/oke.adoc[] From 7b93ae41ffd5ad5e44a53755536c9244ab6f7d0c Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Fri, 21 Mar 2025 08:30:58 +0100 Subject: [PATCH 2/2] Review feedback --- modules/ROOT/pages/kubernetes/huawei-cloud.adoc | 2 +- modules/ROOT/pages/kubernetes/ibm-cloud.adoc | 2 +- modules/ROOT/pages/kubernetes/ionos-managed-stackable.adoc | 2 +- modules/ROOT/pages/kubernetes/microk8s.adoc | 2 +- modules/ROOT/pages/kubernetes/vmware_tanzu.adoc | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc index 913ae0f82..72505f93a 100644 --- a/modules/ROOT/pages/kubernetes/huawei-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/huawei-cloud.adoc @@ -3,5 +3,5 @@ https://www.huaweicloud.com/intl/en-us/product/cce.html Huawei Cloud uses a non-standard Kubelet state directory. -Therefore, installing the secret-operator and listener-operator on Huawei Cloud requires special handling. +For this reason the secret-operator and listener-operator on Huawei Cloud require 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 80922edab..660a3cbea 100644 --- a/modules/ROOT/pages/kubernetes/ibm-cloud.adoc +++ b/modules/ROOT/pages/kubernetes/ibm-cloud.adoc @@ -3,5 +3,5 @@ https://www.ibm.com/products/kubernetes-service IBM Cloud Kubernetes Service uses a non-standard Kubelet state directory. -Therefore, installing the secret-operator and listener-operator on IBM Cloud Kubernetes Service requires special handling. +For this reason the secret-operator and listener-operator on IBM Cloud Kubernetes Service require 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/ionos-managed-stackable.adoc b/modules/ROOT/pages/kubernetes/ionos-managed-stackable.adoc index 150e363bc..ae778d5f4 100644 --- a/modules/ROOT/pages/kubernetes/ionos-managed-stackable.adoc +++ b/modules/ROOT/pages/kubernetes/ionos-managed-stackable.adoc @@ -1,5 +1,5 @@ = IONOS managed Stackable -https://cloud.ionos.com/solutions/managed-stackable +https://cloud.ionos.com/managed/managed-stackable > The Managed Stackable Data Platform from IONOS Cloud is designed to enable you to work with maximum efficiency: Simply select the appropriate data management tools for your respective purpose, build individual stacks for yourself or your customers and make all your data productively usable as quickly as possible diff --git a/modules/ROOT/pages/kubernetes/microk8s.adoc b/modules/ROOT/pages/kubernetes/microk8s.adoc index 7cdc56521..90c424ee9 100644 --- a/modules/ROOT/pages/kubernetes/microk8s.adoc +++ b/modules/ROOT/pages/kubernetes/microk8s.adoc @@ -3,5 +3,5 @@ https://microk8s.io/ Microk8s uses a non-standard Kubelet state directory. -Therefore, installing the secret-operator and listener-operator on Microk8s requires special handling. +For this reason the secret-operator and listener-operator on Microk8s require 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 b7ecf8657..962b1aca0 100644 --- a/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc +++ b/modules/ROOT/pages/kubernetes/vmware_tanzu.adoc @@ -3,5 +3,5 @@ https://www.vmware.com/products/app-platform/tanzu VMware Tanzu uses a non-standard Kubelet state directory. -Therefore, installing the secret-operator and listener-operator on VMware Tanzu requires special handling. +For this reason the secret-operator and listener-operator on VMware Tanzu require 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.