Files
cozystack/docs/changelogs/v1.0.0-beta.6.md
T

6.1 KiB

⚠️ Beta Release Warning: This is a pre-release version intended for testing and early adoption. Breaking changes may occur before the stable v1.0.0 release.

Features and Improvements

  • [platform] Add cilium-kilo networking variant: Added a new cilium-kilo networking variant that combines Cilium CNI with Kilo WireGuard mesh overlay. This variant enables enable-ipip-termination in Cilium for proper IPIP packet handling and deploys Kilo with --compatibility=cilium flag. Users can now select cilium-kilo as their networking variant during platform setup, simplifying the multi-location WireGuard setup compared to manually combining Cilium and standalone Kilo (@kvaps in #2064).

  • [nats] Add monitoring: Added Grafana dashboards for NATS JetStream and server metrics monitoring, along with Prometheus monitoring support with TLS-aware endpoint configuration. Includes updated image customization options (digest and full image name) and component version upgrades for the NATS exporter and utilities. Users now have full observability into NATS message broker performance and health (@klinch0 in #1381).

  • [platform] Add DNS-1035 validation for Application names: Added dynamic DNS-1035 label validation for Application names in the Cozystack API, using IsDNS1035Label from k8s.io/apimachinery. Validation is performed at creation time and accounts for the root host length to prevent names that would exceed Kubernetes resource naming limits. This prevents creation of resources with invalid names that would fail downstream Kubernetes resource creation (@lexfrei in #1771).

  • [operator] Add automatic CRD installation at startup: Added --install-crds flag to the Cozystack operator that installs embedded CRD manifests at startup, ensuring CRDs exist before the operator begins reconciliation. CRD manifests are now embedded in the operator binary and verified for consistency with the Helm crds/ directory via a new CI Makefile check. This eliminates ordering issues during initial cluster setup where CRDs might not yet be present (@lexfrei in #2060).

Fixes

  • [platform] Adopt tenant-root into cozystack-basics during migration: Added migration 31 to adopt existing tenant-root Namespace and HelmRelease into the cozystack-basics Helm release when upgrading from v0.41.x to v1.0. Previously these resources were applied via kubectl apply with no Helm release tracking, causing Helm to treat them as foreign resources and potentially delete them during reconciliation. This migration ensures a safe upgrade path by annotating and labeling these resources for Helm adoption (@kvaps in #2065).

  • [platform] Preserve tenant-root HelmRelease during migration: Fixed a data-loss risk during migration from v0.41.x to v1.0.0-beta where the tenant-root HelmRelease (and the namespace it manages) could be deleted, causing tenant service outages. Added safety annotation to the HelmRelease and lookup logic to preserve current parameters during migration, preventing unwanted deletion of tenant-root resources (@sircthulhu in #2063).

  • [codegen] Add gen_client to update-codegen.sh and regenerate applyconfiguration: Fixed a build error in pkg/generated/applyconfiguration/utils.go caused by a reference to testing.TypeConverter which was removed in client-go v0.34.1. The root cause was that hack/update-codegen.sh never called gen_client, leaving the generated applyconfiguration code stale. Running the full code generation now produces a consistent and compilable codebase (@lexfrei in #2061).

  • [e2e] Make kubernetes test retries effective by cleaning up stale resources: Fixed E2E test retries for the Kubernetes tenant test by adding pre-creation cleanup of backend deployment/service and NFS pod/PVC in run-kubernetes.sh. Previously, retries would fail immediately because stale resources from a failed attempt blocked re-creation. Also increased the tenant deployment wait timeout from 90s to 300s to handle CI resource pressure (@lexfrei in #2062).

Development, Testing, and CI/CD

  • [e2e] Use helm install instead of kubectl apply for cozystack installation: Replaced the pre-rendered static YAML application flow (kubectl apply) with direct helm upgrade --install of the packages/core/installer chart in E2E tests. Removed the CRD/operator artifact upload/download steps from the CI workflow, simplifying the pipeline. The chart with correct values is already present in the sandbox via workspace copy and pr.patch (@lexfrei in #2060).

Documentation

  • [website] Improve Azure autoscaling troubleshooting guide: Enhanced the Azure autoscaling troubleshooting documentation with serial console instructions for debugging VMSS worker nodes, a troubleshooting section for nodes stuck in maintenance mode due to invalid or missing machine config, az vmss update --custom-data instructions for updating machine config, and a warning that Azure does not support reading back customData (@kvaps in cozystack/website#424).

  • [website] Update multi-location documentation for cilium-kilo variant: Updated multi-location networking documentation to reflect the new integrated cilium-kilo variant selection during platform setup, replacing the previous manual Kilo installation and Cilium configuration steps. Added explanation of enable-ipip-termination and updated the troubleshooting section (@kvaps in cozystack/website@02d63f0).

Contributors

We'd like to thank all contributors who made this release possible:

Full Changelog: https://github.com/cozystack/cozystack/compare/v1.0.0-beta.5...v1.0.0-beta.6