Class LocalStackDeployer

java.lang.Object

com.cloudforgeci.localstack.LocalStackDeployer

All Implemented Interfaces:

LocalDeployer, AutoCloseable

public final class LocalStackDeployer
extends Object
implements LocalDeployer

Creates and incrementally updates CloudFormation stacks against LocalStack. All calls use the configured local endpoint; no host AWS CLI or AWS account is used.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	LocalStackDeployer.Change	Deprecated. use LocalResourceChange.
static final record	LocalStackDeployer.DeploymentResult	Deprecated. use LocalDeployResult.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	REPLACE_SAME_APP_ENV	Disable same-app stack replacement when set to false or 0.

Constructor Summary

Constructors

Constructor	Description
LocalStackDeployer()
LocalStackDeployer(String endpoint, String region)	Visible for tests and custom endpoint wiring.

Method Summary

Modifier and Type	Method	Description
void	close()
void	delete(String stackName)
LocalDeployResult	deploy(String stackName, Path template)
List<String>	listActiveLocalstackStacks()	Active *-localstack stacks (excludes DELETE*).
Map<String,String>	outputs(String stackName)
LocalSameApplicationStackReplacer.Result	replaceSameApplicationStacks(String applicationId, String keepCfnStack, Path catalogDirectory)	When replacing an app under a new stack name, delete other active LocalStack stacks for the same applicationId (tag or deployment-contexts catalog).
static String	resolveEndpoint()	LocalStack gateway URL from LOCALSTACK_ENDPOINT, then AWS_ENDPOINT_URL, defaulting to http://localhost:4566.
boolean	stackExists(String stackName)
Map<String,String>	stackTags(String stackName)	Read stack tags; empty when stack missing or has none.
Map<String,String>	verifyDeployment(String stackName)	Confirm the stack exists and return its outputs.

Methods inherited from class Object

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

Field Details

REPLACE_SAME_APP_ENV

public static final String REPLACE_SAME_APP_ENV

Disable same-app stack replacement when set to false or 0.

See Also:

• Constant Field Values

Constructor Details

LocalStackDeployer

public LocalStackDeployer()

LocalStackDeployer

public LocalStackDeployer(String endpoint,
 String region)

Visible for tests and custom endpoint wiring.

Method Details

resolveEndpoint

public static String resolveEndpoint()

LocalStack gateway URL from LOCALSTACK_ENDPOINT, then AWS_ENDPOINT_URL, defaulting to http://localhost:4566.

deploy

public LocalDeployResult deploy(String stackName,
 Path template)
                         throws IOException

Specified by:

deploy in interface LocalDeployer

Throws:

IOException

delete

public void delete(String stackName)
            throws IOException

Specified by:

delete in interface LocalDeployer

Throws:

IOException

listActiveLocalstackStacks

public List<String> listActiveLocalstackStacks()

Active *-localstack stacks (excludes DELETE*).

stackTags

public Map<String,String> stackTags(String stackName)

Read stack tags; empty when stack missing or has none.

replaceSameApplicationStacks

public LocalSameApplicationStackReplacer.Result replaceSameApplicationStacks(String applicationId,
 String keepCfnStack,
 Path catalogDirectory)

When replacing an app under a new stack name, delete other active LocalStack stacks for the same applicationId (tag or deployment-contexts catalog).

verifyDeployment

public Map<String,String> verifyDeployment(String stackName)
                                    throws IOException

Confirm the stack exists and return its outputs.

Throws:

IOException - when the stack is missing or outputs cannot be read

stackExists

public boolean stackExists(String stackName)

Specified by:

stackExists in interface LocalDeployer

outputs

public Map<String,String> outputs(String stackName)

Specified by:

outputs in interface LocalDeployer

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface LocalDeployer