host-controller

Host Controller

Analyzed from commit: baf9c7bcc307ed9358ad59886a5536366a050012 on 2026-09-17 Source paths: pkg/controller/host/

Package Purpose

The Host CRD represents an ESXi host used for direct disk transfer during vSphere migrations. The controller validates the host configuration (provider, inventory ref, IP, credentials) and tests connectivity to the ESXi SDK endpoint. Only vSphere providers are supported for host operations — all other provider types set a TypeNotValid blocker condition. Non-vSphere inventory handlers are no-ops.

---

Key Types and Structs

HostSpec (pkg/apis/forklift/v1beta1/host.go)

type HostSpec struct {
    ref.Ref `json:",inline"`              // inventory host ref (id/name)
    Provider core.ObjectReference         // vSphere Provider ref
    IpAddress string                      // ESXi IP for disk transfer
    Secret core.ObjectReference           // credentials Secret
}

Reconciler (pkg/controller/host/controller.go)

type Reconciler struct {
    base.Reconciler
}

Runtime fields populated during validation: host.Provider.Source (Provider CR), host.Secret (Secret CR).

Handler factory (pkg/controller/host/handler/doc.go)

Provider-type dispatch for inventory watches:

Provider type	Handler	Behavior
vSphere	handler/vsphere	Watches vsphere.Host inventory model
oVirt, OpenStack, Ova, HyperV, OpenShift	per-provider handlers	No-op Watch()
EC2, Azure	NoOpHostHandler	No host-level operations
Nutanix	handler/nutanix	No-op (no ESXi-style hosts)

---

Interfaces and Implementations

type Handler interface {
    Watch(m *handler.WatchManager) error
}

• vSphere handler (handler/vsphere/handler.go): implements inventory event callbacks (Created, Updated, Deleted) and enqueues reconcile events for matching Host CRs.
• ProviderPredicate (predicate.go): embeds handler.WatchManager; calls handler.New() and Watch() when a Provider becomes Ready.