Documentation
¶
Overview ¶
Package control implements UID-bound control-plane fences for node workers. All reads used for authority must use an uncached APIReader.
Index ¶
- func HasStartupTaint(n *corev1.Node) bool
- func IdentityMatches(t api.Target, n *corev1.Node) bool
- func ParseInventory(n *corev1.Node) (map[string]api.NodeRuntime, error)
- func ReleaseClaim(ctx context.Context, c client.Client, r client.Reader, a Authority) error
- func StartupFenced(n *corev1.Node) bool
- func Withdraw(ctx context.Context, c client.Client, r client.Reader, a Authority, ...) (bool, error)
- func WithdrawAdvertisement(ctx context.Context, c client.Client, r client.Reader, a Authority, ...) (bool, error)
- func WithdrawRetiredIdentity(ctx context.Context, c client.Client, r client.Reader, name string, ...) (bool, error)
- func WorkersMayAuthorize(ctx context.Context, r client.Reader, profileUID, nodeUID types.UID) (bool, error)
- type Authority
- type RetiredIdentity
- type Snapshot
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func HasStartupTaint ¶
func ParseInventory ¶
func ReleaseClaim ¶
ReleaseClaim uses a resourceVersion CAS and requires cleanup's durable Teardown checkpoint and complete worker teardown. A failed CAS must be retried by calling this function again, not by reusing the old Node.
func StartupFenced ¶
func Withdraw ¶
func Withdraw(ctx context.Context, c client.Client, r client.Reader, a Authority, keys []string) (bool, error)
Withdraw removes scheduling eligibility. If admission pins labels, only a successful write followed by an independent readback proves the fallback. A conflict/replacement never enters the fallback path with stale authority.
func WithdrawAdvertisement ¶
func WithdrawAdvertisement(ctx context.Context, c client.Client, r client.Reader, a Authority, keys []string) (bool, error)
WithdrawAdvertisement is the controller's scheduling-only revocation path. Unlike host mutation authority, revocation must remain possible after a spec edit or deletion invalidates provisioning. It still requires a durable, claimed UID-bound target and never grants a worker host-write permission.
func WithdrawRetiredIdentity ¶
func WithdrawRetiredIdentity(ctx context.Context, c client.Client, r client.Reader, name string, uid types.UID, identity RetiredIdentity, keys []string) (bool, error)
WithdrawRetiredIdentity removes scheduling eligibility only, including from unowned or foreign-claimed registrations of a retired physical host. It never modifies ownership or confers host cleanup authority.