Argo · Schema

ApplicationSource

Git or Helm chart source for the application manifests.

CNCFCI/CDGitOpsKubernetesOpen SourceProgressive DeliveryWorkflow Engine

Properties

Name	Type	Description
repoURL	string	URL of the Git repository or Helm chart repository.
path	string	Path within the repository where manifests are located. Used for Git repositories.
targetRevision	string	Git branch, tag, or commit SHA to deploy. Defaults to HEAD.
chart	string	Helm chart name. Used when repoURL points to a Helm registry.
helm	object	Helm-specific source configuration.
kustomize	object	Kustomize-specific source configuration.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/argo/refs/heads/main/json-schema/argo-cd-application-source-schema.json",
  "title": "ApplicationSource",
  "description": "Git or Helm chart source for the application manifests.",
  "type": "object",
  "properties": {
    "repoURL": {
      "type": "string",
      "description": "URL of the Git repository or Helm chart repository.",
      "format": "uri"
    },
    "path": {
      "type": "string",
      "description": "Path within the repository where manifests are located. Used for Git repositories."
    },
    "targetRevision": {
      "type": "string",
      "description": "Git branch, tag, or commit SHA to deploy. Defaults to HEAD."
    },
    "chart": {
      "type": "string",
      "description": "Helm chart name. Used when repoURL points to a Helm registry."
    },
    "helm": {
      "type": "object",
      "description": "Helm-specific source configuration.",
      "properties": {
        "valueFiles": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of Helm value file paths."
        },
        "values": {
          "type": "string",
          "description": "Inline Helm values as a YAML string."
        },
        "releaseName": {
          "type": "string",
          "description": "Helm release name override."
        }
      }
    },
    "kustomize": {
      "type": "object",
      "description": "Kustomize-specific source configuration.",
      "properties": {
        "namePrefix": {
          "type": "string",
          "description": "Prefix to append to all resource names."
        },
        "nameSuffix": {
          "type": "string",
          "description": "Suffix to append to all resource names."
        },
        "images": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of image overrides in name=tag format."
        }
      }
    }
  },
  "required": [
    "repoURL"
  ]
}