You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit d8ce521
Browse filesBrowse the repository at this point in the historyBrowse files
feat(kubernetes): frame worker image package as an opt-in catalog
Reframe packages/system/kubernetes-worker-image as an explicit catalog of
golden Talos worker images (each images[] entry is one (schematicID,
version) flavor) and document that it is opt-in: disabled by default and
enabled via bundles.enabledPackages. A tenant node group clones a golden
only when it sets image.builtin; groups without it import over HTTP.
Also raise the dv.yaml storage fallback from 4Gi to 6Gi and quote it: the
Talos raw image is ~4.15 GiB and the values.yaml default is 6Gi, so a
cleared $.Values.storage would otherwise render a too-small PVC.
Assisted-By: Claude <[email protected]>
Signed-off-by: Myasnikov Daniil <[email protected]>
## Pre-populates the Talos worker OS disk image(s) as DataVolumes in the
5
-
## cozy-public namespace so tenant Kubernetes worker VMs boot by CDI csi-clone
6
-
## (a storage-layer copy) instead of each worker independently importing the raw
7
-
## image over HTTP from the Talos Image Factory. One import per
8
-
## (schematicID, version) is then shared by every worker of every tenant cluster
9
-
## that boots that image — eliminating the per-worker Factory dependency (and the
10
-
## kubernetes-* e2e node-join flake, cozystack/cozystack#3231) on the hot path.
4
+
## Pre-populates a catalog of Talos worker OS disk images as DataVolumes in the
5
+
## cozy-public namespace, so a tenant Kubernetes worker node group can boot by CDI
6
+
## csi-clone (a storage-layer copy) of a shared golden image instead of each worker
7
+
## independently importing the raw image over HTTP from the Talos Image Factory.
8
+
## One import per (schematicID, version) is then shared by every worker of every
9
+
## tenant node group that clones it — removing the per-worker Factory dependency
10
+
## (and the kubernetes-* e2e node-join flake, cozystack/cozystack#3231) on the hot
11
+
## path. Each images[] entry is one catalog (schematicID, version) flavor.
11
12
##
12
-
## The kubernetes app looks a golden up by the deterministic name
13
-
## `talos-worker-<schematicID>-<version>` in cozy-public and clones it; when no
14
-
## match exists it falls back to a direct per-worker HTTP import. So each entry
15
-
## here MUST match a (talos.schematicID, talos.version) that tenant `Kubernetes`
16
-
## resources use for the clone to be selected. Keep the default entry in sync
17
-
## with `talos.*` in packages/apps/kubernetes/values.yaml — a drift only costs the
18
-
## caching benefit (workers degrade to HTTP import), it does not break anything.
13
+
## This package is OPT-IN: it is registered through the platform's optional package
14
+
## helper and is disabled by default. Enable it by adding
15
+
## `cozystack.kubernetes-worker-image` to `bundles.enabledPackages` in the Cozystack
16
+
## config; without it no golden is created and every worker imports over HTTP.
17
+
##
18
+
## A tenant node group opts into a clone explicitly by setting
19
+
## `nodeGroups.<name>.image.builtin` (optionally overriding schematicID/version) in
20
+
## a `Kubernetes` resource; the app then clones the golden named deterministically
21
+
## `talos-worker-<schematicID>-<version>` from cozy-public. If the referenced
22
+
## (schematicID, version) has no matching entry in this catalog, the tenant render
23
+
## fails — so keep the catalog in sync with the (schematicID, version) pairs that
24
+
## tenant node groups reference. Node groups that do not set `image.builtin` import
25
+
## over HTTP and never touch this catalog.
19
26
20
27
## @param {string} imageFactoryURL - Default base URL of the Talos Image Factory serving the raw worker OS image (`<url>/image/<schematicID>/<version>/openstack-amd64.raw.xz`). Overridable per image. No trailing slash.
## @field {quantity} [storage] - Override the global storage size for this image.
34
41
## @field {string} [storageClass] - Override the global StorageClass for this image.
35
42
36
-
## @param {[]WorkerImage} images - List of golden Talos worker images to provision in the cozy-public namespace.
43
+
## @param {[]WorkerImage} images - Catalog of golden Talos worker images to provision in the cozy-public namespace. Each entry is one (schematicID, version) flavor a tenant node group can clone via `image.builtin`.
0 commit comments