Skip to main content

Workspace Overview

Concepts​

What is a Workspace?​

A workspace is an isolated environment within your account where data platform applications are deployed and run. Each workspace has its own cloud infrastructure, its own set of deployed applications, and its own member access.

You can think of a workspace as a project environment — for example, a production environment, a team sandbox, or a domain-specific data hub.

Workspace Lifecycle​

A workspace goes through a lifecycle managed by the platform:

  1. Created — workspace record is registered with a provisioning configuration
  2. Provisioning — cloud infrastructure is being created (compute, networking, storage)
  3. Running — infrastructure is ready and applications can be deployed
  4. Failed — an error occurred during provisioning or sync (can be retried)
  5. Deleted — workspace and all its infrastructure are permanently destroyed

Provisioning Configuration​

When creating a workspace, you provide a provisioning configuration that tells the platform how to build the cloud infrastructure:

  • Stack template — the blueprint defining what infrastructure to create
  • Cloud credential — the identity the platform uses to provision resources in your cloud account
  • State storage — where the infrastructure state (Terraform state) is stored
  • Network — optionally attach to a pre-existing network, or let the platform create one

These inputs come from resources already registered in your account. See Account Overview for how to set those up.

Workspace Operations​

Beyond creation, a workspace supports ongoing operational actions:

  • Sync Apps — pull in application stacks defined in the workspace template
  • Provision Infrastructure — re-trigger infra creation when the workspace is in a pending or failed state
  • Sync Infrastructure — re-apply the current configuration without full reprovisioning
  • Delete — permanently destroy the workspace and all associated infrastructure
Deleting a workspace

Deletion is permanent and cannot be undone.

Current UI — How to Create and Manage a Workspace​

This section describes the current interface. It will be updated when the new Oqullus UI launches.

Creating a Workspace​

Requires: Account Owner or Admin role

  1. In the sidebar, click My Workspaces.
  2. Click Create.
  3. Fill in the workspace details:
    • Workspace name — a human-readable name
    • Description — optional
    • External workspace ID — leave Generate external workspace ID checked to auto-generate, or uncheck to set your own
  4. Configure provisioning:
    • Stack template — select the workspace blueprint
    • Cloud credential — select the cloud credential to use
    • State storage — select the Terraform state backend
    • Network — optional; leave as "None" to auto-create
  5. Click Create workspace.

Monitor progress in the Events tab after creation.

Placeholder — Workspace Templates

Available templates depend on what has been registered in your account's catalog. Contact your platform administrator if none appear.

Workspace Settings​

(To be filled in by editor)