Adding a Workspace

Create a workspace for managing Terraform deployments using OpenTofu.
OpenTofu is an open-source, community-driven alternative to Terraform, maintained under the Linux Foundation. It is a drop-in replacement for Terraform and fully compatible with both new and existing Terraform configurations. By specifying the OpenTofu version in your workspace, you ensure that your deployments run consistently across environments.

➡️ Learn more about OpenTofu here: https://opentofu.org

---

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. OpenTofu Version
   Specify the version of OpenTofu to use (e.g., 1.5.7).
   OpenTofu ensures compatibility with Terraform code, so you can continue to use your existing Terraform configurations without modification.

9. Link Resources:

10. Git Repository
    Select from available repositories containing Terraform/OpenTofu 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

---

Important Notes

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