isimahei / terraform-cdk

Define infrastructure resources using programming constructs and provision them using HashiCorp Terraform

CDK for Terraform

This experimental repository contains software which is still being developed and in the alpha testing stage. It is not ready for production use.

CDK (Cloud Development Kit) for Terraform allows developers to use familiar programming languages to define cloud infrastructure and provision it through HashiCorp Terraform.

Overview

CDK for Terraform apps are written in one of the supported programming languages and can leverage the entire ecosystem of Terraform modules and providers. The application synthesizes Terraform configuration in JSON. Terraform or the CDK for Terraform can then be used to deploy the application.

The CDK for Terraform project includes two packages:

• cdktf-cli - A CLI that allows users to run commands to initialize, import, and synthesize CDK for Terraform applications.
• cdktf - A library for defining Terraform resources using programming constructs.

The project currently supports TypeScript, Python, Java, and C#.

Getting Started

Choose a language:

• TypeScript
• Python
• Java
• C#
• Go

Examples

Typescript

• aws-prebuilt
• aws-multiple-stacks
• aws-cloudfront-proxy
• azure
• azure-app-service
• docker
• google
• google-cloudrun
• kubernetes
• vault

Backends

• azurerm
• gcs
• remote
• s3

Python

• aws
• aws-eks
• docker
• kubernetes

Java

• aws
• azure
• google
• gradle-shared-module
• kubernetes

C#

• aws
• azure
• google

Go

Please note: Support for Golang is at an experimental state. In the CDK for Terraform and in the upstream library JSII which powers the support for the supported languages.

• docker
• aws ⚠️ High memory usage: the provider generation currently needs ~6 GB of memory. Hence the maximum for Node.js is currently set to 8GB

Documentation

• Install and run a quick start tutorial at HashiCorp Learn
• Using CDK for Terraform CLI for importing Terraform modules and providers.
• Explore the CDK for Terraform CLI.
• Defining Terraform outputs.
• Using Terraform remote backend.
• Using the CDK for Terraform escape hatch.
• Using the CDK for Terraform tokens.
• Using Terraform data sources.
• Using Terraform variables.
• Synthesizing Terraform configuration using CDK for Terraform synthesize command.
• Project telemetry.
• Defining Terraform locals.
• Handling breaking changes with feature flags.
• Writing own remote templates for init.
• Using assets to transfer files into the Terraform context.

Contributing and Feedback

CDK for Terraform is an early experimental project and the development team would love your feedback to help guide the project.

• Contribute using the CONTRIBUTING.md guide.
• Ask a question on the HashiCorp Discuss using the terraform-cdk category.
• Report a bug or request a new feature.
• Browse all open issues.
• Roadmap.

Building

Clone the project repository

git clone https://github.com/hashicorp/terraform-cdk.git

Download dependencies

cd terraform-cdk/
yarn install

Build the project and packages

yarn build

Cloud Development Kit (CDK) Ecosystem

CDK for Terraform apps are structured as a tree of constructs. The language support beyond Typescript is made possible by jsii.