Package io.github.pod4dev.java

Class KubePlayer

java.lang.Object

io.github.pod4dev.java.KubePlayer

All Implemented Interfaces:

GenericContainer, AutoCloseable

public class KubePlayer
extends Object
implements GenericContainer

Work with /kube/play API.

Constructor Summary

Constructors

Constructor	Description
KubePlayer(String yamlPath)	Creates player with specified path for k8s YAML specification.
KubePlayer(String socketPath, String yamlPath)	Creates player with specified paths for socket file and k8s YAML specification.

Method Summary

Modifier and Type	Method	Description
String	getMappedHost(String serviceName, int exposedPort)	Getting mapped host for the given service's name and exposed port.
int	getMappedPort(String serviceName, int exposedPort)	Getting mapped port for the given service's name and exposed port.
void	start()	Creates the pod or container and immediately starts it.
void	stop()	Stops the pod or container with clearing created volumes.
KubePlayer	withCleanup(boolean doCleanup)	Do resources cleanup after stopping.
KubePlayer	withExposedService(String serviceName, int exposedPort)	Specify service and its port for expose.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.github.pod4dev.java.GenericContainer

close

Constructor Details

KubePlayer

public KubePlayer(String yamlPath)
           throws PodmanException

Creates player with specified path for k8s YAML specification. The socket path is autodetected via PODMAN_SOCKET environment variable.

Parameters:

yamlPath - path to k8s YAML specification.

Throws:

PodmanException - if yamlPath is empty or error during initialization is happened.

KubePlayer

public KubePlayer(String socketPath,
 String yamlPath)
           throws PodmanException

Creates player with specified paths for socket file and k8s YAML specification. The socket path is autodetected via PODMAN_SOCKET environment variable.

Parameters:

socketPath - path to socket file.

yamlPath - path to k8s YAML specification.

Throws:

PodmanException - if yamlPath is empty or error during initialization is happened.

Method Details

withExposedService

public KubePlayer withExposedService(String serviceName,
 int exposedPort)
                              throws PodmanException

Description copied from interface: GenericContainer

Specify service and its port for expose.

Specified by:

withExposedService in interface GenericContainer

Parameters:

serviceName - name of service to expose.

exposedPort - port to expose.

Returns:

container with exposed services.

Throws:

PodmanException

withCleanup

public KubePlayer withCleanup(boolean doCleanup)

Description copied from interface: GenericContainer

Do resources cleanup after stopping.

Specified by:

withCleanup in interface GenericContainer

Parameters:

doCleanup - default if true.

Returns:

customised container.

start

public void start()
           throws PodmanException

Description copied from interface: GenericContainer

Creates the pod or container and immediately starts it. All created resources will be cleared out when a SIGTERM is received or pods exit.

Specified by:

start in interface GenericContainer

Throws:

PodmanException

stop

public void stop()
          throws PodmanException

Description copied from interface: GenericContainer

Stops the pod or container with clearing created volumes.

Specified by:

stop in interface GenericContainer

Throws:

PodmanException

getMappedHost

public String getMappedHost(String serviceName,
 int exposedPort)

Description copied from interface: GenericContainer

Getting mapped host for the given service's name and exposed port.

Specified by:

getMappedHost in interface GenericContainer

Parameters:

serviceName - the service name.

exposedPort - the exposed port.

Returns:

mapped host.

getMappedPort

public int getMappedPort(String serviceName,
 int exposedPort)
                  throws PodmanException

Description copied from interface: GenericContainer

Getting mapped port for the given service's name and exposed port.

Specified by:

getMappedPort in interface GenericContainer

Parameters:

serviceName - the service name.

exposedPort - the exposed port.

Returns:

mapped host.

Throws:

PodmanException