ocp

OpenShift (OCP) Provider

Analyzed from commit: 412c71822 on 2026-05-04

Overview

The OpenShift provider is unique among Forklift providers: it serves as the migration target in every migration, and can also act as a source for OCP-to-OCP (live) migrations. Unlike source-only providers (vSphere, oVirt, OpenStack), it watches native Kubernetes/KubeVirt resources rather than connecting to a vendor-specific API.

Dual Role

Role	When	Resources used
Target	Every migration	StorageClasses, NetworkAttachmentDefinitions, Namespaces
Source	OCP live migration	VirtualMachines, VirtualMachineInstances

Host vs Remote Provider

• Host provider (Spec.URL == ""): represents the local cluster where Forklift is installed. Uses the controller's in-cluster ServiceAccount. Determined by Provider.IsHost().
• Remote OCP provider: connects to a different OCP cluster via Spec.URL + Secret containing a bearer token.
• Restricted host provider: a host-type provider created outside the operator namespace (POD_NAMESPACE). Scoped to its own namespace only; API requests use the requesting user's token for RBAC. Determined by Provider.IsRestrictedHost().

---

Source Files

pkg/controller/provider/
├── container/ocp/    # Inventory collector (K8s watches)
│   ├── collector.go  # Collector factory, Version() stub
│   └── collection.go # Collection types wrapping K8s objects
├── model/ocp/        # Data model (SQLite-backed)
│   ├── model.go      # Base, Namespace, StorageClass, NAD, VM, etc.
│   ├── tree.go       # Tree kinds (VmKind, NamespaceKind)
│   └── doc.go        # All() returns registered model types
└── web/ocp/          # REST API handlers (gin)
    ├── doc.go         # Handler registration, Root path
    ├── base.go        # Base handler, UserClient, list helpers
    ├── provider.go    # GET /providers/openshift[/:uid]
    ├── namespace.go   # .../namespaces[/:uid]
    ├── storageclass.go          # .../storageclasses[/:uid]
    ├── netattachdefinition.go   # .../networkattachmentdefinitions[/:uid]
    ├── vm.go                    # .../vms[/:uid]
    ├── instancetype.go          # .../instancetypes[/:uid]
    ├── clusterinstancetype.go   # .../clusterinstancetypes[/:uid]
    ├── persistentvolumeclaim.go # .../persistentvolumeclaims[/:uid]
    ├── datavolume.go            # .../datavolumes[/:uid]
    ├── kubevirt.go              # .../kubevirts[/:uid]
    ├── tree.go        # .../tree/namespace (VM-by-namespace tree)
    ├── resource.go    # Base REST resource struct
    └── client.go      # Finder + Resolver for ref-based lookups