From 5786d088bf84d7cfd17bf79e52e4673cf2cbe3ef Mon Sep 17 00:00:00 2001 From: Vladimir Iliakov Date: Fri, 25 Apr 2025 11:19:46 +0200 Subject: [PATCH 1/3] STAC-22685: Fixing helm updgrade commands --- setup/install-stackstate/kubernetes_openshift/ingress.md | 4 ++-- .../kubernetes_openshift/kubernetes_install.md | 2 +- .../kubernetes_openshift/openshift_install.md | 4 ++-- setup/upgrade-stackstate/migrate-from-6.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/setup/install-stackstate/kubernetes_openshift/ingress.md b/setup/install-stackstate/kubernetes_openshift/ingress.md index 40d62e888..82b26d8ab 100644 --- a/setup/install-stackstate/kubernetes_openshift/ingress.md +++ b/setup/install-stackstate/kubernetes_openshift/ingress.md @@ -45,7 +45,7 @@ helm upgrade --install \ --namespace "suse-observability" \ --values "ingress_values.yaml" \ --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ - --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ suse-observability \ suse-observability/suse-observability ``` @@ -107,7 +107,7 @@ helm upgrade \ --namespace "suse-observability" \ --values "ingress_otel_values.yaml" \ --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ - --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ suse-observability \ suse-observability/suse-observability ``` diff --git a/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md b/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md index 15a8193df..48799e9e1 100644 --- a/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md +++ b/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md @@ -114,7 +114,7 @@ helm upgrade \ --install \ --namespace suse-observability \ --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ - --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ suse-observability \ suse-observability/suse-observability ``` diff --git a/setup/install-stackstate/kubernetes_openshift/openshift_install.md b/setup/install-stackstate/kubernetes_openshift/openshift_install.md index 44672b47a..d8fb4c267 100644 --- a/setup/install-stackstate/kubernetes_openshift/openshift_install.md +++ b/setup/install-stackstate/kubernetes_openshift/openshift_install.md @@ -141,7 +141,7 @@ helm upgrade \ --install \ --namespace suse-observability \ --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ - --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ --values openshift-values.yaml \ --set "clickhouse.sidecars[0].securityContext.runAsUser=null" \ suse-observability \ @@ -164,7 +164,7 @@ helm upgrade \ --namespace suse-observability \ --values local-docker-registry.yaml \ --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ - --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ --values openshift-values.yaml \ --set "clickhouse.sidecars[0].securityContext.runAsUser=null" \ suse-observability \ diff --git a/setup/upgrade-stackstate/migrate-from-6.md b/setup/upgrade-stackstate/migrate-from-6.md index f7f067a10..b2dcdb48b 100644 --- a/setup/upgrade-stackstate/migrate-from-6.md +++ b/setup/upgrade-stackstate/migrate-from-6.md @@ -301,7 +301,7 @@ Re-routing the traffic will switch both agent traffic and users of StackState to --install \ --namespace suse-observability \ --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ - --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ --values ingress.yaml \ suse-observability \ suse-observability/suse-observability From 89704857e64d62d04d42378bd33042ac44ab4b29 Mon Sep 17 00:00:00 2001 From: Vladimir Iliakov Date: Fri, 25 Apr 2025 12:52:58 +0200 Subject: [PATCH 2/3] STAC-22685: Update persistent volume configuration page --- .../kubernetes_openshift/storage.md | 32 +++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/setup/install-stackstate/kubernetes_openshift/storage.md b/setup/install-stackstate/kubernetes_openshift/storage.md index 829fe7326..86d5f9e05 100644 --- a/setup/install-stackstate/kubernetes_openshift/storage.md +++ b/setup/install-stackstate/kubernetes_openshift/storage.md @@ -93,6 +93,21 @@ stackstate: vmagent: persistence: size: 10Gi + experimental: + storeTransactionLogsToPVC: + volumeSize: 600Mi + stackpacks: + pvc: + size: 1Gi + +backup: + configuration: + scheduled: + pvc: + size: 1Gi +minio: + persistence: + size: 500Gi ``` {% endtab %} {% tab title="Changing volume size Non-Ha" %} @@ -148,6 +163,23 @@ stackstate: vmagent: persistence: size: 10Gi + experimental: + storeTransactionLogsToPVC: + volumeSize: 600Mi + stackpacks: + localpvc: + size: 1Gi + pvc: + size: 1Gi + +backup: + configuration: + scheduled: + pvc: + size: 1Gi +minio: + persistence: + size: 500Gi ``` {% endtab %} {% endtabs %} From e5b4769c088d915930308bbefa06220c4fbe7f2c Mon Sep 17 00:00:00 2001 From: Vladimir Iliakov Date: Fri, 25 Apr 2025 13:30:46 +0200 Subject: [PATCH 3/3] STAC-22685: ACK installation note --- .../kubernetes_openshift/ack.md | 63 +++++++++++++++++++ .../kubernetes_install.md | 1 + 2 files changed, 64 insertions(+) create mode 100644 setup/install-stackstate/kubernetes_openshift/ack.md diff --git a/setup/install-stackstate/kubernetes_openshift/ack.md b/setup/install-stackstate/kubernetes_openshift/ack.md new file mode 100644 index 000000000..574a784bd --- /dev/null +++ b/setup/install-stackstate/kubernetes_openshift/ack.md @@ -0,0 +1,63 @@ +--- +description: SUSE Observability Self-hosted +--- + +# Alibaba Cloud Container Service for Kubernetes (ACK) installation notes + +## Minimum volume size + +Alibaba Cloud's Container Service for Kubernetes (ACK) enforces a minimum volume size of **20 GiB** for disk-based PersistentVolumeClaims (PVCs). When deploying on ACK, Persistent Volume Claims (pvc) have to request **at least 20Gi** of storage. Failure to meet the 20Gi minimum may result in volume provisioning and failures during Helm deployment. + +We provide a dedicated set of Helm values that adjusts all volume sizes to meet this requirement. If you're installing on ACK, use this file during installation: + +```yaml +# ack-values.yaml +zookeeper: + persistence: + size: 20Gi +stackstate: + components: + checks: + tmpToPVC: + volumeSize: 20Gi + healthSync: + tmpToPVC: + volumeSize: 20Gi + localpvc: + size: 20Gi + state: + tmpToPVC: + volumeSize: 20Gi + sync: + tmpToPVC: + volumeSize: 20Gi + vmagent: + persistence: + size: 20Gi + experimental: + storeTransactionLogsToPVC: + volumeSize: 20Gi + stackpacks: + localpvc: + size: 20Gi + pvc: + size: 20Gi +backup: + configuration: + scheduled: + pvc: + size: 20Gi +``` + +Please create a separate file for the ACK-specific values and use it during installation. For example, if you follow [Kubernetes install documentation](https://docs.stackstate.com/self-hosted-setup/install-stackstate/kubernetes_openshift/kubernetes_install#deploy-suse-observability-with-helm) and save the above values in a file called `ack-values.yaml`, you can install Suse Observability with: + +```bash +helm upgrade \ + --install \ + --namespace suse-observability \ + --values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \ + --values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \ + --values ack-values.yaml \ +suse-observability \ +suse-observability/suse-observability +``` diff --git a/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md b/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md index 48799e9e1..4f4956fd3 100644 --- a/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md +++ b/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md @@ -10,6 +10,7 @@ description: SUSE Observability Self-hosted Extra notes for installing on: * **Kubernetes clusters with limited permissions**: Read the [required permissions](required_permissions.md). +* **Alibaba Cloud Container Service for Kubernetes (ACK)**: Read the [ACK installation notes](ack.md). * **OpenShift**: Refer to the [OpenShift installation instructions](openshift_install.md). {% endhint %}