CDK Constructs for AWS CloudFormation
Project description
CDK Constructs for AWS CloudFormation
This module is part of the AWS Cloud Development Kit project.
CodePipeline Actions for CloudFormation
This module contains Actions that allows you to deploy to CloudFormation from AWS CodePipeline.
For example, the following code fragment defines a pipeline that automatically deploys a CloudFormation template directly from a CodeCommit repository, with a manual approval step in between to confirm the changes:
// Source stage: read from repository
const repo = new codecommit.Repository(stack, 'TemplateRepo', {
repositoryName: 'template-repo'
});
const source = new codecommit.PipelineSourceAction({
actionName: 'Source',
repository: repo,
outputArtifactName: 'SourceArtifact',
pollForSourceChanges: true,
});
const sourceStage = {
name: 'Source',
actions: [source],
};
// Deployment stage: create and deploy changeset with manual approval
const stackName = 'OurStack';
const changeSetName = 'StagedChangeSet';
const prodStage = {
name: 'Deploy',
actions: [
new cfn.PipelineCreateReplaceChangeSetAction({
actionName: 'PrepareChanges',
stackName,
changeSetName,
adminPermissions: true,
templatePath: source.outputArtifact.atPath('template.yaml'),
runOrder: 1,
}),
new codepipeline.ManualApprovalAction({
actionName: 'ApproveChanges',
runOrder: 2,
}),
new cfn.PipelineExecuteChangeSetAction({
actionName: 'ExecuteChanges',
stackName,
changeSetName,
runOrder: 3,
}),
],
};
new codepipeline.Pipeline(stack, 'Pipeline', {
stages: [
sourceStage,
prodStage,
],
});
See the AWS documentation for more details about using CloudFormation in CodePipeline.
Actions defined by this package
This package defines the following actions:
- PipelineCreateUpdateStackAction - Deploy a CloudFormation template directly from the pipeline. The indicated stack is created,
or updated if it already exists. If the stack is in a failure state, deployment will fail (unless
replaceOnFailure
is set totrue
, in which case it will be destroyed and recreated). - PipelineDeleteStackAction - Delete the stack with the given name.
- PipelineCreateReplaceChangeSetAction - Prepare a change set to be applied later. You will typically use change sets if you want to manually verify the changes that are being staged, or if you want to separate the people (or system) preparing the changes from the people (or system) applying the changes.
- PipelineExecuteChangeSetAction - Execute a change set prepared previously.
Custom Resources
Custom Resources are CloudFormation resources that are implemented by arbitrary user code. They can do arbitrary lookups or modifications during a CloudFormation synthesis run.
You will typically use Lambda to implement a Construct implemented as a
Custom Resource (though SNS topics can be used as well). Your Lambda function
will be sent a CREATE
, UPDATE
or DELETE
message, depending on the
CloudFormation life cycle, and can return any number of output values which
will be available as attributes of your Construct. In turn, those can
be used as input to other Constructs in your model.
In general, consumers of your Construct will not need to care whether it is implemented in term of other CloudFormation resources or as a custom resource.
Note: when implementing your Custom Resource using a Lambda, use
a SingletonLambda
so that even if your custom resource is instantiated
multiple times, the Lambda will only get uploaded once.
Example
Sample of a Custom Resource that copies files into an S3 bucket during deployment
(implementation of actual copy.py
operation elided).
interface CopyOperationProps {
sourceBucket: IBucket;
targetBucket: IBucket;
}
class CopyOperation extends Construct {
constructor(parent: Construct, name: string, props: DemoResourceProps) {
super(parent, name);
const lambdaProvider = new SingletonLambda(this, 'Provider', {
uuid: 'f7d4f730-4ee1-11e8-9c2d-fa7ae01bbebc',
code: new LambdaInlineCode(resources['copy.py']),
handler: 'index.handler',
timeout: 60,
runtime: LambdaRuntime.Python3,
});
new CustomResource(this, 'Resource', {
lambdaProvider,
properties: {
sourceBucketArn: props.sourceBucket.bucketArn,
targetBucketArn: props.targetBucket.bucketArn,
}
});
}
}
More examples are in the example
directory, including an example of how to use
the cfnresponse
module that is provided for you by CloudFormation.
References
See the following section of the docs on details to write Custom Resources:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aws-cdk.aws-cloudformation-0.27.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab20c761c3ddb7b63fe3720b30536806c6929f056095ff60c84896f9f0925815 |
|
MD5 | ee6ac2f64e12dc462db9dacd3a65e786 |
|
BLAKE2b-256 | 81141078296f5ab59e1f1bcef3925362bd8ac3219cb5aac142d32457e6aef999 |
Hashes for aws_cdk.aws_cloudformation-0.27.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae0ea11d3466b8d99918fc3f06c7ddc364039cf5732eb75d9b525cb490ab146f |
|
MD5 | 6eee08b87a77e5b6391ad4d30145326b |
|
BLAKE2b-256 | 64d473241789eb905df9ec29609fd6e301a22b3f2892a8d1a5d7e714c3facc2a |