Releases: aws/aws-cdk
v0.15.2
v0.15.1
v0.15.0
Bug Fixes
- aws-autoscaling: allow minSize to be set to 0 (#1015) (67f7fa1)
- aws-codebuild: correctly pass the timeout property to CFN when creating a Project. (#1071) (b1322bb)
- aws-codebuild: correctly set S3 path when using it as artifact. (#1072) (f32cba9)
- aws-kms: add output value when exporting an encryption key (#1036) (cb490be)
- Switch from
js-yaml
toyaml
(#1092) (0b132b5)
Features
- don't upload the same asset multiple times (#1011) (35937b6), closes #989
- app-delivery: CI/CD for CDK Stacks (#1022) (f2fe4e9)
- add a new construct library for ECS (#1058) (ae03ddb)
- applets: integrate into toolkit (#1039) (fdabe95), closes #849 #342 #291
- aws-codecommit: use CloudWatch Events instead of polling by default in the CodePipeline Action. (#1026) (d09d30c)
- aws-dynamodb: allow specifying partition/sort keys in props (#1054) (ec87331), closes #1051
- aws-ec2: AmazonLinuxImage supports AL2 (#1081) (97b57a5), closes #1062
- aws-lambda: high level API for event sources (#1063) (1be3442)
- aws-sqs: improvements to IAM grants API (#1052) (6f2475e)
- codepipeline/cfn: Use fewer statements for pipeline permissions (#1009) (8f4c2ab)
- pkglint: Make sure .snk files are ignored (#1049) (53c8d76), closes #643
- toolkit: deployment ui improvements (#1067) (c832eaf)
- Update to CloudFormation resource specification v2.11.0
BREAKING CHANGES
- The ec2.Connections object has been changed to be able to manage multiple
security groups. The relevant property has been changed fromsecurityGroup
tosecurityGroups
(an array of security group objects). - aws-codecommit: this modifies the default behavior of the CodeCommit
Action. It also changes the internal API contract between the
aws-codepipeline-api module and the CodePipeline Actions in the service
packages. - applets: The applet schema has changed to allow Multiple applets can be
define in one file by structuring the files like this: - applets: The applet schema has changed to allow definition of multiple
applets in the same file.
The schema now looks like this:
applets:
MyApplet:
type: ./my-applet-file
properties:
property1: value
...
By starting an applet specifier with npm://, applet modules can directly be
referenced in NPM. You can include a version specifier (@1.2.3) to reference
specific versions.
- aws-sqs:
queue.grantReceiveMessages
has been removed. It is unlikely
that this would be sufficient to interact with a queue. Alternatively you can
usequeue.grantConsumeMessages
orqueue.grant('sqs:ReceiveMessage')
if
there's a need to only grant this action.
v0.14.1
v0.14.0
IMPORTANT NOTE: when upgrading to this version of the CDK framework, you must also upgrade
your installation the CDK Toolkit to the matching version:
$ npm i -g aws-cdk
$ cdk --version
0.14.0 (build ...)
Bug Fixes
- remove CloudFormation property renames (#973) (3f86603), closes #852
- aws-ec2: fix retention of all egress traffic rule (#998) (b9d5b43), closes #987
- aws-s3-deployment: avoid deletion during update using physical ids (#1006) (bca99c6), closes #981 #981
- cloudformation-diff: ignore changes to DependsOn (#1005) (3605f9c), closes #274
- cloudformation-diff: track replacements (#1003) (a83ac5f), closes #1001
- docs: fix EC2 readme for "natgatway" configuration (#994) (0b1e7cc)
- docs: updates to contribution guide (#997) (b42e742)
- iam: Merge multiple principals correctly (#983) (3fc5c8c), closes #924 #916 #958
Features
- add construct library for Application AutoScaling (#933) (7861c6f), closes #856 #861 #640 #644
- add HostedZone context provider (#823) (1626c37)
- assert: haveResource lists failing properties (#1016) (7f6f3fd)
- aws-cdk: add CDK app version negotiation (#988) (db4e718), closes #891
- aws-codebuild: Introduce a CodePipeline test Action. (#873) (770f9aa)
- aws-sqs: Add grantXxx() methods (#1004) (8c90350)
- core: Pre-concatenate Fn::Join (#967) (33c32a8), closes #916 #958
BREAKING CHANGES
- DynamoDB AutoScaling: Instead of
addReadAutoScaling()
, callautoScaleReadCapacity()
, and similar for write scaling. - CloudFormation resource usage: If you use L1s, you may need to change some
XxxName
properties back intoName
. These will match the CloudFormation property names. - You must use the matching
aws-cdk
toolkit when upgrading to this version, or context providers will cease to work. All existing cached context values incdk.json
will be invalidated and refreshed. ec2.AllConnections
was renamed toec2.AllTraffic
.
v0.13.0
Highlights
- A new construct library for AWS Step Functions
(docs).
The library provides rich APIs for modeling state machines by exposing a
programmatic interface for Amazon State
Language. - A new construct library for Amazon S3 bucket deployments
(docs).
You can use now automatically populate an S3 Bucket from a .zip file or a
local directory. This is a building block for end-to-end support for static
websites in the AWS CDK.
Bug Fixes
- aws-apigateway: make LambdaRestApi proxy by default (#963) (a5f5e2c), closes #959
- aws-cdk: Allow use of assumed roles behind a proxy (#898) (f2b1048)
- aws-cdk: Auto-delete stacks that failed creating before new attempt (#917) (2af8309)
- aws-cloudfront: expose distributionId (#938) (f58d98c)
- aws-dynamodb: don't emit empty array properties (#909) (841975a)
- docs: use ..code to display file structure in "writing constructs" (#935) (b743362)
Features
- assets: isZipArchive indicates if this is a zip asset (#944) (65190f9)
- aws-cdk: deploy supports CloudFormation Role (#940) (393be6f), closes #735
- aws-cloudformation: allow specifying custom resource type (#943) (9de3a84)
- aws-cloudformation: correctly handle the templateConfiguration property in the CreateUpdateStack Pipeline Action. (#923) (d251a46)
- aws-cloudfront: add support for "webAclId" (#969) (3ec9d76)
- aws-codedeploy: add auto rollback configuration to server Deployment Group. (#925) (7ee91cf)
- aws-codedeploy: add instance tag filter support for server Deployment Groups. (#824) (e6e8c51)
- aws-codedeploy: add support for setting CloudWatch alarms on a server Deployment Group. (#926) (27b26b1)
- add support for Step Functions (#827) (81b533c)
- aws-lambda: add grantInvoke() method (#962) (1ee8135), closes #961
- aws-lambda: improvements to the code and runtime APIs (#945) (36f29b6), closes #902 #188 #947 #947 #664
- aws-logs: extractMetric() returns Metric object (#939) (5558fff), closes #850
- aws-s3: initial support for website hosting (#946) (2d3661c)
- aws-s3-deployment: bucket deployments (#971) (84d6876), closes #952 #953 #954
- docs: added link to CloudFormation concepts (#934) (666bbba)
BREAKING CHANGES
- aws-apigateway: specifying a path no longer works. If you used to
provide a '/', remove it. Otherwise, you will have to supplyproxy: false
and construct more complex resource paths yourself. - aws-lambda: The construct
lambda.InlineJavaScriptLambda
is no longer supported. Uselambda.Code.inline
instead;lambda.Runtime.NodeJS43Edge
runtime is removed. CloudFront docs stipulate that you should use node6.10 or node8.10. It is always possible to use any value by instantiating alambda.Runtime
object.
v0.12.0
IMPORTANT NOTE: This release includes a fix for a bug
that would make the toolkit unusable for multi-stack applications. In order to benefit from
this fix, a globally installed CDK toolkit must also be updated:
$ npm i -g aws-cdk
$ cdk --version
0.12.0 (build ...)
Like always, you will also need to update your project's library versions:
Language | Update? |
---|---|
JavaScript/TypeScript (npm) | npx npm-check-updates -u |
Java (maven) | mvn versions:use-latest-versions |
.NET (NuGet) | nuget update |
Bug Fixes
- aws-codebuild: allow passing oauth token to GitHubEnterpriseSource (#908) (c23da91)
- toolkit: multi-stack apps cannot be synthesized or deployed (#911) (5511076), closes #868 #294 #910
Features
- aws-cloudformation: add permission management to CreateUpdate and Delete Stack CodePipeline Actions. (#880) (8b3ae43)
- aws-codepipeline: make input and output artifact names optional when creating Actions. (#845) (3d91c93)
BREAKING CHANGES
- aws-codepipeline: this commit contains the following breaking changes:
- Rename 'artifactName' in Action construction properties to 'outputArtifactName'
- Rename the 'artifact' property of Actions to 'outputArtifact'
- No longer allow adding output artifacts to Actions by instantiating the Artifact class
- Rename Action#input/outputArtifacts properties to _input/_outputArtifacts
Previously, we always required customers to explicitly name the output artifacts the Actions used in the Pipeline,
and to explicitly "wire together" the outputs of one Action as inputs to another.
With this change, the CodePipeline Construct generates artifact names,
if the customer didn't provide one explicitly,
and tries to find the first available output artifact to use as input to a newly created Action that needs it,
thus turning both the input and output artifacts from required to optional properties.
v0.11.0
IMPORTANT NOTE: This release includes a breaking change
in the toolkit <=> app protocol. This means that in order to synthesize CDK apps that use this version,
the globally installed CDK toolkit must also be updated:
$ npm i -g aws-cdk
$ cdk --version
0.11.0 (build ...)
Like always, you will also need to update your project's library versions:
Language | Update? |
---|---|
JavaScript/TypeScript (npm) | npx npm-check-updates -u |
Java (maven) | mvn versions:use-latest-versions |
.NET (NuGet) | nuget update |
Bug Fixes
- aws-apigateway: allow + in path parts (#769) (0c50d27), closes #768
- aws-cdk: continue after exceptions in stack monitor (#791) (b0f3298), closes #787
- aws-cloudfront: check for undefined and determining of the defaultRootObject prop is set or not (#801) (32a74c6)
- aws-cloudfront: properly support loggingConfig (#809) (5512f70), closes #721
- aws-codecommit: typo in README (#780) (0e79c2d)
- aws-ec2: Add Burstable Generation 3 Instances (#812) (d36ee6d)
- aws-ec2: fix capitalization of "VPCEndpointType" to "VpcEndpointType" (#789) (7a8ee2c), closes #765
- aws-ec2: fix typo in resource identifier (#818) (f529c80)
- aws-elbv2: fix load balancer registration (#890) (8cc9abe)
- aws-s3: properly export bucketDomainName (#844) (a65060d)
- aws-sqs: Queue.import() doesn't return a value (#885) (c592b7f), closes #879
- cdk: fix TagManager to evaluate to undefined if no tags are included (#882) (477c827)
- cdk: init templates were not upgraded to typescript ^3.0.0 (#904) (2cc7475)
- cdk: jsx support conflicts with React usage (#884) (76d8031), closes #830
- cfn2ts: expect Token instead of CloudFormationToken (#896) (6eee1d2)
- docs: fix issue #718 (Aurora DB example) (#783) (016f3a8)
- docs: update supported languages in README (#819, #450) (#820) (ffac98c)
- Correct heading level of CHANGELOG.md 0.10.0 (40d9ef0)
- Emit valid YAML-1.1 (#876) (ff857ea), closes #875
- toolkit: improve error message for large templates (#900) (a41f48f), closes #34
Code Refactoring
- aws-iam: move IAM classes cdk to aws-iam (#866) (d46a95b), closes #196
- util: remove @aws-cdk/util (#745) (10015cb), closes #709
- framework: remove app boilerplate and improvements to cx protocol (#868) (005beec), closes #216
Features
- aws-apigateway: "LambdaRestApi" and "addProxy" routes (#867) (905a95d)
- aws-cdk: add maven wrapper to java template (#811) (72aa872)
- aws-cloudformation: rename the CFN CodePipeline Actions. (#771) (007e7b4)
- aws-cloudformation: update the ReadMe of the module to reflect the new Action names. (#775) (6c0e75b), closes #771
- aws-cloudfront: Support Security Policy (#804) (b39bf11), closes #795
- aws-codedeploy: Add the auto-scaling groups property to ServerDeploymentGroup. (#739) (0b28886)
- aws-codedeploy: Deployment Configuration Construct. (#653) (e6b67ad)
- aws-codedeploy: support setting a load balancer on a Deployment Group. (#786) (e7af9f5)
- aws-codepipeline: allow specifying the runOrder property when creating Actions. (#776) (d146c8d)
- aws-codepipeline, aws-codecommit, aws-s3: change the convention for naming the source Actions to XxxSourceAction. (#753) (9c3ce7f)
- aws-dynamodb: IAM grants support (#870) (c5a4200)
- aws-dynamodb: support Global Secondary Indexes (#760) (3601440)
- aws-dynamodb: tags support (#814) (924c84e)
- aws-dynamodB: support Local Secondary Indexes (#825) (3175af3)
- aws-ec2: add support for ICMP protocol's classification Types & Codes to SecurityGroupRule (#893) (85bd3c0)
- aws-ec2: allow configuring subnets for NAT gateway (#874) (8ec761c)
- aws-ec2: support UDP port ranges in SecurityGroups (#835) (b42ef90)
- aws-elasticloadbalancingv2: support for ALB/NLB (#750) (bd9ee01)
- aws-s3: support granting public access to objects (#886) (bdee191), closes #877
- cdk: Add support for UseOnlineResharding with UpdatePolicies (#881) (1f717e1)
- cdk: configurable default SSM context provider (#889) (353412b)
- core: resource overrides (escape hatch) (#784) (5054eef), closes #606
- aws-codepipeline: Manage IAM permissions for (some) CFN CodePipeline actions ([#843](https://gith...
v0.10.0
This release introduces a better way to "escape" L2 constructs in case of missing features
by adding the ability to add arbitrary overrides for resource properties:
const bucket = new s3.Bucket(this, 'L2Bucket');
// access L1
const bucketResource = bucket.findChild('Resource') as s3.cloudformation.BucketResource;
// strongly-typed overrides
bucketResource.propertyOverrides.bucketName = 'NewBucketName';
// weakly-typed overrides
bucketResource.addPropertyOverride('BucketName', 'NewerBucketName');
Bug Fixes
- aws-codecommit: typo in README (#780) (0e79c2d)
- aws-ec2: fix capitalization of "VPCEndpointType" to "VpcEndpointType" (#789) (7a8ee2c), closes #765
- docs: fix issue #718 (Aurora DB example) (#783) (016f3a8)
Code Refactoring
Features
- aws-cloudformation: rename the CodePipeline actions (#771) (007e7b4)
- aws-cloudformation: update the README of the module to reflect the new action names (#775) (6c0e75b), closes #771
- aws-codedeploy: add auto-scaling groups property to ServerDeploymentGroup (#739) (0b28886)
- aws-codedeploy: add deployment configuration construct (#653) (e6b67ad)
- aws-codepipeline, aws-codecommit, aws-s3: change the convention for naming the source Actions to XxxSourceAction (#753) (9c3ce7f)
- aws-elasticloadbalancingv2: support for ALB/NLB (#750) (bd9ee01)
- tagging support for AutoScaling/SecurityGroup (#766) (3d48eb2)
- core: resource overrides (escape hatch) (#784) (5054eef), closes #606
- toolkit: stop creating 'empty' stacks (#779) (1dddd8a)
BREAKING CHANGES
- cdk: the constructor signature of
TagManager
has changed.initialTags
is now passed inside a props object. - util:
@aws-cdk/util
is no longer available - aws-elasticloadbalancingv2: adds classes for modeling Application and Network Load
Balancers. AutoScalingGroups now implement the interface that makes
constructs a load balancing target. The breaking change is that Security
Group rule identifiers have been changed in order to make adding rules
more reliable. No code changes are necessary but existing deployments
may experience unexpected changes. - aws-cloudformation: this renames all CloudFormation Actions for CodePipeline
to bring them in line with Actions defined in other service packages. - aws-codepipeline, aws-codecommit, aws-s3: change the names of the source Actions from XxxSource to XxxSourceAction.
This is to align them with the other Actions, like Build.
Also, CodeBuild has the concept of Sources, so it makes sense to strongly differentiate between the two.
CloudFormation Changes
- @aws-cdk/cfnspec: Updated [CloudFormation resource specification] to
v2.8.0
([@RomainMuller] in #767)- New Construct Libraries
@aws-cdk/aws-amazonmq
@aws-cdk/aws-iot1click
- New Resource Types
- AWS::IoT1Click::Device
- AWS::IoT1Click::Placement
- AWS::IoT1Click::Project
- Attribute Changes
- AWS::EC2::VPCEndpoint CreationTimestamp (added)
- AWS::EC2::VPCEndpoint DnsEntries (added)
- AWS::EC2::VPCEndpoint NetworkInterfaceIds (added)
- Property Changes
- AWS::ApiGateway::Deployment DeploymentCanarySettings (added)
- AWS::ApiGateway::Method AuthorizationScopes (added)
- AWS::ApiGateway::Stage AccessLogSetting (added)
- AWS::ApiGateway::Stage CanarySetting (added)
- AWS::AutoScaling::AutoScalingGroup LaunchTemplate (added)
- AWS::CodeBuild::Project LogsConfig (added)
- AWS::CodeBuild::Project SecondaryArtifacts (added)
- AWS::CodeBuild::Project SecondarySources (added)
- AWS::CodeDeploy::DeploymentGroup Ec2TagSet (added)
- AWS::CodeDeploy::DeploymentGroup OnPremisesTagSet (added)
- AWS::EC2::FlowLog LogDestination (added)
- AWS::EC2::FlowLog LogDestinationType (added)
- AWS::EC2::FlowLog DeliverLogsPermissionArn.Required (changed)
- Old: true
- New: false
- AWS::EC2::FlowLog LogGroupName.Required (changed)
- Old: true
- New: false
- AWS::EC2::VPCEndpoint IsPrivateDnsEnabled (deleted)
- AWS::EC2::VPCEndpoint PrivateDnsEnabled (added)
- AWS::EC2::VPCEndpoint RouteTableIds.DuplicatesAllowed (added)
- AWS::EC2::VPCEndpoint SecurityGroupIds.DuplicatesAllowed (added)
- AWS::EC2::VPCEndpoint SubnetIds.DuplicatesAllowed (added)
- AWS::EC2::VPCEndpoint VPCEndpointType.UpdateType (changed)
- Old: Mutable
- New: Immutable
- AWS::ECS::Service SchedulingStrategy (added)
- AWS::ECS::Service ServiceRegistries.UpdateType (changed)
- Old: Mutable
- New: Immutable
- AWS::ElastiCache::ReplicationGroup NodeGroupConfiguration.UpdateType (changed)
- Old: Immutable
- New: Conditional
- AWS::ElastiCache::ReplicationGroup NumNodeGroups.UpdateType (changed)
- Old: Immutable
- New: Conditional
- AWS::RDS::DBCluster EngineMode (added)
- AWS::RDS::DBCluster ScalingConfiguration (added)
- AWS::SageMaker::NotebookInstance LifecycleConfigName.UpdateType (changed)
- Old: Immutable
- New: Mutable
- Property Type Changes
- AWS::ApiGateway::Deployment.AccessLogSetting (added)
- AWS::ApiGateway::Deployment.CanarySetting (added)
- AWS::ApiGateway::Deployment.DeploymentCanarySettings (added)
- AWS::ApiGateway::Stage.AccessLogSetting (added)
- AWS::ApiGateway::Stage.CanarySetting (added)
- AWS::AutoScaling::AutoScalingGroup.LaunchTemplateSpecification (added)
- AWS::CodeBuild::Project.CloudWatchLogsConfig (added)
- AWS::CodeBuild::Project.LogsConfig (added)
- AWS::CodeBuild::Project.S3LogsConfig (added)
- AWS::CodeDeploy::DeploymentGroup.EC2TagSet (added)
- AWS::CodeDeploy::DeploymentGroup.EC2TagSetListObject (added)
- AWS::CodeDeploy::DeploymentGroup.OnPremisesTagSet (added)
- AWS::CodeDeploy::DeploymentGroup.OnPremisesTagSetListObject (added)
- AWS::EC2::SpotFleet.ClassicLoadBalancer (added)
- AWS::EC2::SpotFleet.ClassicLoadBalancersConfig (added)
- AWS::EC2::SpotFleet.FleetLaunchTemplateSpecification (added)
- AWS::EC2::SpotFleet.LaunchTemplateConfig (added)
- AWS::EC2::SpotFleet.LaunchTemplateOverrides (added)
- AWS::EC2::SpotFleet.LoadBalancersConfig (added)
- AWS::EC2::SpotFleet.TargetGroup (added)
- AWS::EC2::SpotFleet.TargetGroupsConfig (added)
- AWS::ECS::TaskDefinition.DockerVolumeConfiguration (added)
- AWS::ECS::TaskDefinition.RepositoryCredentials (added)
- AWS::ECS::TaskDefinition.Tmpfs (added)
- AWS::Events::Rule.SqsParameters (added)
- AWS::RDS::DBCluster.ScalingConfiguration (added)
- AWS::ApiGateway::Deployment.StageDescription AccessLogSetting (added)
- AWS::ApiGateway::Deployment.StageDescription CanarySetting (added)
- AWS::ApiGateway::Method.Integration ConnectionId (added)
- AWS::ApiGateway::Method.Integration ConnectionType (added)
- AWS::ApiGateway::Method.Integration TimeoutInMillis (added)
- AWS::ApiGateway::UsagePlan.ApiStage Throttle (added)
- AWS::CodeBuild::Project.Artifacts ArtifactIdentifier (added)
- AWS::CodeBuild::Project.Source SourceIdentifier (added)
- AWS::CodeBuild::Project.VpcConfig SecurityGroupIds.Required (changed)
- Old: true
- New: false
- AWS::CodeBuild::Project.VpcConfig Subnets.Required (changed)
- Old: true
- New: false
- AWS::CodeBuild::Project.VpcConfig VpcId.Required (changed)
- Old: true
- New: false
- AWS::CodeDeploy::DeploymentGroup.EC2TagFilter Key.Documentation (changed)
- Old: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codedeploy-deploymentgroup-ec2tagfilters.html#cfn-properties-codedeploy-deploymentgroup-ec2tagfilters-key
- New: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-codedeploy-deploymentgroup-ec2tagfilter.html#cfn-codedeploy-deploymentgroup-ec2tagfilter-key
- AWS::CodeDeploy::DeploymentGroup.EC2TagFilter Type.Documentati...
- New Construct Libraries
v0.9.2
NOTICE: This release includes a framework-wide breaking change which changes the type of all the string resource attributes across the framework. Instead of using strong-types that extend cdk.Token
(such as QueueArn
, TopicName
, etc), we now represent all these attributes as normal string
s, and codify the tokens into the string (using the feature introduced in #168).
Furthermore, the cdk.Arn
type has been removed. In order to format/parse ARNs, use the static methods on cdk.ArnUtils
.
See motivation and discussion in #695.
Breaking Changes
- cfn2ts: use stringified tokens for resource attributes instead of strong types (#712) (6508f78), closes #518 #695 #744
- aws-dynamodb: Attribute type for keys, changes the signature of the
addPartitionKey
andaddSortKey
methods to be consistent across the board. (#720) (e6cc189) - aws-codebuild: fix typo "priviledged" -> "privileged
Bug Fixes
- assets: can't use multiple assets in the same stack (#725) (bba2e5b), closes #706
- aws-codebuild: typo in BuildEnvironment "priviledged" -> "privileged (#734) (72fec36)
- aws-ecr: fix addToResourcePolicy (#737) (eadbda5)
- aws-events: ruleName can now be specified (#726) (a7bc5ee), closes #708
- aws-lambda: jsii use no long requires 'sourceAccount' (#728) (9e7d311), closes #714
- aws-s3: remove
policy
argument (#730) (a79190c), closes #672 - cdk: "cdk init" java template is broken (#732) (281c083), closes #711 awslabs/jsii#233
Features
- aws-apigateway: new API Gateway Construct Library (#665) (b0f3857)
- aws-cdk: detect presence of EC2 credentials (#724) (8e8c295), closes #702 #130
- aws-codepipeline: make the Stage insertion API in CodePipeline more flexible (#460) (d182818)
- aws-codepipeline: new "Pipeline#addStage" convenience method (#647) (25c9fa0)
- aws-rds: add support for parameter groups (#729) (2541508), closes #719
- docs: add documentation for CDK toolkit plugings (#733) (965b918)
- dependencies: upgrade to jsii 0.7.6