argo-cd/docs/operator-manual/feature-maturity.md
Mangaal Meetei 5103112b9a
docs: Promote ApplicationSet in any namespace to stable (#27417)
Signed-off-by: Mangaal <angommeeteimangaal@gmail.com>
2026-04-20 14:04:25 +03:00

75 lines
5.2 KiB
Markdown

# Feature Maturity
Argo CD features may be marked with a certain [status](https://github.com/argoproj/argoproj/blob/main/community/feature-status.md)
to indicate their stability and maturity. These are the statuses of non-stable features in Argo 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 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](./upgrading/overview.md) before upgrading.
## Overview
| Feature | Introduced | Status |
|-------------------------------------------|------------|--------|
| [AppSet Progressive Syncs][2] | v2.6.0 | Beta |
| [Proxy Extensions][3] | v2.7.0 | Beta |
| [Skip Application Reconcile][4] | v2.7.0 | Alpha |
| [Cluster Sharding: round-robin][6] | v2.8.0 | Alpha |
| [Dynamic Cluster Distribution][7] | v2.9.0 | Alpha |
| [Cluster Sharding: consistent-hashing][9] | v2.12.0 | Alpha |
| [Service Account Impersonation][10] | v2.13.0 | Alpha |
| [Source Hydrator][11] | v2.14.0 | Alpha |
## Unstable Configurations
### Application CRD
| Feature | Property | Status |
| ------------------------------- | --------------------------------------------------------------------------------------- | ------ |
| [Skip Application Reconcile][4] | `metadata.annotations[argocd.argoproj.io/skip-reconcile]` | Alpha |
### AppProject CRD
| Feature | Property | Status |
| ----------------------------------- | ----------------------------------- | ------ |
| [Service Account Impersonation][10] | `spec.destinationServiceAccounts.*` | Alpha |
### ApplicationSet CRD
| Feature | Property | Status |
| ----------------------------- | ---------------------------- |--------|
| [AppSet Progressive Syncs][2] | `spec.strategy.*` | Beta |
| [AppSet Progressive Syncs][2] | `status.applicationStatus.*` | Beta |
### Configuration
| Feature | Resource | Property / Variable | Status |
| ----------------------------------------- | --------------------------------------------- | ----------------------------------------------------------- | ------ |
| [AppSet Progressive Syncs][2] | `ConfigMap/argocd-cmd-params-cm` | `applicationsetcontroller.enable.progressive.syncs` | Beta |
| [AppSet Progressive Syncs][2] | `Deployment/argocd-applicationset-controller` | `ARGOCD_APPLICATIONSET_CONTROLLER_ENABLE_PROGRESSIVE_SYNCS` | Beta |
| [Proxy Extensions][3] | `ConfigMap/argocd-cmd-params-cm` | `server.enable.proxy.extension` | Beta |
| [Proxy Extensions][3] | `Deployment/argocd-server` | `ARGOCD_SERVER_ENABLE_PROXY_EXTENSION` | Beta |
| [Proxy Extensions][3] | `ConfigMap/argocd-cm` | `extension.config` | Beta |
| [Dynamic Cluster Distribution][7] | `Deployment/argocd-application-controller` | `ARGOCD_ENABLE_DYNAMIC_CLUSTER_DISTRIBUTION` | Alpha |
| [Dynamic Cluster Distribution][7] | `Deployment/argocd-application-controller` | `ARGOCD_CONTROLLER_HEARTBEAT_TIME` | Alpha |
| [Cluster Sharding: round-robin][6] | `ConfigMap/argocd-cmd-params-cm` | `controller.sharding.algorithm: round-robin` | Alpha |
| [Cluster Sharding: round-robin][6] | `StatefulSet/argocd-application-controller` | `ARGOCD_CONTROLLER_SHARDING_ALGORITHM=round-robin` | Alpha |
| [Cluster Sharding: consistent-hashing][9] | `ConfigMap/argocd-cmd-params-cm` | `controller.sharding.algorithm: consistent-hashing` | Alpha |
| [Cluster Sharding: consistent-hashing][9] | `StatefulSet/argocd-application-controller` | `ARGOCD_CONTROLLER_SHARDING_ALGORITHM=consistent-hashing` | Alpha |
| [Service Account Impersonation][10] | `ConfigMap/argocd-cm` | `application.sync.impersonation.enabled` | Alpha |
[2]: applicationset/Progressive-Syncs.md
[3]: ../developer-guide/extensions/proxy-extensions.md
[4]: ../user-guide/skip_reconcile.md
[6]: ./high_availability.md#argocd-application-controller
[7]: dynamic-cluster-distribution.md
[8]: ../user-guide/diff-strategies.md#server-side-diff
[9]: ./high_availability.md#argocd-application-controller
[10]: app-sync-using-impersonation.md
[11]: ../user-guide/source-hydrator.md