Skip to content
Terrateam

terrateam plan

Execute Terraform plan to preview infrastructure changes before applying them.

Usage

Section titled “Usage”
terrateam plan [tag-query]

Examples

Section titled “Examples”

Plan All Changes

Section titled “Plan All Changes”
terrateam plan

Target Specific Resources

Section titled “Target Specific Resources”
Terminal window
# Plan a specific directory
terrateam plan dir:staging


# Plan a specific workspace
terrateam plan workspace:production


# Plan multiple directories
terrateam plan dir:app or dir:database


# Complex tag queries
terrateam plan production and dir:us-east-1

Tag Query Support

Section titled “Tag Query Support”

The plan command supports tag queries to filter which directories to plan:

  • dir:<path> - Target specific directory
  • workspace:<name> - Target specific workspace
  • Tags can be referenced directly (e.g., production, staging)
  • Logical operators: and, or, not

Workflow Configuration

Section titled “Workflow Configuration”

The plan command executes the workflow defined in your .terrateam/config.yml. See workflow configuration for customization options.

Plan Storage

Section titled “Plan Storage”

Plan files are automatically stored for later apply operations. Configure storage options in your storage configuration.

Access Control

Section titled “Access Control”

Plan permissions can be restricted using access control.

Section titled “Related Commands”