General Settings
Change Version
The version of a managed Argo CD instance can be upgraded (or downgraded) easily using the Akuity Platform.
-
Navigate to Argo CD → your instance → Settings → General.
-
Under Change Version, select your desired version.
-
Click Save.
Once saved, the Akuity Platform will automatically update the instance. After the operation is complete, the instance will show a healthy status in the dashboard, indicating success.
Changing the version of the instance will trigger an update of the Akuity Agent on all connected clusters. The operation is carried out by a temporary job executed in the agent's namespace.
Automatic updates to the Akuity Agent can be disabled by default for all clusters on an instance and per cluster. See Disable Auto Upgrade in Agent Advanced Settings.
A similar job is used when modifying cluster options such as Agent size, Labels or Annotations, to automatically update the agent configuration in the connected clusters.
Applications in any namespace
The Applications in any namespace is an Argo CD feature that allows you to store Application resources in any namespace of a control plane cluster.
To enable this feature, navigate to Argo CD → your instance → Settings → General and toggle the App In Any Namespace switch.
Once feature is enabled, you can create additional namespaces as well as Application resources in new namespace of a control plane cluster using declarative management approach. Make sure to allow the additional namespaces in the required Argo CD project as described in the official documentation. Example:
apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
name: test
namespace: argocd
spec:
destinations:
- name: '*'
namespace: '*'
server: '*'
sourceNamespaces:
- test
sourceRepos:
- '*'
---
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: my-app
namespace: test
spec:
destination:
name: test
namespace: default
project: test
source:
path: guestbook
repoURL: https://github.com/argoproj/argocd-example-apps.git
targetRevision: HEAD
To apply this manifest, run akuity argocd apply --name <your-instance> -f <resource-name>.yaml
. This will create the application resource in the test
namespace.