Package dasniko.testcontainers.keycloak

Class ExtendableKeycloakContainer<SELF extends ExtendableKeycloakContainer<SELF>>

java.lang.Object

org.testcontainers.containers.FailureDetectingExternalResource

org.testcontainers.containers.GenericContainer<SELF>

dasniko.testcontainers.keycloak.ExtendableKeycloakContainer<SELF>

All Implemented Interfaces:

AutoCloseable, org.junit.rules.TestRule, org.testcontainers.containers.Container<SELF>, org.testcontainers.containers.ContainerState, org.testcontainers.containers.traits.LinkableContainer, org.testcontainers.containers.wait.strategy.WaitStrategyTarget, org.testcontainers.lifecycle.Startable

Direct Known Subclasses:

KeycloakContainer

public abstract class ExtendableKeycloakContainer<SELF extends ExtendableKeycloakContainer<SELF>>
extends org.testcontainers.containers.GenericContainer<SELF>

Author:

Niko Köbler, https://www.n-k.de, @dasniko

Nested Class Summary

Nested classes/interfaces inherited from interface org.testcontainers.containers.Container

org.testcontainers.containers.Container.ExecResult

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ADMIN_CLI_CLIENT
static final String	MASTER_REALM

Fields inherited from class org.testcontainers.containers.GenericContainer

CONTAINER_RUNNING_TIMEOUT_SEC, dependencies, dockerClient, INTERNAL_HOST_HOSTNAME, waitStrategy

Fields inherited from interface org.testcontainers.containers.ContainerState

STATE_HEALTHY

Constructor Summary

Constructors

Constructor	Description
ExtendableKeycloakContainer()	Create a KeycloakContainer with default image and version tag
ExtendableKeycloakContainer(String dockerImageName)	Create a KeycloakContainer by passing the full docker image name

Method Summary

Modifier and Type	Method	Description
protected void	configure()
protected void	createKeycloakExtensionDeployment(String deploymentLocation, String extensionName, String extensionClassFolder)	Maps the provided extensionClassFolder as an exploded extension.jar to the deploymentLocation.
void	createKeycloakExtensionProvider(String extensionClassFolder)	Maps the provided extensionClassFolder as an exploded providers.jar to the Keycloak providers folder.
String	getAdminPassword()
String	getAdminUsername()
String	getAuthServerUrl()
String	getContextPath()
int	getDebugPort()	Get the mapped port for remote debugging.
int	getHttpPort()
int	getHttpsPort()
org.keycloak.admin.client.Keycloak	getKeycloakAdminClient()
String	getKeycloakDefaultVersion()
Duration	getStartupTimeout()
protected String	resolveExtensionClassLocation(String extensionClassFolder)
SELF	useMutualTls(String tlsTruststoreFilename, String tlsTruststorePassword, HttpsClientAuth httpsClientAuth)
SELF	useTls()
SELF	useTls(String tlsCertificateFilename, String tlsCertificateKeyFilename)
SELF	useTlsKeystore(String tlsKeystoreFilename, String tlsKeystorePassword)
SELF	withAdminPassword(String adminPassword)
SELF	withAdminUsername(String adminUsername)
SELF	withCommand(String cmd)
SELF	withCommand(String... commandParts)
SELF	withContextPath(String contextPath)
SELF	withDebug()	Enable remote debugging in Keycloak and expose it on a random port.
SELF	withDebugFixedPort(int hostPort, boolean suspend)	Enable remote debugging in Keycloak and expose it on a fixed port.
SELF	withDefaultProviderClasses()	Exposes the default classes location target/classes as an exploded providers.jar.
SELF	withDisabledCaching()
SELF	withEnabledMetrics()
SELF	withFeaturesDisabled(String... features)
SELF	withFeaturesEnabled(String... features)
SELF	withProviderClassesFrom(String classesLocation)	Exposes the given classes location as an exploded providers.jar.
SELF	withProviderLibsFrom(List<File> libs)
SELF	withRamPercentage(int initialRamPercentage, int maxRamPercentage)
SELF	withRealmImportFile(String importFile)
SELF	withRealmImportFiles(String... files)
SELF	withStartupTimeout(Duration startupTimeout)
SELF	withVerboseOutput()

Methods inherited from class org.testcontainers.containers.GenericContainer

addEnv, addExposedPort, addExposedPorts, addFileSystemBind, addFixedExposedPort, addFixedExposedPort, addLink, apply, canBeReused, containerIsCreated, containerIsStarted, containerIsStarted, containerIsStarting, containerIsStarting, containerIsStopped, containerIsStopping, copyFileFromContainer, createVolumeDirectory, dependsOn, dependsOn, dependsOn, doStart, equals, failed, finished, getBinds, getCommandParts, getContainerId, getContainerInfo, getContainerName, getCopyToFileContainerPathMap, getCreateContainerCmdModifiers, getDependencies, getDockerClient, getDockerImageName, getEnv, getEnvMap, getExposedPorts, getExtraHosts, getImage, getIpAddress, getLabels, getLinkedContainers, getLivenessCheckPort, getLivenessCheckPortNumbers, getLivenessCheckPorts, getLogConsumers, getNetwork, getNetworkAliases, getNetworkMode, getPortBindings, getShmSize, getStartupAttempts, getStartupCheckStrategy, getTestHostIpAddress, getTmpFsMapping, getVolumesFroms, getWaitStrategy, getWorkingDirectory, hashCode, isHostAccessible, isPrivilegedMode, isShouldBeReused, logger, setBinds, setCommand, setCommand, setCommandParts, setContainerDef, setCopyToFileContainerPathMap, setDockerImageName, setEnv, setExposedPorts, setExtraHosts, setHostAccessible, setImage, setLabels, setLinkedContainers, setLogConsumers, setNetwork, setNetworkAliases, setNetworkMode, setPortBindings, setPrivilegedMode, setShmSize, setStartupAttempts, setStartupCheckStrategy, setTmpFsMapping, setVolumesFroms, setWaitStrategy, setWorkingDirectory, start, starting, stop, succeeded, toString, waitingFor, waitUntilContainerStarted, withAccessToHost, withClasspathResourceMapping, withClasspathResourceMapping, withCopyFileToContainer, withCopyToContainer, withCreateContainerCmdModifier, withEnv, withEnv, withExposedPorts, withExtraHost, withFileSystemBind, withImagePullPolicy, withLabel, withLabels, withLogConsumer, withMinimumRunningDuration, withNetwork, withNetworkAliases, withNetworkMode, withPrivilegedMode, withReuse, withSharedMemorySize, withStartupAttempts, withStartupCheckStrategy, withTmpFs, withVolumesFrom, withWorkingDirectory

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.testcontainers.containers.Container

addFileSystemBind, followOutput, followOutput, self, withEnv, withFileSystemBind

Methods inherited from interface org.testcontainers.containers.ContainerState

copyFileFromContainer, copyFileToContainer, copyFileToContainer, execInContainer, execInContainer, execInContainer, execInContainer, execInContainerWithUser, execInContainerWithUser, getBoundPortNumbers, getContainerIpAddress, getCurrentContainerInfo, getFirstMappedPort, getHost, getLogs, getLogs, getMappedPort, isCreated, isHealthy, isRunning

Methods inherited from interface org.testcontainers.lifecycle.Startable

close

Field Details

MASTER_REALM

public static final String MASTER_REALM

See Also:

• Constant Field Values

ADMIN_CLI_CLIENT

public static final String ADMIN_CLI_CLIENT

See Also:

• Constant Field Values

Constructor Details

ExtendableKeycloakContainer

public ExtendableKeycloakContainer()

Create a KeycloakContainer with default image and version tag

ExtendableKeycloakContainer

public ExtendableKeycloakContainer(String dockerImageName)

Create a KeycloakContainer by passing the full docker image name

Parameters:

dockerImageName - Full docker image name, e.g. quay.io/keycloak/keycloak:24.0

Method Details

configure

protected void configure()

Overrides:

configure in class org.testcontainers.containers.GenericContainer<SELF extends ExtendableKeycloakContainer<SELF>>

withCommand

public SELF withCommand(String cmd)

Specified by:

withCommand in interface org.testcontainers.containers.Container<SELF extends ExtendableKeycloakContainer<SELF>>

Overrides:

withCommand in class org.testcontainers.containers.GenericContainer<SELF extends ExtendableKeycloakContainer<SELF>>

withCommand

public SELF withCommand(String... commandParts)

Specified by:

withCommand in interface org.testcontainers.containers.Container<SELF extends ExtendableKeycloakContainer<SELF>>

Overrides:

withCommand in class org.testcontainers.containers.GenericContainer<SELF extends ExtendableKeycloakContainer<SELF>>

createKeycloakExtensionProvider

public void createKeycloakExtensionProvider(String extensionClassFolder)

Maps the provided extensionClassFolder as an exploded providers.jar to the Keycloak providers folder.

Parameters:

extensionClassFolder - a path relative to the current classpath root.

createKeycloakExtensionDeployment

protected void createKeycloakExtensionDeployment(String deploymentLocation,
 String extensionName,
 String extensionClassFolder)

Maps the provided extensionClassFolder as an exploded extension.jar to the deploymentLocation.

Parameters:

deploymentLocation - the target deployments location of the Keycloak server.

extensionName - the name suffix of the created extension.

extensionClassFolder - a path relative to the current classpath root.

resolveExtensionClassLocation

protected String resolveExtensionClassLocation(String extensionClassFolder)

withRealmImportFile

public SELF withRealmImportFile(String importFile)

withRealmImportFiles

public SELF withRealmImportFiles(String... files)

withAdminUsername

public SELF withAdminUsername(String adminUsername)

withAdminPassword

public SELF withAdminPassword(String adminPassword)

withContextPath

public SELF withContextPath(String contextPath)

withRamPercentage

public SELF withRamPercentage(int initialRamPercentage,
 int maxRamPercentage)

withProviderClassesFrom

public SELF withProviderClassesFrom(String classesLocation)

Exposes the given classes location as an exploded providers.jar.

Parameters:

classesLocation - a classes location relative to the current classpath root.

withDefaultProviderClasses

public SELF withDefaultProviderClasses()

Exposes the default classes location target/classes as an exploded providers.jar.

withProviderLibsFrom

public SELF withProviderLibsFrom(List<File> libs)

withStartupTimeout

public SELF withStartupTimeout(Duration startupTimeout)

Specified by:

withStartupTimeout in interface org.testcontainers.containers.Container<SELF extends ExtendableKeycloakContainer<SELF>>

Overrides:

withStartupTimeout in class org.testcontainers.containers.GenericContainer<SELF extends ExtendableKeycloakContainer<SELF>>

useTls

public SELF useTls()

useTls

public SELF useTls(String tlsCertificateFilename,
 String tlsCertificateKeyFilename)

useTlsKeystore

public SELF useTlsKeystore(String tlsKeystoreFilename,
 String tlsKeystorePassword)

useMutualTls

public SELF useMutualTls(String tlsTruststoreFilename,
 String tlsTruststorePassword,
 HttpsClientAuth httpsClientAuth)

withVerboseOutput

public SELF withVerboseOutput()

withFeaturesEnabled

public SELF withFeaturesEnabled(String... features)

withFeaturesDisabled

public SELF withFeaturesDisabled(String... features)

withDisabledCaching

public SELF withDisabledCaching()

withEnabledMetrics

public SELF withEnabledMetrics()

withDebug

public SELF withDebug()

Enable remote debugging in Keycloak and expose it on a random port.

withDebugFixedPort

public SELF withDebugFixedPort(int hostPort,
 boolean suspend)

Enable remote debugging in Keycloak and expose it on a fixed port.

Parameters:

hostPort - The port on the host machine

suspend - Control if Keycloak should wait until a debugger is attached

getKeycloakAdminClient

public org.keycloak.admin.client.Keycloak getKeycloakAdminClient()

getAuthServerUrl

public String getAuthServerUrl()

getAdminUsername

public String getAdminUsername()

getAdminPassword

public String getAdminPassword()

getHttpPort

public int getHttpPort()

getHttpsPort

public int getHttpsPort()

getDebugPort

public int getDebugPort()

Get the mapped port for remote debugging. Should only be used if debugging has been enabled.

Returns:

the mapped port or -1 if debugging has not been configured

See Also:

• withDebug()
• withDebugFixedPort(int, boolean)

getContextPath

public String getContextPath()

getStartupTimeout

public Duration getStartupTimeout()

getKeycloakDefaultVersion

public String getKeycloakDefaultVersion()