Fork me on GitHub

carrotaws:cloud-formation-create

Full name:

com.carrotgarden.maven:carrot-maven-aws-plugin:1.2.2:cloud-formation-create

Description:

cloud formation: create stack based on: stack name, stack template (stackTemplateFile), stack parameters (stackPropertiesInputFile + stackInputParams), and produce a stack output (stackPropertiesOutputFile) as well as inject output into into project.properties ; wait for completion or fail (stackTimeout);

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • Binds by default to the lifecycle phase: prepare-package.

Required Parameters

Name Type Since Description
amazonRegion String - AWS region name, such as us-east-1, which controls amazon region selection; alternatively, see amazonRegionProperty
Default value is: us-east-1.
stackName String - AWS CloudFormation stack name; must be unique under your aws account / region; alternatively, see stackNameProperty
Default value is: amazon-builder.
stackServerId String - AWS CloudFormation amazon security credentials stored in maven settings.xml under server id entry; username="Access Key ID", password="Secret Access Key";
Default value is: com.example.aws.stack.
stackTemplateFile File - AWS CloudFormation template file
Default value is: ./target/formation/formation.template.

Optional Parameters

Name Type Since Description
amazonRegionProperty String - name of project.property which, if set dynamically, will be used instead of plugin property amazonRegion
amazonTagName String - default amazon tag for resource names
Default value is: Name.
stackEndpintFormat String - AWS CloudFormation end point format
Default value is: https://cloudformation.%s.amazonaws.com.
stackEndpoint String - AWS CloudFormation optional api end point url which controls amazon region selection; when omitted, will be constructed from stackEndpintFormat and amazonRegion
stackInputParams Map - AWS CloudFormation Parameters Declaration stack template input parameters; optional; overrides settings from #stackPropertiesInputFile
stackIsInjectOutputProperties boolean - should inject stack operation output into the project.properties?
Default value is: true.
stackIsPersistOutputProperties boolean - should persist stack operation output into stackPropertiesOutputFile
Default value is: true.
stackNameProperty String - name of project.property which, if set dynamically, will be used instead of plug-in property stackName
stackPropertiesInputFile File - AWS CloudFormation stack create execution Parameters Declaration input properties file; will be overridden by #stackInputParams if any
Default value is: ./target/formation/formation-input.properties.
stackPropertiesOutputFile File - AWS CloudFormation stack create execution result Outputs Section output properties file
Default value is: ./target/formation/formation-output.properties.
stackTimeout String - AWS CloudFormation operation timeout; seconds
Default value is: 600.

Parameter Details

amazonRegion:

AWS region name, such as us-east-1, which controls amazon region selection; alternatively, see amazonRegionProperty
  • Type: java.lang.String
  • Required: Yes
  • Default: us-east-1

amazonRegionProperty:

name of project.property which, if set dynamically, will be used instead of plugin property amazonRegion
  • Type: java.lang.String
  • Required: No

amazonTagName:

default amazon tag for resource names
  • Type: java.lang.String
  • Required: No
  • Default: Name

stackEndpintFormat:

AWS CloudFormation end point format
  • Type: java.lang.String
  • Required: No
  • Default: https://cloudformation.%s.amazonaws.com

stackEndpoint:

AWS CloudFormation optional api end point url which controls amazon region selection; when omitted, will be constructed from stackEndpintFormat and amazonRegion
  • Type: java.lang.String
  • Required: No

stackInputParams:

AWS CloudFormation Parameters Declaration stack template input parameters; optional; overrides settings from #stackPropertiesInputFile
  • Type: java.util.Map
  • Required: No

stackIsInjectOutputProperties:

should inject stack operation output into the project.properties?
  • Type: boolean
  • Required: No
  • Default: true

stackIsPersistOutputProperties:

should persist stack operation output into stackPropertiesOutputFile
  • Type: boolean
  • Required: No
  • Default: true

stackName:

AWS CloudFormation stack name; must be unique under your aws account / region; alternatively, see stackNameProperty
  • Type: java.lang.String
  • Required: Yes
  • Default: amazon-builder

stackNameProperty:

name of project.property which, if set dynamically, will be used instead of plug-in property stackName
  • Type: java.lang.String
  • Required: No

stackPropertiesInputFile:

AWS CloudFormation stack create execution Parameters Declaration input properties file; will be overridden by #stackInputParams if any
  • Type: java.io.File
  • Required: No
  • Default: ./target/formation/formation-input.properties

stackPropertiesOutputFile:

AWS CloudFormation stack create execution result Outputs Section output properties file
  • Type: java.io.File
  • Required: No
  • Default: ./target/formation/formation-output.properties

stackServerId:

AWS CloudFormation amazon security credentials stored in maven settings.xml under server id entry; username="Access Key ID", password="Secret Access Key";
  • Type: java.lang.String
  • Required: Yes
  • Default: com.example.aws.stack

stackTemplateFile:

AWS CloudFormation template file
  • Type: java.io.File
  • Required: Yes
  • Default: ./target/formation/formation.template

stackTimeout:

AWS CloudFormation operation timeout; seconds
  • Type: java.lang.String
  • Required: No
  • Default: 600