Advanced Settings

---

General

Installation Namespace

• Use the Installation Namespace field to deploy the agent to a different namespace. The default namespace is akuity.

  note

  Operators can only configure this setting during the initial deployment of the agent.

State Replication

• The State Replication toggle allows disconnecting the cluster from the Akuity Platform without losing core Argo CD features. See State Replication for more information.

  note

  Operators can only configure this setting during the initial deployment of the agent.

Redis Tunneling

• The Redis Tunneling toggle enables the ability to connect to Redis over a web-socket tunnel that allows using Akuity agent behind HTTPS proxy.

Auto Update

• Toggle Auto Upgrade off to prevent the agent from automatically upgrading its components.

  Manual Updates to the Akuity Agent

  With auto upgrades disabled, users must apply the agent updates manually. To accomplish this, go to the Clusters menu for the Argo CD instance and click Install Agent on the desired cluster, then run the provided command with the kubectl context set for the corresponding cluster.

Namespace Scoped

• Toggle Namespace Scoped to limit the agent to only deploying resources into its namespace.

  note

  Operators can only configure this setting during the initial deployment of the agent.

Agent Size

• In the Agent Size section, choose the size of your Akuity Agent. This selection only impacts the resources allocated to the Akuity Agent within your cluster and does not impact your billing in any way.

  Optimized Default Agent Sizes

  Agent Size	Controller Memory	Controller CPU	Repo Server Memory	Repo Server CPU	Repo Server Replicas
  Small	0.5GB	0.25CPU	0.25GB	0.25CPU	2
  Medium	1GB	0.50CPU	0.50GB	0.5CPU	2
  Large	2GB	1CPU	0.50GB	0.5CPU	3
  Custom	2GB	1CPU	0.50GB	0.5CPU	3

  caution

  Custom Agent Sizes will override manually created Agent Kustomizations. All other Kustomizations will remain the same.

Labels & Annotations

• Add applicable labels and annotations as key/value pairs in the Labels and Annotations sections of the Advanced settings menu.

  • Click + Add to add a key/value pair.

  • Click the trash bin icon next to a key/value pair to delete it.

Managed Cluster Kubeconfig

• Use the Managed Cluster Kubeconfig field to use a different kubeconfig than the default in-cluster kubeconfig. This is useful if you want to e.g. connect a vCluster
  from a host cluster.

  • The agent needs to be installed into a location where there is a secret configured with a kubeconfig.
  • The default Secret Name is cluster-config, this is configurable.
  • If you have the kubeconfig located under a specific key in the secret, that's also configurable (see Secret Key)

---

Manifests Customization

Akuity Custom Image Registry

• Enter where to pull the agent image from using the Akuity Custom Image Registry field. The default registry is quay.io/akuity.

Argoproj Custom Image Registry

• Enter where to pull the Argo CD images from using the Argoproj Custom Image Registry field. The default registry is quay.io/argoproj.

Notifications Controller Log Level

• Set the logging level of the argocd-notifications-controller: debug|info|warn|error (default "info").

Repo Server Env Variables

• Enter an environment variable that you would like to configure for the argocd-repo-server.

Example:

ARGOCD_EXEC_TIMEOUT: 'value'
ARGOCD_REPO_SERVER_PARALLELISM_LIMIT: 'value'
HELM_REGISTRY_CONFIG: 'value'

info

Please contact support on best practices and optimization of the argocd-repo-server.

Kustomization

• The Akuity Platform supports customizing the Akuity Agent manifests using a Kustomization.

Agent Size Kustomization:

In some cases the optimized default Agent sizes might not be enough for all use cases. The following example describes how to increase the resource limits/request for both the argocd-repo-server & argocd-application-controller.

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
patches:
  - patch: |-
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: argocd-repo-server
      spec:
        template:
          spec:
            containers:
            - name: argocd-repo-server
              resources:
                limits:
                  memory: 2Gi
                requests:
                  cpu: 750m
                  memory: 1Gi
    target:
      kind: Deployment
      name: argocd-repo-server

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
patches:
  - patch: |-
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: argocd-application-controller
      spec:
        template:
          spec:
            containers:
            - name: argocd-application-controller
              resources:
                limits:
                  memory: 4Gi
                requests:
                  cpu: 1000m
                  memory: 2Gi
    target:
      kind: Deployment
      name: argocd-application-controller