com.syncapse.jenkinsci.plugins.awscloudformationwrapper
Class CloudFormation

java.lang.Object
  com.syncapse.jenkinsci.plugins.awscloudformationwrapper.CloudFormation

public class CloudFormation
extends Object

Class for interacting with CloudFormation stacks, including creating them, deleting them and getting the outputs.

Author:

erickdovale

Field Summary

static long

MIN_TIMEOUT Minimum time to wait before considering the creation of the stack a failure.

Constructor Summary

CloudFormation(PrintStream logger, String stackName, String recipeBody, Map<String,String> parameters, long timeout, String awsAccessKey, String awsSecretKey, boolean autoDeleteStack, hudson.EnvVars envVars)

Method Summary

boolean	create()
boolean	delete()
boolean	getAutoDeleteStack() Return true if this stack should be automatically deleted at the end of the job, or false if it should not be automatically deleted.
protected com.amazonaws.services.cloudformation.AmazonCloudFormation	getAWSClient()
Map<String,String>	getOutputs()

Methods inherited from class java.lang.Object

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

Field Detail

MIN_TIMEOUT

public static final long MIN_TIMEOUT

Minimum time to wait before considering the creation of the stack a failure. Default value is 5 minutes. (300 seconds)

See Also:

Constant Field Values

Constructor Detail

CloudFormation

public CloudFormation(PrintStream logger,
                      String stackName,
                      String recipeBody,
                      Map<String,String> parameters,
                      long timeout,
                      String awsAccessKey,
                      String awsSecretKey,
                      boolean autoDeleteStack,
                      hudson.EnvVars envVars)

Parameters:

logger - a logger to write progress information.

stackName - the name of the stack as defined in the AWS CloudFormation API.

recipeBody - the body of the json document describing the stack.

parameters - a Map of where the keys are the param name and the value the param value.

timeout - Time to wait for the creation of a stack to complete. This value will be the greater between MIN_TIMEOUT and the given value.

awsAccessKey - the AWS API Access Key.

awsSecretKey - the AWS API Secret Key.

Method Detail

getAutoDeleteStack

public boolean getAutoDeleteStack()

Return true if this stack should be automatically deleted at the end of the job, or false if it should not be automatically deleted.

Returns:

true if this stack should be automatically deleted at the end of the job, or false if it should not be automatically deleted.

delete

public boolean delete()

Returns:

create

public boolean create()
               throws TimeoutException

Returns:

True of the stack was created successfully. False otherwise.

Throws:

TimeoutException - if creating the stack takes longer than the timeout value passed during creation.

See Also:

CloudFormation#CloudFormation(PrintStream, String, String, Map, long, String, String)

getAWSClient

protected com.amazonaws.services.cloudformation.AmazonCloudFormation getAWSClient()

getOutputs

public Map<String,String> getOutputs()