operator

Forklift Operator

Analyzed from commit: baf9c7bcc307ed9358ad59886a5536366a050012 on 2026-09-17 Source paths: operator/

Package Purpose

The Forklift operator is an Ansible-based operator (operator-sdk) that watches the ForkliftController CRD and reconciles all Forklift components into the target namespace. It uses a single Ansible role (forkliftcontroller) with Jinja2 templates. The CR's .spec fields map to Ansible variables that override defaults in roles/forkliftcontroller/defaults/main.yml.

---

Key Types and Structs

ForkliftController CRD

• Group: forklift.konveyor.io, Version: v1beta1, Kind: ForkliftController
• Watched resource defined in operator/watches.yaml
• Finalizer: forklift.konveyor.io/finalizer (cleanup on deletion via finalize: true)

type ForkliftControllerSpec struct {
    // Feature gates (string "true"/"false")
    FeatureUIPlugin, FeatureValidation, FeatureVolumePopulator, FeatureCopyOffload,
    FeatureOCPLiveMigration, FeatureOVAApplianceManagement, FeatureVMwareSystemSerialNumber,
    FeatureAuthRequired, FeatureCLIDownload, FeatureMCPServer,
    FeatureVSphereVMwareDriverRemoval, FeatureWindowsRegistryNetworkConfig,
    FeatureWindowsWaitForReboot, FeatureUseConversionCR string

    // Container image overrides (FQIN)
    ControllerImageFQIN, VirtV2VImageFQIN, VirtV2VImageXFSFQIN,
    DeepInspectionImageFQIN, DeepInspectionImageXFSFQIN, VDDKImage,
    APIImageFQIN, CLIDownloadImageFQIN, UIPluginImageFQIN, ValidationImageFQIN,
    PopulatorControllerImageFQIN, PopulatorOvirtImageFQIN, PopulatorOpenstackImageFQIN,
    PopulatorVSphereCopyOffloadImageFQIN, OVAProviderServerFQIN, HyperVProviderServerFQIN,
    MustGatherImageFQIN, OVAProxyFQIN string

    // Controller tuning, AAP settings, MCP server config, resource limits...
}

---

Feature Flags

Feature flags flow from the ForkliftController CR through Ansible into controller pod env vars:

ForkliftController CR spec
  → Ansible role variables
    → deployment-controller.yml.j2
      → Pod env vars (FEATURE_*)
        → pkg/settings/features.go