Package io.quarkus.kubernetes.deployment

Class KubernetesConfig

java.lang.Object

io.quarkus.kubernetes.deployment.KubernetesConfig

All Implemented Interfaces:

EnvVarHolder, PlatformConfiguration

@ConfigRoot
public class KubernetesConfig
extends Object
implements PlatformConfiguration

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	KubernetesConfig.DeploymentResourceKind

Field Summary

Fields

Modifier and Type	Field	Description
(package private) boolean	addBuildTimestamp	Whether to add the build timestamp to the Kubernetes annotations This is a very useful way to have manifests of successive builds of the same application differ - thus ensuring that Kubernetes will apply the updated resources
(package private) boolean	addNameToLabelSelectors	If true, the 'app.kubernetes.io/name' label will be part of the selectors of Service and Deployment
(package private) boolean	addVersionToLabelSelectors	If true, the 'app.kubernetes.io/version' label will be part of the selectors of Service and Deployment
(package private) Map<String,String>	annotations	Custom annotations to add to all resources
(package private) Optional<String>	appConfigMap	If set, the config map will be mounted to the application container and its contents will be used for application configuration.
(package private) Optional<String>	appSecret	If set, the secret will mounted to the application container and its contents will be used for application configuration.
(package private) Optional<List<String>>	arguments	The arguments
(package private) Map<String,AwsElasticBlockStoreVolumeConfig>	awsElasticBlockStoreVolumes	AWS Elastic BlockStore volumes
(package private) Map<String,AzureDiskVolumeConfig>	azureDiskVolumes	Azure disk volumes
(package private) Map<String,AzureFileVolumeConfig>	azureFileVolumes	Azure file volumes
(package private) Optional<List<String>>	command	The commands
(package private) Map<String,ConfigMapVolumeConfig>	configMapVolumes	ConfigMap volumes
(package private) Optional<String>	containerName	If set, it will change the name of the container according to the configuration
(package private) CronJobConfig	cronJob	CronJob configuration.
(package private) boolean	deploy	If set to true, Quarkus will attempt to deploy the application to the target Kubernetes cluster
(package private) Optional<KubernetesConfig.DeploymentResourceKind>	deploymentKind	The kind of the deployment resource to use.
(package private) Optional<List<String>>	deploymentTarget	The target deployment platform.
(package private) DeployStrategy	deployStrategy	If deploy is enabled, it will follow this strategy to update the resources to the target Kubernetes cluster.
(package private) Optional<List<String>>	emptyDirVolumes	EmptyDir volumes
(package private) EnvVarsConfig	env	Environment variables to add to all containers.
(package private) Map<String,EnvConfig>	envVars	Deprecated. Use env instead using the new syntax as follows: quarkus.kubernetes.env-vars.foo.field=fieldName becomes quarkus.kubernetes.env.fields.foo=fieldName quarkus.kubernetes.env-vars.foo.value=value becomes quarkus.kubernetes.env.vars.foo=bar quarkus.kubernetes.env-vars.bar.configmap=configName becomes quarkus.kubernetes.env.configmaps=configName quarkus.kubernetes.env-vars.baz.secret=secretName becomes quarkus.kubernetes.env.secrets=secretName
(package private) boolean	externalizeInit	Deprecated, for removal: This API element is subject to removal in a future version.
(package private) boolean	generateImagePullSecret	Enable generation of image pull secret, when the container image username and password are provided.
(package private) Map<String,GitRepoVolumeConfig>	gitRepoVolumes	Git Repository volumes
(package private) Map<String,HostAliasConfig>	hostAliases	The host aliases
(package private) boolean	idempotent	Switch used to control whether non-idempotent fields are included in generated kubernetes resources to improve git-ops compatibility
(package private) io.dekorate.kubernetes.annotation.ImagePullPolicy	imagePullPolicy	Image pull policy
(package private) Optional<List<String>>	imagePullSecrets	The image pull secret
(package private) IngressConfig	ingress	Ingress configuration
(package private) Map<String,ContainerConfig>	initContainers	Init containers
(package private) InitTaskConfig	initTaskDefaults	Default Init tasks configuration.
(package private) Map<String,InitTaskConfig>	initTasks	Init tasks configuration.
(package private) JobConfig	job	Job configuration.
(package private) Map<String,String>	labels	Custom labels to add to all resources
(package private) ProbeConfig	livenessProbe	The liveness probe
(package private) Map<String,MountConfig>	mounts	Volume mounts
(package private) Optional<String>	name	The name of the application.
(package private) Optional<String>	namespace	The namespace the generated resources should belong to.
(package private) OptionalInt	nodePort	The nodePort to set when serviceType is set to node-port.
(package private) Optional<String>	outputDirectory	Optionally set directory generated kubernetes resources will be written to.
(package private) Optional<String>	partOf	The name of the group this component belongs too
(package private) Map<String,PortConfig>	ports	The application ports
(package private) PrometheusConfig	prometheus	Prometheus configuration
(package private) Map<String,PvcVolumeConfig>	pvcVolumes	Persistent Volume Claim volumes
(package private) RbacConfig	rbac	RBAC configuration
(package private) ProbeConfig	readinessProbe	The readiness probe
(package private) DebugConfig	remoteDebug	Debug configuration to be set in pods.
(package private) Integer	replicas	The number of desired pods
(package private) ResourcesConfig	resources	Resources requirements
(package private) RollingUpdateConfig	rollingUpdate	Specifies rolling update configuration.
(package private) Map<String,SecretVolumeConfig>	secretVolumes	Secret volumes
(package private) SecurityContextConfig	securityContext	If set, it will copy the security context configuration provided into the generated pod settings.
(package private) Optional<String>	serviceAccount	The service account
(package private) io.dekorate.kubernetes.annotation.ServiceType	serviceType	The type of service that will be generated for the application
(package private) Map<String,ContainerConfig>	sidecars	Sidecar containers
(package private) ProbeConfig	startupProbe	The startup probe
(package private) io.dekorate.kubernetes.config.DeploymentStrategy	strategy	Specifies the deployment strategy.
(package private) Optional<String>	version	The version of the application.
(package private) Optional<String>	workingDir	Working directory

Constructor Summary

Constructors

Constructor	Description
KubernetesConfig()

Method Summary

Modifier and Type	Method	Description
Map<String,String>	getAnnotations()
Optional<String>	getAppConfigMap()
Optional<String>	getAppSecret()
Optional<List<String>>	getArguments()
Map<String,AwsElasticBlockStoreVolumeConfig>	getAwsElasticBlockStoreVolumes()
Map<String,AzureDiskVolumeConfig>	getAzureDiskVolumes()
Map<String,AzureFileVolumeConfig>	getAzureFileVolumes()
Optional<List<String>>	getCommand()
Map<String,ConfigMapVolumeConfig>	getConfigMapVolumes()
Optional<String>	getContainerName()
KubernetesConfig.DeploymentResourceKind	getDeploymentResourceKind(io.quarkus.deployment.Capabilities capabilities)
DeployStrategy	getDeployStrategy()
List<String>	getEmptyDirVolumes()
EnvVarsConfig	getEnv()	Retrieves the definition of environment variables to add to the application's container.
Map<String,EnvConfig>	getEnvVars()	Deprecated.
Map<String,GitRepoVolumeConfig>	getGitRepoVolumes()
Map<String,HostAliasConfig>	getHostAliases()
io.dekorate.kubernetes.annotation.ImagePullPolicy	getImagePullPolicy()
Optional<List<String>>	getImagePullSecrets()
Map<String,ContainerConfig>	getInitContainers()
InitTaskConfig	getInitTaskDefaults()
Map<String,InitTaskConfig>	getInitTasks()
Map<String,String>	getLabels()
ProbeConfig	getLivenessProbe()
Map<String,MountConfig>	getMounts()
Optional<String>	getName()
Optional<String>	getNamespace()
OptionalInt	getNodePort()
Optional<String>	getPartOf()
Map<String,PortConfig>	getPorts()
PrometheusConfig	getPrometheusConfig()
Map<String,PvcVolumeConfig>	getPvcVolumes()
RbacConfig	getRbacConfig()
ProbeConfig	getReadinessProbe()
Integer	getReplicas()
ResourcesConfig	getResources()
Map<String,SecretVolumeConfig>	getSecretVolumes()
SecurityContextConfig	getSecurityContext()
Optional<String>	getServiceAccount()
io.dekorate.kubernetes.annotation.ServiceType	getServiceType()
Map<String,ContainerConfig>	getSidecars()
ProbeConfig	getStartupProbe()
String	getTargetPlatformName()	Specifies which the name of the platform this EnvVarHolder targets.
Optional<String>	getVersion()
Optional<String>	getWorkingDir()
boolean	isAddBuildTimestamp()
boolean	isAddNameToLabelSelectors()
boolean	isAddVersionToLabelSelectors()
boolean	isExternalizeInit()
boolean	isGenerateImagePullSecret()
boolean	isIdempotent()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.quarkus.kubernetes.deployment.EnvVarHolder

convertToBuildItems

Methods inherited from interface io.quarkus.kubernetes.deployment.PlatformConfiguration

getConfigName

Field Details

partOf

@ConfigItem
Optional<String> partOf

The name of the group this component belongs too

name

@ConfigItem
Optional<String> name

The name of the application. This value will be used for naming Kubernetes resources like: - Deployment - Service and so on ...

version

@ConfigItem
Optional<String> version

The version of the application.

deploymentKind

@ConfigItem
Optional<KubernetesConfig.DeploymentResourceKind> deploymentKind

The kind of the deployment resource to use. Supported values are 'StatefulSet', 'Job', 'CronJob' and 'Deployment' defaulting to the latter.

namespace

@ConfigItem
Optional<String> namespace

The namespace the generated resources should belong to. If not value is set, then the 'namespace' field will not be added to the 'metadata' section of the generated manifests. This in turn means that when the manifests are applied to a cluster, the namespace will be resolved from the current Kubernetes context (see https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context for more details).

labels

@ConfigItem
Map<String,String> labels

Custom labels to add to all resources

annotations

@ConfigItem
Map<String,String> annotations

Custom annotations to add to all resources

addBuildTimestamp

@ConfigItem(defaultValue="true")
boolean addBuildTimestamp

Whether to add the build timestamp to the Kubernetes annotations This is a very useful way to have manifests of successive builds of the same application differ - thus ensuring that Kubernetes will apply the updated resources

workingDir

@ConfigItem
Optional<String> workingDir

Working directory

command

@ConfigItem
Optional<List<String>> command

The commands

arguments

@ConfigItem
Optional<List<String>> arguments

The arguments

serviceAccount

@ConfigItem
Optional<String> serviceAccount

The service account

ports

@ConfigItem
Map<String,PortConfig> ports

The application ports

replicas

@ConfigItem(defaultValue="1")
Integer replicas

The number of desired pods

strategy

@ConfigItem(defaultValue="None")
io.dekorate.kubernetes.config.DeploymentStrategy strategy

Specifies the deployment strategy.

rollingUpdate

@ConfigItem
RollingUpdateConfig rollingUpdate

Specifies rolling update configuration. The configuration is applied when DeploymentStrategy == RollingUpdate, or when explicit configuration has been provided. In the later case RollingUpdate is assumed.

serviceType

@ConfigItem(defaultValue="ClusterIP")
io.dekorate.kubernetes.annotation.ServiceType serviceType

The type of service that will be generated for the application

nodePort

@ConfigItem
OptionalInt nodePort

The nodePort to set when serviceType is set to node-port.

imagePullPolicy

@ConfigItem(defaultValue="Always")
io.dekorate.kubernetes.annotation.ImagePullPolicy imagePullPolicy

Image pull policy

imagePullSecrets

@ConfigItem
Optional<List<String>> imagePullSecrets

The image pull secret

generateImagePullSecret

@ConfigItem(defaultValue="false")
boolean generateImagePullSecret

Enable generation of image pull secret, when the container image username and password are provided.

livenessProbe

@ConfigItem
ProbeConfig livenessProbe

The liveness probe

readinessProbe

@ConfigItem
ProbeConfig readinessProbe

The readiness probe

startupProbe

@ConfigItem
ProbeConfig startupProbe

The startup probe

prometheus

@ConfigItem
PrometheusConfig prometheus

Prometheus configuration

mounts

@ConfigItem
Map<String,MountConfig> mounts

Volume mounts

secretVolumes

@ConfigItem
Map<String,SecretVolumeConfig> secretVolumes

Secret volumes

configMapVolumes

@ConfigItem
Map<String,ConfigMapVolumeConfig> configMapVolumes

ConfigMap volumes

emptyDirVolumes

@ConfigItem
Optional<List<String>> emptyDirVolumes

EmptyDir volumes

gitRepoVolumes

@ConfigItem
Map<String,GitRepoVolumeConfig> gitRepoVolumes

Git Repository volumes

pvcVolumes

@ConfigItem
Map<String,PvcVolumeConfig> pvcVolumes

Persistent Volume Claim volumes

awsElasticBlockStoreVolumes

@ConfigItem
Map<String,AwsElasticBlockStoreVolumeConfig> awsElasticBlockStoreVolumes

AWS Elastic BlockStore volumes

azureFileVolumes

@ConfigItem
Map<String,AzureFileVolumeConfig> azureFileVolumes

Azure file volumes

azureDiskVolumes

@ConfigItem
Map<String,AzureDiskVolumeConfig> azureDiskVolumes

Azure disk volumes

initContainers

@ConfigItem
Map<String,ContainerConfig> initContainers

Init containers

sidecars

@ConfigItem
Map<String,ContainerConfig> sidecars

Sidecar containers

deploymentTarget

@ConfigItem
Optional<List<String>> deploymentTarget

The target deployment platform. Defaults to kubernetes. Can be kubernetes, openshift, knative, minikube etc., or any combination of the above as comma separated list.

hostAliases

@ConfigItem(name="hostaliases")
Map<String,HostAliasConfig> hostAliases

The host aliases

resources

@ConfigItem
ResourcesConfig resources

Resources requirements

rbac

RbacConfig rbac

RBAC configuration

ingress

IngressConfig ingress

Ingress configuration

job

JobConfig job

Job configuration. It's only used if and only if quarkus.kubernetes.deployment-kind is `Job`.

cronJob

CronJobConfig cronJob

CronJob configuration. It's only used if and only if quarkus.kubernetes.deployment-kind is `CronJob`.

addVersionToLabelSelectors

@ConfigItem(defaultValue="true")
boolean addVersionToLabelSelectors

If true, the 'app.kubernetes.io/version' label will be part of the selectors of Service and Deployment

addNameToLabelSelectors

@ConfigItem(defaultValue="true")
boolean addNameToLabelSelectors

If true, the 'app.kubernetes.io/name' label will be part of the selectors of Service and Deployment

deploy

@ConfigItem(defaultValue="false")
boolean deploy

If set to true, Quarkus will attempt to deploy the application to the target Kubernetes cluster

deployStrategy

@ConfigItem(defaultValue="CreateOrUpdate")
DeployStrategy deployStrategy

If deploy is enabled, it will follow this strategy to update the resources to the target Kubernetes cluster.

appSecret

@ConfigItem
Optional<String> appSecret

If set, the secret will mounted to the application container and its contents will be used for application configuration.

appConfigMap

@ConfigItem
Optional<String> appConfigMap

If set, the config map will be mounted to the application container and its contents will be used for application configuration.

securityContext

@ConfigItem
SecurityContextConfig securityContext

If set, it will copy the security context configuration provided into the generated pod settings.

containerName

@ConfigItem
Optional<String> containerName

If set, it will change the name of the container according to the configuration

remoteDebug

DebugConfig remoteDebug

Debug configuration to be set in pods.

externalizeInit

@Deprecated(since="3.1",
            forRemoval=true)
@ConfigItem(defaultValue="true")
boolean externalizeInit

Deprecated, for removal: This API element is subject to removal in a future version.

Flag to enable init task externalization. When enabled (default), all initialization tasks created by extensions, will be externalized as Jobs. In addition, the deployment will wait for these jobs.

initTasks

@ConfigItem
Map<String,InitTaskConfig> initTasks

Init tasks configuration. The init tasks are automatically generated by extensions like Flyway to perform the database migration before staring up the application. This property is only taken into account if `quarkus.kubernetes.externalize-init` is true.

initTaskDefaults

@ConfigItem
InitTaskConfig initTaskDefaults

Default Init tasks configuration. The init tasks are automatically generated by extensions like Flyway to perform the database migration before staring up the application.

idempotent

@ConfigItem(defaultValue="false")
boolean idempotent

Switch used to control whether non-idempotent fields are included in generated kubernetes resources to improve git-ops compatibility

outputDirectory

@ConfigItem
Optional<String> outputDirectory

Optionally set directory generated kubernetes resources will be written to. Default is `target/kubernetes`.

envVars

@ConfigItem
@Deprecated
Map<String,EnvConfig> envVars

Deprecated.

Use env instead using the new syntax as follows:

• quarkus.kubernetes.env-vars.foo.field=fieldName becomes quarkus.kubernetes.env.fields.foo=fieldName
• quarkus.kubernetes.env-vars.foo.value=value becomes quarkus.kubernetes.env.vars.foo=bar
• quarkus.kubernetes.env-vars.bar.configmap=configName becomes quarkus.kubernetes.env.configmaps=configName
• quarkus.kubernetes.env-vars.baz.secret=secretName becomes quarkus.kubernetes.env.secrets=secretName

Environment variables to add to all containers using the old syntax.

env

@ConfigItem
EnvVarsConfig env

Environment variables to add to all containers.

Constructor Details

KubernetesConfig

public KubernetesConfig()

Method Details

getPartOf

public Optional<String> getPartOf()

Specified by:

getPartOf in interface PlatformConfiguration

getName

public Optional<String> getName()

Specified by:

getName in interface PlatformConfiguration

getVersion

public Optional<String> getVersion()

Specified by:

getVersion in interface PlatformConfiguration

getNamespace

public Optional<String> getNamespace()

Specified by:

getNamespace in interface PlatformConfiguration

getLabels

public Map<String,String> getLabels()

Specified by:

getLabels in interface PlatformConfiguration

getAnnotations

public Map<String,String> getAnnotations()

Specified by:

getAnnotations in interface PlatformConfiguration

isAddBuildTimestamp

public boolean isAddBuildTimestamp()

Specified by:

isAddBuildTimestamp in interface PlatformConfiguration

isAddNameToLabelSelectors

public boolean isAddNameToLabelSelectors()

Specified by:

isAddNameToLabelSelectors in interface PlatformConfiguration

isAddVersionToLabelSelectors

public boolean isAddVersionToLabelSelectors()

Specified by:

isAddVersionToLabelSelectors in interface PlatformConfiguration

getTargetPlatformName

public String getTargetPlatformName()

Description copied from interface: EnvVarHolder

Specifies which the name of the platform this EnvVarHolder targets. This name, when needed, is used by dekorate to generate the descriptor associated with the targeted deployment platform.

Specified by:

getTargetPlatformName in interface EnvVarHolder

Returns:

the name of the targeted platform e.g. Constants.KUBERNETES

getEnvVars

@Deprecated
public Map<String,EnvConfig> getEnvVars()

Deprecated.

Specified by:

getEnvVars in interface EnvVarHolder

getEnv

public EnvVarsConfig getEnv()

Description copied from interface: EnvVarHolder

Retrieves the definition of environment variables to add to the application's container.

Specified by:

getEnv in interface EnvVarHolder

Returns:

the associated EnvVarsConfig holding the definition of which environment variables to add

getWorkingDir

public Optional<String> getWorkingDir()

Specified by:

getWorkingDir in interface PlatformConfiguration

getCommand

public Optional<List<String>> getCommand()

Specified by:

getCommand in interface PlatformConfiguration

getArguments

public Optional<List<String>> getArguments()

Specified by:

getArguments in interface PlatformConfiguration

getServiceAccount

public Optional<String> getServiceAccount()

Specified by:

getServiceAccount in interface PlatformConfiguration

getContainerName

public Optional<String> getContainerName()

Specified by:

getContainerName in interface PlatformConfiguration

getPorts

public Map<String,PortConfig> getPorts()

Specified by:

getPorts in interface PlatformConfiguration

getReplicas

public Integer getReplicas()

getServiceType

public io.dekorate.kubernetes.annotation.ServiceType getServiceType()

Specified by:

getServiceType in interface PlatformConfiguration

getNodePort

public OptionalInt getNodePort()

getImagePullPolicy

public io.dekorate.kubernetes.annotation.ImagePullPolicy getImagePullPolicy()

Specified by:

getImagePullPolicy in interface PlatformConfiguration

getImagePullSecrets

public Optional<List<String>> getImagePullSecrets()

Specified by:

getImagePullSecrets in interface PlatformConfiguration

isGenerateImagePullSecret

public boolean isGenerateImagePullSecret()

Specified by:

isGenerateImagePullSecret in interface PlatformConfiguration

getLivenessProbe

public ProbeConfig getLivenessProbe()

Specified by:

getLivenessProbe in interface PlatformConfiguration

getReadinessProbe

public ProbeConfig getReadinessProbe()

Specified by:

getReadinessProbe in interface PlatformConfiguration

getStartupProbe

public ProbeConfig getStartupProbe()

Specified by:

getStartupProbe in interface PlatformConfiguration

getPrometheusConfig

public PrometheusConfig getPrometheusConfig()

Specified by:

getPrometheusConfig in interface PlatformConfiguration

getMounts

public Map<String,MountConfig> getMounts()

Specified by:

getMounts in interface PlatformConfiguration

getSecretVolumes

public Map<String,SecretVolumeConfig> getSecretVolumes()

Specified by:

getSecretVolumes in interface PlatformConfiguration

getConfigMapVolumes

public Map<String,ConfigMapVolumeConfig> getConfigMapVolumes()

Specified by:

getConfigMapVolumes in interface PlatformConfiguration

getEmptyDirVolumes

public List<String> getEmptyDirVolumes()

Specified by:

getEmptyDirVolumes in interface PlatformConfiguration

getGitRepoVolumes

public Map<String,GitRepoVolumeConfig> getGitRepoVolumes()

Specified by:

getGitRepoVolumes in interface PlatformConfiguration

getPvcVolumes

public Map<String,PvcVolumeConfig> getPvcVolumes()

Specified by:

getPvcVolumes in interface PlatformConfiguration

getAwsElasticBlockStoreVolumes

public Map<String,AwsElasticBlockStoreVolumeConfig> getAwsElasticBlockStoreVolumes()

Specified by:

getAwsElasticBlockStoreVolumes in interface PlatformConfiguration

getAzureFileVolumes

public Map<String,AzureFileVolumeConfig> getAzureFileVolumes()

Specified by:

getAzureFileVolumes in interface PlatformConfiguration

getAzureDiskVolumes

public Map<String,AzureDiskVolumeConfig> getAzureDiskVolumes()

Specified by:

getAzureDiskVolumes in interface PlatformConfiguration

getInitContainers

public Map<String,ContainerConfig> getInitContainers()

Specified by:

getInitContainers in interface PlatformConfiguration

getSidecars

public Map<String,ContainerConfig> getSidecars()

Specified by:

getSidecars in interface PlatformConfiguration

getHostAliases

public Map<String,HostAliasConfig> getHostAliases()

Specified by:

getHostAliases in interface PlatformConfiguration

getResources

public ResourcesConfig getResources()

Specified by:

getResources in interface PlatformConfiguration

getAppSecret

public Optional<String> getAppSecret()

Specified by:

getAppSecret in interface PlatformConfiguration

getAppConfigMap

public Optional<String> getAppConfigMap()

Specified by:

getAppConfigMap in interface PlatformConfiguration

getSecurityContext

public SecurityContextConfig getSecurityContext()

Specified by:

getSecurityContext in interface PlatformConfiguration

isIdempotent

public boolean isIdempotent()

Specified by:

isIdempotent in interface PlatformConfiguration

getDeployStrategy

public DeployStrategy getDeployStrategy()

getRbacConfig

public RbacConfig getRbacConfig()

Specified by:

getRbacConfig in interface PlatformConfiguration

getDeploymentResourceKind

public KubernetesConfig.DeploymentResourceKind getDeploymentResourceKind(io.quarkus.deployment.Capabilities capabilities)

isExternalizeInit

public boolean isExternalizeInit()

getInitTasks

public Map<String,InitTaskConfig> getInitTasks()

getInitTaskDefaults

public InitTaskConfig getInitTaskDefaults()