org.testcontainers.vault

Class VaultContainer<SELF extends VaultContainer<SELF>>

java.lang.Object

org.testcontainers.containers.FailureDetectingExternalResource

org.testcontainers.containers.GenericContainer<SELF>

org.testcontainers.vault.VaultContainer<SELF>

All Implemented Interfaces:

java.lang.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

public class VaultContainer<SELF extends VaultContainer<SELF>>
extends org.testcontainers.containers.GenericContainer<SELF>

GenericContainer subclass for Vault specific configuration and features. The main feature is the withSecretInVault method, where users can specify which secrets to be pre-loaded into Vault for their specific test scenario.

Other helpful features include the withVaultPort, and withVaultToken methods for convenience.

Nested Class Summary

Nested classes/interfaces inherited from class org.testcontainers.containers.GenericContainer

org.testcontainers.containers.GenericContainer.AbstractWaitStrategy

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

org.testcontainers.containers.Container.ExecResult

Field Summary

Fields inherited from class org.testcontainers.containers.GenericContainer

CONTAINER_RUNNING_TIMEOUT_SEC, containerId, containerName, dependencies, dockerClient, dockerDaemonInfo, INTERNAL_HOST_HOSTNAME, waitStrategy

Fields inherited from interface org.testcontainers.containers.ContainerState

STATE_HEALTHY

Constructor Summary

Constructors

Constructor and Description
VaultContainer()
VaultContainer(java.lang.String dockerImageName)

Method Summary

Modifier and Type	Method and Description
protected void	containerIsStarted(com.github.dockerjava.api.command.InspectContainerResponse containerInfo)
SELF	withSecretInVault(java.lang.String path, java.lang.String firstSecret, java.lang.String... remainingSecrets) Pre-loads secrets into Vault container.
SELF	withVaultPort(int port) Deprecated. the exposed port will be randomized automatically. As calling this method provides no additional value, you are recommended to remove the call. getFirstMappedPort() may be used to obtain the listening vault port.
SELF	withVaultToken(java.lang.String token) Sets the Vault root token for the container so application tests can source secrets using the token

Methods inherited from class org.testcontainers.containers.GenericContainer

addEnv, addExposedPort, addExposedPorts, addFileSystemBind, addFixedExposedPort, addFixedExposedPort, addLink, apply, canBeReused, configure, containerIsCreated, containerIsStarted, containerIsStarting, containerIsStarting, containerIsStopped, containerIsStopping, copyFileFromContainer, createVolumeDirectory, dependsOn, dependsOn, dependsOn, doStart, equals, failed, fetchDockerDaemonInfo, finished, getBinds, getCommandParts, getContainerId, getContainerInfo, getContainerName, getCopyToFileContainerPathMap, getCreateContainerCmdModifiers, getDependencies, getDockerClient, getDockerDaemonInfo, 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, isPrivilegedMode, isShouldBeReused, logger, setBinds, setCommand, setCommand, setCommandParts, setCopyToFileContainerPathMap, setDockerImageName, setEnv, setExposedPorts, setExtraHosts, setImage, setLabels, setLinkedContainers, setLogConsumers, setNetwork, setNetworkAliases, setNetworkMode, setPortBindings, setPrivilegedMode, setShmSize, setStartupAttempts, setStartupCheckStrategy, setTmpFsMapping, setVolumesFroms, setWaitStrategy, setWorkingDirectory, start, starting, stop, succeeded, toString, waitingFor, waitUntilContainerStarted, withClasspathResourceMapping, withClasspathResourceMapping, withCommand, withCommand, withCopyFileToContainer, withCreateContainerCmdModifier, withEnv, withEnv, withExposedPorts, withExtraHost, withFileSystemBind, withImagePullPolicy, withLabel, withLabels, withLogConsumer, withMinimumRunningDuration, withNetwork, withNetworkAliases, withNetworkMode, withPrivilegedMode, withReuse, withSharedMemorySize, withStartupAttempts, withStartupCheckStrategy, withStartupTimeout, 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, getBoundPortNumbers, getContainerIpAddress, getCurrentContainerInfo, getFirstMappedPort, getHost, getLogs, getLogs, getMappedPort, isCreated, isHealthy, isRunning

Methods inherited from interface org.testcontainers.lifecycle.Startable

close

Constructor Detail

VaultContainer

public VaultContainer()

VaultContainer

public VaultContainer(java.lang.String dockerImageName)

Method Detail

containerIsStarted

protected void containerIsStarted(com.github.dockerjava.api.command.InspectContainerResponse containerInfo)

Overrides:

containerIsStarted in class org.testcontainers.containers.GenericContainer<SELF extends VaultContainer<SELF>>

withVaultToken

public SELF withVaultToken(java.lang.String token)

Sets the Vault root token for the container so application tests can source secrets using the token

Parameters:

token - the root token value to set for Vault.

Returns:

this

withVaultPort

@Deprecated
public SELF withVaultPort(int port)

Deprecated. the exposed port will be randomized automatically. As calling this method provides no additional value, you are recommended to remove the call. getFirstMappedPort() may be used to obtain the listening vault port.

Sets the Vault port in the container as well as the port bindings for the host to reach the container over HTTP.

Parameters:

port - the port number you want to have the Vault container listen on for tests.

Returns:

this

withSecretInVault

public SELF withSecretInVault(java.lang.String path,
                              java.lang.String firstSecret,
                              java.lang.String... remainingSecrets)

Pre-loads secrets into Vault container. User may specify one or more secrets and all will be added to each path that is specified. Thus this can be called more than once for multiple paths to be added to Vault.

The secrets are added to vault directly after the container is up via the addSecrets, called from containerIsStarted

Parameters:

path - specific Vault path to store specified secrets

firstSecret - first secret to add to specifed path

remainingSecrets - var args list of secrets to add to specified path

Returns:

this