Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 63 additions & 0 deletions setup/install-stackstate/kubernetes_openshift/ack.md
Original file line number Diff line number Diff line change
@@ -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
```
4 changes: 2 additions & 2 deletions setup/install-stackstate/kubernetes_openshift/ingress.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```
Expand Down Expand Up @@ -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
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 %}

Expand Down Expand Up @@ -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
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 \
Expand All @@ -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 \
Expand Down
32 changes: 32 additions & 0 deletions setup/install-stackstate/kubernetes_openshift/storage.md
Original file line number Diff line number Diff line change
Expand Up @@ -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" %}
Expand Down Expand Up @@ -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 %}
Expand Down
2 changes: 1 addition & 1 deletion setup/upgrade-stackstate/migrate-from-6.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading