State Replication
The State Replication feature on the Akuity Platform allows you to disconnect a managed cluster from the platform without losing core Argo CD features. This feature is immutable and can only be enabled during cluster creation. Once enabled, all Application and Project CRDs are synced to the managed clusters, and the application-controller in the managed cluster is switched to work with the managed cluster instead of the Akuity Platform control plane cluster.
Enabling State Replication
To enable the State Replication feature during cluster connection, follow these steps:
- Under Advanced settings, locate the flag called State Replication.
- Toggle the flag to enable State Replication.
- Complete the cluster connection process.
Using State Replication
Once the State Replication feature is enabled, the application-controller in the managed cluster will work with the managed cluster instead of the control plane cluster. This means that even if the connection to the control plane is lost, core ArgoCD functionality will still be working.
To run the Argo CD UI in the managed cluster, use the argocd admin dashboard command from argocd CLI.
Note that the application-controller will still be trying to write to the control plane redis. If you need a fully functioning Argo CD UI, switch the application-controller to the redis located in the managed cluster. This can be done by editing the application-controller deployment.
Changing the version of the instance won't update CRDs in the managed cluster, because Akuity Agent doesn't have permission to do that, hence the agent manifest needs to be reapplied manually.