OS Manuals

/usr/bin/metacontroller

Writing kubernetes controllers can be simple

From metacontroller-fips 4.17.6-r2 (enterprise-packages), captured 2026-11-09 by running metacontroller --help (exit 0). permalink

Usage of /usr/bin/metacontroller:
  -apply-strategy string
    	Strategy to use for applying changes to objects (default "dynamic-apply")
  -apply-strategy-ssa-field-manager string
    	FieldManager to use for server-side apply (default "metacontroller")
  -cache-flush-interval duration
    	How often to flush local caches and relist objects from the API server (default 30m0s)
  -client-go-burst int
    	Allowed burst queries for client-go (default 10) (default 10)
  -client-go-qps float
    	Number of queries per second client-go is allowed to make (default 5) (default 5)
  -discovery-interval duration
    	How often to refresh discovery cache to pick up newly-installed resources (default 30s)
  -events-burst int
    	Number of events allowed to send per object (default 25) (default 25)
  -events-qps float
    	Rate of events flowing per object (default - 1 event per 5 minutes) (default 0.0033333333333333335)
  -health-probe-bind-address string
    	The address the health probes endpoint binds to (default ":8081")
  -kubeconfig string
    	Paths to a kubeconfig. Only required if out-of-cluster.
  -leader-election
    	Determines whether or not to use leader election when starting metacontroller
  -leader-election-id string
    	Determines the name of the resource that leader election will use for holding the leader lock (default "metacontroller")
  -leader-election-namespace string
    	Determines the namespace in which the leader election resource will be created
  -leader-election-resource-lock string
    	Determines which resource lock to use for leader election (default "leases")
  -metrics-address string
    	The address to bind metrics endpoint - /metrics (default ":9999")
  -pprof-address string
    	Enable pprof and bind to endpoint - /debug/pprof, set to 0 to disable pprof serving (default "0")
  -target-label-selector string
    	Label selector used to restrict an instance of metacontroller to manage specific Composite and Decorator controllers
  -workers int
    	Number of sync workers to run (default 5) (default 5)
  -zap-devel
    	Development Mode defaults(encoder=consoleEncoder,logLevel=Debug,stackTraceLevel=Warn). Production Mode defaults(encoder=jsonEncoder,logLevel=Info,stackTraceLevel=Error)
  -zap-encoder value
    	Zap log encoding (one of 'json' or 'console')
  -zap-log-level value
    	Zap Level to configure the verbosity of logging. Can be one of 'debug', 'info', 'error', 'panic' or any integer value > 0 which corresponds to custom debug levels of increasing verbosity
  -zap-stacktrace-level value
    	Zap Level at and above which stacktraces are captured (one of 'info', 'error', 'panic').
  -zap-time-encoding value
    	Zap time encoding (one of 'epoch', 'millis', 'nano', 'iso8601', 'rfc3339' or 'rfc3339nano'). Defaults to 'epoch'.
Options (23)
OptionDescriptionSource
-apply-strategy stringStrategy to use for applying changes to objects (default "dynamic-apply")help
-apply-strategy-ssa-field-manager stringFieldManager to use for server-side apply (default "metacontroller")help
-cache-flush-interval durationHow often to flush local caches and relist objects from the API server (default 30m0s)help
-client-go-burst intAllowed burst queries for client-go (default 10) (default 10)help
-client-go-qps floatNumber of queries per second client-go is allowed to make (default 5) (default 5)help
-discovery-interval durationHow often to refresh discovery cache to pick up newly-installed resources (default 30s)help
-events-burst intNumber of events allowed to send per object (default 25) (default 25)help
-events-qps floatRate of events flowing per object (default - 1 event per 5 minutes) (default 0.0033333333333333335)help
-health-probe-bind-address stringThe address the health probes endpoint binds to (default ":8081")help
-kubeconfig stringPaths to a kubeconfig.help
-leader-electionDetermines whether or not to use leader election when starting metacontrollerhelp
-leader-election-id stringDetermines the name of the resource that leader election will use for holding the leader lock (default "metacontroller")help
-leader-election-namespace stringDetermines the namespace in which the leader election resource will be createdhelp
-leader-election-resource-lock stringDetermines which resource lock to use for leader election (default "leases")help
-metrics-address stringThe address to bind metrics endpoint - /metrics (default ":9999")help
-pprof-address stringEnable pprof and bind to endpoint - /debug/pprof, set to 0 to disable pprof serving (default "0")help
-target-label-selector stringLabel selector used to restrict an instance of metacontroller to manage specific Composite and Decorator controllershelp
-workers intNumber of sync workers to run (default 5) (default 5)help
-zap-develDevelopment Mode defaults(encoder=consoleEncoder,logLevel=Debug,stackTraceLevel=Warn).help
-zap-encoder valueZap log encoding (one of 'json' or 'console')help
-zap-log-level valueZap Level to configure the verbosity of logging.help
-zap-stacktrace-level valueZap Level at and above which stacktraces are captured (one of 'info', 'error', 'panic').help
-zap-time-encoding valueZap time encoding (one of 'epoch', 'millis', 'nano', 'iso8601', 'rfc3339' or 'rfc3339nano').help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.