reconstitution

Documentation

Index

• type Client
• type CompositionRef
  • func NewCompositionRef(comp *apiv1.Composition) *CompositionRef
• type Manager
  • func New(mgr ctrl.Manager, writeBatchInterval time.Duration) (*Manager, error)
  • func (m *Manager) Add(rec Reconciler) error
  • func (r Manager) AddQueue(queue workqueue.Interface)
  • func (m *Manager) GetClient() Client
  • func (w Manager) PatchStatusAsync(ctx context.Context, ref *ManifestRef, patchFn StatusPatchFn)
  • func (r Manager) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
  • func (w Manager) Start(ctx context.Context) error
• type ManifestRef
  • func (m *ManifestRef) FindStatus(slice *apiv1.ResourceSlice) *apiv1.ResourceState
• type Reconciler
• type Request
• type Resource
• type StatusPatchFn

Types

type Client

type Client interface {
	Get(ctx context.Context, comp *CompositionRef, res *resource.Ref) (*resource.Resource, bool)
	PatchStatusAsync(ctx context.Context, req *ManifestRef, patchFn StatusPatchFn)
}

Client provides read/write access to a collection of reconstituted resources.

type CompositionRef

type CompositionRef struct {
	Name, Namespace string
	Generation      int64
}

CompositionRef refers to a specific generation of a composition.

func NewCompositionRef

func NewCompositionRef(comp *apiv1.Composition) *CompositionRef

type Manager

type Manager struct {
	ctrl.Manager
	// contains filtered or unexported fields
}

func New

func New(mgr ctrl.Manager, writeBatchInterval time.Duration) (*Manager, error)

New creates a new Manager, which is responsible for "reconstituting" resources i.e. allowing controllers to treat them as individual resources instead of their storage representation (ResourceSlice).

func (*Manager) Add

func (m *Manager) Add(rec Reconciler) error

func (Manager) AddQueue

func (r Manager) AddQueue(queue workqueue.Interface)

func (*Manager) GetClient

func (m *Manager) GetClient() Client

func (Manager) PatchStatusAsync

func (w Manager) PatchStatusAsync(ctx context.Context, ref *ManifestRef, patchFn StatusPatchFn)

func (Manager) Reconcile

func (r Manager) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)

func (Manager) Start

func (w Manager) Start(ctx context.Context) error

type ManifestRef

type ManifestRef struct {
	Slice types.NamespacedName
	Index int // position of this manifest within the slice
}

ManifestRef references a particular resource manifest within a resource slice.

func (*ManifestRef) FindStatus

func (m *ManifestRef) FindStatus(slice *apiv1.ResourceSlice) *apiv1.ResourceState

type Reconciler

type Reconciler interface {
	Name() string
	Reconcile(ctx context.Context, req *Request) (ctrl.Result, error)
}

Reconciler is implemented by types that can reconcile individual, reconstituted resources.

type Request

type Request struct {
	Resource    resource.Ref
	Manifest    ManifestRef
	Composition types.NamespacedName
}

Request is like controller-runtime reconcile.Request but for reconstituted resources. https://pkg.go.dev/sigs.k8s.io/controller-runtime/pkg/reconcile#Request

type Resource

type Resource = resource.Resource

type StatusPatchFn

type StatusPatchFn func(*apiv1.ResourceState) *apiv1.ResourceState