Skip to main content

General Settings

Change Version​

The version of a managed Argo CD instance can be upgraded (or downgraded) easily using the Akuity Platform.

  1. Navigate to Argo CD → your instance → Settings → General.

  2. Under Change Version, select your desired version.

  3. 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.

caution

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.

note

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.