storage-map

StorageMap Controller

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

Source: pkg/controller/map/storage/ in the forklift repo.

---

Overview

The StorageMap controller reconciles StorageMap CRs (forklift.konveyor.io/v1beta1). Each StorageMap defines how source provider storage maps to target OpenShift StorageClasses for VM disk migration.

---

Mapping Structure

spec:
  provider:
    source:      { namespace, name }    # ref to source Provider CR
    destination: { namespace, name }    # ref to destination Provider CR (must be OpenShift)
  map:
    - source:                           # ref.Ref — identifies source storage
        id: "<inventory-id>"            # match by ID
        name: "<storage-name>"          # OR match by name (path suffix)
      destination:
        storageClass: "<sc-name>"       # target StorageClass name
        volumeMode: "Filesystem" | "Block"        # optional
        accessMode: "ReadWriteOnce" | "ReadWriteMany" | "ReadOnlyMany"  # optional
      offloadPlugin:                    # optional — per-pair offload config
        vsphereXcopyConfig:             # prefer a single plugin; if both populated, UI resolves CSI first
          secretRef: "<secret-name>"
          storageVendorProduct: "<vendor>"
        # csiVolumeImport:              # CSI Volume Import (MTV-5483); takes precedence when both are set
        #   secretRef: "<secret-name>"
        #   storageVendorProduct: "primera3par"

Destination Fields

Field	Required	Values	Purpose
storageClass	Yes	Any valid SC name	Target StorageClass on OpenShift
volumeMode	No	Filesystem, Block	PVC volume mode
accessMode	No	ReadWriteOnce, ReadWriteMany, ReadOnlyMany	PVC access mode

---

Reconciliation Flow

Reconcile()
 ├─ Fetch StorageMap CR (return if NotFound)
 ├─ BeginStagingConditions()
 ├─ Record Kubernetes events
 ├─ validate(mp)
 │   ├─ ProviderPair.Validate() — validate source + destination providers
 │   │   └─ Short-circuit if any provider condition is set
 │   ├─ validateSource(mp) — check source storage against inventory
 │   └─ validateDestination(mp) — check destination StorageClasses against inventory
 ├─ Set Ready condition (if no blocker conditions)
 ├─ EndStagingConditions()
 └─ Update status (ObservedGeneration = Generation)