Class AbstractLocalEmulatorRuntime

java.lang.Object

com.cloudforge.core.local.AbstractLocalEmulatorRuntime

All Implemented Interfaces:

LocalEmulatorRuntime

Direct Known Subclasses:

LocalStackEmulatorRuntime, MiniStackEmulatorRuntime

public abstract class AbstractLocalEmulatorRuntime
extends Object
implements LocalEmulatorRuntime

Shared Docker lifecycle for CloudForge local emulators.

Target modules supply dockerCreateArgs() only; container names, health URLs, and conflict handling come from LocalEmulatorSpec in core.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractLocalEmulatorRuntime(LocalEmulatorSpec spec)

Method Summary

Modifier and Type	Method	Description
protected final List<String>	baseDockerCreateArgs()
Optional<String>	conflictingContainerName()	Optional container that must be stopped first because it binds the same gateway port.
String	containerName()	Stable Docker container name (for example cfc-ministack).
protected abstract List<String>	dockerCreateArgs()	Arguments after docker run -d when the container does not yet exist.
URI	healthEndpoint()	Gateway health URL on the host (for example http://localhost:4566/_ministack/health).
boolean	isHealthy()	Whether the gateway health endpoint returns HTTP 2xx.
boolean	isRunning()	Whether the named container is in the running state.
protected void	onStarted()
protected LocalEmulatorSpec	spec()
void	start()	Start the emulator container and wait until LocalEmulatorRuntime.isHealthy().
void	stop()	Stop the emulator container if it is running.
DeploymentTarget	target()	Deployment target this runtime serves.

Methods inherited from class Object

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

Methods inherited from interface LocalEmulatorRuntime

restart

Constructor Details

AbstractLocalEmulatorRuntime

protected AbstractLocalEmulatorRuntime(LocalEmulatorSpec spec)

Method Details

spec

protected LocalEmulatorSpec spec()

dockerCreateArgs

protected abstract List<String> dockerCreateArgs()
                                          throws IOException

Arguments after docker run -d when the container does not yet exist.

Throws:

IOException

target

public DeploymentTarget target()

Description copied from interface: LocalEmulatorRuntime

Deployment target this runtime serves.

Specified by:

target in interface LocalEmulatorRuntime

containerName

public String containerName()

Description copied from interface: LocalEmulatorRuntime

Stable Docker container name (for example cfc-ministack).

Specified by:

containerName in interface LocalEmulatorRuntime

conflictingContainerName

public Optional<String> conflictingContainerName()

Description copied from interface: LocalEmulatorRuntime

Optional container that must be stopped first because it binds the same gateway port.

Specified by:

conflictingContainerName in interface LocalEmulatorRuntime

healthEndpoint

public URI healthEndpoint()

Description copied from interface: LocalEmulatorRuntime

Gateway health URL on the host (for example http://localhost:4566/_ministack/health).

Specified by:

healthEndpoint in interface LocalEmulatorRuntime

start

public void start()
           throws IOException

Description copied from interface: LocalEmulatorRuntime

Start the emulator container and wait until LocalEmulatorRuntime.isHealthy().

Specified by:

start in interface LocalEmulatorRuntime

Throws:

IOException

stop

public void stop()
          throws IOException

Description copied from interface: LocalEmulatorRuntime

Stop the emulator container if it is running.

Specified by:

stop in interface LocalEmulatorRuntime

Throws:

IOException

isRunning

public boolean isRunning()
                  throws IOException

Description copied from interface: LocalEmulatorRuntime

Whether the named container is in the running state.

Specified by:

isRunning in interface LocalEmulatorRuntime

Throws:

IOException

isHealthy

public boolean isHealthy()

Description copied from interface: LocalEmulatorRuntime

Whether the gateway health endpoint returns HTTP 2xx.

Specified by:

isHealthy in interface LocalEmulatorRuntime

onStarted

protected void onStarted()
                  throws IOException

Throws:

IOException

baseDockerCreateArgs

protected final List<String> baseDockerCreateArgs()