0.15.0

Breaking changes

Renaming of `Options` and `Props` to `*Config`

We had several exports where the configuration passed to constructs or functions was using a class with a different suffix then Config. If you are using a language like C#, Java, Python, or Go you might have needed to specify these classes in your CDKTF application. To simplify the usage we changed every suffix to be Config, so if you currently use one of the others please rename them to use the Config suffix. No options were changed in the process, only the names were aligned.

This would be one example of the change to be made (this is in Java):

import software.constructs.Construct;
import com.hashicorp.cdktf.App;
import com.hashicorp.cdktf.TerraformStack;
import com.hashicorp.cdktf.CloudBackend;
-import com.hashicorp.cdktf.CloudBackendProps;
+import com.hashicorp.cdktf.CloudBackendConfig;
import com.hashicorp.cdktf.NamedCloudWorkspace;

    public static class Demo extends TerraformStack{

        public Demo(Construct scope, String id){
            super(scope, id);
-            new CloudBackend(this, CloudBackendProps.builder()
+            new CloudBackend(this, CloudBackendConfig.builder()
                    .organization("hashicorp")
                    .workspaces(new NamedCloudWorkspace("demo"))
                    .build()
            );

Notice: CDKTF 0.15 bumps minimum Terraform version to 1.2

CDKTF is bumping the minimum supported version of Terraform from 1.0 to 1.2 starting from CDKTF version 0.15. This change is necessary as CDKTF 0.15 uses the Terraform CLI for planning and applying changes for Terraform Cloud and Terraform Enterprise instead of the API used in version 0.14.

Terraform promises compatibility between all v1.x releases, so there shouldn't be any issues with this change. The only changes between these versions are bug fixes, and new feature additions.

Please open an issue if you encounter any issues or bugs with this change.

Deprecation: We deprecate the feature flags that go into the `context` field of the `cdktf.json`

CDKTF used to use feature flags to enable potentially breaking behaviors in a release. These are no longer needed since most of the changes we introduce from here can not be hidden behind feature flags. When the feature flags are removed, the behavior will be the same as this configuration:

{
  "context": {
    "excludeStackIdFromLogicalIds": "true",
    "allowSepCharsInLogicalIds": "true"
  }
}

feat

feat(cli): Add cdktf provider list command #2270
feat(cli): support -var and -var-file terraform flags #2468
feat(cli): add -no-color tag #2307
feat: enable non-escaping mode for tokens #2179
feat: use our own pre-built package for node-pty to have builds for Nodejs 19 available #2478
feat(docs): Document node-gyp errors if no precompiled binaries are available and the target system misses a native toolchain #2497

fix

fix(cli): don't enquote args as they will be escaped and end up in the calls to Terraform #2493
fix: detect destroys on windows / TF version #2486
fix(tests): change Options -> Config as per #2471 #2482
fix(cli): windows fixes #2480
fix: limit concurrency for integration tests to 10 for each windows and linux #2474
fix(tests): Make version more stable #2467
fix: use older SHA from jsii superchain docker image #2465
fix: fix go build in pipeline #2464
fix(cli): remove newlines from tokens during terraform login #2459
fix(cli): abort apply if not all variables are known #2455
fix: Expose provider matcher to jest #2448
fix: Adds environment to keys to preserve case #2446
fix: Allow git access for sentry cli in docker #2426
fix: add path: dist for npm and pypi #2410

chore

chore: create upgrade guide #2494
chore: increase parallel limit (10->30) to speed up integration tests #2487
chore: disable cron for project board #2484
chore(docs): fix some docs #2483
chore: fix typo in function name #2462
chore: add a notice for minimum supported version to changelog #2461
chore: fix broken GHA version updater #2453
chore: update CODEOWNERS #2444
chore(docs): running snippet update tool revealed an existing snippet that is not up-to-date #2440
chore: update JSII #2428
chore: Support custom endpoints #2427
chore: create TFC/TFE workspace using the Terraform CLI #2424
chore: switch to SHA-based workflow pins #2422
chore: Update all documentation examples for Typescript #2421
chore: remove long-running hooks #2418
chore: translate documentation to csharp #2417
chore: add a refactoring guide #2413
chore: fix homebrew deploy step #2412
chore: add TFE information to TFC docs #2407
chore: deprecate feature flags #2498
chore: document variable flags #2495

refactor

refactor: rename all *Props and *Options classes and interfaces to *Config #2471

0.14.3

fix

fix: add completed tfc pending states #2398
fix: skip confirming on auto-apply enabled tfc workspaces #2397
fix(hcl2cdk): snapshot generated code instead of snapshotting that the function returns a promise #2392
fix: add required_version to json schema #2355

chore

chore: add provider-integration tests conditionally for PRs and to releases #2371
chore: increase operations per run of stale workflow #2363
chore: update github workflow actions #2361
chore(docs): Add Example for Complex input variables #2309
chore: add Terraform 1.3.4 to Docker container #2285

feat

feat(cli): prompt added in init - asks to use TFC when credentials are present #2386
feat(docs): document Token.nullValue() #2297

0.14.2

Breaking changes

We split up our cdktf-cli package into cdktf-cli for the UI parts, utilizing @cdktf/cli-core for the functionality. If you previously relied on the internal cdktf-cli/lib entrypoint you should switch to @cdktf/cli-core. This was never an official API, but we want to mention it here in case it breaks for anyone.

chore

chore: skip hcl2cdk tests for now #2384
chore: Update Digital Team Files #2383
chore: move from pr target to pr #2381
chore: fix finalizing the Sentry release #2379
chore: update workflows for new workflow endpoint #2378
chore: disable python edge test #2369
chore: only trigger unit tests once #2362
chore: use secret #2358
chore: document go version #2351
chore: fix stale workflow #2343
chore: add build step to ci #2338
chore: add workflows to auto-close and lock stale issues and PRs #2335
chore: add expression paranthesis #2332
chore: dedupe concurrency prefix #2330
chore: npm-check-updates && yarn upgrade #2329
chore: improve release pipelines #2328
chore: add GH Action that labels PRs #2325
chore(docs): Update remote-backends.mdx #2324
chore: ensure we run all tests on dependency updates #2323
chore: re-add run url #2320
chore: limit concurrency on releases #2318
chore: fix sentry release script #2317
chore: fix typo #2316
chore: offboard checks from PRs to main #2315
chore(docs): prepare for code samples in multiple languages #2314
chore: run CI more selectively #2313
chore: make feature flag tests more resilient to provider updates #2312
chore: additional potential speedup experiments for hcl2cdk unit tests #2311
chore(tests): enable go provider add tests #2308
chore: run linting and prettier as part of CI #2304
chore(docs): translate hcl-interop examples to c# #2288
chore: add workflow to update our github actions #2283
chore(docs): translate functions examples to c# #2277
chore(docs): translate data-sources examples to c# #2276
chore(docs): translate aspects example to c# #2273
chore(docs): translate all examples to python #2186
chore(docs): Translate Documentation Snippets for Java #2183
chore: make info level log a debug level one #2502

feat

feat(examples): python upcloud server #2366

fix

fix: pin yargs types version #2364
fix: Transition to planned state after cost estimation and policy checks with TFC/TFE #2360
fix(cli): don't fail with UsageError when determining whether a provider is installed as a pre-built provider #2348
fix: scoped packages need a publish config to be published to npm #2347
fix: scoped packages need a publish config to be published to npm #2346
fix(docs): fix header indentation causing no page contents sidebar for this page #2299
fix(hcl2json): don't overwrite crypto if it's set already #2282
fix: Graceful failures when using cdktf with non-admin tokens #2258
fix: Prevent any release jobs from triggering if no release is required #2158

refactor

refactor(cli): parse json according to schema #2286
refactor: extract asset and constructs example into separate files #2275
refactor(cli): move cli library into seperate package #2253

0.14.1

A broken import that only appeared in the bundled cdktf-cli that we publish broke the 0.14.0 release. This patch release fixes this.

fix

fix(provider-generator): fix cross package import which breaks the cdktf-cli release bundle #2302

chore

chore: document authoring cdktf constructs #2287

0.14.0

Breaking changes Back in October, we announced significant performance improvements with CDKTF version 0.13. These improvements required breaking changes for which we provided backward-compatible provider bindings in version 0.13. As announced, the 0.12 (non-namespaced) provider bindings will no longer work starting with CDKTF 0.14. Refer to the upgrade guide for 0.13 to learn how to update your imports for these changes.

feat

feat(cli): add provider upgrade command #2202
feat(cli): Add option to select providers to add with init #2184
feat(cli): only re-generate provider bindings on get if necessary #2266
feat(lib): expose operators on their own API class #2292
feat(lib): Introduce Token.nullValue() that allows to pass null to Terraform configurations in languages other than TypeScript #2284
feat(cli): Automatically Update Locked Providers #2020
feat(lib): Added testing matchers for Providers #2154
feat(lib): adds failed process output to test matcher APIs #1953 #2196

fix

fix(cli): do not check for version when DISABLE_VERSION_CHECK #2257
fix(docs): fix module code example #2256
fix(docs): fix links to pre-built provider repositories #2264
fix(docs): fix a couple of typos in stacks.mdx #2269
fix(examples): fix CI for Python examples #2291
fix: set global flag to be able to start search for code blocks at an index #2274

chore

chore(docs): Add CDK for Terraform to page titles #2278
chore: document Python hash error in local development #2272
chore: document JSII debug flags in contribution guide #2271
chore: update LICENSE #2268
chore(cli): Prevent minification when watching cdktf-cli #2262
chore(lib): Add deprecation notices to backends that were deprecated in Terraform v1.2.3 and removed in TF 1.3 #2261
chore: adding mgarrell777 to docs codeowners to be notified for docs changes #2259
chore: add ecs-microservices example #2252
chore: sync version and changelog from the 0.13.3 backported release #2251
chore: install pre-built provider with exact version #2249
chore: cache examples and terraform plugins #2213

0.13.3

fix

fix: Redact authorization header when error logging from TFC/TFE #2241

0.13.2

fix

fix(provider-generator): don't require arrays wrapping variable / output declarations #2199
fix(cli): Use 'id' as argument name for all templates #2119
fix(cli): use a custom user-agent when talking to TFC #2210
fix(cli): Ignore local obj/ dir in C# template #2217
fix(deps): Use apt instead of yum, since base image is debian based now #2216
fix: correctly denote all of our redirects as temporary because they might change #2218

chore

chore: Update Go to version 1.18 on windows workflows #2219
chore: Update Digital Team Files #2203
chore(cli): change url to pre-built providers to one we control #2181
chore(cli): Move things to src/ folder #2130
chore(deps): Update docker image to use new jsii/superchain tag #2214
chore(docs): rewrite internal redirects #2204

feat

feat: add CODEOWNERS file for automatic PR review assignment #2212

0.13.1

feat

feat(cli): Add support for terraform's parallelism flag #2107
feat: add redirect link to pre-built providers json file #2180
feat(cli): link to troubleshooting page for error #2192

fix

fix(provider-generator): change Static resource class to StaticResource as their namespace 'static' is not valid in TypeScript re-exports #2168
fix(cli): dont wrap list terminal output #2188
fix(cli): handle missing package versions for non-npm packages #2177
fix(docs): Fix upgrade guide imports for Python #2171
fix(docs): update old config key #2195

chore

chore: Update link to blogpost #2176

0.13.0

Breaking Changes Abbreviated version below, for a guide see Upgrade Guide for 0.13.

0.13 includes performance improvements to generated providers. Instead of exporting a flat list of exports including all supported resources and data sources, we now export each construct and it's associated structures in their own namespace. Due to this, the way you import constructs from your CDKTF application will change. For more information regarding this release, and some of the reasonings behind the changes, please check out the version 0.13 release post.

Typescript

// Before version 0.13
import { Container, Image, DockerProvider } from "@ckdtf/provider-docker";

// Version 0.13
import { Image } from "@cdktf/provider-docker/lib/image";
import { DockerProvider } from "@cdktf/provider-docker/lib/provider";
import { Container } from "@cdktf/provider-docker/lib/container";

Python

# Before version 0.13
from cdktf_cdktf_provider_kubernetes.kubernetes import Namespace, Service, Deployment, KubernetesProvider

# Version 0.13
from cdktf_cdktf_provider_kubernetes.kubernetes.provider import KubernetesProvider
from cdktf_cdktf_provider_kubernetes.kubernetes.namespace import Namespace
from cdktf_cdktf_provider_kubernetes.kubernetes.deployment import Deployment
from cdktf_cdktf_provider_kubernetes.kubernetes.service import Service

Go

Note: For Go projects, another important thing to note is that we've also moved our pre-built providers to the cdktf Github Organization. You can find more about that change here.

// Before version 0.13
import (
  "github.com/cdktf/cdktf-provider-azurerm-go/azurerm"
)

// Version 0.13
import (
  azurermprovider "github.com/cdktf/cdktf-provider-azurerm-go/azurerm/provider"
  "github.com/cdktf/cdktf-provider-azurerm-go/azurerm/networkinterface"
)

Java

// Before version 0.13
import com.hashicorp.cdktf.providers.google.ComputeInstance;
import com.hashicorp.cdktf.providers.google.GoogleProvider;

// Version 0.13
import com.hashicorp.cdktf.providers.google.compute_instance.ComputeInstance;
import com.hashicorp.cdktf.providers.google.provider.GoogleProvider;

C#

// Before version 0.13
using azurerm;

// Version 0.13
using azurerm.Provider;
using azurerm.VirtualNetwork;

feat

feat(provider-generator): namespace every resource / data source / provider #2087
feat(provider-generator): Move generated files into their own directories #2153

fix

fix(docs): Fix Aspects example #2152

chore

chore: update documentation for version 0.13 release #2156
chore: Upgrade guide for 0.13 #2155
chore: Add version 0.13 upgrade guide to releases page #2161
chore: Add redirect to incoming github issue #2159

0.12.3

Breaking Changes

A very minor change in the UX of the cdktf get command now generates the provider bindings for all languages (except TypeScript) in parallel. This speeds up the process in general, but on devices with limited memory it could lead to Out of Memory errors. If this happens you can limit the parallelism by providing the parallelism flag: cdktf get --parallelism=1.

fix

fix(provider-generator): Add special case in case resource is named 'object' #2138
fix(docs): Fix two small bugs in the code causing it to not compile #2128
fix(lib): Add missing config options for AzurermBackend #2127
fix(cli): Update require package in template #2118
fix: Change url of pipenv in log #2117
fix(cli): support using remote execution in Terraform Cloud with up to 500 MB (instead of 10MB) #2108
fix(docs): remove empty code block #2102
fix: update constructs and go runtime versions #2096
fix(cli): add sentry DSN in build process #2085
fix(docs): fix wrong command mentioned in TFC docs #2083
fix: let create changelog script use commit hashes from PRs instead of finding merge commit messages that may not always exist #2068

feat

feat(cli): include language used in cdktf init telemetry event #2123
feat(cli): support generating provider bindings in parallel #2111

chore

chore(cli): Use the npm package's repository field for generating go package name #2145
chore: npm-check-updates && yarn upgrade #2142
chore: split up unit tests per package #2122
chore: Update diagram with new provider count #2104
chore: change YT link to cut version #2103
chore(cli): Don't trim output for unstructured logs #2100
chore: only run expensive tasks on source code changes #2099
chore: Support building with Go 1.19 #2098
chore: fix go azure example #2092
chore: fix the project board TS errors #2091
chore: npm-check-updates && yarn upgrade #2090
chore: npm-check-updates && yarn upgrade #2077
chore(examples): clean up examples #2069
chore(docs): Check whether links work :) #2063
chore: ensure we have license header #1960
chore: measure and print memory consumption of build and synth steps for examples in CI #2060
chore: start running tests against TF 1.2.8 and drop running against 1.0.7 #2058

0.12.2

Breaking Changes

A very minor change in the interface names for provisioners occured to support them in JSII languages, renaming the following interfaces:

ISSHProvisionerConnection to SSHProvisionerConnection
IWinrmProvisionerConnection to WinrmProvisionerConnection
IFileProvisioner to FileProvisioner
ILocalExecProvisioner to LocalExecProvisioner
IRemoteExecProvisioner to RemoteExecProvisioner

Another very minor change is that we now use the CloudBackend by default when running cdktf init. This requires Terraform >=1.1, therefore an error is thrown on cdktf init if you want to use Terraform Cloud and are on an older version. Already existing projects are not affected and you can use cdktf init --local and configure the RemoteBackend if you need to use an older version.

feat

feat(cli): throw an error if a user tries to create a new project with TFC on an old TF version #2062
feat: install time tool in Docker container to be able to use it for memory consumption tracking in tests #2059
feat: add Go port of TypeScript Google CloudRun example #2035
feat(lib): add support for cloud backend #1924

fix

fix(provider-generator): use terraform get instead of init to download modules #2057
fix(lib): Add missing config options for S3Backend: skipRegionValidation, assumeRolePolicyArns, assumeRoleTags, and assumeRoleTransitiveTagKeys #2050
fix: support provisioners in JSII languages #2042
fix(hcl2json): add fs-extra to dependencies #2040
fix(lib): Improve error message when provider constructs are missing #2039
fix(cli): Make provider add command case insensitive for provider names #2038
fix(cli): run a speculative plan on diff #2033

chore

chore(cli): remove red and magenta from colors for stack names #2064
chore: add link to hybrid module talk #2054
chore: make Terraform 1.2.8 available in Docker image #2051
chore: document updating the API documentation #2046
chore(docs): Remove positional language + fix style nits #2045
chore(lib): deprecate Resource in favor of Construct #2044
chore: update links in our youtube playlist examples #2043
chore: npm-check-updates && yarn upgrade #2025
chore: translate parts of the documentation #2011

refactor

refactor: port example script to JS #2047

0.12.1

fix

fix(cli): add major versions greater 1 to package name when installing pre-built providers for go #2002
fix(cli): Wait for other stacks to complete if one of them failed #1987
fix(cli): fix version detection for Java being a bit too optimistic about the package name #1995
fix(cli): Improve wording around starting from an existing Terraform project #1985
fix(tests): force local as Go now has pre-built providers #2005
fix(tests): as predicted, the test needs to be skipped for a bit of time #2004
fix(docs): fix aspects example not being valid TypeScript #1986
fix(docs): fix links by removing all links to the providers-and-resources page that does not exist anymore #2010
fix: don't lock state in tests #1990
fix: don't overwrite all NODE_OPTIONS #2009

chore

chore: add vercel config for cdk.tf redirects page #2016
chore: add notes for how to clean the local dotnet cache #2022
chore: add issue template for filing bugs with a pre-built providers label #1983
chore: npm-check-updates && yarn upgrade #1984
chore: npm-check-updates && yarn upgrade #2007

0.12.0

Breaking Changes

`cdktf get` exits with 0 exit code when no provider / module specifications are found in the `cdktf.json`

Previously we would throw an error and exit with 1 if there were no provider or module specifications in the cdktf.json file. This can be inconvenient if cdktf get is part of a workflow.

`Fn.merge` is split into `Fn.mergeLists` and `Fn.mergeMaps`

The Terraform merge function can merge both lists and maps, but this can cause issues when using the result in a typed language. Therefore we split it into Fn.mergeLists and Fn.mergeMaps, this means you need to change your cdktf programs code.

Simplified interfaces of recursive attributes

The generated provider bindings are based on the Terraform schema which does not support recursion and hence uses a large, explicit structure instead. Previously this resulted in long names such as e.g. Wafv2WebAclRuleStatementAndStatementStatementOrStatementStatementLabelMatchStatement. In 0.12 we implemented a first rough detection for this underlying recursion which drastically reduced the amount of generated interfaces as they now are converted to recursive data structures themselves. If you are currently using those types e.g. in a language like Java, you will need to change them to the new shorter names.

feat

feat(lib): Introduce Iterator and for_each to implement apply time iteration #1830
feat(lib): Introduce TerraformDynamicBlock to enable iterator usage on blocks #1882
feat(cli): support refresh only option for diff and deploy #1851
feat(docs): Add iterator docs page #1840
feat(docs): document FORCE_COLOR env var that allows disabling colored output #1917
feat(cli): plug provider add command in help printed after initializing a new cdktf project #1833
feat(lib): exposed testing matchers for other languages properly #1935

fix

fix: Allow "all" as ignoreChanges lifecycle value #1848
fix: Fixed naming collision between resources of different providers #1870
fix: Small fix to the CONTRIBUTING.md #1887
fix(cli): increase default max memory for node process when running app command for synth #1915
fix(provider-generator): Meta arguments available for generated modules #1880
fix(provider-generator): replace dashes with underscores in module names for Go when generating bindings for Terraform modules #1928
fix(hcl2json): bundle wasm_exec used for building Go instead of looking for it at runtime #1954
fix(hcl2cdk): use the same attribute renaming function as in the provider generation #1842
fix(hcl2cdk): maps should not be wrapped in arrays #1838

chore

chore: document CI flag #1888
chore: modernize example output #1914
chore: pin provider version #1896
chore: update prerequisites #1894
chore(tests): Re-enable Windows Provider Add C# Test #1879
chore: add tfe test as pre-step to releasing #1872
chore: split provider tests into one test per provider #1862
chore: reuse integration test definition for releases #1859
chore: fix broken link in readme #1845
chore: npm-check-updates && yarn upgrade #1706

0.11.2

feat

feat(cli): support custom Terraform Enterprise instances #1857
feat(hcl2json): expose hcl expression parser #1794

chore

chore: synthesize all boolean as iresolvable tests #1849
chore(docs): Fix Environment Variables and Best Practices #1839

0.11.1

fix

fix(cli): Fix package version check on Windows #1831
fix(docs): fix code blocks in "create and deploy" documentation #1826
fix(release): update changelog #1824

chore

chore(cli): filter usage errors from error reporting #1828
chore: document debug command #1812
chore: add best practice page #1790

0.11.0

Breaking Changes

Abbreviated version below, for a guide see Upgrade Guide for 0.11

`TF_VAR_` prefixed environment variables can no longer be accessed at synth time

These environment variables will now be filtered out in the synth phase since they are only intended to be used during diff (plan) and deploy (apply) phases to supply values for TerraformVariables. This inhibits accidentally inlining those values into the generated cdk.tf.json config.

Environment variable and CLI option changes

DEBUG is replaced by setting CDKTF_LOG_LEVEL=debug, setting the CDKTF_LOG_LEVEL to debug will now also behave like DEBUG=1 and include logs from the provider generation
CDKTF_DISABLE_LOGGING=false is replaced by setting CDKTF_LOG_FILE_DIRECTORY=/path/to/logs/directory. If left empty no logs will be written.
--disable-logging was removed, instead use the environment variable CDKTF_LOG_LEVEL=off
DISABLE_VERSION_CHECK, CDKTF_DISABLE_PLUGIN_CACHE_ENV need to be set to true or 1, before anything worked.

Stack ids can no longer contain whitespaces

A TerraformStack may no longer contain whitespace characters, since we rely on paths being whitespace free. If you have a stack with an id containing a whitespace, please replace it with a hyphen. If the stack was already deployed with the default LocalBackend you might need to rename your statefile to match the new stack id.

Computed Map References are referenced through getter

For computed maps, the reference is now through a getter.

To access { property = "value" }, instead of resource.mapAttribute("property") you can now use resource.mapAttribute.lookup("property").

Use ComplexLists and ComplexMaps for complex assignable properties #1725

Assignable properties of the form Object[] or { [key: string]: Object } no longer have setters; they instead have putX methods. The getter return type is also changed to be a derivative of either ComplexList or ComplexMap.

fix

fix(docs): Make sure code example works #1807
fix(lib): Delay complex object fqn so that override id can still be used #1793
fix(provider-generator): strictly adhere to the provider schema #1792
fix: Avoid unstable fqn for TerraformElements #1779
fix(cli): Respect CDKTF_HOME environment variable for checkpoint telemetry #1778
fix(docs): remove outdated docs from the previous watch implementation #1768
fix(cli): throw an error if a stack contains a whitespace #1750

feat

feat(lib): add docstrings to gcs/http/local backend resources #1803
feat(lib): add a warning about id fields #1802
feat(docs): add guidance around secrets and warn that those values might be inlined in the generated Terraform config #1801
feat(lib): add docstrings to cos/etcd/etcdv3 backend resources #1783
feat(lib): add docstrings to artifactory/azurerm/consul backend resources #1781
feat(lib): add docstrings to S3 backend resource #1780
feat(release): support running releases on backport-release branches besides only on main #1770
feat(cli): add cdktf provider add command #1761
feat(provider-generator): Use ComplexList for any complex list #1725

test

test(lib): ensure list mapper does not fail when passed IResolvables #1791

chore

chore: group needs to be prefixed per type #1813
chore: limit CI concurrency to the latest pushed commits #1810
chore(cli): add sentry error reporting #1809
chore: document computed map reference documentation #1775
chore(release): Update changelog to contain backported release for 0.10.4 #1773
chore(docs): document how to debug cdktf programs #1758

0.10.4

fix

fix(cli): Stop pinning jest in TS init template #1769

0.10.3

feat

feat(provider-generator): emit a versions.json file to the output directory, containing the used provider versions #1749
feat(cli): debug command #1731

chore

chore(cli): add environment variable to disable version checks #1757
chore: drop Terraform v0.15.7 from Docker image and replace with v1.1.9 for running tests #1747
chore: add Terraform v1.1.9 to Docker image #1743
chore(docs): update env var usage #1693

fix

fix(lib): Add new optional AWS route attributes #1755
fix(cli): handle version check more defensively #1753
fix(cli): we should not send wait for approval if a stop has been issued #1740
fix(cli): Fix indentation of RemoteBackend in CSharp and Java template #1733
fix(cli): fix templates to properly indent cdktf.json and add RemoteBackend in TS template #1732

0.10.2

fix

fix(tests): pin awscc version #1727
fix(cli): return non-zero exit code in case of error when using cdktf diff #1726
fix(cli): allow init command to run in a directory containing a README.md #1722
fix(provider-generator): Include "arn" when assignable #1716
fix(hcl2cdk): detect list extensions in strings and wrap them in an array #1707
fix(lib): override values containing intrinsic tokens caused an infinite loop #1702
fix(lib): contextualize error messages in terraform functions #1699
fix(cli): fix path for .terraform directory #1694
fix(cli): improve cli error handling #1687

chore

chore: align versions to an unpublished version #1718
chore(docs): update convert docs #1701
chore(docs): update aspect docs #1690
chore: npm-check-updates && yarn upgrade #1683

test

test(hcl2cdk): add test case for property renaming #1709

feat

feat(cli): warn users about misaligned CLI and library versions #1700
feat(lib): improve error messages around misused list mutation #1691

0.10.1

fix

fix(cli): fix convert single blocks as array bug #1680
fix(cli): Only print error that's thrown #1678

refactor

refactor(tests): move from table driven tests to functional way #1679
refactor(cli): remove xstate as state machine #1670

chore

chore(docs): update project maturity statement #1676
chore(docs): add sidebar link #1674
chore: add extra column for PRs outside our main repo #1673

feat

feat(cli): support HTTP_PROXY for Terraform Cloud #1507

0.10.0

Breaking Changes

Remove `cdktf synth --json` Option #1640

If you are using cdktf synth --json <stack-name> to get the synthesized JSON configuration for your Stack, you will now need to run cdktf synth && cat ./cdktf.out/stacks/<stack-name>/cdk.tf.json instead. The ./cdktf.out part is your output directory (set by cdktf.json or via the --output flag).

Model ComplexComputedLists as ComplexLists and ComputedObjects #1499

In an effort to streamline the interfaces of resources, computed attributes of the type list and set are now modeled as a separate ComplexList type instead of being a method that directly takes an index and returns an item. This change also did change the type of the index from string to number.

Typescript

// previously
const firstItemId = resource.listAttribute("0").id;

// new
const firstItemId = resource.listAttribute.get(0).id;
const firstItem = resource.listAttribute.get(0); // now possible

Python

# previously
first_item_id = resource.list_attribute("0").id;

# new
first_item_id = resource.list_attribute.get(0).id;
first_item = resource.list_attribute.get(0); # now possible

CSharp

// previously
string firstItemId = resource.ListAttribute("0").Id;

// new
string firstItemId = resource.ListAttribute.Get(0).Id;
ListAttributeItem firstItem = resource.ListAttribute.Get(0); // now possible

Java

// previously
String firstItemId = resource.listAttribute("0").getId();

// new
String firstItemId = resource.getListAttribute().get(0).getId();
ListAttributeItem firstItem = resource.getListAttribute().get(0); // now possible

Go

// previously
firstItemId := resource.ListAttribute(jsii.String("0")).Id();

// new
firstItemId := resource.ListAttribute().Get(jsii.Number(0)).Id();
firstItem := resource.ListAttribute().Get(jsii.Number(0)); // now possible

Referencing computed string map entries via function call #1630

In preparation for a similar change as to the computed lists (section above), string map entries can now be accessed via a function call instead of using Fn.lookup. Accessing the whole map at once now requires a different function call in the meantime.

Example

const bucket = new s3.S3Bucket(this, "bucket");

// previously
const firstRuleStage = Fn.lookup(
  bucket.lifecycleRule("0").tags,
  "stage",
  "no-stage"
);
const firstRuleTags = bucket.lifecycleRule("0").tags;

// new
const firstRuleStage = bucket.lifecycleRule.get(0).tags("stage"); // tags is now a function
const firstRuleTags = bucket.lifecycleRule
  .get(0)
  .interpolationForAttribute("tags"); // will be improved in a future iteration

feat

feat(cli): rewrite watch using explicit file globs #1658
feat(cli): stop TFC plans when we discard / stop / ctrl-c #1650
feat(cli): throw clearer error if --from-terraform-project misses an arg #1646
feat(cli): enhance logs with path to construct #1635
feat(cli): match multiple stacks with patterns #1634
feat(cli): allow multiple stacks in the output command #1633
feat(cli): Support nested_type in generator #1630
feat(cli): check whether an existing token is still valid when running login command #1627
feat(cli): parallelize cdktf deploy/destroy #1625
feat(cli): handle dismissing a single stack vs stopping all stacks #1621
feat(lib): Support impersonate_service_account and _delegate on gcs backend #1615
feat(cli): serial multi-stack deploys #1609
feat(cli): properly shutdown subprocesses on abort #1605
feat: stream terraform output on diff, deploy, and destroy #1596
feat(lib): update attributes['//'] instead of assigning to it #1543
feat(provider-generator): allow tfResourceType to be narrowly typed #1535
feat: Model ComplexComputedLists as ComplexLists and ComputedObjects #1499

fix

fix(readme): update links to getting started guides #1664
fix: ignore vercel for PRs as it currently fails on branches of forks #1649
fix(docs): improve documentation of module map inputs #1647
fix: fix snapshot tests #1636
fix(cli): parse JSON log lines if possible #1617
fix(cli): fix go template stack name replacing for Terraform Cloud #1598
fix: Support Auto Updating Snapshots for forks #1595
fix(examples): update eks python example #1400

chore

chore(docs): sync up changelog and upgrade guide #1671
chore(docs): update cross stack ref docs for multi-stack deployment story #1665
chore: npm-check-updates && yarn upgrade #1663
chore(cli): remove deploying resource overview #1648
chore(docs): Update README and remove old files #1643
chore(cli): remove json flag from synth #1640
chore: disable watch test #1638
chore: use distinct GitHub token to push changes #1623
chore: npm-check-updates && yarn upgrade #1622
chore: npm-check-updates && yarn upgrade #1614
chore(docs): add vercel config #1611
chore(docs): Update page title and description #1603
chore: npm-check-updates && yarn upgrade #1600
chore(docs): Remove broken link on overview page #1594
chore(provider-generator): Include Provider Version in Generated Bindings #1586
chore(cli): remove date-fns dependency #1492

refactor

refactor: separate logic from UI layer #1511

0.9.4

fix

fix(lib): check for null objects and don't try to reverse undefined or null #1592

chore

chore(cli): fix typo in test assertion #1591

0.9.3

feat

feat(examples): Add Scaleway Golang example #1576

fix

fix(cli): convert failed with a single provider passed #1588
fix(tests): Windows needs special docker host override to work #1567

0.9.2

fix

fix: cross-stack references in terraform cloud remote execution mode #1574

chore

chore: npm-check-updates && yarn upgrade #1579
chore: npm-check-updates && yarn upgrade #1565

0.9.1

feat

feat(cli): show help when no command is passed #1540

fix

fix(tests): run package before running unit tests in release pipelines #1563
fix(hcl2cdk): handle no providers passed and add cdktf import for remote state data sources #1561
fix(cli): Fix template for Go not adding jsii import when using Terraform Cloud #1556
fix(lib): Add missing regex Function #1531
fix(cli): add better messaging on inint #1524
fix(docs): fix a typo in serverless-application-typescript.md #1517
fix(provider-generator): Replace jsii incompatible names #1516
fix(provider-generator): don't build generated edge provider output as part of building the provider-generator #1509
fix(tests): add --ci flag to jest invocations when in CI #1498
fix: stringValue rated valid strings as unescaped double quotes #1566
chore(deps): upgrade jsii (substantially improves cdktf get performance for Go) #1558
fix(cli): reflect correct node version requirement #1573

chore

chore(docs): we now support cross stack refs, the section is no longer needed #1571
chore(docs): remove old docs files #1542
chore(docs): Update main from stable-website #1529
chore(docs): remove old layouts folder #1522
chore(docs): Merge stable-website into main #1515
chore(docs): add 0.9 upgrade guide #1512

test

test(hcl2cdk): check if produced code can generate HCL #1539

0.9.0

Breaking Changes

Standardize IResolvable Usage #1299

This is an effort to make sure attributes can be freely passed between resources for all different types.

There is a minor breaking change:

count on resources and data sources has gone from number | cdktf.IResolvable to number. If code was previously passing an IResolvable, it will now need to use Token.asNumber()

Map Tokens #1411

As part of an effort to use more native types, there are now tokens for maps of primitive values.

As a result, there is a minor breaking change:

Map attributes have gone from { [key: string]: TYPE } | cdktf.IResolvable to { [key: string]:TYPE } when TYPE is string, number, or boolean.
- The most common impact is maps created by using Terraform functions (Fn.(...)) will now need to be passed to Token.as<String/Number/Boolean>Map() before assigning to a resource attribute.

Number[] Tokens #1471

As part of an effort to use more native types, there are now tokens for number[]. This is mostly an internal change, but there is now Token.asNumberList() which can be used to convert other values into number[].

As a result of some standardization, there is a minor breaking change:

Boolean[] attributes have gone from boolean[] to Array<boolean | IResolvable> | IResolvable.
- This is done because neither boolean or boolean[] is representable by a token.
- This should make it easier to pass around boolean[] between resources and fuctions.
- For jsii languages (especially Java and C#), these types will end up as List<Object>.

feat

feat(cli): output command #1495
feat(lib): cross-stack references #1416
feat(lib): cross stack references other backends #1488
feat(lib): Allow relative assets #1346
feat(lib): Create assets for local modules #1476
feat(lib): number[] Tokens #1471
feat(lib): produce stable cdk.tf.json output #1454
feat(lib): Initial improvements for set support #1415
feat(lib): Map Tokens #1411
feat(provider-generator): reference computed values nested in lists #1468
feat(tests): add test which confirms that modules now support sets #1497

fix

fix(cli): speed up shell autocompletions #1496
fix(cli): remove deprecated -state option #1461
fix(lib): resolve objects correctly in cross stack references #1487
fix(docs): fix typo #1387
fix: increase memory for integration:update command #1490

chore

chore(examples): Added go/azurerm examples #1275
chore(lib): Standardize IResolvable usage #1299
chore(docs): document pinning state to stack #1504
chore(docs): link to AWS Constructs base class #1473
chore(docs): Final Docs Migration Cleanup #1431
chore(docs): Manual windows testing #1407
chore: migrate docs to mdx #1421
chore: store website nav files #1434
chore: update example for azure app service #1484
chore: add tooling for an automated issue dashboard #1474
chore: decrease update speed of the project board #1485
chore: npm-check-updates && yarn upgrade #1477
chore: npm-check-updates && yarn upgrade #1489
chore: npm-check-updates && yarn upgrade #1503
chore: remove patch file created through update automation #1491

0.8.6

fix

fix(lib): don't treat strings as maps #1467
fix: update specified nodejs version to >=14.0 to reflect our actual requirements #1466

Other

chore: fix constructs error #1460

0.8.5

fix

fix(provider-generator): rename String resource #1455

chore

chore(hcl2cdk): update readme #1452
chore(examples): Upgrade aws provider version for Go example #1450
chore: update maven config for publishing #1457
chore: update constructs to 10.0.25 #1453

0.8.4

fix

fix(provider-generator): remove .html suffix for doc links #1438
fix: Update Remote State Outputs documentation #1436

feat

feat(lib): Add nullable field to terraform variables #1435

chore

chore: update constructs to 10.0.20 #1444
chore: store website nav files (main) #1434
chore: add make website command to preview docs website #1426

0.8.3

fix

fix(provider-generator): rename system attributes as they conflict in CSharp (fixes Okta provider) #1422
fix(docs): fix order of changelog steps to make sure version is bumped after running script #1419

chore

chore: migrate docs to mdx #1421
chore: fix edge provider tests in pre-release pipeline #1423

0.8.2

fix

fix(lib): make sure to resolve reference expression target #1412
fix(provider-generator): Fix false block attributes #1405
fix(lib): inline references in strings should not destroy string itself #1401
fix: data can be null in some cases as well #1395

chore

chore(docs): Adds a REAMDE to docs folder #1381
chore: update constructs to 10.0.12 #1414
chore: copy edge provider on release pipeline #1408

test

test(provider-generator): verify generated provider emit same HCL across languages #1311

0.8.1 (December 3, 2021)

fix

fix(cli): Distribute unbundled source code #1379
fix(lib): Add struct sharding for providers without namespaces #1375
fix(cli): only log if logs are sent #1365
fix(lib): Keep specified empty objects #1329

chore

chore(cli): typescript init prints link to all prebuilt providers #1348

0.8.0 (December 1, 2021)

Breaking Changes

Namespaced AWS Provider Resources #1248

We iterated on the namespacing for the AWS provider which got introduced in #1101. Our goal was, to enable custom L2 / L3 abstractions being built with jsii, improve the general jsii support for the namespacing and last but not least to allow both namespace and barrel imports in Typescript. A welcome side effect is a 5x performance gain when building packages via jsii for Python (from ~ 16 minutes to ~ 3 minutes) and likely other targets such as Java or C#

As a result, there are a few minor breaking changes:

Namespaces are all lowercased now, without a separating character
Namespaces are all a single word now (e.g. DynamoDb used to be dynamo_db in Python - it's now just dynamodb)
CloudwatchEventBridge namespace got renamed to eventbridge

Typescript Example

Before

This was pretty much the only way to use the namespaced provider classes.

import { CloudFront } from "@cdktf/provider-aws";

new CloudFront.CloudfrontDistribution(this, "cloudfront", {});

After

Now it's possible to either import the entire namespace, or a resource class directly.

// Similar to before, but namespace is lowercased
import { cloudfront } from "@cdktf/provider-aws";

new cloudfront.CloudfrontDistribution(this, "cloudfront", {});

// new option
import { CloudfrontDistribution } from "@cdktf/provider-aws/lib/cloudfront";

new CloudfrontDistribution(this, "cloudfront", {});

See this Pull Request for more details.

Other Changes

fix

fix(provider-generator): Fix private registry module generation #1361
fix(lib): Fix incorrect parseInt casing #1359
fix(lib): fix documentation link for lookup #1347
fix(provider-generator): Mutating complex objects #1331
fix(provider-generator): attributes on resources should not be undefined #1310
fix(examples): Make sure we're using pipenv #1272
fix(lib): Increased --max-old-space-size value #1265
fix(examples): temporarily set fixed AWS provider version for Java #1261
fix(cli): fix bug that required cdktf.json in parent directory when running convert #1256
fix(provider-generator): escape hyphens in provider names for Go package identifiers #1252
fix(lib): Rework AWS Provider Namespacing #1248
fix(lib): escape newlines in terraform functions #1233
fix(lib): Also separate Token Map and symbols for interoperability with AWS CDK Tokens #1176
fix(release): only include prs since last version in the changelog #1171

chore

chore(docs): Fix broken anchor links #1345
chore(docs): link and layout fixes #1344
chore(docs): document list escape hatches #1342
chore(tests): remove jsii version from snapshot #1341
chore(docs): Add constructs documentation to website #1338
chore(deps): upgrade jsii versions and unpin AWS TF provider version for Java example #1336
chore(docs): Move examples up in sidebar, list out tutorials #1291
chore(deps): yarn upgrade #1283
chore(cli): upgrade React version #1259
chore(release): Pre-releases should use next version #1257
chore(docs): Fix docs nits like images, headings, and contractions #1245
chore(deps): remove obsolete dependency json-schema-to-typescript #1232
chore(deps): fix dependabot config #1220
chore(deps): re-enable dependabot #1219
chore(docs): document escape hatch for dynamic blocks #1215
chore(docs): copy over aspects #1214
chore(docs): revert link change #1177
chore(docs): Laura fix docs nits #1172
chore(examples): Use AWS provider 3.0 #1155

Other

chore: add website release automation #1255
fix: Fix EC2 Instance creation example #1254
fix: Minor typo in error message about missing providers #1240

feat

feat(cli): use ts-node to compile main.ts #1253
feat(docs): add link to new deploy apps tutorial #1236
feat(lib): Add staticId option to TerraformOutput (uses construct id as synthesized output name)" #1213
feat(lib): throw error when a token is used in a construct name #1181
feat(hcl2cdk): document providers with missing type information #1174
feat(lib): Expand Output value types #1145

test

test(cli): test generated providers #1235
test(lib): ensure assets dont redeploy without FS changes #1178

0.7.0 (October 19, 2021)

Breaking Changes

Abbreviated version below, for a guide see Upgrade Guide for 0.7

Namespaced AWS Provider Resources #572

The AWS Provider has a size that makes it hard to navigate in editors, especially in languages that compile it to a single file like Python. We implemented namespaces that hold Resources and Data Sources the same category together, the categories can be found on the AWS Provider page. If you don't use the AWS provider no action is needed, if you do you need to adjust your import statements to match the namespaces. You can find more information at the upgrade guide.

Simplify Provider API Surface #258

When generating the provider bindings we previously translated any block to an array of a certain type, both in configuration and as properties on the resource / data source instances. For blocks that can only appear once at most this is making the API harder to use. From this version on these blocks are going to be just the type instead of an array of a certain type. For information on how to migrate please see the upgrade guide.

Technical Preview

AWS Adapter

The AWS Adapter is a technical preview and not ready for production usage. Its API is not stable and things might break unexpectedly.

The AwsTerraformAdapter (included in the @cdktf/aws-cdk package) allows you to use Amazon Web Services Cloud Development Kit (AWS CDK) constructs in your CDK for Terraform (CDKTF) projects. Find out more in the Github repository hashicorp/aws-cdk or jump straight to the documentation.

Features

feat(docs): Aws Adapter #1149
feat(lib): change the namespace of encoded string, list and number tokens #1148
feat(docs): document the use of aspects and annotations #1144
feat(lib): invoke Aspects when using Testing.synth and Testing.synthScope #1143
feat(cli): namespace aws provider #1101
feat(docs): add telemetry docs #1071
feat(examples): add example azure service bus #1063
feat(hcl2cdk): Copy local modules when init from TF project #1024
feat(lib): use objects instead of objects in arrays if possible #935
feat: Extend support for Terraform expressions #1131

Fixed Bugs

fix(docs): fix missing backticks #1167
fix(lib): Lock jsii version #1166
fix(provider-generator): rename lambda namespace in lambda functions #1154
fix(docs): fix typo in remote templates docs #1151
fix(examples): fix path to setup.js file in jest config #1147
fix(hcl2cdk): Convert null provider #1142
fix(docs): fix example for integration test #1129
fix(tests): quote lerna scope to prevent shell expansion #1121
fix(hcl2cdk): Always using module binding for convert command #1120
fix(hcl2cdk): Fix duplicate modules #1025

Refactoring

refactor(cli): replace links with redirects #1138

Documentation

chore(docs): Fix link to outputs doc #1164
chore(docs): Fixes broken links #1163
chore(docs): Update docs link #1162
chore(docs): Fix docs links #1161
chore(docs): reference interoperability layer #1160
chore(docs): add new namespaces #1159
chore(docs): review cli reference #1158
chore(docs): remove adapter part #1157
chore(docs): improve release script to not require manual pr selection #1156
chore(docs): Proofreading edits #1150
chore(docs): Terraform Docs #1146
chore(docs): document numeric tokens #1140
chore(deps): add script to update all snapshot tests #1139
chore(docs): Laura architecture edits #1137
chore(docs): Merge docs content to stable website #1133
chore(docs): Laura docs todos edits #1128
chore(docs): Add note and copyediting to providers page #1127
chore(docs): Address todos #1126
chore(docs): CDK for Terraform Architecture #1112
chore(docs): Update cli configuration doc #1111
chore(docs): Autofix prettier #1110
chore(tests): Ignore website changes for test workflows #1109
chore(docs): Combine Resources and Providers pages #1092
chore(docs): Edits to Project Setup & Config file docs #1085
chore(docs): Terraform Outputs #1078
chore(docs): Adds descriptions example drafts #1073
chore(docs): improve community documentation #1066
chore(docs): What is CDKTF and Interoperability #1065
chore(docs): link docs to Pocket codebase, YouTube #1062
chore(docs): Project Setup #1056

0.6.4 (October 4, 2021)

Breaking Changes

fix(cli): Better handle non-registry modules and improved naming #929

If you use Terraform Modules you will need to adust their names. We changed the naming to be more intuitive, e.g. TerraformAwsModulesVpcAws is now Vpc. To migrate please run cdktf get with this version and change your imports to match the new abbreviated form.

Fixed Bugs

fix(cli): directly depend on cli-spinners v2.6.0 #1116
fix(cli): create .cdktf folder if needed #1107
fix(lib): check for null on removing metadata in testing framework #1075
fix: ignore build output in prettier #1077

Chores

chore(deps): bump trim-newlines from 3.0.0 to 3.0.1 #863
chore(docs): remove roadmap link from README #1067

0.6.3 (September 22, 2021)

Features

feat(hcl2cdk): Add logical id override when construct id's aren't unique #1045
feat(lib): use jest asymetric matchers & nicer error messages #1052

Fixed Bugs

fix(hcl2cdk): Correctly handle remote state #1031
fix(docs): adjust setup handling in docs #1048
fix(cli): don't create config.json files if none was present before #1054
fix(lib): fix source path generated for local modules #947
fix(docs): typo in documentation #1060
fix(lib): Fix release pipeline #1061

Chores

chore(tests): Build examples as matrix - 1 build per example #1043
chore(tests): Fix release pipeline #1050
chore(tests): Upgrade to jest 0.27 for integration tests and retry failed tests once #1051
chore(deps): bump tmpl from 1.0.4 to 1.0.5 #1055
chore: fix config for dependabot #1057

0.6.2 (September 17, 2021)

Fixed Bugs

fix(cli): replaceAll not available in node v14 #1036
fix(cli): fix import path for Manifest (was relative) #1037

Chores

chore: lint monorepo for relative imports between packages #1040
chore: remove duplicated jest interface members #1042

Documentation

feat(docs): add docs for Testing.renderConstructTree() #1029

0.6.1 (September 16, 2021)

Fixed Bugs

fix(lib): Fix testing setup #1027

0.6.0 (September 15, 2021)

Breaking Changes

Abbreviated version below, for a guide see Upgrade Guide for 0.6

Constructs upgrade (`v3` to `v10`)

The constructs package serves as the base for all building blocks of the CDKs (e.g. CDK for Terraform, AWS CDK and cdk8s). Recently the constructs package was lifted to v10 with a few but major changes. The reason behind those was to make it future proof and stable across different CDKs. In this process the API surface area of the constructs base package was reduced and some functionality has been moved directly to the AWS CDK instead. For more information and the underlying motivation for the changes to the constructs library refer to the Removal of Construct Compatibility Layer RFC.

Moved functionality

Aspects are now part of cdktf as they've been removed from constructs. If you use them, you need to change your import statement to import them from the cdktf package. The api also has changed a bit. The new way to register Aspects is Aspects.of(construct).add(aspect) instead of construct.node.applyAspect(aspect).
The construct.node.addInfo(), construct.node.addWarning() and construct.node.addError() methods are now available under the Annotations.of(construct) API: e.g. Annotations.of(construct).addWarning('my warning'). Annotations are a part of the cdktf base library.

Removed functionality

construct.onPrepare / construct.prepare() has been removed. Instead you can use Aspects.
onSynthesize has been removed. If you find yourself needing support for it, please file a new issue on this repo and describe your use-case.

Features

feat(hcl2cdk): inform about recommended variable usage #875
feat(lib): make asset paths change if asset content changes #769
feat(cli): Introduce support for shell completions #943
feat(lib): Print a hint when the app has been passed to a backend instead of the stack #945
feat(lib): expose unit testing helpers #942
feat(cli): detect and validate used node & go version #855
feat(lib): expose terraform functions #903

Documentation

chore(docs): add a first short note about how to release #864
feat(docs): document how to connect CDKTF to Terraform Cloud #874
fix(docs): update docs to be correct about outdir since multiple stacks feature #872
fix(hcl2cdk): aliased provider missed in graph #876
chore(docs): release pre-built providers #892
chore(docs): update telemetry.md for 0.6 release #1017
chore(docs): remove custom adapter section for now #1021
feat(docs): upgrade guide for v0.6 #991

Fixed Bugs

fix(lib): keysToSnakeCase needs to ignore intrinsic tokens #902
fix(lib): synthesise numbers correctly #899
fix(lib): better error for uninitialized provider #896
fix(cli): Don't specify --user flag when running in an pip activated virtualenv #912
fix(deps): check in husky hooks #919
fix(lib): Alternative Validation Approach #911
fix(cli): Don't print sensitive outputs when running deploy #940
fix(tests): enable windows test with escapes #957
fix(hcl2cdk): Fix convert with numeric count #1011
fix(lib): Module references to providers synthesizes array instead of map #933
fix(tests): disable terraform cloud test for now #955

Chores

chore(lib): speed up TS compilation #873
chore(deps): ignore tsbuildinfo #894
chore(docs): Brief reference for local provider usage #897
chore(docs): Link Python Poetry community template #922
chore(deps): bump tar from 4.4.13 to 4.4.17 #914
chore(tests): remove unused aws provider dependency to speed up test #926
chore: fix typos #927
chore(lib): BREAKING CHANGE upgrade constructs lib to v10 #921
chore(deps): Upgrade yargs to v17 #779
chore(tests): Align workflow trigger #931
chore(cli): Make sure Python dependencies are working locally #936
chore(deps): bump tar from 4.4.17 to 4.4.19 #941
chore(release): run all tests on npm test #962
chore(hcl2cdk): Provide guidance for imports #949
chore(deps): bump axios from 0.21.1 to 0.21.4 #963
refactor(lib): use the same jest config everywhere #930
feat(cli): Improve telemetry #895

0.5.0 (July 29, 2021)

New Features

feat(cli): implement hcl2cdk #796
feat(cli): add cdktf watch command #817

Documentation

chore(docs): link docker integration example #789
chore(docs): add google cloud kubernetes example #742
chore(docs): python example for gcp cloud function #776
chore(docs): Add serverless application guide #786
chore(docs): link to serverless e2e example #795
chore(docs): add examples for ucloud provider (ts/python/java/c#/go) #790
chore(docs): add azure python link #773
chore(docs): Enhance readme with Terraform Platform Illustration #778
chore(docs): Add Project Maturity section to README #797
chore(docs): Add callouts to Learn tutorials #767
chore(docs): Create BUGPROCESS.md #815
refactor(docs): clarify that we support all providers and modules #783
fix(docs): remove Csharp readme in Python for #745 #820
fix(docs): add mandatory cdktf get step #784
fix(docs): document module generation #848

Fixed Bugs

fix(cli): throw explicit error when commands are invoked outside of a cdktf project #854
fix(cli): dont compile cdktf output directory #754
fix(cli): dont upload .terraform folders #758
fix(cli): polish user interaction by switching libraries #850
fix(cli): update hint for tfstate file #756
fix(cli): parse JSON output #774
fix(hcl2cdk): exclude non-registry modules from the cdktf.json #847
fix(hcl2cdk): adjust link for label renaming #852
fix(hcl2cdk): only run get conditionally #846
fix(hcl2cdk): camelCase backend properties #862
fix(hcl2cdk): suffix variables and locals #845
fix(tests): make less assumptions about environment in config.test.ts #832
fix(lib): Add in new optional AWS route attributes #821

Chores

chore(deps): use nodejs v14 version of aws jsii/superchain image #843
chore(deps): add gcc and gcc-c++ to Dockerfile required for node-gyp #849
chore(deps): Upgrade eslint to v7 #819
chore(deps): bump ws from 7.4.2 to 7.4.6 #747
chore(deps): bump y18n from 4.0.0 to 4.0.3 #777
chore(cli): send telemetry on errors #829
chore(cli): lint tsx files and clean up React Hooks code #818
chore(cli): add prettier #793
chore(lib): track overrides and backend types in stack #830
chore(tests): Provide global PR workflow status #781

0.4.1 (June 7, 2021)

Fixed Bugs

Fix cdktf destroy - Make sure output parses only relevant parts #761
Dont error on init when log has been written #759

0.4.0 (May 27, 2021)

Implemented enhancements

Experimental Go Support #686
Add Asset Construct #698
Support sensitive variables #701
Update python templates to use RemoteBackend construct #644 & #669
UX: Explain how to specify a stack in the error message #689
Terraform Cloud: Output uses attribute name instead of id #717
Terraform Cloud: Stream resource updates #712
Add JSDoc links to Terraform Registry docs when generating providers #576

Fixed Bugs

Return non-zero exit code on unknown command and allow terraform-like command names #680
Add cdktf.log to .gitignore of built-in templates #662
Fix elasticsearch index resource #681
Fix gitignore after init #691
Deploy changes on TF output changes #687
Fix: Unable to use resources containing an argument named 'stack' #716
OCI Synth issues: "module has already exported a member" #713
Adapt to changed output format in Terraform 0.15.4 #736

0.3.0 (April 21, 2021)

Breaking Changes

We're now supporting multiple Stacks! - existing Terraform state files from local Terraform workflows have to be renamed to match the stack name.

Up until CDK for Terraform version 0.2 only a single stack was supported. For local state handling, a terraform.tfstate file in the project root folder was used. With version 0.3.0 the local state file reflects the stack name it belongs to in its file name. When a terraform.tfstate file is still present in the project root folder, it has to be renamed to match the schema terraform.<stack-name>.tfstate manually.

Implemented enhancements

Add support for remote templates #645
Handle Multiple Stacks #636

Fixed Bugs

Wait for ConfigurationVersion to be ready when using Terraform Cloud #655
Fix module variables without type #630
Fix module without newline #633
Rename instance variable to a more specific name to avoid name collisions #640
Fix multiple modules with same end name #637

0.2.2 (April 13, 2021)

Fixed Bugs

Resources containing hyphens in resource ids did not correctly display their apply status #614
Add missing handling for resource status lines #619
Print more descriptive error messages if requests to Terraform Cloud fail #623, #626, #488, #400

0.2.1 (March 29, 2021)

Fixed Bugs

Allow for module without outputs #599
Fix Python template #604
Don't treat warning lines as resources #585
Handle malformed code blocks in provider schema descriptions #605

0.2.0 (March 11, 2021)

Breaking Changes

Generated classes for modules from the registry will change - see this comment for more details
Phased out testing and support for Terraform 0.12. It's likely to still work for now, but it's not guaranteed anymore #592

Implemented enhancements:

Improve Module Support #584
Release packages to Maven Central #556
Release packages to Nuget.org #528
TerraformHclModule outputs use tokens #512
Improve C# init behaviour for Github Package Registry #497
Support for dynamic attribute type #565
Upgrade to ink v3 #559

Fixed bugs:

Correct depends on casing for modules #508
Python pip template adjustments for windows #535
Checkpoint Error Handling / Timeout #552
Inject defaults for certain attributes #479
Python-pip template fix/improvements #541
Quote cdktf path in init templates #511
Include feature flags in java template and test #471
Update jsii-srcmak to remove symlink #580
Rename null provider for java & c# #589

Chores:

Fix typo in execTerraformSynth #554
Upgrade Java exec-maven-plugin 3.0.0 #536

0.1.0 (January 14, 2021)

Implemented enhancements:

C# Support #477
Terraform Cloud support with remote execution mode #449

Fixed bugs:

Include feature flags in java template and test #471

Security Updates:

Bump ini from 1.3.5 to 1.3.8 #460
CVE-2020-7789 / GHSA-p9pc-299p-vxgp #478 / #493

0.0.19 (December 6, 2020)

Fixed bugs:

Depends on expansion #442
Make sure tokens resolved before converting to json #439
Alter reset and input names when they conflict #429
Fix complex map attribute data source reference #441
Remap 'equals' to 'equalTo' to work around jsii limitation #428
Generated custom mappings #395

0.0.18 (November 5, 2020)

Fixed bugs:

Update jsii with python docs fix #418
Maintain dependencies between required construct properties #310

Implemented enhancements:

Java support #360
Simple Terraform Locals #357
allow to use TERRAFORM_BINARY_NAME env to set terraform binary #366
Default to NPM in templates #359
Terraform version check #378
Terraform Variables #277
Terraform hcl module #375
Support for matching existing Terraform names #329

0.0.17 (September 1, 2020)

Fixed bugs:

Fix Orcale Provider #341
Run Terraform commands with input=false flag #343
Use default provider caching of Terraform, rather than creating error prone symlinks #344

Implemented enhancements:

Streamline CLI workflows for prebuilt providers #331
CLI installable via Homebrew #342
Support Terraform provider caching by default #189, #222, #349

0.0.16 (August 21, 2020)

Fixed bugs:

Fix TerraformProvider alias definition #332

Implemented enhancements:

Checkpoint telemetry integration #326
Adding cdktf version to the terraform user agent #321
Migrate to jsii-srcmak #276

0.0.15 (August 17, 2020)

Fixed bugs:

Terraform 0.13 Compatibility for 3rd Party Providers (e.g. Docker) in Python #309
Fix Naming Collision with Config interfaces #300

Implemented enhancements:

Use remote backend class for typescript template #313

0.0.14 (August 9, 2020)

Implemented enhancements:

Terraform 0.13 Compatibility #285

Security Updates:

Fix dot-prop security dependency bot alert #296

0.0.13 (July 31, 2020)

Fixed bugs:

Fix interpolation bug in complex computed list of data sources #215
Avoid conflicts with resource attributes called "node" #230
Python: setup imports dir as a package #262

Implemented enhancements:

Add support for List of Maps in schema generator #229
Add Lists of Maps #229
Bump and align Typescript / @node/types Dependencies - Upgrade lodash #252
Terraform backend config #224
Terraform data remote state #241

0.0.12 (July 18, 2020)

Fixed bugs:

cdktf init was broken on Windows #198

0.0.11 (July 15, 2020)

Implemented enhancements:

Defaults are opposite of Terraform but should default to being non-destructive #155
Version check for new cdktf cli #130
Set NODE_ENV for CLI #129
Make local state persistent #116
Improved resource name structure in Diff / Deploy / Destroy #135

Fixed bugs:

cdktf destroy errors saying stale plan #182
Migrating from local state to remote state doesn't work #168
Display Typescript Errors for Synth #161
cdktf init is broken #157
Handle stale stacks in cdktf #150
cdktf init Terraform Cloud workspace creation doesn't work #144
Case sensitive tags are incorrectly downcased #75

0.0.10 (July 7, 2020)

Bug when creating Terraform Cloud workspace via cdktf init (#144)

0.0.9 (Jul 7, 2020)

Fix cdktf init issue (#139)

0.0.8 (July 5, 2020)

Minor bug fixes and documentation for getting started guides.

0.0.7 (July 3, 2020)

Support for cdktf diff (#90)
Support for cdktf deploy (#92)
Support for cdktf destroy (#111)
Support for Terraform Cloud via cdktf login (#96)
Support for logging across the project (#100)
New UI for cdktf synth and cdktf get (#103)
Basic error handling support (#110)

There are other minor bug fixes included in the release. (#109, #122, #128).

0.0.6 (May 14, 2020)

Typescript examples and template defaults for synthesize commands to compile application (#63)
Terraform Output doesn't handle Optional Types (#83)

0.0.5 (May 13, 2020)

Document Terraform outputs and remote backend (#64)
Fix providers file workflow (#66)
Stack escape hatch (#81)

0.0.4 (May 12, 2020)

Getting started guide for Python (#73)
Change output directory to cdktf.out for Terraform configuration (#70)
Fix output directory argument for cdktf synth (#62)

0.0.3 (May 11, 2020)

Enable synthesis to Python

0.0.2-alpha.2 (May 9, 2020)

Minor output changes and updated README.md example.

0.0.2-alpha.1 (May 9, 2020)

Alpha release for Github and NPM

0.0.2 (May 8, 2020)

Initial release to GitHub and NPM.

0.0.1 (May 8, 2020)

Initial release of cdktf-cli and cdktf to Github and NPM registry.

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

0.15.0

Renaming of *Options and *Props to *Config

Notice: CDKTF 0.15 bumps minimum Terraform version to 1.2

Deprecation: We deprecate the feature flags that go into the context field of the cdktf.json

feat

fix

chore

refactor

0.14.3

fix

chore

feat

0.14.2

chore

feat

fix

refactor

0.14.1

fix

chore

0.14.0

feat

fix

chore

0.13.3

fix

0.13.2

fix

chore

feat

0.13.1

feat

fix

chore

0.13.0

Typescript

Python

Go

Java

C#

feat

fix

chore

0.12.3

fix

feat

chore

0.12.2

feat

fix

chore

refactor

0.12.1

fix

chore

0.12.0

cdktf get exits with 0 exit code when no provider / module specifications are found in the cdktf.json

Fn.merge is split into Fn.mergeLists and Fn.mergeMaps

Simplified interfaces of recursive attributes

feat

fix

chore

0.11.2

feat

chore

0.11.1

fix

chore

0.11.0

TF_VAR_ prefixed environment variables can no longer be accessed at synth time

Environment variable and CLI option changes

Stack ids can no longer contain whitespaces

Computed Map References are referenced through getter

Use ComplexLists and ComplexMaps for complex assignable properties #1725

Renaming of `Options` and `Props` to `*Config`

Deprecation: We deprecate the feature flags that go into the `context` field of the `cdktf.json`

`cdktf get` exits with 0 exit code when no provider / module specifications are found in the `cdktf.json`

`Fn.merge` is split into `Fn.mergeLists` and `Fn.mergeMaps`

`TF_VAR_` prefixed environment variables can no longer be accessed at synth time

Remove `cdktf synth --json` Option #1640