Welcome to Terrateam

What is Terrateam?

Terrateam is open-source GitOps CI/CD for Terraform and OpenTofu that integrates with GitHub. It enables teams to manage infrastructure changes through pull requests.

With Terrateam, you can:

• Easily manage your infrastructure as code.
• Collaborate with your team.
• Automate your deployment processes.

Why Choose Terrateam?

Team Collaboration

Review infrastructure changes with intelligent locking to prevent conflicts.

Enhanced Security

Fine-grained access controls, policy enforcement, and OIDC authentication.

Ready-to-Use

Skip building custom pipelines. Terrateam handles plan storage, locks, drift detection, and more.

Multi-Environment

Manage dev, staging, and production with consistent workflows.

Terrateam Features

GitHub-Native

Terrateam is built as a GitHub app and Action, making it easy to integrate directly with your repositories.

Installation

GitOps Workflow

Manage infrastructure through pull requests, using automated plans and controlled applies.

Workflows

Enterprise Security

Terrateam uses OIDC for cloud authentication, enhancing security and minimizing credential exposure.

Security

Resource Coordination

Smart locking prevents conflicts when multiple team members work simultaneously.

Locks

Access Control

Define role-based policies to determine who can perform specific infrastructure operations.

RBAC

Custom Workflows

Automate Terraform workflows, like post-apply Slack notifications, tailored to your team’s needs.

Custom Workflows

Multi-Environment

Manage enviroments (e.g., development, staging, and production) and cloud providers.

Environments

Policy Enforcement

Integrate OPA Conftest to enforce best practices and compliance in infrastructure changes.

OPA Integration

How Terrateam Works

Terrateam brings GitOps principles to Terraform workflows, making infrastructure changes visible, reviewable, and safe.

The following steps explain how Terrateam processes your Terraform changes:

1. Create a Pull Request with Terraform Changes

   When you create a pull request containing Terraform code changes, Terrateam automatically detects the modifications.

   

2. Automatic Plan Operation

   Terrateam automatically runs terraform plan and comments the results directly in your pull request, allowing team members to review the proposed changes.

   

3. Apply When Ready

   You can apply changes either before merging or after merging.

   

Learn more about workflows

Getting Started

1. Install

   Add the Terrateam GitHub app to your repository.

   Installation Guide

2. Configure

   Configure Terrateam using the .terrateam/config.yml file in your repository.

   Configuration

3. Connect Cloud

   Set up secure OIDC authentication with your providers.

   Cloud Setup

Next Steps

Now that you have an overview of Terrateam, explore the following sections to dive deeper into specific topics:

Core Concepts

Configuration Reference

Advanced Workflows

Integrations