@cdktf/aws-cdk
v0.13.30
Published
Adapter for using AWS CDK constructs in Terraform CDK (cdktf) projects
Downloads
2,701
Readme
[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.
The AwsTerraformAdapter
uses the aws_cloudcontrolapi_resource
Terraform resource to communicate with the AWS Cloud Control API. Reference this list of supported resources for the Cloud Control API.
You need to manually map resources that the AWS Cloud Control API does not yet support to specific Terraform resources because attribute names and resource types differ between CloudFormation and Terraform. Some manual mappings are already included in the adapter. Manual mappings will become obsolete over time as AWS Cloud Control API expands its coverage. In the meantime, we are happy to accept PRs adding manual mappings for currently unsupported resources!
Requirements
The AwsTerraformAdapter
currently only supports TypeScript projects:
node
>= 18.12.0cdktf
>= 0.20.0aws-cdk-lib
>= 2.80.0constructs
>= 10.0.25
npm install @cdktf/aws-cdk
Docs
Read the docs on HashiCorp Developer.
Find auto-generated API docs for this package here.