Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/terramate-io/terramate

Terramate CLI is an open-source Infrastructure as Code (IaC) Orchestration and Code Generation tool for Terraform, OpenTofu and Terragrunt.
https://github.com/terramate-io/terramate

Last synced: 25 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/terramate-io/terramate
Owner: terramate-io
License: mpl-2.0
Created: 2021-09-29T10:33:53.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-07-25T06:16:58.000Z (4 months ago)
Last Synced: 2024-07-25T11:39:02.627Z (4 months ago)
Language: Go
Homepage: https://terramate.io
Size: 30.1 MB
Stars: 3,168
Watchers: 23
Forks: 86
Open Issues: 58
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-opentofu - Terramate - Automation, orchestration, and code generation for OpenTofu, Terraform, Kubernetes, and others. (Tools / Wrappers)
awesome-repositories - terramate-io/terramate - Terramate CLI is an open-source Infrastructure as Code (IaC) Orchestration and Code Generation tool for Terraform, OpenTofu and Terragrunt. (Go)
jimsghstars - terramate-io/terramate - Terramate CLI is an open-source Infrastructure as Code (IaC) Orchestration and Code Generation tool for Terraform, OpenTofu and Terragrunt. (Go)
awesome-tf - terramate - Tool for managing multiple Terraform stacks that comes with support for change detection and code generation (Tools / Community providers)

README

Terramate

🚀 Getting Started | 📖 Documentation | 💻 Playground

## What is Terramate CLI?

Terramate CLI is an open-source Infrastructure as Code (IaC) code generation and orchestration tool for Terraform,
OpenTofu and Terragrunt. With Terramate, you can:

(a) **Simplify complex codebases** to make your work more productive and reliable. Break down large state files with
stacks to reduce run-time and blast radius and keep them DRY with native code generation.

(b) **Automate and orchestrate Terraform, OpenTofu and Terragrunt in any CI/CD** using Pull Request automation, GitOps
blueprints, and workflow tooling with zero-config orchestration and change detection.

(c) **Provide the foundation to later leverage Terramate Cloud**, a management layer that gives you visibility, control, and actionable insights into your infra.

## Installation

With brew:

```sh
brew install terramate
```

With Go:

```sh
go install github.com/terramate-io/terramate/cmd/...@latest
```

For other installation methods, please see the [documentation](https://terramate.io/docs/cli/installation).

## Getting Started

The fastest way to get started with Terramate is our [getting started guide](https://terramate.io/docs/cli/getting-started/).

## Why simplify complex codebases?

As Terraform and OpenTofu offer no standard pattern on how to organize code efficiently, projects quickly sprawl out of
control. The consequences are ***code complexity***, ***long-running pipelines***,
***large blast radius***, ***drift***, and ***poor governance***.

Terramate CLI enables a new approach to eliminating the root cause of these consequences: using a modular and efficient
approach called Terramate Stacks. A stack is a combination of infrastructure code, state and configuration, which can be
nested to split state further.

Organizationally, a stack is a way to establish an ownership model. By consistently sizing stacks into isolated units
that your team members can quickly understand, assuming ownership of your infra becomes a lot simpler.
Terramate CLI supports Terraform, OpenTofu and Terragrunt, and can be run locally as well as in your existing VCS
(Github, Gitlab) CI/CD.

Terramate CLI is designed to work especially well with [Terramate Cloud](https://cloud.terramate.io), which provides
an IaC management layer and offers a generous free tier.

## Features

- **Orchestration:** Run any command and configurable workflows in stacks with unlimited concurrency.
- **Change Detection:** Only execute stacks that contain changes. Allows to detect changes in referenced Terraform and
OpenTofu modules as well as Terragrunt dependencies.
- **Code Generation:** Generate code such **HCL**, **JSON** and **YAML** to keep your stacks DRY (Don't repeat yourself). Comes with
support for global variables and functions.
- **Automation Blueprints:** Pre-configured GitOps workflows for GitHub, GitLab, BitBucket and Atlantis to enable Pull
Automation with plan previews in your existing CI/CD.
- **Drift Management:** Detect and reconcile drift with scheduled workflows.
- **Observability, Visibility and Insights:** Provides actionable insights and observability into your stacks, deployments,
and resources.

## Terramate Cloud

[Terramate Cloud](https://cloud.terramate.io?ref=github) provides you with the best IaC management experience possible. It helps you orchestrate your stacks
in your existing CI/CD platform, such as GitHub Actions, GitLab and Bitbucket Pipelines, so you don't need to buy yet
another CI/CD vendor.

It also provides a powerful dashboard that adds **observability** and **insights**, **deployment metrics**
(e.g., **DORA**), **notifications**, **drift management**, **asset management,** and more for your stacks to provide
the developer experience and infrastructure to build, scale and observe all your infrastructure managed with IaC.

![Terramate Cloud Dashboard](dashboard.png "Terramate Cloud Dashboard")

## Join the Community

- Join our [Discord](https://discord.gg/CyzcScEPkc)
- Contact us via email at [[email protected]](mailto:[email protected])
- Follow us on [X](https://twitter.com/terramateio)
- Follow us on [LinkedIn](https://www.linkedin.com/company/terramate-io)

## Additional Resources

- [Documentation](https://terramate.io/docs)
- [Playground](https://play.terramate.io/)
- [Getting started guide](https://terramate.io/docs/cli/getting-started/)
- [Terramate Blog](https://terramate.io/rethinking-iac/)

## Reporting Bugs, Requesting Features, or Contributing to Terramate

Want to report a bug or request a feature? Open an [issue](https://github.com/terramate-io/terramate/issues/new)

Interested in contributing to Terramate? Check out our [Contribution Guide](https://github.com/terramate-io/terramate/blob/main/CONTRIBUTING.md)

## License

See the [LICENSE](./LICENSE) file for licensing information.

## Terramate

Terramate is a [CNCF](https://landscape.cncf.io/?item=app-definition-and-development--continuous-integration-delivery--terramate)
and [Linux Foundation](https://www.linuxfoundation.org/membership/members/) silver member.

CNCF Silver Member logo