Skip to main content
2 min read

Key Concepts

Key Concepts

You need seven ideas to use StackGen. Each links to its full guide.

Enterprise and workspaces​

Your organization in StackGen is the enterprise. Admins split it into workspaces, one per team, product or environment boundary. A workspace holds its own appStacks, members, environment defaults, secrets and governance. See Create a workspace.

appStack​

An appStack is the infrastructure for one application or system, for example an API's database, buckets and network. You design it on the canvas, and StackGen turns it into Terraform. See appStacks.

Modules and the Module Registry​

Everything you add to an appStack is a module: a reusable Terraform module with inputs you fill in. The Module Registry holds the modules your organization approved, imported from Git or a Terraform registry, or written in the Module Editor. See Module Registry.

Generated IaC​

StackGen writes the Terraform for each appStack as you edit it. You can read it in the IaC tab, download it, push it to Git, or deploy it from StackGen. See IaC in StackGen.

Environments​

The same appStack can be deployed to several environments, such as dev and prod. Each environment has its own variable values, cloud credentials and state backend, where Terraform keeps track of what it deployed. See Environment profiles.

Policies and governance​

Policies check an appStack while you design it and before you deploy it: built-in security rules, your own OPA/Rego rules, and restrictions on which modules and Terraform versions are allowed. A governance configuration bundles policies and assigns them to workspaces. See Policies and Governance.

Roles​

Each person has a role per workspace. Admins manage the enterprise and workspaces. DevOps engineers manage modules, environments and deployments. Developers build and deploy appStacks within the guardrails. See Users and roles.

How they fit together​

  1. Admins create workspaces and assign governance.
  2. Platform teams publish approved modules and templates.
  3. Developers build appStacks from those modules.
  4. StackGen generates Terraform and checks policies as they go.
  5. Teams deploy to each environment and StackGen tracks runs, drift and compliance.

For the names used in older versions of the UI, see the Glossary.