Skip to content

Feature Maturity

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

Using Alpha/Beta features risks

Aplha 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 Argo CD upgrades.

Furthermore, removal of Alpha features may modify your resources to an unpredictable state after Argo 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 Alpha
Proxy Extensions v2.7.0 Alpha
Skip Application Reconcile v2.7.0 Alpha
AppSets in any Namespace v2.8.0 Beta
Cluster Sharding: round-robin v2.8.0 Alpha
Dynamic Cluster Distribution v2.9.0 Alpha
Server Side Diff v2.10.0 Beta
Cluster Sharding: consistent-hashing v2.12.0 Alpha
Service Account Impersonation v2.13.0 Alpha

Unstable Configurations

Application CRD

Feature Property Status
Server Side Diff metadata.annotations[argocd.argoproj.io/compare-options]: ServerSideDiff=true Beta
Server Side Diff metadata.annotations[argocd.argoproj.io/compare-options]: IncludeMutationWebhook=true Beta
Skip Application Reconcile metadata.annotations[argocd.argoproj.io/skip-reconcile] Alpha

AppProject CRD

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

ApplicationSet CRD

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

Configuration

Feature Resource Property / Variable Status
AppSets in any Namespace Deployment/argocd-applicationset-controller ARGOCD_APPLICATIONSET_CONTROLLER_ALLOWED_SCM_PROVIDERS Beta
AppSets in any Namespace ConfigMap/argocd-cmd-params-cm applicationsetcontroller.allowed.scm.providers Beta
AppSets in any Namespace ConfigMap/argocd-cmd-params-cm applicationsetcontroller.enable.scm.providers Beta
AppSets in any Namespace Deployment/argocd-applicationset-controller ARGOCD_APPLICATIONSET_CONTROLLER_ENABLE_SCM_PROVIDERS Beta
AppSets in any Namespace Deployment/argocd-applicationset-controller ARGOCD_APPLICATIONSET_CONTROLLER_NAMESPACES Beta
AppSets in any Namespace ConfigMap/argocd-cmd-params-cm applicationsetcontroller.namespaces Beta
Server Side Diff ConfigMap/argocd-cmd-params-cm controller.diff.server.side Beta
Server Side Diff StatefulSet/argocd-application-controller ARGOCD_APPLICATION_CONTROLLER_SERVER_SIDE_DIFF Beta
AppSet Progressive Syncs ConfigMap/argocd-cmd-params-cm applicationsetcontroller.enable.progressive.syncs Alpha
AppSet Progressive Syncs Deployment/argocd-applicationset-controller ARGOCD_APPLICATIONSET_CONTROLLER_ENABLE_PROGRESSIVE_SYNCS Alpha
Proxy Extensions ConfigMap/argocd-cmd-params-cm server.enable.proxy.extension Alpha
Proxy Extensions Deployment/argocd-server ARGOCD_SERVER_ENABLE_PROXY_EXTENSION Alpha
Proxy Extensions ConfigMap/argocd-cm extension.config Alpha
Dynamic Cluster Distribution Deployment/argocd-application-controller ARGOCD_ENABLE_DYNAMIC_CLUSTER_DISTRIBUTION Alpha
Dynamic Cluster Distribution Deployment/argocd-application-controller ARGOCD_CONTROLLER_HEARTBEAT_TIME Alpha
Cluster Sharding: round-robin ConfigMap/argocd-cmd-params-cm controller.sharding.algorithm: round-robin Alpha
Cluster Sharding: round-robin StatefulSet/argocd-application-controller ARGOCD_CONTROLLER_SHARDING_ALGORITHM=round-robin Alpha
Cluster Sharding: consistent-hashing ConfigMap/argocd-cmd-params-cm controller.sharding.algorithm: consistent-hashing Alpha
Cluster Sharding: consistent-hashing StatefulSet/argocd-application-controller ARGOCD_CONTROLLER_SHARDING_ALGORITHM=consistent-hashing Alpha
Service Account Impersonation ConfigMap/argocd-cm application.sync.impersonation.enabled Alpha