Skip to main content

Workspace Builder

The Workspace Builder tab allows you to configure advanced dependencies and detailed setups for your workspace to automate complex deployment scenarios. This visual builder provides an intuitive way to define the end-to-end Terraform workflow, including module sourcing, planning, and applying infrastructure changes.

GCP Environment Variable Example

Overview​

In Workspace Builder, you define a Run Workflow, composed of these stages:

  • Source: Specifies where Terraform modules are retrieved (e.g., Git branch or repository).
  • Plan: Generates and displays the Terraform execution plan.
  • Apply: Applies infrastructure changes automatically or manually.

These stages are connected sequentially to create a clear, repeatable deployment process.

Steps to Configure​

  1. Navigate to Workspace Details > Workspace Builder.
  2. Click any stage (Source, Plan, or Apply) to open its configuration settings.
  3. For Source:
    • Choose the source type (e.g., Git).
    • Select the repository branch (e.g., main).
    • Configure authentication if required.
  4. For Plan:
    • Set approval mode (manual or automatic).
    • Define plan behaviors such as refresh options.
  5. For Apply:
    • Choose whether applies run automatically or require approval.
  6. Use the canvas to rearrange, connect, or remove stages as needed.
  7. Click Save to store your workflow configuration.

Tip: Use manual approval in production environments to prevent unintended infrastructure changes.