0.27.0 (2019-03-28)

Highlights

• Python support (experimental)
• You can now run the CLI through npx cdk
• Make sure to go through the BREAKING CHANGES section below

Bug Fixes

• autoscaling: verify public subnets for associatePublicIpAddress (#2077) (1e3d41e)
• ec2: descriptive error message when selecting 0 subnets (#2025) (0de2206), closes #2011
• lambda: use Alias ARN directly (#2091) (bc40494)
• rds: remove Instance class (#2081) (6699fed)
• secretsmanager: allow templated string creation (#2010) (4e105a3)
• secretsmanager/ssm: verify presence of parameter name (#2066) (b93350f)
• serverless: rename aws-serverless to aws-sam (#2074) (4a82f13)
• stepfunctions: make Fail.error optional (#2042) (86e9d03)

Code Refactoring

• readonly struct properties and hide internals (#2106) (66dd228), closes awslabs/cdk-ops#321

Features

• toolkit:: new 'cdk' package to allow executing the cli through npx cdk (#2113) (32bca05)
• Python Support (#2009) (e6083fa)
• core: present reason for cyclic references (#2061) (e82e208)
• lambda: add support for log retention (#2067) (63132ec), closes #667 #667
• rds: cluster retention, reference KMS key by object (#2063) (99ab46d)
• secretsmanager/rds: support credential rotation (#2052) (bf79c82)
• toolkit: introduce the concept of auto-deployed Stacks. (#2046) (abacc66)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• lambda: cloudWatchLogsRetentionTimeDays in @aws-cdk/aws-cloudtrail now uses a logs.RetentionDays instead of a LogRetention.
• core: stack._toCloudFormation method is now unavailable and is replaced by @aws-cdk/assert.SynthUtils.toCloudFormation(stack).
• rds: replaced kmsKeyArn: string by kmsKey: kms.IEncryptionKey in DatabaseClusterProps
• autoscaling: VpcNetwork.isPublicSubnet() has been renamed to VpcNetwork.isPublicSubnetIds().
• serverless: renamed aws-serverless to aws-sam
• ec2: vpcPlacement has been renamed to vpcSubnets on all objects, subnetsToUse has been renamed to subnetType. natGatewayPlacement has been renamed to natGatewaySubnets.
• All properties of all structs (interfaces that do not begin with an "I") are now readonly since it is passed by-value and not by-ref (Python is the first language to require that). This may impact code in all languages that assumed it is possible to mutate these structs. Let us know if this blocks you in any way.

0.26.0 (2019-03-20)

Bug Fixes

• aws-cdk: fix VpcNetwork.importFromContext() (#2008) (e1a1a7b), closes #1998
• aws-cdk: update F# template to latest CDK version (#2006) (bda12f2)
• cdk: merge cloudFormation tags with aspect tags (#1762) (bfb14b6), closes #1725
• cfn2ts: properly de-Tokenize L1 string-arrays (#2033) (1e50383), closes #2030
• core: allow embedding condition expression as strings (#2007) (6afa87f), closes #1984
• ecs: make TaskDefinition accept IRoles (#2034) (f32431a), closes #1925
• lambda: expose underlying function's role on the alias (#2024) (de296de)
• stepfunctions: Actually perform rendering of NotCondition (06b59d9)
• toolkit: 'cdk deploy' support updates to Outputs (#2029) (23509ae), closes #778
• toolkit: increase number of retries (#2053) (133dc98), closes #1647
• rename core classes adding a Cfn prefix (#1960) (5886bf6), closes #1462 #288

Code Refactoring

• name "toCloudFormation" internal (renamed to _toCloudFormation) (#2047) (515868b), closes #2044 #2016

Features

• aws-cdk: support fixed repository name for DockerImageAsset (#2032) (942f938)
• aws-rds: ability to add an existing security group to RDS cluster (#2021) (1f24336)
• cfn2ts: make cfn2ts output TSDoc-compatible docblocks (#2000) (c6c66e9)
• cfnspec: update to version 2.28.0 (#2035) (6a671f2)
• cloudformation: allow specifying additional inputs for deploy Actions (#2020) (2d463be), closes #1247
• core: can use Constructs to model applications (#1940) (32c2377), closes #1479
• ecs: support private registry authentication (#1737) (11ed691), closes #1698
• glue: add L2 resources for Database and Table (#1988) (3117cd3)
• region-info: Model region-specific information (#1839) (946b444), closes #1282
• servicediscovery: AWS Cloud Map construct library (#1804) (1187366)
• ses: add constructs for email receiving (#1971) (3790858)
• add more directories excluded and treated as source in the JetBrains script. (#1961) (a1df717)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• “toCloudFormation” is now internal and should not be called directly. Instead use “app.synthesizeStack”
• ecs: ContainerImage.fromDockerHub has been renamed to ContainerImage.fromRegistry.
• rename Condition to CfnCondition.
• rename StackElement to CfnElement.
• rename Parameter to CfnParameter.
• rename Resource to CfnResource.
• rename Output to CfnOutput.
• rename Mapping to CfnMapping.
• rename Referenceable to CfnRefElement.
• rename IConditionExpression to ICfnConditionExpression.
• rename CfnReference to Reference.
• rename Rule to CfnRule.

0.25.3 (2019-03-12)

Bug Fixes

• aws-cloudtrail: correct created log policy when sendToCloudWatchLogs is true (#1966) (f06ff8e)
• aws-ec2: All SSM WindowsVersion entries (#1977) (85a1840)
• decdk: relax validation when not using constructs (#1999) (afbd591)

Features

• core: add fsharp init-template (#1912) (dfefb58)
• ec2: vpn metrics (#1979) (9319e13)

0.25.2 (2019-03-07)

Bug Fixes

• awslint: Don't fail if the @aws-cdk/cdk module is not present (#1953) (929e854)
• cdk-integ: Update cdk-integ to use new context file (#1962) (dbd2401)
• cloudfront: allow IBucket as CloudFront source (855f1f5), closes #1946
• cloudfront: pass viewerProtocolPolicy to the distribution's behaviors (#1932) (615ecd4)
• eks: remove 'const' from NodeType enum (#1970) (ac52989), closes #1969
• init: update the C# init sample with the new App API (#1919) (02f991d)

Features

• aws-certificatemanager: add DNSValidatedCertificate (#1797) (ae8870d), closes #605
• aws-ecs: add Fargate version 1.3.0 (#1968) (b529ad7)
• core: democratize synthesis and introduce artifacts (#1889) (4ab1cd3), closes #1716 #1893
• ec2: add support for vpn connections (#1899) (e150648), closes awslabs/jsii#231
• toolkit: add '--reuse-asset' option (#1918) (1767b61), closes #1916

0.25.1 (2019-03-04)

Bug Fixes

• toolkit: fix context passed in from command-line (#1939) (bec4a02), closes #1911

0.25.0 (2019-02-28)

Bug Fixes

• toolkit: Don't collect runtime information when versionReporting is disabled (#1890) (f827a88)
• aws-codepipeline: update CFN example. (#1653) (5dec01a)
• aws-s3-deployment: add setup.cfg to fix pip install bug on mac (#1826) (759c708)
• cdk: move apply() from Construct to ConstructNode (#1738) (642c8a6), closes #1732
• cloudtrail: addS3EventSelector does not expose all options (#1854) (5c3431b), closes #1841
• cloudtrail: Invalid resource for policy when using sendToCloudWatchLogs (#1851) (816cfc0), closes #1848
• cloudwatch: fix name of 'MetricAlarmProps' (#1765) (c87f09a), closes #1760
• codebuild: accept IRole instead of Role (#1781) (f08ca15), closes #1778
• codedeploy: LambdaDeploymentGroup now takes IRole (#1840) (f6adb7c), closes #1833
• codepipeline: allow providing Tokens as the physical name of the Pipeline. (#1800) (f6aea1b), closes #1788
• core: improve error message if construct names conflict (#1706) (0ea4a78)
• core: performance improvements (#1750) (77b516f)
• ecs: rename capacity adding methods (#1715) (e3738ac)
• elbv2: explicitly implement IApplicationTargetGroup (#1806) (828a2d7), closes #1799
• init: add new parameter to C# example (#1831) (c7b99d8)
• kms: have EncryptionKeyBase implement IEncryptionKey (#1728) (49080c6)
• lambda: Add 'provided' runtime (#1764) (73d5bef), closes #1761
• lambda: add region check for environment variables (#1690) (846ed9f)
• ssm: Generate correct SSM Parameter ARN (#1726) (39df456)
• toolkit: correctly reset context from the shell command (#1903) (58025c0)
• toolkit: correcty load cdk.json file without context (#1900) (7731565)
• toolkit: ignore hidden files for 'cdk init' (#1766) (afdd173), closes #1758
• toolkit: only fail if errors are on selected stacks (#1807) (9c0cf8d), closes #1784 #1783
• toolkit: support diff on multiple stacks (#1855) (72d2535)
• build: Npm ignores files and folders named "core" by default (#1767) (42876e7), closes npm/npm-packlist#24
• core: stack.partition is never scoped (#1763) (c968588)

Features

• apigateway: add support for MethodResponse to aws-apigateway. (#1572) (46236d9)
• autoscaling: bring your own IAM role (#1727) (2016b8d), closes #1701
• aws-eks: add construct library for EKS (#1655) (22fc8b9), closes #991
• cfnspec: manually add VPCEndpointService (#1734) (f782958), closes #1659
• codebuild: add support for setting the gitCloneDepth property on Project sources. (#1798) (5408a53), closes #1789
• core: Add construct.node.stack attribute (#1753) (a46cfd8), closes #798
• dynamodb: partitionKey and sortKey are now immutable (#1744) (63ae0b4)
• ecs: allow ECS to be used declaratively (#1745) (2480f0f), closes #1618
• kms: Allow opting out of "Retain" deletion policy (#1685) (7706302)
• lambda: allow specify event sources in props (#1746) (a84157d)
• lambda-event-sources: "api" event source (#1742) (5c11680)
• route53: Convenience API for creating zone delegations (#1853) (f974531), closes #1847
• sns: Support raw message delivery (#1827) (cc0a28c)
• ssm: allow referencing "latest" version of SSM parameter (#1768) (9af36af), closes #1587
• toolkit: improve docker build time in CI (#1776) (1060b95), closes #1748
• codepipelines: re-structure the CodePipeline Construct library API. (#1590) (3c3db07)
• decdk: Prototype for declarative CDK (decdk) (#1618) (8713ac6)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• cloudtrail: The CloudTrail.addS3EventSelector accepts an options object instead of only a ReadWriteType value.
• codedeploy: If an existing role is provided to a LambdaDeploymentGroup, you will need to provide the assuming service principal (codedeploy.amazonaws.com) yourself.
• core:$$** 'Aws' class returns unscoped Tokens, introduce a new class 'ScopedAws' which returns scoped Tokens.
• ssm: Rename parameter.valueAsString => parameter.stringValue, rename parameter.valueAsList => parameter.stringListValue, rename ssmParameter.parameterValue => ssmParameter.stringValue or ssmParameter.stringListValue depending on type, rename secretString.value => secretString.stringValue, rename secret.toSecretString() =>secret.secretString
• cloudwatch: Rename 'MetricAarmProps' => 'MetricAlarmProps'.
• core: Stack.find(c) and Stack.tryFind(c) were replaced by c.node.stack.
• dynamodb: partitionKey is now a required property when defining a dynamodb.Table. The addPartitionKey and addSortKey methods have been removed.
• cdk: Tag aspects use this feature and any consumers of this implementation must change from myConstruct.apply( ... ) to myConstruct.node.apply( ... ).
• ecs: Rename 'addDefaultAutoScalingGroupCapacity' => 'addCapacity', 'addAutoScalingGroupCapacity' => 'addAutoScalingGroup'.
• codepipelines: the CodePipeline Stage class is no longer a Construct, and cannot be instantiated directly, only through calling Pipeline#addStage; which now takes an Object argument instead of a String.
• codepipelines: the CodePipeline Actions are no longer Constructs.
• codepipelines: the CodePipeline Action name is now part of the Action props, instead of being a separate parameter.
• codepipelines: the Pipeline#addToPipeline methods in Resources like S3, CodeBuild, CodeCommit etc. have been renamed to toCodePipelineAction.
• aws-eks: For AutoScalingGroup, renamed minSize => minCapacity, maxSize => maxCapacity, for consistency with desiredCapacity and also Application AutoScaling. For ECS's addDefaultAutoScalingGroupCapacity(), instanceCount => desiredCapacity and the function now takes an ID (pass "DefaultAutoScalingGroup" to avoid interruption to your deployments).

0.24.1 (2019-02-07)

Bug Fixes

• reference documentation is missing (8fba8bc)

0.24.0 (2019-02-06)

Bug Fixes

• aws-ecs: correctly sets MinimumHealthyPercentage to 0 (#1661) (ce5966f), closes #1660
• cdk: only make Outputs Exports when necessary (#1624) (ebb8aa1), closes #903 #1611
• elbv2: fix specifying TargetGroup name (#1684) (1d7198a), closes #1674
• sns: create subscription object under subscriber (#1645) (0cc11ca), closes #1643 #1534

Features

• aws-s3: add option to specify block public access settings (#1664) (299fb6a)
• cdk: aspect framework and tag implementation (#1451) (f7c8531), closes #1136 #1497 #360
• cdk: metric functions now automatically generated (#1617) (36cfca8)
• cognito: Implement user pool and user pool client constructs (#1615) (8e03ed6)
• core: overrideLogicalId: override IDs of CFN elements (#1670) (823a1e8), closes #1594
• secretsmanager: L2 construct for Secret (#1686) (8da9115)
• serverless: add AWS::Serverless::Application to CFN spec (#1634) (bfa40b1)
• ssm: Add L2 resource for SSM Parameters (#1515) (9858a64)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• cdk: if you are using TagManager the API for this object has completely changed. You should no longer use TagManager directly, but instead replace this with Tag Aspects. cdk.Tag has been renamed to cdk.CfnTag to enable cdk.Tag to be the Tag Aspect.

0.23.0 (2019-02-04)

Bug Fixes

• apig: Move selectionPattern to integrationResponses (#1636) (7cdbcec), closes #1608
• aws-cdk: Improvements to IAM diff rendering (#1542) (3270b47), closes #1458 #1495 #1549
• aws-cdk: Java init template works on Windows (#1503) (24f521a)
• sns: create subscription object under subscriber (5c4a9e5), closes #1643 #1534
• Improve error message in SSMParameterProvider (#1630) (6a8e010), closes #1621
• aws-ec2: CfnNetworkAclEntry.CidrBlock should be optional (#1565) (4af7c0d), closes #1517
• aws-ec2: change maxAZs default for VPCs to 3 (#1543) (32a4b29), closes #996
• aws-events: ergonomics improvements to CloudWatch Events (#1570) (5e91a0a), closes #1514 #1198 #1275
• aws-s3-deployment: clean up tempfiles after deployment (#1367) (e291d37)
• dynamodb: grant also gives access to indexes (#1564) (33c2a6d), closes #1540
• Report stack metadata in assertions (#1547) (c2d17f5)

Features

• alexa-ask: Add deploy action for Alexa (#1613) (0deea61)
• apigateway: support function alias in LambdaIntegration (9f8bfa5)
• app: add source map support to TS app template (#1581) (5df22d9), closes #1579
• autoscaling: Support AssociatePublicIpAddress (#1604) (23c9afc), closes #1603
• aws-codepipeline: support setting a Role for a CFN Action (#1449) (77fe077)
• aws-ecs: add additional configuration to Volume (#1357) (ff96f3f)
• aws-ecs: add support for Event Targets (#1571) (aa68db5), closes #1370
• aws-ecs: ECS service scaling on ALB RequestCount (#1574) (2b491d4)
• aws-s3: add the option to not poll to the CodePipeline Action. (#1260) (876b26d)
• cdk: Support UpdateReplacePolicy on Resources (#1610) (f49c33b)
• cdk: treat the "fake" CFN intrinsics (Fn::GetArtifactAtt, Fn::GetParam) specially when stringifying JSON. (#1605) (2af2426), closes #1588
• cfnspec: Upgrade to CFN Resource Specification v2.21.0 (#1622) (21a5529)
• cloudwatch: Support 'datapointsToAlarm' on Alarms (#1631) (828ac20), closes #1626
• core: Generalization of dependencies (#1583) (53e68257)
• ecs: environment variables for LoadBalancedXxxService (#1537) (b633505)
• ecs: VPC link for API Gatweay and ECS services (#1541) (6642ca2)
• iam: Make roleName available on IRole (#1589) (9128390)
• lambda: reserved concurrent executions (#1560) (f7469c1)
• lambda: Support AWS Lambda Layers (#1411) (036cfdf)
• s3: Add DeployAction for codepipeline (#1596) (8f1a5e8)
• s3: export bucket websiteURL (#1521) (#1544) (4e46d3c)
• s3: imported bucket format option for website URL format (#1550) (28a423d)
• toolkit: disable colors if a terminal is not attached to stdout (#1641) (58b4685)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• aws-codepipeline: the role property in the CloudFormation Actions has been renamed to deploymentRole.
• aws-codepipeline: the role property in the app-delivery package has been renamed to deploymentRole.

0.22.0 (2019-01-10)

This is a major release with multiple breaking changes in the core layers. Please consult the breaking changes section below for details.

We are focusing these days on finalizing the common patterns and APIs of the CDK framework and the AWS Construct Library, which is why you are seeing all these breaking changes. Expect a few more releases with changes of that nature as we stabilize these APIs, so you might want to hold off with upgrading. We will communicate when this foundational work is complete.

Bug Fixes

• core: automatic cross-stack refs for CFN resources (#1510) (ca5ee35)
• ecs: correct typo and other minor mistakes in ecs readme (#1448) (9c91b20)
• elbv2: unable to specify load balancer name (#1486) (5b24583), closes #973 #1481
• lambda: use IRole instead of Role to allow imports (#1509) (b909dcd)
• toolkit: fix typo in --rename option description (#1438) (1dd56d4)
• toolkit: support multiple toolkit stacks in the same environment (#1427) (095da14), closes #1416

Features

• apigateway: add tracingEnabled property to APIGW Stage (#1482) (fefa764)
• assets: enable local tooling scenarios such as lambda debugging (#1433) (0d2b633), closes #1432
• aws-cdk: better stack dependency handling (#1511) (b4bbaf0), closes #1508 #1505
• aws-codepipeline: jenkins build and test actions (#1216) (471e8eb)
• aws-codepipeline: support notifications on the ManualApprovalAction (#1368) (068fa46), closes #1222
• aws-ecs: add support Amazon Linux 2 (#1484) (82ec0ff), closes #1483
• aws-kms: allow tagging kms keys (#1485) (f43b4d4)
• aws-lambda: add input and output artifacts to the CodePipeline action (#1390) (fbd7728), closes #1384
• cdk: transparently use constructs from another stack (d7371f0), closes #1324
• cli: allow specifying options using env vars (#1447) (7cd84a0)
• aws resource api linting (breaking changes) (#1434) (8c17ca7), closes #742 #1428
• core: cloudformation condition chaining (#1494) (2169015), closes #1457
• diff: better diff of arbitrary json objects (#1488) (607f997)
• route53: support cname records (#1487) (17eddd1), closes #1420
• step-functions: support parameters option (#1492) (935054a), closes #1480
• core: construct base class changes (breaking) (#1444) (fb22a32), closes #1431 #1441 #189 #1441 #1431
• core: idiomize cloudformation intrinsics functions (#1428) (04217a5), closes #202
• cloudformation: no more generated attribute types in CFN layer (L1) (#1489) (4d6d5ca), closes #1455 #1406
• cloudformation: stop generating legacy cloudformation resources (#1493) (81b4174)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• Cross-stack references: if you are using export() and import() to share constructs between stacks, you can stop doing that, instead of FooImportProps accept an IFoo directly on the consuming stack, and use that object as usual.
• ArnUtils.fromComponents() and ArnUtils.parse() have been moved onto Stack.
• All CloudFormation pseudo-parameter (such as AWS::AccountId etc) are now also accessible via Stack, as stack.accountId etc.
• All CloudFormation intrinsic functions are now represented as static methods under the Fn class (e.g. Fn.join(...) instead of new FnJoin(...).toString())
• resolve() has been moved to this.node.resolve().
• CloudFormationJSON.stringify() has been moved to this.node.stringifyJson(). validate() now should be protected.
• The deprecated cloudformation.XxxResource classes have been removed. Use the CfnXxx classes instead.
• Any CfnXxx resource attributes that represented a list of strings are now typed as string[]s (via #1144). Attributes that represent strings, are still typed as string (#712) and all other attribute types are represented as cdk.Token.
• route53: The route53.TXTRecord class was renamed to route53.TxtRecord.
• route53: record classes now require a zone when created (not assuming zone is the parent construct).
• lambda: the static "metric" methods moved from lambda.FunctionRef to lambda.Function.
• Many AWS resource classes have been changed to conform to API guidelines:
  • XxxRef abstract classes are now IXxx interfaces
  • XxxRefProps are now XxxImportProps
  • XxxRef.import(...) are now Xxx.import(...) accept XxxImportProps and return IXxx
  • export(): XxxImportProps is now defined in IXxx and implemented by imported resources