AWS Cloudformation Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID jenkins-cloudformation-plugin Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
0.11
Mar 04, 2013
1.414
Source Code
Issue Tracking
Maintainer(s)
GitHub
Open Issues
Erick Dovale (id: edovale)
Usage Installations 2013-Apr 158
2013-May 154
2013-Jun 182
2013-Jul 179
2013-Aug 190
2013-Sep 180
2013-Oct 191
2013-Nov 202
2013-Dec 205
2014-Jan 217
2014-Feb 219
2014-Mar 242

A plugin that allows for the creation of cloud formation stacks before running the build and the deletion of them after the build is completed.

This plugin gives Jenkins the ability to spawn Amazon Cloud Formation stacks before running the build and stopping it at the end.

This is particularly useful for testing; where you can create your application stacks in the Amazon cloud; deploy your application to them, run tests against it and finally take all the stacks down.

If the stack takes parameters, you can enter them as a semi-colon separated list of value=pair. For backward compatibility you can also use comma as separator for parameters. This however prevents you from passing comma separated lists as values for parameters. If you need to pass lists as values for parameters then you should separate your parameters with a semi-colon like this:

 param1=value1;param2=v2,v3,v4,v5;param3=v3,v4;param4=value4

If the stack that is created has outputs, they will be added as variables to the build environment so you can use them during the build just as any other environment variable like $WORKSPACE. The name of the variables will be the name of the output item defined in the stack json document prefixed with the name of the stack that produced it (ie. stack1_outputName).

This has the useful side effect of allowing for the chaining of several stacks where the ones further down can be fed the outputs of the previous stacks as parameters. In this way, if you have a stack that creates an instance and outputs its IP address you can potentially pass the IP address into another stack as a parameter and use it in whatever way you need.

The timeout value in the configuration refers to the maximum amount of time to wait before giving up on the stack creation. Keep in mind that if this threshold is reached the plugin will make no effort to delete the stack. Future version may change this behavior.

The stacks order can be re-arranged by dragging them. WARNING: If you are chaining stacks the order is relevant and therefore you should revise the parameters configuration of each of the stacks.

If an error occurs during the creation of the stack, this plugin will mark the build as failed and all previously created stacks will be deleted (Assuming they were flagged to be deleted at the end of the job)

As of version 0.8 a Build Notifier has been added to delete stacks. This feature allows jobs to kill stacks that were created in previous jobs. Here is a snapshot of the configuration for notifier:

Labels

Edit
plugin-buildwrapper plugin-buildwrapper Delete
plugin-external plugin-external Delete
plugin-notifier plugin-notifier Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment