Component 04

TFC Workspace

Manage Terraform Cloud workspaces and repository-driven runs.

Status

Available module

Deployment scope

Terraform Cloud

Example version constraint

~> 1.1

Review published versions ↗

What it deploys

The resources this component creates, and how they connect. Drag to pan, scroll to zoom.

Usage example

Inputs in, outputs out. Illustrative wiring, not a standalone deployment.

Configure the TFE provider with organization access and an existing GitHub App installation. Replace the sample organization, repository, and installation ID. Configure provider requirements and credentials in your root module; check the documentation for all required inputs and version changes.

main.tf
module "workspace" {
  source  = "pomo-studio/workspace/tfe"
  version = "~> 1.1"

  name                       = "my-app-prod"
  organization               = "example-org"
  vcs_repo                   = "pomo-studio/my-app"
  github_app_installation_id = "ghain-abc123"
}

Key inputs

  • name
  • organization
  • vcs_repo
  • github_app_installation_id
  • role_arn

Useful outputs

  • workspace_id
  • workspace_name
  • workspace_url

What you get

01

VCS-driven runs

Trigger plans and applies from your repository workflow.

02

Dynamic credentials

Use short-lived cloud credentials instead of workspace secrets.

03

Team controls

Separate plan and apply access with predictable workspace defaults.

Built with

  • Terraform Cloud
  • GitHub
  • OIDC
  • Terraform