Source Watcher

Controller Specification

The source-watcher implements the source.extensions.fluxcd.io API that extends the capabilities of the Flux source-controller with advanced source composition and decomposition patterns.

Flags

Name Type Description
--artifact-digest-algo string The hashing algorithm used to calculate the digest of artifacts. (default “sha256”)
--artifact-retention-records int The maximum number of artifacts to be kept in storage after a garbage collection. (default 2)
--artifact-retention-ttl duration The duration of time that artifacts from previous reconciliations will be kept in storage before being garbage collected. (default 1m0s)
--concurrent int The number of concurrent reconciles per controller. (default 10)
--enable-leader-election boolean Enable leader election for controller manager. Enabling this will ensure there is only one active controller manager.
--events-addr string The address of the events receiver.
--health-addr string The address the health endpoint binds to. (default “:9440”)
--http-retry int The maximum number of retries when failing to fetch artifacts over HTTP. (default 9)
--interval-jitter-percentage uint8 Percentage of jitter to apply to interval durations. A value of 10 will apply a jitter of +/-10% to the interval duration. It cannot be negative, and must be less than 100. (default 5)
--leader-election-lease-duration duration Interval at which non-leader candidates will wait to force acquire leadership (duration string). (default 35s)
--leader-election-release-on-cancel boolean Defines if the leader should step down voluntarily on controller manager shutdown. (default true)
--leader-election-renew-deadline duration Duration that the leading controller manager will retry refreshing leadership before giving up (duration string). (default 30s)
--leader-election-retry-period duration Duration the LeaderElector clients should wait between tries of actions (duration string). (default 5s)
--log-encoding string Log encoding format. Can be ‘json’ or ‘console’. (default “json”)
--log-level string Log verbosity level. Can be one of ‘trace’, ‘debug’, ‘info’, ‘error’. (default “info”)
--max-retry-delay duration The maximum amount of time for which an object being reconciled will have to wait before a retry. (default 15m0s)
--metrics-addr string The address the metric endpoint binds to. (default “:8080”)
--min-retry-delay duration The minimum amount of time for which an object being reconciled will have to wait before a retry. (default 750ms)
--no-cross-namespace-refs boolean When set to true, references between custom resources are allowed only if the reference and the referee are in the same namespace. (default false)
--reconciliation-timeout duration The maximum duration of a reconciliation. (default 10m0s)
--requeue-dependency duration The interval at which failing dependencies are reevaluated. (default 5s)
--storage-addr string The address the static file server binds to. (default “:9090”)
--storage-adv-addr string The advertised address of the static file server.
--storage-path string The local storage path. (default “/data”)
--watch-all-namespaces boolean Watch for resources in all namespaces, if set to false it will only watch the runtime namespace. (default true)
--watch-label-selector string Watch for resources with matching labels e.g. ‘sharding.fluxcd.io/shard=shard1’.
--feature-gates mapStringBool A comma separated list of key=value pairs defining the state of experimental features.

Feature Gates

Name Default Value Description
DirectSourceFetch false Enables fetching source objects (GitRepository, OCIRepository, Bucket, HelmChart, ExternalArtifact) directly from the API server using APIReader, bypassing the controller’s cache. This can be useful when immediate consistency is required for source object reads.