README
¶
Terraplane
PR-driven Terraform automation with remote agents.
Website · Docs · Quickstart · Releases
Still baking
This repository is so WIP it hurts. Nothing in here is designed for public consumption, nor should it be relied on for anything other than interest. It's a project I've wanted to make for a long time, but I've yet to determine if I have the capacity to see it through.
What it is
Terraform belongs in the pull request, and the runner belongs inside your network. Terraplane keeps an Atlantis-style comment workflow (plan / apply / unlock) but splits into:
- an orchestrator — webhooks, jobs, locks, PR feedback
- agents — dial out over WebSocket and run Terraform where credentials and network access already live
Stacks live under environments in terraplane.yaml and route work to the right agent (agent on the environment, optional per-stack override). Details: Why Terraplane, How it works.
Get started
Quickstart is the path from zero to a PR plan. Everything else lives in the docs — configuration, deployment, local Make targets.
Helm:
helm install terraplane oci://ghcr.io/terraplane-org/charts/terraplane \
--version 0.2.0 \
-n terraplane --create-namespace \
-f my-values.yaml
Chart values and split-install notes: [charts/terraplane](charts/terraplane).
Acknowledgements
Terraplane would not exist without Atlantis. The PR-comment UX is intentional; the remote-agent split is where Terraplane diverges.
License
MIT. Keep the copyright and permission notice; otherwise use it however you want.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
pkg
|
|
|
agent/terraform/mock_terraform
Package mock_terraform is a generated GoMock package.
|
Package mock_terraform is a generated GoMock package. |
|
agent/workspace/mock_workspace
Package mock_workspace is a generated GoMock package.
|
Package mock_workspace is a generated GoMock package. |
|
agentsession/mock_agentsession
Package mock_agentsession is a generated GoMock package.
|
Package mock_agentsession is a generated GoMock package. |
|
log/mock_log
Package mock_log is a generated GoMock package.
|
Package mock_log is a generated GoMock package. |
|
scm/github/mock_github
Package mock_github is a generated GoMock package.
|
Package mock_github is a generated GoMock package. |
|
scm/mock_scm
Package mock_scm is a generated GoMock package.
|
Package mock_scm is a generated GoMock package. |
|
storage/repository/mock_repository
Package mock_repository is a generated GoMock package.
|
Package mock_repository is a generated GoMock package. |