TerraConstructs

TerraConstructs is a library of classes and interfaces inspired by AWS CDK, but designed to leverage the power and flexibility of Terraform. Built using CDKTF, TerraConstructs enables developers to define cloud infrastructure using familiar object-oriented programming patterns, while taking advantage of Terraform/OpenTofu's broad provider ecosystem and efficient state management.

With TerraConstructs, you can write infrastructure as code that is intuitive, modular, and maintainable. It combines the ease of high-level constructs with the powerful capabilities of Terraform providers, offering an exceptional developer experience for defining and managing cloud resources.

Why TerraConstructs?

• Object-Oriented Constructs: Simplify infrastructure definition with reusable, high-level constructs that abstract complexity.
• Terraform Integration: Use the extensive Terraform provider ecosystem for multi-cloud and hybrid-cloud deployments.
• Inspired by AWS CDK: Enjoy similar patterns and abstractions with the flexibility to go beyond AWS.

For detailed documentation, examples, and to learn more about the project, visit our website: 👉 terraconstructs.dev

Contributing

To get started contributing to TerraConstructs:

1. Clone the Repository

   git clone https://github.com/terraconstructs/base.git
   cd base

2. Install Dependencies Ensure you have Node.js (>=18.18.0) installed along with the pnpm (9.9.0) package manager. Then run:

   pnpm install

   This will set up the workspace and install all required dependencies.

Tool versions

Correct tool versions can be controlled using mise.

# view requested config
mise ls

# install tool versions required
mise install

Integration testing

TerraConstructs are validated using gruntwork-io/terratest.

Refer to integ/ for further details.