From cd508e68ea807348fb8b9b41da68f466947c67e2 Mon Sep 17 00:00:00 2001 From: Alexey Artamonov Date: Wed, 11 Nov 2026 21:24:28 +0300 Subject: [PATCH] docs(platform): document ingress.rootEnabled The platform now carries whether the root Tenant runs ingress-nginx, and tenant-root's applications read it to decide whether to wait for ingress-nginx and whether to create their Ingress objects. Nothing ties the value to Tenant/root spec.ingress, so operators need to know to set it. Assisted-by: LLM Signed-off-by: Alexey Artamonov --- .../docs/next/operations/configuration/platform-package.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/content/en/docs/next/operations/configuration/platform-package.md b/content/en/docs/next/operations/configuration/platform-package.md index 2b17aeb24..1ae86517c 100644 --- a/content/en/docs/next/operations/configuration/platform-package.md +++ b/content/en/docs/next/operations/configuration/platform-package.md @@ -160,6 +160,12 @@ gateway: | --- | --- | --- | | `scheduling.globalAppTopologySpreadConstraints` | `""` | Global pod topology spread constraints applied to all managed applications. | +#### Ingress + +| Value | Default | Description | +| --- | --- | --- | +| `ingress.rootEnabled` | `true` | Whether the root tenant runs its own ingress-nginx, that is, whether `Tenant/root` has `spec.ingress: true`. When `true`, applications in `tenant-root`, and every tenant that inherits its ingress from the root, are told their ingress lives in `tenant-root`: they render `Ingress` objects with the `tenant-root` class, and SeaweedFS in `tenant-root` waits for `ingress-nginx-system` before it starts. When `false`, they are told there is no ingress: SeaweedFS starts without waiting, its S3 `Ingress`, Grafana's `Ingress` and the proxied ingress-nginx addon `Ingress` of a tenant Kubernetes cluster are not created, and the remaining `Ingress` objects are created without a class. Nothing sets `spec.ingress` on the root Tenant from this value: set it to match the root Tenant. With `true` while the root tenant has ingress disabled, SeaweedFS in `tenant-root` waits for an ingress-nginx that never comes up, and so does the platform backup bucket. The default `true` keeps the earlier behaviour. | + #### Monitoring | Value | Default | Description |