[FEATURE] Cannonical Example Repo

[donovanrost]

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

[soerenmartius]

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.

[soerenmartius]

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

[soerenmartius]

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

[soerenmartius]

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