Terrateam Usage Guide

Overview

Terrateam is an open-source GitOps CI/CD platform that automates Terraform and OpenTofu workflows through GitHub pull requests. It provides intelligent locking, policy enforcement, OIDC authentication, drift detection, and cost estimation.

Key Capabilities:

• Automatic plan/apply operations triggered by pull requests
• Tag-based configuration for targeting specific environments
• Fine-grained access control with team/role-based policies
• OIDC authentication for AWS and GCP (no static credentials)
• Drift detection with scheduled reconciliation
• Security scanning with Checkov and policy validation with Conftest

Prerequisites

• GitHub repository with Terraform/OpenTofu code
• Terrateam installed (GitHub App or self-hosted)
• Cloud provider credentials configured (OIDC recommended)