Configuration property fixed at build time - All other configuration properties are overridable at runtime

Configuration property

Type

Default

Whether the operator should check that the CRD is properly deployed and that the associated CustomResource implementation matches its information before registering the associated controller.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_VALIDATE

boolean

true

Whether the extension should automatically generate the CRD based on CustomResource implementations.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_GENERATE

boolean

Whether the extension should automatically apply updated CRDs when they change. When running on DEV mode, the CRD changes will always be applied automatically.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_APPLY

boolean

Comma-separated list of which CRD versions should be generated.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_VERSIONS

list of string

v1

The directory where the CRDs will be generated, defaults to the kubernetes directory of the project’s output directory.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_OUTPUT_DIRECTORY

string

Whether the extension should generate all CRDs even if some are not tied to a Reconciler.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_GENERATE_ALL

boolean

false

Whether the CRDs should be generated in parallel. Please note that this feature is experimental and it may lead to unexpected results.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_GENERATE_IN_PARALLEL

boolean

false

A comma-separated list of fully-qualified class names implementing custom resources to exclude from the CRD generation process.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_EXCLUDE_RESOURCES

list of string

A comma-separated list of paths where external CRDs that need to be referenced for non-generated custom resources. Typical use cases where this might be needed include when custom resource implementations are located in a different module than the controller implementation or when the CRDs are not generated at all (e.g. in integration cases where your operator needs to deal with 3rd party custom resources).

Paths can be either absolute or relative, in which case they will be resolved from the current module root directory.

Environment variable: QUARKUS_OPERATOR_SDK_CRD_EXTERNAL_CRD_LOCATIONS

list of string

Whether controllers should only process events if the associated resource generation has increased since last reconciliation, otherwise will process all events. Sets the default value for all controllers.

Environment variable: QUARKUS_OPERATOR_SDK_GENERATION_AWARE

boolean

true

Whether Role-Based Access Control (RBAC) resources generated by the Kubernetes extension should be augmented by this extension.

Environment variable: QUARKUS_OPERATOR_SDK_DISABLE_RBAC_GENERATION

boolean

false

Whether the operator should be automatically started or not. Mostly useful for testing scenarios.

Environment variable: QUARKUS_OPERATOR_SDK_START_OPERATOR

boolean

true

Whether the injected Kubernetes client should be stopped when the operator is stopped.

Environment variable: QUARKUS_OPERATOR_SDK_CLOSE_CLIENT_ON_STOP

boolean

true

Whether the operator should stop if an informer error (such as one caused by missing / improper RBACs) occurs during startup.

Environment variable: QUARKUS_OPERATOR_SDK_STOP_ON_INFORMER_ERROR_DURING_STARTUP

boolean

true

Whether to fail or emit a debug-level (warning-level when misalignment is at the minor or above version level) log when the extension detects that there are misaligned versions.

The following versions are checked for alignment:

  • declared Quarkus version used to build the extension vs. actually used Quarkus version at runtime

  • Fabric8 client version used by JOSDK vs. actually used Fabric8 client version

  • Fabric8 client version used by Quarkus vs. actually used Fabric8 client version

Environment variable: QUARKUS_OPERATOR_SDK_FAIL_ON_VERSION_CHECK

boolean

false

The list of profile names for which leader election should be activated. This is mostly useful for testing scenarios where leader election behavior might lead to issues.

Environment variable: QUARKUS_OPERATOR_SDK_ACTIVATE_LEADER_ELECTION_FOR_PROFILES

list of string

prod

The optional Server-Side Apply (SSA) related configuration.

Environment variable: QUARKUS_OPERATOR_SDK_ENABLE_SSA

boolean

true

An optional list of comma-separated watched namespace names that will be used to generate manifests at build time if controllers do NOT specify a value individually. See BuildTimeControllerConfiguration#generateWithWatchedNamespaces for more information.

Environment variable: QUARKUS_OPERATOR_SDK_GENERATE_WITH_WATCHED_NAMESPACES

list of string

Can be used to disable helm chart generation.

Environment variable: QUARKUS_OPERATOR_SDK_HELM_ENABLED

boolean

false

The max number of concurrent dispatches of reconciliation requests to controllers.

Environment variable: QUARKUS_OPERATOR_SDK_CONCURRENT_RECONCILIATION_THREADS

int

Amount of seconds the SDK waits for reconciliation threads to terminate before shutting down.

Environment variable: QUARKUS_OPERATOR_SDK_TERMINATION_TIMEOUT_SECONDS

int

An optional list of comma-separated namespace names all controllers will watch if they do not specify their own list. If a controller specifies its own list either via the io.javaoperatorsdk.operator.api.reconciler.ControllerConfiguration annotation or via the associated application.properties property, that value will be used instead of the operator-level default value that this configuration option provides.

If this property is left empty then controllers will watch all namespaces by default (which is equivalent to setting this property to Constants#WATCH_ALL_NAMESPACES, assuming they do not provide their own list of namespaces to watch. . The value can be set to Constants#WATCH_CURRENT_NAMESPACE to make all controllers watch the current namespace as specified by the kube config file the operator uses.

Environment variable: QUARKUS_OPERATOR_SDK_NAMESPACES

list of string

QOSDK_USE_BUILDTIME_NAMESPACES

The max number of concurrent workflow processing requests.

Environment variable: QUARKUS_OPERATOR_SDK_CONCURRENT_WORKFLOW_THREADS

int

How long the operator will wait for informers to finish synchronizing their caches on startup before timing out.

Environment variable: QUARKUS_OPERATOR_SDK_CACHE_SYNC_TIMEOUT

Duration 

2M

Whether the controller should only process events if the associated resource generation has increased since last reconciliation, otherwise will process all events.

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__GENERATION_AWARE

boolean

An optional list of comma-separated watched namespace names that will be used to generate manifests at build time.

Note that this is provided as a means to quickly deploy a specific controller to test it by applying the generated manifests to the target cluster. If empty, no manifests will be generated. The namespace in which the controller will be deployed will be the currently configured namespace as specified by your .kube/config file, unless you specify the target deployment namespace using the quarkus.kubernetes.namespace property.

As this functionality cannot handle namespaces that are not know until runtime (because the generation happens during build time), we recommend that you use a different mechanism such as OLM or Helm charts to deploy your operator in production.

This replaces the previous namespaces property which was confusing and against Quarkus best practices since it existed both at build time and runtime. That property wasn’t also adequately capturing the fact that namespaces that wouldn’t be known until runtime would render whatever got generated at build time invalid as far as generated manifests were concerned.

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__GENERATE_WITH_WATCHED_NAMESPACES

list of string

Indicates whether the primary resource for the associated controller is unowned, meaning that another controller is the principal controller handling resources of this type. By default, controllers are assumed to own their primary resource but there are cases where this might not be the case, for example, when extra processing of a given resource type is required even though another controller already handles reconciliations of resources of that type. Set this property to true if you want to indicate that the controller doesn’t own its primary resource

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__UNOWNED_PRIMARY

boolean

false

An optional list of comma-separated namespace names the controller should watch. If this property is left empty then the controller will watch all namespaces. The value can be set to "JOSDK_WATCH_CURRENT" to watch the current (default) namespace from kube config. Constant(s) can be found in at `io.javaoperatorsdk.operator.api.reconciler.Constants`".

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__NAMESPACES

list of string

QOSDK_USE_BUILDTIME_NAMESPACES

The optional name of the finalizer for the controller. If none is provided, one will be automatically generated.

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__FINALIZER

string

How many times an operation should be retried before giving up

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__RETRY_MAX_ATTEMPTS

int

The initial interval that the controller waits for before attempting the first retry

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__RETRY_INTERVAL_INITIAL

long

2000

The value by which the initial interval is multiplied by for each retry

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__RETRY_INTERVAL_MULTIPLIER

double

1.5

The maximum interval that the controller will wait for before attempting a retry, regardless of all other configuration

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__RETRY_INTERVAL_MAX

long

An optional list of comma-separated label selectors that Custom Resources must match to trigger the controller. See …​ for more details on selectors.

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__SELECTOR

string

An optional Duration to specify the maximum time that is allowed to elapse before a reconciliation will happen regardless of the presence of events. See MaxReconciliationInterval#interval() for more details. Value is specified according to the rules defined at Duration#parse(CharSequence).

Environment variable: QUARKUS_OPERATOR_SDK_CONTROLLERS__CONTROLLERS__MAX_RECONCILIATION_INTERVAL

Duration 

About the Duration format

To write duration values, use the standard java.time.Duration format. See the Duration#parse() Java API documentation for more information.

You can also use a simplified format, starting with a number:

  • If the value is only a number, it represents time in seconds.

  • If the value is a number followed by ms, it represents time in milliseconds.

In other cases, the simplified format is translated to the java.time.Duration format for parsing:

  • If the value is a number followed by h, m, or s, it is prefixed with PT.

  • If the value is a number followed by d, it is prefixed with P.