Skip to content

Commit 909bbdc

Browse files
committed
docs: clarify that sync and terminate operations are allowed on autonomous apps from the hub
Signed-off-by: Mike Ng <ming@redhat.com>
1 parent c37e3bf commit 909bbdc

2 files changed

Lines changed: 5 additions & 5 deletions

File tree

docs/concepts/agent-modes/autonomous.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@
44

55
In *autonomous mode*, the workload cluster is wholly responsible for maintaining its own configuration. As opposed to the [managed mode](./managed.md), all configuration is first created on the workload cluster. The agent on this workload cluster will observe creation, modification and deletion of configuration and transmit them to the principal on the control plane cluster.
66

7-
The principal will then create, update or delete this configuration on the control plane cluster. Users can use the Argo CD UI, CLI or API to inspect the status of the configuration, but they are not able to perform changes to the configuration or delete it.
7+
The principal will then create, update or delete this configuration on the control plane cluster. Users can use the Argo CD UI, CLI or API to inspect the status of the configuration, but they are not able to modify the configuration spec or delete it. Sync and terminate operations can still be triggered from the control plane and will be forwarded to the agent.
88

9-
Keep in mind that you will not be able to perform any changes whatsoever on the control plane (i.e. through the Argo CD UI, CLI or API) to Applications that are governed by an agent running in *autonomous* configuration mode. This includes parametrization (e.g. Kustomize or Helm parameters) as well as annotations, labels, changing Git parameters, sync options and others.
9+
Keep in mind that you will not be able to perform configuration changes on the control plane (i.e. through the Argo CD UI, CLI or API) to Applications that are governed by an agent running in *autonomous* configuration mode. This includes parametrization (e.g. Kustomize or Helm parameters) as well as annotations, labels, changing Git parameters, sync options and others. Such spec-level modifications are automatically reverted to match the agent's version.
1010

1111
## Architectural considerations
1212

1313
* Autonomous mode requires all components except argocd-server and argocd-dex to be running on a workload cluster.
14-
* In this mode, workload clusters are truly autonomous and only report back to the control plane. The control plane is merely an observation tool for autonomous agents.
14+
* In this mode, workload clusters are truly autonomous and own their configuration. The control plane serves primarily as an observation tool, though sync and terminate operations can still be triggered from it.
1515
* Argo CD configuration management must be externalized (e.g. app-of-apps, all changes must go through Git)
1616

1717
## Why chose this mode

docs/user-guide/applications.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,9 +138,9 @@ For more information, refer to [Managing AppProjects](./appprojects.md#autonomou
138138
In autonomous mode, the agent is the source of truth:
139139

140140
- **Agent → Principal**: Both spec and status changes
141-
- **Principal → Agent**: Read-only mirror (no modifications sent back)
141+
- **Principal → Agent**: Spec modifications are reverted; sync and terminate operations are forwarded
142142

143-
The principal serves as a centralized view of all Applications across autonomous agents but doesn't control them.
143+
The principal serves as a centralized view of all Applications across autonomous agents but doesn't control their configuration.
144144

145145
### Lifecycle Management
146146

0 commit comments

Comments
 (0)