Resources / Workspace

Workspace

A unit of ownership and trust. It holds projects and child workspaces, is linked to one billing account, and has its own owner: whoever creates it receives the owner role in it and in everything below it, and nothing above it or beside it.

Overview

APIresourcemanager.etorm.com/v1alpha1
Resourceworkspaces (cluster-scoped inside its cluster)
Short namesws
Available inthe platform only
Statuswritten by a controller through /status

Minimal example

apiVersion: resourcemanager.etorm.com/v1alpha1
kind: Workspace
metadata:
  name: example
spec: {}

Spec

FieldTypeRequiredDefaultAllowedDescription
displayNamestringup to 128 charactersHuman-readable name.
parentRefreference to WorkspaceThe workspace this one is inside. Empty for a top-level workspace. Cannot be changed.
billingAccountRefreference to BillingAccountThe billing account that pays for the workspace's projects. Required for a top-level workspace; a child inherits its parent's unless its creator may charge another. Cannot be changed.
cascadeDeletebooleanSet this, then delete the workspace, to erase it together with every project and child workspace under it. Irreversible: each project's objects and data are deleted. Without it a workspace is deleted only when empty.
quotasobjectCeilings for everything under this workspace (itself included). Set by someone above the workspace, never by its own owners; a child cannot exceed its parent's.
quotas.projectsintegerat least 0Most projects in this workspace and its descendants.
quotas.workspacesintegerat least 0Most descendant workspaces.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringLifecycle phase.
idstringImmutable identifier (the object's uid); storage and audit use it, never the path.
pathstringNames from the top-level workspace, separated by a colon.
depthinteger1 for a top-level workspace.
accountstringThe billing account this workspace is linked to (its own or inherited).
projectCountintegerProjects directly in this workspace.
conditionslist of objectDetailed state, one entry per aspect; Ready says whether the object is usable.
conditions[].typestring
conditions[].statusstring
conditions[].reasonstring
conditions[].messagestring

Columns in listings

ColumnFrom
Path.status.path
Billing-Account.status.account
Projects.status.projectCount
Phase.status.phase

All resources