Skip to content

Commit 8bd3d56

Browse files
committed
docs(roles): list the slim platform variants
Cozystack adds isp-slim, isp-slim-generic and isp-hosted-slim. The role already renders a valid Package for them. Document the names, that they need a Cozystack release carrying them, and that the chart ignores the Kube-OVN network values there: two of them run Cilium alone and the hosted one uses the host CNI. Assisted-by: LLM Signed-off-by: Aleksei Sviridkin <[email protected]>
1 parent 16b6cef commit 8bd3d56

3 files changed

Lines changed: 19 additions & 3 deletions

File tree

‎CHANGELOG.rst‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,15 @@ cozystack.installer Release Notes
55
Unreleased
66
==========
77

8+
- The role docs list the minimal platform variants for
9+
``cozystack_platform_variant``:
10+
``isp-slim``, ``isp-slim-generic`` and ``isp-hosted-slim``. They need a
11+
Cozystack release that includes cozystack/cozystack#4595. On
12+
generic Linux use ``isp-slim-generic``: it installs the base platform
13+
only, networking is Cilium without Kube-OVN, and the pod CIDR comes
14+
from k3s. The chart ignores ``cozystack_pod_cidr``,
15+
``cozystack_pod_gateway``, ``cozystack_svc_cidr`` and
16+
``cozystack_join_cidr`` there.
817
- CI: new ``hack/check-versions.sh`` invariant check runs in the ``Lint``
918
job and fails the build if version strings drift across the three
1019
tracked dependencies: the ``cozy-installer`` chart version must match

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -323,7 +323,7 @@ cluster-cidr: 10.42.0.0/16
323323
service-cidr: 10.43.0.0/16
324324
```
325325

326-
These CIDRs are the k3s defaults. The example clusters set them via the `server_config_yaml` variable consumed by `k3s.orchestration`, defined in `examples/<distro>/inventory.yml`. The role variables `cozystack_pod_cidr` and `cozystack_svc_cidr` must match — they default to the same values.
326+
These CIDRs are the k3s defaults. The example clusters set them via the `server_config_yaml` variable consumed by `k3s.orchestration`, defined in `examples/<distro>/inventory.yml`. The role variables `cozystack_pod_cidr` and `cozystack_svc_cidr` must match — they default to the same values. On isp-slim-generic, the slim variant for k3s, the chart ignores both: Cilium takes pod ranges from k3s.
327327

328328
## Installation
329329

@@ -407,7 +407,7 @@ Runs on `server[0]` only.
407407
| `cozystack_helm_version` | `3.20.0` | Helm binary version to install |
408408
| `cozystack_helm_binary` | `/usr/local/bin/helm` | Path to Helm binary on target |
409409
| `cozystack_create_platform_package` | `true` | Create Platform Package CR after install |
410-
| `cozystack_platform_variant` | `isp-full-generic` | Platform variant: default, isp-full, isp-hosted, isp-full-generic |
410+
| `cozystack_platform_variant` | `isp-full-generic` | Platform variant: default, isp-full, isp-hosted, isp-full-generic. Cozystack releases that include cozystack/cozystack#4595 also accept isp-slim-generic (the minimal variant for k3s), isp-slim (its Talos counterpart) and isp-hosted-slim. |
411411
| `cozystack_root_host` | `""` | Domain for Cozystack services (empty = skip publishing) |
412412
| `cozystack_external_ips` | `[]` | List of external IPs for ingress-nginx Service. Required on platforms without a native LB (cloud VMs, bare metal). Each entry must be a valid IPv4/IPv6 address. |
413413
| `cozystack_tenant_root_ingress` | `false` | Enable ingress on the root tenant. When `true`, patches the root Tenant CR after Platform Package apply to create IngressClass and ingress-nginx controller. |

‎roles/cozystack/defaults/main.yml‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,14 @@ cozystack_helm_diff_version: "3.12.5"
5050
cozystack_create_platform_package: true
5151

5252
# Platform Package variant (determines which platform components are deployed)
53-
# Available: default, isp-full, isp-hosted, isp-full-generic
53+
# Available: default, isp-full, isp-hosted, isp-full-generic.
54+
# Newer Cozystack releases also ship isp-slim, isp-slim-generic and
55+
# isp-hosted-slim (added by cozystack/cozystack#4595).
56+
# They install the base platform only. isp-slim-generic is the one for
57+
# k3s; isp-slim is its Talos counterpart. Both run Cilium without
58+
# Kube-OVN, and isp-hosted-slim uses the host CNI,
59+
# so the chart ignores cozystack_pod_cidr, cozystack_pod_gateway,
60+
# cozystack_svc_cidr and cozystack_join_cidr there.
5461
cozystack_platform_variant: "isp-full-generic"
5562

5663
# Domain for Cozystack services (dashboard, grafana, etc.)

0 commit comments

Comments
 (0)