Files
deploy/docs/operator-manual/feature-maturity.md
zeekayandHanzo Dev 446e343a3d cd: annotations are cd.hanzo.ai, API group is apps.hanzo.ai
Two corrections on top of the naming pass, both found by checking the live
cluster rather than the source.

The rename had silently changed the user-facing annotation key from
argocd.argoproj.io/sync-wave to cd.argoproj.io/sync-wave — 63 live
Applications carry the old key, so deploying that would have ignored every
sync-wave and broken fleet deploy ordering. The key is now cd.hanzo.ai/*,
and universe 575650286 moves the ApplicationSet template that stamps it, so
the controller regenerates all 63 consistently.

The API group in code said argoproj.io/v1alpha1 in 157 places while the
cluster has served apps.hanzo.ai/v1alpha1 since 2026-07-23 (the CRDs are
applications.apps.hanzo.ai). Code now matches what is actually served.

The legacy applications.argoproj.io/app-name label had ZERO live users, so it
went with the rest. foo.argoproj.io test fixtures became foo.example.com —
arbitrary test domains should not carry a vendor name.

go build ./... exit 0.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-28 16:32:14 -07:00

5.9 KiB

Feature Maturity

Hanzo CD features may be marked with a certain status to indicate their stability and maturity. These are the statuses of non-stable features in Hanzo CD:

Caution

Using Alpha/Beta features risks

Alpha and Beta features do not guarantee backward compatibility and are subject to breaking changes in the future releases. It is highly suggested for Argo users not to rely on these features in production environments, especially if you do not have control over the Hanzo CD upgrades.

Furthermore, removal of Alpha features may modify your resources to an unpredictable state after Hanzo CD is upgraded. You should make sure to document which features are in use and review the release notes before upgrading.

Overview

Feature Introduced Status
AppSet Progressive Syncs v2.6.0 Beta
Proxy Extensions v2.7.0 Beta
Skip Application Reconcile v2.7.0 Alpha
Cluster Sharding: round-robin v2.8.0 Alpha
Dynamic Cluster Distribution v2.9.0 Alpha
Cluster Sharding: consistent-hashing v2.12.0 Alpha
Service Account Impersonation v2.13.0 Beta
Source Hydrator v2.14.0 Beta
ApplicationSet Web UI v3.5.0 Alpha

Unstable Configurations

Application CRD

Feature Property Status
Skip Application Reconcile metadata.annotations[cd.hanzo.ai/skip-reconcile] Alpha
Source Hydrator spec.sourceHydrator.* Beta

AppProject CRD

Feature Property Status
Service Account Impersonation spec.destinationServiceAccounts.* Beta

ApplicationSet CRD

Feature Property Status
AppSet Progressive Syncs spec.strategy.* Beta
AppSet Progressive Syncs status.applicationStatus.* Beta

Configuration

Feature Resource Property / Variable Status
AppSet Progressive Syncs ConfigMap/cd-cmd-params-cm applicationsetcontroller.enable.progressive.syncs Beta
AppSet Progressive Syncs Deployment/cd-applicationset-controller CD_APPLICATIONSET_CONTROLLER_ENABLE_PROGRESSIVE_SYNCS Beta
Proxy Extensions ConfigMap/cd-cmd-params-cm server.enable.proxy.extension Beta
Proxy Extensions Deployment/cd-server CD_SERVER_ENABLE_PROXY_EXTENSION Beta
Proxy Extensions ConfigMap/cd-cm extension.config Beta
Dynamic Cluster Distribution Deployment/cd-application-controller CD_ENABLE_DYNAMIC_CLUSTER_DISTRIBUTION Alpha
Dynamic Cluster Distribution Deployment/cd-application-controller CD_CONTROLLER_HEARTBEAT_TIME Alpha
Cluster Sharding: round-robin ConfigMap/cd-cmd-params-cm controller.sharding.algorithm: round-robin Alpha
Cluster Sharding: round-robin StatefulSet/cd-application-controller CD_CONTROLLER_SHARDING_ALGORITHM=round-robin Alpha
Cluster Sharding: consistent-hashing ConfigMap/cd-cmd-params-cm controller.sharding.algorithm: consistent-hashing Alpha
Cluster Sharding: consistent-hashing StatefulSet/cd-application-controller CD_CONTROLLER_SHARDING_ALGORITHM=consistent-hashing Alpha
Service Account Impersonation ConfigMap/cd-cm application.sync.impersonation.enabled Beta
Source Hydrator ConfigMap/cd-cmd-params-cm hydrator.enabled Beta
Source Hydrator Deployment/cd-application-controller CD_HYDRATOR_ENABLED Beta
Source Hydrator Deployment/cd-server CD_HYDRATOR_ENABLED Beta