Suse observability stac 22685 (#1610)

* STAC-22685: Fixing helm updgrade commands

* STAC-22685: Update persistent volume configuration page

* STAC-22685: ACK installation note

Author: viliakov

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
+```

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
 ```

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 %}
 
@@ -114,7 +115,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
 ```

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 \

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 %}

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