Source Hydrator supports inline Helm source parameters

Introduced 2026-02-02 · score 0.96

HOW TO USE IT

When configuring a Source Hydrator Application to render a Helm chart with environment-specific values, put the Helm settings under `spec.sourceHydrator.drySource.helm`; the hydrator uses that inline source configuration when rendering.

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-helm-app
spec:
  sourceHydrator:
    drySource:
      repoURL: https://github.com/argoproj/argocd-example-apps
      path: helm-guestbook
      targetRevision: HEAD
      helm:
        valueFiles:
          - values-prod.yaml
        parameters:
          - name: image.tag
            value: v1.2.3
        releaseName: my-release
    syncSource:
      targetBranch: environments/prod
      path: helm-guestbook-hydrated

WHY THIS HELPS

Configure a Source Hydrator Application to render a Helm chart with environment-specific values.

BEFORE THIS CHANGE

Source Hydrator supported basic Git repository fields (`repoURL`, `targetRevision`, `path`) in `DrySource`, but not Helm-specific configuration such as value files or parameters.

REQUIREMENTS AND LIMITATIONS

Version: v3.3.0
Availability: Source Hydrator is identified as an alpha feature in the PR description.
spec.sourceHydrator.drySource.repoURL (required): Repository URL containing the source.
spec.sourceHydrator.drySource.path: Path to the source within the repository.
spec.sourceHydrator.drySource.targetRevision (required): Revision of the dry source.
spec.sourceHydrator.drySource.helm.valueFiles: Helm values files used to override chart values.
spec.sourceHydrator.drySource.helm.parameters[].name: Helm parameter name to set.
spec.sourceHydrator.drySource.helm.parameters[].value: Value for the named Helm parameter.
spec.sourceHydrator.drySource.helm.releaseName: Helm release name override.
spec.sourceHydrator.syncSource.targetBranch (required): Branch receiving hydrated manifests.
spec.sourceHydrator.syncSource.path (required): Output path for hydrated manifests; must be a non-root repository directory.
Prerequisite: Source Hydrator is disabled by default. Enable the commit server and set `hydrator.enabled: "true"` in `argocd-cmd-params-cm`, then restart the Argo CD controller and API server.
Prerequisite: Install separate pull and push repository secrets for the source repository.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card

Tools change faster than your agent’s training data.

Changes

Source Hydrator supports inline Helm source parameters