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
- Variables
- func Resource(resource string) schema.GroupResource
- type Provider
- type ProviderList
- type ProviderSecretRef
- type ProviderSpec
- type ProviderStatus
- type SeedBinding
- type SeedExportReference
- type SeedObject
- type SeedPermissionClaim
- type SeedTenantAccess
- type SystemWorkspace
- type SystemWorkspaceList
- type SystemWorkspaceSpec
- type SystemWorkspaceStatus
- type WorkspaceSeed
- type WorkspaceSeedList
- type WorkspaceSeedSpec
- type WorkspaceSeedStatus
Constants ¶
const ( GroupName = "admin.railgrid.ai" Version = "v1alpha1" )
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" )
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 ¶
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 ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Provider.
func (*Provider) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Provider) DeepCopyObject ¶
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
func (in *SystemWorkspaceStatus) DeepCopy() *SystemWorkspaceStatus
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.