Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

componentmanager

package

Go to main page

Versions in this module

v1

v1.6.0

May 27, 2026

Changes in this version

+ var ErrCapabilityInterfaceNotImplemented = errors.New("component manager capability interface is not implemented")

+ var ErrCapabilityNameEmpty = capability.ErrNameEmpty

+ var ErrManagerDescriptorMismatch = errors.New("component manager descriptor mismatch")

+ var ErrManagerNotCreated = errors.New("component manager was not created")

+ var ErrUnknownCapability = capability.ErrUnknown

+ var ErrUnsupportedCapability = errors.New("component manager capability is not supported")

+ type BringUpStatusReader interface

+ GetBringUpStatus func(ctx context.Context, target common.Target) (map[string]operations.MachineBringUpState, error)

+ type CapabilityInterfaceNotImplementedError struct

+ Capability capability.Capability

+ ComponentType devicetypes.ComponentType

+ Implementation string

+ func (e CapabilityInterfaceNotImplementedError) Error() string

+ func (e CapabilityInterfaceNotImplementedError) Is(target error) bool

+ type CapabilityNameEmptyError = capability.NameEmptyError

type ComponentManager

+ Descriptor func() cmcatalog.Descriptor

+ type ExpectationInjector interface

+ InjectExpectation func(ctx context.Context, target common.Target, ...) error

+ type FactorySpec struct

+ Descriptor cmcatalog.Descriptor

+ Factory ManagerFactory

+ type FirmwareController interface

+ FirmwareControl func(ctx context.Context, target common.Target, ...) error

+ type FirmwareStatusReader interface

+ GetFirmwareStatus func(ctx context.Context, target common.Target) (map[string]operations.FirmwareUpdateStatus, error)

+ type ManagerDescriptorMismatchError struct

+ Actual cmcatalog.Descriptor

+ Expected cmcatalog.Descriptor

+ func (e ManagerDescriptorMismatchError) Error() string

+ func (e ManagerDescriptorMismatchError) Is(target error) bool

+ type ManagerNotCreatedError struct

+ ComponentType devicetypes.ComponentType

+ Implementation string

+ func (e ManagerNotCreatedError) Error() string

+ func (e ManagerNotCreatedError) Is(target error) bool

+ type PowerController interface

+ PowerControl func(ctx context.Context, target common.Target, ...) error

+ type PowerStatusReader interface

+ GetPowerStatus func(ctx context.Context, target common.Target) (map[string]operations.PowerStatus, error)

type Registry

+ func (r *Registry) CheckCapability(componentType devicetypes.ComponentType, ...) error

+ func (r *Registry) ComponentManagers() []ComponentManager

+ func (r *Registry) ComponentTypes() []devicetypes.ComponentType

+ func (r *Registry) Descriptors() ([]cmcatalog.Descriptor, error)

+ func (r *Registry) GetCapableManager(componentType devicetypes.ComponentType, ...) (ComponentManager, error)

+ type RequiredProviderNotConfiguredError = cmconfig.RequiredProviderNotConfiguredError

+ type UnknownCapabilityError = capability.UnknownError

+ type UnsupportedCapabilityError struct

+ Available capability.CapabilitySet

+ Capability capability.Capability

+ ComponentType devicetypes.ComponentType

+ Implementation string

+ func (e UnsupportedCapabilityError) Error() string

+ func (e UnsupportedCapabilityError) Is(target error) bool

v1.5.1

May 14, 2026

v1.5.0

May 13, 2026

Changes in this version

+ var ErrComponentManagerFactoryNotConfigured = errors.New("component manager factory is not configured")

+ var ErrComponentManagerFactoryNotRegistered = errors.New("component manager factory is not registered")

+ var ErrComponentManagerImplementationNameEmpty = cmconfig.ErrComponentManagerImplementationNameEmpty

+ var ErrComponentManagersNotConfigured = cmconfig.ErrComponentManagersNotConfigured

+ var ErrConfigNotConfigured = cmconfig.ErrConfigNotConfigured

+ var ErrDuplicateDescriptor = errors.New("duplicate component manager descriptor")

+ var ErrDuplicateProvider = providerapi.ErrDuplicateProvider

+ var ErrDuplicateProviderConfig = cmconfig.ErrDuplicateProviderConfig

+ var ErrManagerCreationFailed = errors.New("component manager creation failed")

+ var ErrManagerNotConfigured = errors.New("component manager is not configured")

+ var ErrProviderConfigDecoderNotRegistered = cmconfig.ErrProviderConfigDecoderNotRegistered

+ var ErrProviderConfigNameMismatch = providerapi.ErrProviderConfigNameMismatch

+ var ErrProviderConfigTypeMismatch = errors.New("provider config type mismatch")

+ var ErrProviderNameEmpty = providerapi.ErrProviderNameEmpty

+ var ErrProviderNameMismatch = providerapi.ErrProviderNameMismatch

+ var ErrProviderNotConfigured = providerapi.ErrProviderNotConfigured

+ var ErrProviderRegistryNotConfigured = providerapi.ErrProviderRegistryNotConfigured

+ var ErrProviderTypeMismatch = providerapi.ErrProviderTypeMismatch

+ var ErrRegistryNotConfigured = errors.New("component manager registry is not configured")

+ var ErrUnknownComponentManagerImplementation = errors.New("unknown component manager implementation")

+ var ErrUnknownComponentType = cmconfig.ErrUnknownComponentType

+ var ErrUnknownProvider = providerapi.ErrUnknownProvider

+ type BringUpController interface

+ BringUpControl func(ctx context.Context, target common.Target) error

+ GetBringUpStatus func(ctx context.Context, target common.Target) (map[string]operations.MachineBringUpState, error)

+ type Catalog struct

+ func NewCatalog(descriptors []Descriptor) (Catalog, error)

+ func (c Catalog) Get(componentType devicetypes.ComponentType, implementation string) (Descriptor, bool)

+ func (c Catalog) Implementations(componentType devicetypes.ComponentType) []string

+ func (c Catalog) ListImplementations() map[devicetypes.ComponentType][]string

+ type ComponentManager interface

+ FirmwareControl func(ctx context.Context, target common.Target, ...) error

+ GetFirmwareStatus func(ctx context.Context, target common.Target) (map[string]operations.FirmwareUpdateStatus, error)

+ GetPowerStatus func(ctx context.Context, target common.Target) (map[string]operations.PowerStatus, error)

+ InjectExpectation func(ctx context.Context, target common.Target, ...) error

+ PowerControl func(ctx context.Context, target common.Target, ...) error

+ Type func() devicetypes.ComponentType

+ type ComponentManagerFactoryNotConfiguredError struct

+ ComponentType devicetypes.ComponentType

+ Implementation string

+ func (e ComponentManagerFactoryNotConfiguredError) Error() string

+ func (e ComponentManagerFactoryNotConfiguredError) Is(target error) bool

+ type ComponentManagerFactoryNotRegisteredError struct

+ ComponentType devicetypes.ComponentType

+ func (e ComponentManagerFactoryNotRegisteredError) Error() string

+ func (e ComponentManagerFactoryNotRegisteredError) Is(target error) bool

+ type ComponentManagerImplementationNameEmptyError = cmconfig.ComponentManagerImplementationNameEmptyError

+ type Descriptor struct

+ Factory ManagerFactory

+ Implementation string

+ RequiredProviders []string

+ Type devicetypes.ComponentType

+ type DuplicateDescriptorError struct

+ ComponentType devicetypes.ComponentType

+ Implementation string

+ func (e DuplicateDescriptorError) Error() string

+ func (e DuplicateDescriptorError) Is(target error) bool

+ type DuplicateProviderConfigError = cmconfig.DuplicateProviderConfigError

+ type DuplicateProviderError = providerapi.DuplicateProviderError

+ type FirmwareConsistencyChecker interface

+ VerifyFirmwareConsistency func(ctx context.Context, target common.Target) error

+ type ManagerCreationError struct

+ ComponentType devicetypes.ComponentType

+ Err error

+ Implementation string

+ func (e ManagerCreationError) Error() string

+ func (e ManagerCreationError) Is(target error) bool

+ func (e ManagerCreationError) Unwrap() error

+ type ManagerFactory func(providers *providerapi.ProviderRegistry) (ComponentManager, error)

+ type ManagerNotConfiguredError struct

+ ComponentType devicetypes.ComponentType

+ func (e ManagerNotConfiguredError) Error() string

+ func (e ManagerNotConfiguredError) Is(target error) bool

+ type ProviderConfigDecoderNotRegisteredError = cmconfig.ProviderConfigDecoderNotRegisteredError

+ type ProviderConfigNameMismatchError = providerapi.ProviderConfigNameMismatchError

+ type ProviderConfigTypeMismatchError struct

+ Got any

+ Name string

+ Want string

+ func (e ProviderConfigTypeMismatchError) Error() string

+ func (e ProviderConfigTypeMismatchError) Is(target error) bool

+ type ProviderNameMismatchError = providerapi.ProviderNameMismatchError

+ type ProviderNotConfiguredError = providerapi.ProviderNotConfiguredError

+ type ProviderTypeMismatchError = providerapi.ProviderTypeMismatchError

+ type Registry struct

+ func NewRegistry(catalog Catalog, config cmconfig.Config, ...) (*Registry, error)

+ func (r *Registry) FindManager(componentType devicetypes.ComponentType) ComponentManager

+ func (r *Registry) GetAllManagers() []ComponentManager

+ func (r *Registry) GetDescriptor(componentType devicetypes.ComponentType) (Descriptor, error)

+ func (r *Registry) GetManager(componentType devicetypes.ComponentType) (ComponentManager, error)

+ type UnknownComponentManagerImplementationError struct

+ Available []string

+ ComponentType devicetypes.ComponentType

+ Implementation string

+ RegisteredFor []devicetypes.ComponentType

+ func (e UnknownComponentManagerImplementationError) Error() string

+ func (e UnknownComponentManagerImplementationError) Is(target error) bool

+ type UnknownComponentTypeError = cmconfig.UnknownComponentTypeError

+ type UnknownProviderError = providerapi.UnknownProviderError