Workspace
Workspace CRD schema reference (group tenancy.kcp.io)
Version v1alpha1
Properties
.apiVersion
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
.kind
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
.metadata
.metadata.name
.spec
WorkspaceSpec holds the desired state of the Workspace.
.spec.URL
URL is the address under which the Kubernetes-cluster-like endpoint can be found. This URL can be used to access the workspace with standard Kubernetes client libraries and command line tools.
Set by the system.
.spec.cluster
cluster is the name of the logical cluster this workspace is stored under.
Set by the system.
.spec.location
location constraints where this workspace can be scheduled to.
If the no location is specified, an arbitrary location is chosen.
.spec.location.selector
selector is a label selector that filters workspace scheduling targets.
.spec.location.selector.matchExpressions
matchExpressions is a list of label selector requirements. The requirements are ANDed.
.spec.location.selector.matchExpressions[*]
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
.spec.location.selector.matchExpressions[*].key
key is the label key that the selector applies to.
.spec.location.selector.matchExpressions[*].operator
operator represents a key’s relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
.spec.location.selector.matchExpressions[*].values
values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
.spec.location.selector.matchExpressions[*].values[*]
.spec.location.selector.matchLabels
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is “key”, the operator is “In”, and the values array contains only “value”. The requirements are ANDed.
.spec.type
type defines properties of the workspace both on creation (e.g. initial resources and initially installed APIs) and during runtime (e.g. permissions). If no type is provided, the default type for the workspace in which this workspace is nesting will be used.
The type is a reference to a WorkspaceType in the listed workspace, but lower-cased. The WorkspaceType existence is validated at admission during creation. The type is immutable after creation. The use of a type is gated via the RBAC workspacetypes/use resource permission.
.spec.type.name
name is the name of the WorkspaceType
.spec.type.path
path is an absolute reference to the workspace that owns this type, e.g. root:org:ws.
.status
WorkspaceStatus communicates the observed state of the Workspace.
.status.conditions
Current processing state of the Workspace.
.status.conditions[*]
Condition defines an observation of a object operational state.
.status.conditions[*].lastTransitionTime
Last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
.status.conditions[*].message
A human readable message indicating details about the transition. This field may be empty.
.status.conditions[*].reason
The reason for the condition’s last transition in CamelCase. The specific API may choose whether or not this field is considered a guaranteed API. This field may not be empty.
.status.conditions[*].severity
Severity provides an explicit classification of Reason code, so the users or machines can immediately understand the current situation and act accordingly. The Severity field MUST be set only when Status=False.
.status.conditions[*].status
Status of the condition, one of True, False, Unknown.
.status.conditions[*].type
Type of condition in CamelCase or in foo.example.com/CamelCase. Many .condition.type values are consistent across resources like Available, but because arbitrary conditions can be useful (see .node.status.conditions), the ability to deconflict is important.
.status.initializers
initializers must be cleared by a controller before the workspace is ready and can be used.
.status.initializers[*]
LogicalClusterInitializer is a unique string corresponding to a logical cluster initialization controller.
.status.phase
Phase of the workspace (Scheduling, Initializing, Ready).