terramate-io / terramate

Terramate CLI is an open-source Infrastructure as Code (IaC) Orchestration and Code Generation tool for Terraform, OpenTofu and Terragrunt.

Home Page:https://terramate.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

[FEATURE] Cannonical Example Repo

donovanrost opened this issue · comments

Is your feature request related to a problem? Please describe.
I have taken over a project using Terramate. I don't believe the previous engineer did it well since the blast radius is huge. I'm still trying to wrap my head around the tool while trying to refactor into smaller modules

Describe the solution you'd like
I would like a well designed sample repository that illustrates Terramates opinion on stack design

Describe alternatives you've considered
Moving off terramate and going to Terragrunt

Hi @donovanrost,

Thanks for reaching out. We're about to publish a series of new guides explaining the usage and sizing of stacks for reference architectures in AWS and Google Cloud. In general, stacks should be sized as small as possible. We would also recommend that you group infrastructure resources by business domains. Let's assume you want to deploy a network, a Kubernetes cluster and a database. Those would all belong in separate stacks, whereas the node groups of the cluster could be managed in a child stack within the Kubernetes stack. You can find an example for Google Cloud in https://github.com/terramate-io/terramate-example-code-generation

I will update this Issue once we release the new guides. BTW, you would still need to wrap your head around stack sizing and make similar decisions if you migrate to Terragrunt.

In the meantime, please feel free to join our Discord to get in touch with our team to help you directly.

Hey @donovanrost,

Just wanted to follow up and let you know that I started working on some a reference architecture in https://github.com/terramate-io/terramate-examples/tree/main/01-keep-terraform-dry. I'll complete that example and publish a guide late next week.

Have a good weekend,
Soren

Hi @donovanrost good things sometimes take a while! You can now find the reference architecture at https://github.com/terramate-io/terramate-quickstart-aws

I am gonna close the issue for now, let me know if anything else is needed!