Kubernetes operator for migrating OpenShift clusters between VMware vCenters (e.g. VMware Cloud Foundation environments).
The operator reconciles the VmwareCloudFoundationMigration custom resource through a multi-phase workflow: preflight validation, destination initialization, RHCOS image import, multi-site configuration, workload migration (workers + control plane), source cleanup, and final health checks.
- User Guide
- Install with OLM
- Install without OLM
- Spec Examples — YAML examples of the migration spec
- Developer Guide
- API Reference — CR spec, status, condition types
- Architecture — package layout, reconciliation flow, requeue strategy
- Development — build, test, deploy, code generation, CI
# Build and deploy the operator
make operator-image operator-push IMG=<registry>/vcf-migration-operator:latest
make deploy IMG=<registry>/vcf-migration-operator:latest
# Apply a sample migration
kubectl apply -k config/samples/For full YAML examples of the migration spec, see Spec Examples. The operator attaches destination cluster ownership tags to the migrated inventory.
See the user docs for full installation instructions and the development guide for building from source.
Contributions are welcome. Run make help for all available targets. See also AGENTS.md for build, lint, and test commands.
Copyright 2026. Licensed under the Apache License, Version 2.0.