org.testcontainers.utility

Class ResourceReaper

java.lang.Object

org.testcontainers.utility.ResourceReaper

public final class ResourceReaper
extends java.lang.Object

Component that responsible for container removal and automatic cleanup of dead containers at JVM shutdown.

Method Summary

Modifier and Type	Method and Description
static ResourceReaper	instance()
void	performCleanup() Perform a cleanup.
void	registerContainerForCleanup(java.lang.String containerId, java.lang.String imageName) Register a container to be cleaned up, either on explicit call to stopAndRemoveContainer, or at JVM shutdown.
void	registerFilterForCleanup(java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> filter) Register a filter to be cleaned up.
void	registerImageForCleanup(java.lang.String dockerImageName)
void	registerNetworkForCleanup(java.lang.String networkName) Deprecated. see registerNetworkIdForCleanup(String)
void	registerNetworkIdForCleanup(java.lang.String id) Register a network to be cleaned up at JVM shutdown.
void	removeNetworkById(java.lang.String id) Removes a network by ID.
void	removeNetworks(java.lang.String identifier) Deprecated. see removeNetworkById(String)
static java.lang.String	start(java.lang.String hostIpAddress, com.github.dockerjava.api.DockerClient client)
static java.lang.String	start(java.lang.String hostIpAddress, com.github.dockerjava.api.DockerClient client, boolean withDummyMount) Deprecated.
void	stopAndRemoveContainer(java.lang.String containerId) Stop a potentially running container and remove it, including associated volumes.
void	stopAndRemoveContainer(java.lang.String containerId, java.lang.String imageName) Stop a potentially running container and remove it, including associated volumes.
void	unregisterContainer(java.lang.String identifier)
void	unregisterNetwork(java.lang.String identifier)

Methods inherited from class java.lang.Object

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

Method Detail

start

@Deprecated
public static java.lang.String start(java.lang.String hostIpAddress,
                                                 com.github.dockerjava.api.DockerClient client,
                                                 boolean withDummyMount)

Deprecated.

start

public static java.lang.String start(java.lang.String hostIpAddress,
                                     com.github.dockerjava.api.DockerClient client)

instance

public static ResourceReaper instance()

performCleanup

public void performCleanup()

Perform a cleanup.

registerFilterForCleanup

public void registerFilterForCleanup(java.util.List<java.util.Map.Entry<java.lang.String,java.lang.String>> filter)

Register a filter to be cleaned up.

Parameters:

filter - the filter

registerContainerForCleanup

public void registerContainerForCleanup(java.lang.String containerId,
                                        java.lang.String imageName)

Register a container to be cleaned up, either on explicit call to stopAndRemoveContainer, or at JVM shutdown.

Parameters:

containerId - the ID of the container

imageName - the image name of the container (used for logging)

stopAndRemoveContainer

public void stopAndRemoveContainer(java.lang.String containerId)

Stop a potentially running container and remove it, including associated volumes.

Parameters:

containerId - the ID of the container

stopAndRemoveContainer

public void stopAndRemoveContainer(java.lang.String containerId,
                                   java.lang.String imageName)

Stop a potentially running container and remove it, including associated volumes.

Parameters:

containerId - the ID of the container

imageName - the image name of the container (used for logging)

registerNetworkIdForCleanup

public void registerNetworkIdForCleanup(java.lang.String id)

Register a network to be cleaned up at JVM shutdown.

Parameters:

id - the ID of the network

registerNetworkForCleanup

@Deprecated
public void registerNetworkForCleanup(java.lang.String networkName)

Deprecated. see registerNetworkIdForCleanup(String)

Parameters:

networkName - the name of the network

removeNetworkById

public void removeNetworkById(java.lang.String id)

Removes a network by ID.

Parameters:

id -

removeNetworks

@Deprecated
public void removeNetworks(java.lang.String identifier)

Deprecated. see removeNetworkById(String)

Removes a network by ID.

Parameters:

identifier -

unregisterNetwork

public void unregisterNetwork(java.lang.String identifier)

unregisterContainer

public void unregisterContainer(java.lang.String identifier)

registerImageForCleanup

public void registerImageForCleanup(java.lang.String dockerImageName)