operator

package
v0.1.2 Latest Latest
Warning

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

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

Documentation

Overview

Package operator reconciles the marketplace API into producer workspaces and bind grants.

It runs one manager per APIExport with schemas, and holds one client for the provisioner capability — and that is the whole security design: each write happens through exactly one claim someone accepted.

catalog      Providers, in the catalog workspace.
publish      APIExports, in each producer workspace; materializes the
             per-export `bind` grant that publishing means. It reads
             those exports through a claim and never writes to them —
             an offering is a producer's own object, annotated.
provisioner  (client only) creates producer workspaces under the
             producers parent.

The operator never touches a consumer workspace: enabling an offering is a plain kcp APIBinding the consumer creates themselves, authorized by their own RBAC and by the `bind` grant publishing materialized.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Run

func Run(ctx context.Context, opts Options) error

Run starts the operator and blocks until ctx is cancelled.

Types

type Options

type Options struct {
	// RestConfig reaches the kcp shard hosting the marketplace APIExports.
	RestConfig *rest.Config
	// Slice names, one per export. Defaults match what init installs.
	CatalogSlice     string
	PublishSlice     string
	ProvisionerSlice string
	// ExportsPath is where the WorkspaceTypes live; Workspace objects
	// reference their type by path.
	ExportsPath string
	// CatalogPath is the workspace Provider records live in.
	CatalogPath string
	// ProducersPath is the workspace provisioned producer workspaces are
	// created under.
	ProducersPath string
	// BindUsers and BindGroups are the subjects the per-offering `bind`
	// grants name: who may enable a published offering. Both empty means
	// the system:authenticated group — mirroring this repo's bind-RBAC
	// stance that a claim only takes effect once the consumer accepts it,
	// and matching what kcp does for its own root exports.
	BindUsers  []string
	BindGroups []string
}

Options configures the operator.

Jump to

Keyboard shortcuts

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