Skip to content

Adding a Workspace

Create a workspace for managing Terraform deployments. Define variables and secrets with the highest precedence over project and cloud account levels. Deploy configurations sourced from your linked Git repositories.

Prerequisites

  • An active project in CloudPie
  • Cloud account to be associated in workspace is added to project
  • Git repository containing Terraform configurations added to Project
  • User with permissions to create workspaces

Creating a Workspace

  1. Access the Project:
  2. Navigate to the Dashboard
  3. Select your target project
  4. Click Create Workspace in the sidebar

  5. Configure Workspace Settings:

  6. Workspace Name (required) Enter a unique identifier for your workspace

  7. Description (optional) Add details about the workspace purpose

  8. Terraform Version Specify the version (e.g., 1.5.7)

  9. Link Resources:

  10. Git Repository Select from available repositories containing Terraform code

  11. Cloud Account Choose the target cloud account for deployments

  12. Add Variables (Optional):

  13. Click Add Variable to define workspace-specific variables
  14. Variables defined here take precedence over project and cloud account variables

  15. Click Create Workspace to finish setup

Screenshot of Create Workspace form

Important Notes

  • Workspace names must be unique within a project
  • Git repository must contain valid Terraform configurations
  • Variables are encrypted and securely stored
  • State files are managed automatically
  • Conflicts are prevented through state locking