v1alpha1

package
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package v1alpha1 contains the platform-owner-only admin API. It holds the Provider type, which declaratively provisions a provider's kcp sub-workspace + ServiceAccount + kubeconfig Secret.

The group name carries "admin" deliberately: the admin.railgrid.ai APIExport is bound ONLY in root:railgrid:providers (admin/hub). This is distinct from providers.railgrid.ai, which serves CatalogEntry and IS bound into provider sub-workspaces so providers can self-register their catalog entry. Because Provider lives behind the admin-only export, a provider running in its own sub-workspace (with cluster-admin over that workspace) cannot create a Provider and thereby bootstrap sibling provider workspaces.

Index

Constants

View Source
const (
	GroupName = "admin.railgrid.ai"
	Version   = "v1alpha1"
)
View Source
const (
	// SystemWorkspaceAnnotation marks a Workspace under root:railgrid:system as
	// created for a SystemWorkspace; its value is the SystemWorkspace's name.
	// The hub only provisions into, and only deletes, workspaces that carry
	// it, so a SystemWorkspace can never take over or remove a workspace
	// somebody else put there.
	SystemWorkspaceAnnotation = "admin.railgrid.ai/system-workspace"

	// SystemWorkspaceTypeName is the WorkspaceType (in root:railgrid) of the
	// workspaces a SystemWorkspace provisions.
	SystemWorkspaceTypeName = "system-service"
)
View Source
const (
	// WorkspaceSeedAnnotation marks an APIBinding in a tenant workspace as
	// created by a WorkspaceSeed; its value is the seed's name. The hub only
	// rewrites bindings that carry it.
	WorkspaceSeedAnnotation = "admin.railgrid.ai/workspace-seed"

	// TenantAccessAnnotation on an APIBinding in a tenant workspace bounds
	// what the workspace's members may do with the API groups the binding
	// serves; its value is a SeedTenantAccess. Tenants cannot write
	// APIBindings, so only the hub sets it. A binding without it gives members
	// full access, as every provider binding does.
	TenantAccessAnnotation = "admin.railgrid.ai/tenant-access"

	// WorkspaceSeedFieldManager is the server-side-apply field manager the hub
	// writes a seed's objects under.
	WorkspaceSeedFieldManager = "railgrid-workspace-seed"
)

Variables

View Source
var (
	SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: Version}
	SchemeBuilder      = runtime.NewSchemeBuilder(addKnownTypes)
	AddToScheme        = SchemeBuilder.AddToScheme
)

Functions

func Resource

func Resource(resource string) schema.GroupResource

Types

type Provider

type Provider struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ProviderSpec   `json:"spec,omitempty"`
	Status ProviderStatus `json:"status,omitempty"`
}

Provider declaratively provisions the kcp-side scaffolding a third-party extension needs to run: the per-provider sub-workspace root:railgrid:providers:<name>, a "provider" ServiceAccount with cluster-admin inside that workspace, and a long-lived kubeconfig the provider pod mounts — written into a Secret in root:railgrid:system:providers (the same workspace this CR lives in). It also binds the providers.railgrid.ai APIExport (CatalogEntry) into the new sub-workspace so the provider can self-register its CatalogEntry.

It is deliberately minimal: workspace + ServiceAccount + kubeconfig Secret + the CatalogEntry binding, and NOTHING ELSE. The provider's APIExport, APIResourceSchemas, APIExportEndpointSlice, bind grant, and CatalogEntry all come from the provider's own `init` (running inside the sub-workspace with the minted kubeconfig).

Provider lives in the admin.railgrid.ai APIExport, bound ONLY in root:railgrid:system:providers — a provider cannot create a Provider from its own sub-workspace, so it cannot bootstrap sibling providers.

WARNING: deleting a Provider triggers FULL teardown — its finalizer deletes the sub-workspace (cascading the ServiceAccount, its token, the CatalogEntry, and any APIExport / APIResourceSchemas the provider's init created there) plus the kubeconfig Secret. Do not delete a Provider whose exports tenants still depend on.

func (*Provider) DeepCopy

func (in *Provider) DeepCopy() *Provider

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Provider.

func (*Provider) DeepCopyInto

func (in *Provider) DeepCopyInto(out *Provider)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*Provider) DeepCopyObject

func (in *Provider) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type ProviderList

type ProviderList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Provider `json:"items"`
}

ProviderList contains a list of Provider.

func (*ProviderList) DeepCopy

func (in *ProviderList) DeepCopy() *ProviderList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ProviderList.

func (*ProviderList) DeepCopyInto

func (in *ProviderList) DeepCopyInto(out *ProviderList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*ProviderList) DeepCopyObject

func (in *ProviderList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type ProviderSecretRef

type ProviderSecretRef struct {
	// Namespace is the namespace the Secret lives in within
	// root:railgrid:system:providers. Typically "default".
	// +optional
	Namespace string `json:"namespace,omitempty"`

	// Name is the Secret name.
	Name string `json:"name"`

	// Key is the data key holding the kubeconfig YAML. Typically "kubeconfig".
	// +optional
	Key string `json:"key,omitempty"`
}

ProviderSecretRef locates the minted kubeconfig Secret in root:railgrid:system:providers.

func (*ProviderSecretRef) DeepCopy

func (in *ProviderSecretRef) DeepCopy() *ProviderSecretRef

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ProviderSecretRef.

func (*ProviderSecretRef) DeepCopyInto

func (in *ProviderSecretRef) DeepCopyInto(out *ProviderSecretRef)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ProviderSpec

type ProviderSpec struct {
	// DisplayName is informational, shown in admin tooling. The provisioned
	// sub-workspace is always root:railgrid:providers:<metadata.name> regardless.
	// +optional
	// +kubebuilder:validation:MaxLength=128
	DisplayName string `json:"displayName,omitempty"`

	// SecretName overrides the name of the kubeconfig Secret the controller
	// writes into root:railgrid:system:providers. Defaults to "<name>-kubeconfig".
	// +optional
	// +kubebuilder:validation:MaxLength=253
	SecretName string `json:"secretName,omitempty"`

	// ServerURLOverride overrides the API server URL baked into the minted
	// kubeconfig. Empty means the controller's configured provider server URL
	// (the hub's --hub-internal-url when set, otherwise --hub-external-url).
	// +optional
	// +kubebuilder:validation:MaxLength=512
	ServerURLOverride string `json:"serverURLOverride,omitempty"`
}

ProviderSpec defines the desired state of a Provider. The provider's name (metadata.name) is the identity: it drives the sub-workspace path (root:railgrid:providers:<name>) and the ServiceAccount, so the spec carries only optional knobs.

func (*ProviderSpec) DeepCopy

func (in *ProviderSpec) DeepCopy() *ProviderSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ProviderSpec.

func (*ProviderSpec) DeepCopyInto

func (in *ProviderSpec) DeepCopyInto(out *ProviderSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ProviderStatus

type ProviderStatus struct {
	// WorkspacePath is the kcp workspace path the controller provisioned, e.g.
	// "root:railgrid:providers:kuery".
	// +optional
	WorkspacePath string `json:"workspacePath,omitempty"`

	// WorkspaceCluster is the logical-cluster ID of the provisioned
	// sub-workspace (Workspace.spec.cluster).
	// +optional
	WorkspaceCluster string `json:"workspaceCluster,omitempty"`

	// SecretRef points at the kubeconfig Secret the controller wrote into
	// root:railgrid:system:providers.
	// +optional
	SecretRef *ProviderSecretRef `json:"secretRef,omitempty"`

	// LastProvisioned is the wall-clock time provisioning last succeeded.
	// +optional
	LastProvisioned *metav1.Time `json:"lastProvisioned,omitempty"`

	// Conditions describe the current state of the Provider. The "Ready"
	// condition is True once the workspace, ServiceAccount, and kubeconfig
	// Secret all exist.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

ProviderStatus defines the observed state of a Provider.

func (*ProviderStatus) DeepCopy

func (in *ProviderStatus) DeepCopy() *ProviderStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ProviderStatus.

func (*ProviderStatus) DeepCopyInto

func (in *ProviderStatus) DeepCopyInto(out *ProviderStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SeedBinding added in v0.2.56

type SeedBinding struct {
	// Name is the APIBinding's name in the workspace. A binding of that name
	// that this seed did not create, or that references another export, is
	// left alone and reported; "railgrid" is the hub's own and is refused.
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$`
	Name string `json:"name"`

	// Export is the APIExport to bind.
	Export SeedExportReference `json:"export"`

	// PermissionClaims are the export's permission claims the binding
	// accepts. kcp reports a mismatch, and serves nothing for the claim, when
	// group, resource, verbs and identity hash differ from what the export
	// declares; a claim the export declares and this list omits stays
	// unaccepted.
	// +optional
	// +listType=atomic
	// +kubebuilder:validation:MaxItems=32
	PermissionClaims []SeedPermissionClaim `json:"permissionClaims,omitempty"`

	// TenantAccess bounds what workspace members may do with the API groups
	// this binding serves. ReadWrite, the default, is what a provider's
	// binding gives. With ReadOnly or None only the hub and the export's own
	// controllers write those objects, which is what makes an object created
	// by this seed something a tenant cannot delete and create again.
	// +optional
	// +kubebuilder:default=ReadWrite
	TenantAccess SeedTenantAccess `json:"tenantAccess,omitempty"`
}

SeedBinding is one APIBinding created in every tenant workspace.

func (*SeedBinding) DeepCopy added in v0.2.56

func (in *SeedBinding) DeepCopy() *SeedBinding

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SeedBinding.

func (*SeedBinding) DeepCopyInto added in v0.2.56

func (in *SeedBinding) DeepCopyInto(out *SeedBinding)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SeedExportReference added in v0.2.56

type SeedExportReference struct {
	// Path is the workspace path of the export, for example
	// root:railgrid:system:switchboard.
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=512
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?(:[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$`
	Path string `json:"path"`

	// Name is the APIExport's name.
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name"`
}

SeedExportReference names an APIExport.

func (*SeedExportReference) DeepCopy added in v0.2.56

func (in *SeedExportReference) DeepCopy() *SeedExportReference

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SeedExportReference.

func (*SeedExportReference) DeepCopyInto added in v0.2.56

func (in *SeedExportReference) DeepCopyInto(out *SeedExportReference)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SeedObject added in v0.2.56

type SeedObject struct {
	// Resource is the plural resource name of the manifest's kind, for
	// example "requests". The hub does not run discovery per workspace.
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=63
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`
	Resource string `json:"resource"`

	// WhenBound lists exports that must have a Bound APIBinding in the
	// workspace before the object is created, beyond this seed's own
	// bindings. It is how an object of a provider's API is created only in
	// workspaces where that provider is enabled, and as soon as it is.
	// +optional
	// +listType=atomic
	// +kubebuilder:validation:MaxItems=8
	WhenBound []SeedExportReference `json:"whenBound,omitempty"`

	// Manifest is the object: apiVersion, kind, metadata.name and whatever
	// else it holds. It is namespaced when metadata.namespace is set; the
	// namespace must exist ("default" does in every tenant workspace). The
	// manifest is applied as written, the same in every workspace.
	// +kubebuilder:pruning:PreserveUnknownFields
	// +kubebuilder:validation:EmbeddedResource
	Manifest runtime.RawExtension `json:"manifest"`
}

SeedObject is one object created in every tenant workspace.

func (*SeedObject) DeepCopy added in v0.2.56

func (in *SeedObject) DeepCopy() *SeedObject

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SeedObject.

func (*SeedObject) DeepCopyInto added in v0.2.56

func (in *SeedObject) DeepCopyInto(out *SeedObject)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SeedPermissionClaim added in v0.2.56

type SeedPermissionClaim struct {
	// Group of the claimed resource; empty for the core group.
	// +optional
	Group string `json:"group,omitempty"`

	// Resource is the claimed resource, plural.
	// +kubebuilder:validation:MinLength=1
	Resource string `json:"resource"`

	// Verbs the export's controllers get on the resource.
	// +kubebuilder:validation:MinItems=1
	// +listType=set
	Verbs []string `json:"verbs"`

	// IdentityHash of the export that serves the claimed resource, when it is
	// not a built-in one.
	// +optional
	IdentityHash string `json:"identityHash,omitempty"`

	// Selector scopes the claim to the objects it matches. Without one the
	// claim covers every object of the resource in the workspace, which is
	// refused for core secrets and configmaps.
	// +optional
	Selector *metav1.LabelSelector `json:"selector,omitempty"`
}

SeedPermissionClaim is one accepted permission claim.

func (*SeedPermissionClaim) DeepCopy added in v0.2.56

func (in *SeedPermissionClaim) DeepCopy() *SeedPermissionClaim

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SeedPermissionClaim.

func (*SeedPermissionClaim) DeepCopyInto added in v0.2.56

func (in *SeedPermissionClaim) DeepCopyInto(out *SeedPermissionClaim)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SeedTenantAccess added in v0.2.56

type SeedTenantAccess string

SeedTenantAccess is what the members of a workspace may do with the API groups a seeded binding serves. +kubebuilder:validation:Enum=ReadWrite;ReadOnly;None

const (
	// SeedTenantAccessReadWrite gives members full access to the groups, as
	// for a provider's binding.
	SeedTenantAccessReadWrite SeedTenantAccess = "ReadWrite"
	// SeedTenantAccessReadOnly lets members get, list and watch.
	SeedTenantAccessReadOnly SeedTenantAccess = "ReadOnly"
	// SeedTenantAccessNone gives members nothing on the groups.
	SeedTenantAccessNone SeedTenantAccess = "None"
)

type SystemWorkspace added in v0.2.56

type SystemWorkspace struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   SystemWorkspaceSpec   `json:"spec,omitempty"`
	Status SystemWorkspaceStatus `json:"status,omitempty"`
}

SystemWorkspace provisions the kcp-side home of a platform service that is not a provider: the workspace root:railgrid:system:<name>, a "provider" ServiceAccount with cluster-admin inside it, and a long-lived kubeconfig written into a Secret in root:railgrid:system:providers, next to this object.

It is the counterpart of Provider for services that reach tenant workspaces through a WorkspaceSeed rather than through the catalog. The differences from a Provider's workspace are what keep such a service out of the provider machinery: the workspace is outside root:railgrid:providers, so the hub does not treat bindings of its exports as an enabled provider, and its WorkspaceType binds no CatalogEntry export, so the service cannot register itself in the catalog.

The service's own APIExports, schemas and configuration come from the service's installer, run with the minted kubeconfig. The ServiceAccount is always cluster-admin in the workspace: a system service is operated by the platform, and it writes objects of the APIs it defines there.

The names "controllers", "providers" and "tenants" are the hub's own and are refused. A workspace of the requested name that this object did not create (for example one an installer made by hand) is left alone and reported.

WARNING: deleting a SystemWorkspace deletes the workspace and with it every APIExport in it. Tenant workspaces bound to those exports by a WorkspaceSeed lose the API and its objects. Remove the seed's references first.

func (*SystemWorkspace) DeepCopy added in v0.2.56

func (in *SystemWorkspace) DeepCopy() *SystemWorkspace

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SystemWorkspace.

func (*SystemWorkspace) DeepCopyInto added in v0.2.56

func (in *SystemWorkspace) DeepCopyInto(out *SystemWorkspace)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*SystemWorkspace) DeepCopyObject added in v0.2.56

func (in *SystemWorkspace) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type SystemWorkspaceList added in v0.2.56

type SystemWorkspaceList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []SystemWorkspace `json:"items"`
}

SystemWorkspaceList contains a list of SystemWorkspace.

func (*SystemWorkspaceList) DeepCopy added in v0.2.56

func (in *SystemWorkspaceList) DeepCopy() *SystemWorkspaceList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SystemWorkspaceList.

func (*SystemWorkspaceList) DeepCopyInto added in v0.2.56

func (in *SystemWorkspaceList) DeepCopyInto(out *SystemWorkspaceList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*SystemWorkspaceList) DeepCopyObject added in v0.2.56

func (in *SystemWorkspaceList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type SystemWorkspaceSpec added in v0.2.56

type SystemWorkspaceSpec struct {
	// DisplayName is informational, shown in admin tooling.
	// +optional
	// +kubebuilder:validation:MaxLength=128
	DisplayName string `json:"displayName,omitempty"`

	// ServerURLOverride overrides the API server URL baked into the minted
	// kubeconfig. Empty means the hub's --hub-internal-url when set, otherwise
	// --hub-external-url.
	// +optional
	// +kubebuilder:validation:MaxLength=512
	ServerURLOverride string `json:"serverURLOverride,omitempty"`
}

SystemWorkspaceSpec defines the desired state of a SystemWorkspace. The name (metadata.name) is the identity: it is the last segment of the workspace path root:railgrid:system:<name>.

func (*SystemWorkspaceSpec) DeepCopy added in v0.2.56

func (in *SystemWorkspaceSpec) DeepCopy() *SystemWorkspaceSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SystemWorkspaceSpec.

func (*SystemWorkspaceSpec) DeepCopyInto added in v0.2.56

func (in *SystemWorkspaceSpec) DeepCopyInto(out *SystemWorkspaceSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type SystemWorkspaceStatus added in v0.2.56

type SystemWorkspaceStatus struct {
	// WorkspacePath is the kcp workspace path the hub provisioned, for example
	// "root:railgrid:system:switchboard". It is what a WorkspaceSeed names as
	// the path of the service's exports.
	// +optional
	WorkspacePath string `json:"workspacePath,omitempty"`

	// WorkspaceCluster is the logical-cluster ID of the workspace.
	// +optional
	WorkspaceCluster string `json:"workspaceCluster,omitempty"`

	// SecretRef points at the kubeconfig Secret the hub wrote into
	// root:railgrid:system:providers.
	// +optional
	SecretRef *ProviderSecretRef `json:"secretRef,omitempty"`

	// LastProvisioned is the wall-clock time provisioning last succeeded.
	// +optional
	LastProvisioned *metav1.Time `json:"lastProvisioned,omitempty"`

	// Conditions describe the SystemWorkspace. "Ready" is True once the
	// workspace, ServiceAccount and kubeconfig Secret all exist.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

SystemWorkspaceStatus defines the observed state of a SystemWorkspace.

func (*SystemWorkspaceStatus) DeepCopy added in v0.2.56

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new SystemWorkspaceStatus.

func (*SystemWorkspaceStatus) DeepCopyInto added in v0.2.56

func (in *SystemWorkspaceStatus) DeepCopyInto(out *SystemWorkspaceStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type WorkspaceSeed added in v0.2.56

type WorkspaceSeed struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   WorkspaceSeedSpec   `json:"spec,omitempty"`
	Status WorkspaceSeedStatus `json:"status,omitempty"`
}

WorkspaceSeed declares backend functionality every tenant workspace gets without anyone enabling it: APIExports the hub binds into the workspace and objects it creates there. It is how a platform service that is not a provider (it has no catalog entry, no portal presence and no Enable step) reaches every workspace.

The hub applies every accepted seed to every tenant workspace (root:railgrid:tenants:<org>:<workspace>): to a new one once its core binding is in place, to existing ones when the seed is created or changed, and again whenever an APIBinding in the workspace changes. Bindings are created with the hub's own credential, with exactly the permission claims the seed lists accepted. Objects are server-side applied under the field manager "railgrid-workspace-seed", with force: the seed wins over whoever else wrote the fields it sets, and an object a tenant deleted is created again at the next of the triggers above. The hub does not watch the objects themselves.

Nothing a seed created is removed when the seed changes or is deleted: deleting an APIBinding deletes the workspace's objects of that API, so removal is an operator's decision, taken per workspace.

WorkspaceSeed lives in the admin.railgrid.ai APIExport, bound only in root:railgrid:system:providers. Whoever may write there decides what runs in every tenant workspace with which permission claims accepted; treat write access to it as platform administration.

func (*WorkspaceSeed) DeepCopy added in v0.2.56

func (in *WorkspaceSeed) DeepCopy() *WorkspaceSeed

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WorkspaceSeed.

func (*WorkspaceSeed) DeepCopyInto added in v0.2.56

func (in *WorkspaceSeed) DeepCopyInto(out *WorkspaceSeed)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*WorkspaceSeed) DeepCopyObject added in v0.2.56

func (in *WorkspaceSeed) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type WorkspaceSeedList added in v0.2.56

type WorkspaceSeedList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []WorkspaceSeed `json:"items"`
}

WorkspaceSeedList contains a list of WorkspaceSeed.

func (*WorkspaceSeedList) DeepCopy added in v0.2.56

func (in *WorkspaceSeedList) DeepCopy() *WorkspaceSeedList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WorkspaceSeedList.

func (*WorkspaceSeedList) DeepCopyInto added in v0.2.56

func (in *WorkspaceSeedList) DeepCopyInto(out *WorkspaceSeedList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*WorkspaceSeedList) DeepCopyObject added in v0.2.56

func (in *WorkspaceSeedList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type WorkspaceSeedSpec added in v0.2.56

type WorkspaceSeedSpec struct {
	// Bindings are the APIExports bound into every tenant workspace.
	// +optional
	// +listType=map
	// +listMapKey=name
	// +kubebuilder:validation:MaxItems=16
	Bindings []SeedBinding `json:"bindings,omitempty"`

	// Objects are created in every tenant workspace once every binding of this
	// seed is Bound there, in the order listed.
	// +optional
	// +listType=atomic
	// +kubebuilder:validation:MaxItems=32
	Objects []SeedObject `json:"objects,omitempty"`
}

WorkspaceSeedSpec is what every tenant workspace gets.

func (*WorkspaceSeedSpec) DeepCopy added in v0.2.56

func (in *WorkspaceSeedSpec) DeepCopy() *WorkspaceSeedSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WorkspaceSeedSpec.

func (*WorkspaceSeedSpec) DeepCopyInto added in v0.2.56

func (in *WorkspaceSeedSpec) DeepCopyInto(out *WorkspaceSeedSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type WorkspaceSeedStatus added in v0.2.56

type WorkspaceSeedStatus struct {
	// ObservedGeneration is the generation the status was computed from.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Bindings is the number of bindings the accepted spec declares.
	// +optional
	Bindings int32 `json:"bindings,omitempty"`

	// Objects is the number of objects the accepted spec declares.
	// +optional
	Objects int32 `json:"objects,omitempty"`

	// Conditions describe the seed. "Accepted" is True when the spec is valid
	// and the hub applies it to tenant workspaces; when False the message says
	// what is wrong and the last accepted spec, if any, is no longer applied
	// to further workspaces. The status does not say how far the fleet has
	// been seeded; the hub logs each workspace it fails to seed.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

WorkspaceSeedStatus is the observed state of a WorkspaceSeed.

func (*WorkspaceSeedStatus) DeepCopy added in v0.2.56

func (in *WorkspaceSeedStatus) DeepCopy() *WorkspaceSeedStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new WorkspaceSeedStatus.

func (*WorkspaceSeedStatus) DeepCopyInto added in v0.2.56

func (in *WorkspaceSeedStatus) DeepCopyInto(out *WorkspaceSeedStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL