Skip to content

Commit c5e9287

Browse files
authored
docs(release): add changelog for v1.3.4 (#2676)
This PR adds the changelog for release `v1.3.4`. ✅ Changelog has been automatically generated in `docs/changelogs/v1.3.4.md`. <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **New Features** * OpenSearch is now integrated into the 1.3 PaaS bundle so operator and dashboard components deploy when PaaS is enabled. * Storage class input now renders as a dropdown including OpenSearch as an option. * **Bug Fixes** * Fixed Harbor reconciliation regression related to bucket secret handling and render-path coverage. * **Documentation** * v1.3.4 release notes published, expanded docs, summary of related project changes, contributor list and compare link. <!-- review_stack_entry_start --> [![Review Change Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/cozystack/cozystack/pull/2676?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack) <!-- review_stack_entry_end --> <!-- end of auto-generated comment: release notes by coderabbit.ai -->
2 parents f6f34cb + de668c6 commit c5e9287

1 file changed

Lines changed: 67 additions & 0 deletions

File tree

‎docs/changelogs/v1.3.4.md‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
<!--
2+
https://github.com/cozystack/cozystack/releases/tag/v1.3.4
3+
-->
4+
5+
# v1.3.4 (2026-05-19)
6+
7+
A patch release that wires OpenSearch into the PaaS bundle on 1.3 (so the operator and dashboard entry actually deploy when `bundles.paas.enabled=true`) and fixes a Harbor reconciliation regression that prevented the Harbor app from coming up cleanly when the COSI BucketAccess Secret had not been populated yet. Documentation and the bundled `talm` CLI also moved forward during this release window.
8+
9+
## Features and Improvements
10+
11+
_No notable user-facing features in this patch release._
12+
13+
## Fixes
14+
15+
* **fix(platform,dashboard): wire OpenSearch into PaaS bundle and form overrides**: OpenSearch has shipped as a complete package set on the 1.3 line — `packages/apps/opensearch/`, `packages/system/opensearch-operator/`, `packages/system/opensearch-rd/`, and the `cozystack.opensearch-*` PackageSources — but the PaaS bundle template never referenced the OpenSearch PackageSources. On any 1.3 cluster with `bundles.paas.enabled=true`, that meant `opensearch-operator` was never deployed (no `OpenSearchCluster` CRD on the cluster), the `opensearch-rd` release was never deployed (no `ApplicationDefinition/opensearch`), and the dashboard catalog had no OpenSearch entry — tenants could not create `opensearches.apps.cozystack.io`. Two changes ship here: (1) `packages/core/platform/templates/bundles/paas.yaml` now references `cozystack.opensearch-operator` and `cozystack.opensearch-application`, matching every other DB application; and (2) `internal/controller/dashboard/customformsoverride.go` (and its unit test) add `OpenSearch` to the `StorageClass` listInput override case, so the create-form `storageClass` field renders as a dropdown in the legacy openapi-ui dashboard that ships with 1.3. (The new cozystack-ui in 1.4 derives this widget client-side from the schema, so the form-override half is not needed on main — see counterpart #2648.) ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in #2649).
16+
17+
* **fix(harbor): drive `bucket-secret.yaml` from values, gate HelmRelease on `BucketInfo`**: Previously the Harbor system chart rendered its `*-registry-s3` Secret by calling `lookup` against the COSI BucketAccess credentials Secret. On the first reconcile that Secret does not yet exist, so the template crashed with `index of untyped nil` and Harbor never came up. The template is now driven by `.Values.bucket.bucketInfo` (a JSON string) with `dig`-based safe accessors, so a missing, empty, or partially-populated value renders nothing instead of erroring. The downstream `<release>-system` HelmRelease now sources `BucketInfo` through `valuesFrom` (`valuesKey: BucketInfo`, `targetPath: bucket.bucketInfo`) with the default `optional: false`, which tells helm-controller to refuse to compose values until the COSI BucketAccess controller has populated the Secret — both gating initial reconciliation and forcing a config-digest change (and thus a helm upgrade) once credentials arrive. This is the correct primitive here because Flux `HelmRelease.dependsOn` cannot reference COSI resources directly, and helm-controller's upgrade trigger is digest-based: a `lookup` returning new data on a later reconcile is not enough to force an upgrade on its own. The now-unused `bucket.secretName` value has been dropped from both the system chart's `values.yaml` default and the apps chart's `values:` block, and a new helm-unittest covers the unset / empty / empty-object / fully-populated render paths ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in #2528, backport #2673).
18+
19+
## Documentation
20+
21+
* **[website] docs(platform): add guides related managed apps backups**: Adds a tenant guide for application backup and recovery across managed Postgres, MariaDB, ClickHouse, and FoundationDB (one-off and scheduled backups, status, in-place or copy restores) and an administrator guide for configuring the backup framework via cluster `BackupClass` and driver strategies. The legacy chart-level backup values are marked deprecated with migration guidance ([**@androndo**](https://github.com/androndo) in cozystack/website#536).
22+
* **[website] docs(virtualization): document vm-default-images as opt-in package**: Adds a "Default Image Collection (opt-in package)" section to the Golden Images page documenting that `vm-default-images` is disabled by default, the ~320 GiB storage footprint of the default 16-image set, how to enable it via `bundles.enabledPackages`, and how to override `storageClass` or the `images[]` list through the `cozystack.vm-default-images` Package ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in cozystack/website#538).
23+
* **[website] docs(talm): init reference + operator extension points**: Adds a full `talm init` reference page (flag matrix, encrypt/decrypt, key recovery hint, `--cluster-endpoint`) and documents the new operator extension points (`extra*` values keys) introduced in talm v0.30.0 ([**@lexfrei**](https://github.com/lexfrei) in cozystack/website#537).
24+
* **[website] docs: lineage-controller-webhook configuration guide**: Documents the lineage-controller-webhook component and how to configure it on a Cozystack cluster ([**@lllamnyp**](https://github.com/lllamnyp) in cozystack/website#513).
25+
* **[website] fix(docs): stop autoupdate PRs from rewriting source URLs every run**: Pins the autoupdate doc generator so it no longer regenerates the same source URLs on every CI run, eliminating churn-only PRs against the docs site ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in cozystack/website#516).
26+
* **[website] docs(resource-management): instance-type resource presets**: Adds a reference for instance-type resource presets (CPU, memory, ratio) used by managed workloads, with backticked values for clarity ([**@lexfrei**](https://github.com/lexfrei) in cozystack/website#535).
27+
* **[website] docs: add platform licenses reference**: Adds a licenses page listing all OSS components shipped with Cozystack, with logos and license metadata, surfaced as an OSS-card grid on the docs site ([**@tym83**](https://github.com/tym83) in cozystack/website#530).
28+
* **[website] docs(networking): clusterDomain is pinned on tenants, drop stale 0.7.0 references**: Clarifies that `clusterDomain` is pinned on tenant clusters and removes outdated 0.7.0-era references ([**@lexfrei**](https://github.com/lexfrei) in cozystack/website#534).
29+
* **[website] feat(seo): canonical, JSON-LD, sitemap directive, richer meta descriptions**: Adds canonical link tags, JSON-LD schemas (including `SoftwareApplication`), a Sitemap directive in `robots.txt`, `llms.txt`, `noindex` for legacy doc versions, and richer per-page meta descriptions for keyword coverage in search and AI-search engines ([**@tym83**](https://github.com/tym83) in cozystack/website#533).
30+
* **[website] feat(docs): added guide about backup workloads from managed k8s**: New how-to guide for backing up workloads running inside managed tenant Kubernetes clusters with the Velero addon, including SeaweedFS bucket setup and credential extraction ([**@androndo**](https://github.com/androndo) in cozystack/website#528).
31+
* **[website] docs(networking): document publishing.proxyProtocol + ouroboros hairpin-NAT fix**: Documents `publishing.proxyProtocol` and explains the ouroboros hairpin-NAT fix for in-cluster clients reaching their own public IPs ([**@lexfrei**](https://github.com/lexfrei) in cozystack/website#527).
32+
* **[website] docs(storage): add LINSTOR GUI documentation**: Documents the LINSTOR GUI bundled with Cozystack — how to access it and what it exposes ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in cozystack/website#521).
33+
* **[website] docs(virtualization): update vm-image guide for golden images / vm-default-images**: Rewrites the VM image guide around the golden-image / `vm-default-images` workflow that ships in the v1.3 line ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in cozystack/website#520).
34+
* **[website] chore(ci): remove obsolete update-managed-apps cron workflow**: Removes the obsolete `update-managed-apps` cron workflow from the docs site CI ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in cozystack/website#519).
35+
* **[website] fix(ci): skip prereleases when picking openapi.json release**: The OpenAPI spec download step in the GitHub Pages build now skips prereleases so the docs site always picks up the latest stable `openapi.json` ([**@myasnikovdaniil**](https://github.com/myasnikovdaniil) in cozystack/website#515).
36+
* **[website] fix: refresh OSS health snapshots monthly**: Keeps the OSS Health page's telemetry snapshot stable by refreshing it on a monthly cadence rather than on every build ([**@tym83**](https://github.com/tym83) in cozystack/website#531).
37+
38+
## Other repositories
39+
40+
* **[talm] v0.25.1 → v0.30.0**: Significant `talm` development in this window. Major user-visible changes:
41+
- **Breaking — `-n` shorthand for `--nodes` dropped** (talm v0.28.0, #197): the long form `--nodes <IP>` is unchanged, but `-n IP` no longer works. The shorthand was silently absorbing `-n <value>` typed after a wrapped talosctl subcommand (e.g. `talm get hostnames -n network` parsed `network` as an additional node and failed inside the gRPC resolver with "produced zero addresses"); operators with `kubectl -n <ns>` muscle memory now get a clean `flag -n not defined` from cobra instead. Update scripts and docs accordingly ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#197).
42+
- **Behaviour change — `talm init` refuses inside an existing project** (talm v0.27.0, #161): pass `--root .` to create a sub-project under the current directory anyway, or run from the ancestor root to re-init it. `--root <path>` on subcommands (`apply`, `template`, `talosconfig`, `kubeconfig`, `rotate-ca`) now also correctly opts out of the implicit CWD walk-up — previously the flag was silently ignored on subcommands ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#161).
43+
- **Apply-time safety gates** (talm v0.28.0, #173, #200): `talm apply` now refuses to apply if declared resources don't exist on the node, and previews/verifies drift before mutating state. Follow-ups (#189, #190, #191, #192) round out the UX. The first `-f` file anchors the project root and later `-f` files are treated as patches ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#173, #200).
44+
- **`talm reset` preserves META by default** (talm v0.28.0, #185): operators no longer wipe Talos META during a reset unless they explicitly opt in ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#185).
45+
- **`talm upgrade` now sources the image from `values.yaml`, not the rendered node body**, and point-patches `install.image` after a successful upgrade so the next render matches reality (talm v0.29.0 and v0.30.0, #204, #211). Fixes drift between what was upgraded to and what subsequent renders would produce ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#204, #211).
46+
- **VIP / floatingIP correctness** (talm v0.27.0–v0.28.x, #163, #145, #147, #201): VIP is now pinned to a subnet-matching link (longest-prefix match) instead of the default-route link, IPv6 Hetzner topologies are pinned, empty bond configs are skipped, malformed CIDRs are filtered, and the v1.12 multi-doc network renderer was rewritten for full link coverage. `--endpoints` is honored in both `init` and the `talosconfig` regenerate flow (#202).
47+
- **Reliability** (talm v0.27.0): `RotateKeys` is now atomic — backup-and-restore on any phase failure, no partial state on disk (#159). `talm init` is all-or-nothing: every destination is pre-checked before the first write, so a `Chart.yaml` conflict no longer leaves `talosconfig` / `talm.key` / `secrets.encrypted.yaml` stranded. Encryption helpers write `secrets.yaml` and encrypted output with mode `0600`. IPv6 endpoint normalisation preserves brackets.
48+
- **Engine** (#139, #146): `talm apply` is now idempotent for object-array and `merge:replace` fields, and `$patch:delete` on absent paths is a no-op instead of an error.
49+
- **Operator extension points + presets** (talm v0.30.0, #211): exposes Talos operator extension points (`extra*` values keys) in the cozystack and generic presets, allowing operators to extend node configs without forking the chart ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#211).
50+
- **`talm dmesg` retired** (talm v0.29.0, #207): retired ahead of the upstream removal; operators are redirected to `talm logs kernel` ([**@lexfrei**](https://github.com/lexfrei) in cozystack/talm#207).
51+
- **UX hardening** (talm v0.28.0, #197): persistent flags reworked, crashdump and kubeconfig hints on failure, `dmesg` cushion, TUI refusal in non-interactive contexts, rich shell autocompletion for presets, modes, files, and talosconfig (#204), and `--set` warns when the value looks like a bare IP that should have been `--set-string`.
52+
- **Other** (#148): the cluster name can now be overridden via chart values ([**@dislogical**](https://github.com/dislogical) in cozystack/talm#148).
53+
54+
## Contributors
55+
56+
Thanks to everyone who contributed to this patch release:
57+
58+
* [**@androndo**](https://github.com/androndo)
59+
* [**@dislogical**](https://github.com/dislogical)
60+
* [**@lexfrei**](https://github.com/lexfrei)
61+
* [**@lllamnyp**](https://github.com/lllamnyp)
62+
* [**@myasnikovdaniil**](https://github.com/myasnikovdaniil)
63+
* [**@tym83**](https://github.com/tym83)
64+
65+
---
66+
67+
**Full Changelog**: https://github.com/cozystack/cozystack/compare/v1.3.3...v1.3.4

0 commit comments

Comments
 (0)