How to trigger runs in TFE/TFC only from the root directory using a VCS connection

Introduction

When you create a workspace using a Version Control System (VCS) workflow, you can configure the workspace to trigger runs only when changes occur in the root directory. When a change is committed to a non-root directory, HCP Terraform or Terraform Enterprise will not trigger a run.

Prerequisites

• An HCP Terraform account or a Terraform Enterprise v202209-1 or newer installation.
• A workspace connected to a VCS repository.

Procedure

Follow these steps to configure your workspace's run triggers.

1. Navigate to your desired workspace in HCP Terraform or Terraform Enterprise and go to Settings > Version Control.
2. Under Terraform Working Directory, set the path to ..
3. Under Run Triggers, select Only trigger runs when files in specified paths change.

4. In the Include text box, enter the pattern ./* and click Add pattern.

   

5. Under Pull Requests, deselect the Automatic speculative plans checkbox.

   

After saving these settings, the workspace will only trigger runs for commits that modify files in the root directory of the repository.

Additional Information

• Terraform Working Directory
• Only trigger runs when files in specified paths change
• Glob Patterns for Automatic Run Triggering