VMs nach OpenShift Virtualization:
der komplette Fahrplan

Datastores, Netze, Hosts und VMs werden per Managed Object Reference (moRef) referenziert. Die holst du dir aus dem Inventory-Service:

# Route des Inventory-Service und Token
oc get route -n openshift-mtv
TOKEN=$(oc whoami -t)

# Provider-ID, dann z. B. Datastores auflisten
curl -H "Authorization: Bearer $TOKEN" https://<inventory_route>/providers/vsphere -k
curl -H "Authorization: Bearer $TOKEN" https://<inventory_route>/providers/vsphere/<provider_id>/datastores/ -k

Im JSON steht die moRef im Feld id (z. B. datastore-11).

Das Secret trägt Labels, damit MTV es dem Provider-Typ zuordnen kann; der Provider verweist zurück auf das Secret.

cat <<'EOF' | oc apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: vsphere-creds
  namespace: openshift-mtv
  labels:
    createdForProviderType: vsphere
    createdForResourceType: providers
type: Opaque
stringData:
  user: <user>
  password: <password>
  insecureSkipVerify: "false"
  cacert: |
    <ca_certificate>
  url: https://<vCenter_host>/sdk
EOF

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Provider
metadata:
  name: vsphere-source
  namespace: openshift-mtv
spec:
  type: vsphere
  url: https://<vCenter_host>/sdk
  settings:
    vddkInitImage: <VDDK_image>
    sdkEndpoint: vcenter
  secret:
    name: vsphere-creds
    namespace: openshift-mtv
EOF

Ganze Migration: Migration-CR löschen. Einzelne VMs: in den spec.cancel-Block der laufenden Migration-CR eintragen – der Rest läuft weiter.

oc delete migration <migration> -n openshift-mtv

# oder gezielt einzelne VMs (per moRef-id oder name)
cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Migration
metadata:
  name: <migration>
  namespace: openshift-mtv
spec:
  cancel:
  - id: vm-102
  - name: rhel8-vm
EOF

Deep Inspection mountet die Disks in einem Inspection-Pod und analysiert Gast-OS, Dateisysteme und bekannte Konvertierungsprobleme – Fehler fallen so vor der Migration auf statt mittendrin. Läuft in Batches von 10 gleichzeitig; braucht VDDK und aktiviertes CBT.

# Conversion-CR mit conversion-type: DeepInspection anlegen, dann:
oc get conversion <vm_name>-inspection -n openshift-mtv -o json | jq '.status.phase'
oc get conversion <vm_name>-inspection -n openshift-mtv -o json | jq '.status.inspectionResult'

Pods und PVCs räumt MTV nach der Inspektion selbst auf. Tech Preview – nicht für Produktion supportet.

Fehlerquellen vor dem Start beseitigen, statt sie mitten in der Migration zu debuggen: Antivirus aus den Quell-VMs entfernen, vMotion/svMotion für die betroffenen VMs deaktivieren, VM-Namen auf DNS-Konformität prüfen. Für warm: CBT auf jeder VM und jeder Disk aktivieren. vSphere-Rechte auf Datacenter-Ebene mit Propagierung vergeben.

Ohne gültige Credentials kommt der Provider nie auf Ready – das Secret ist das Fundament.

cat <<'EOF' | oc apply -f -
apiVersion: v1
kind: Secret
metadata:
  name: vsphere-creds
  namespace: openshift-mtv
  labels:
    createdForProviderType: vsphere
    createdForResourceType: providers
type: Opaque
stringData:
  user: <user>
  password: <password>
  insecureSkipVerify: "false"
  cacert: |
    <ca_certificate>
  url: https://<vCenter_host>/sdk
EOF

Der Provider macht die Quelle für MTV sichtbar; das VDDK-Image beschleunigt jeden Transfer. Die Host-CR bindet den ESXi an das Migrationsnetz.

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Provider
metadata:
  name: vsphere-source
  namespace: openshift-mtv
spec:
  type: vsphere
  url: https://<vCenter_host>/sdk
  settings:
    vddkInitImage: <VDDK_image>
    sdkEndpoint: vcenter
  secret:
    name: vsphere-creds
    namespace: openshift-mtv
EOF

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Host
metadata:
  name: esxi-01
  namespace: openshift-mtv
spec:
  provider:
    namespace: openshift-mtv
    name: vsphere-source
  id: <source_host_mor>
  ipAddress: <source_network_ip>
EOF

Maps und VM-Liste referenzieren vSphere-Objekte per moRef – ohne die IDs geht nichts weiter.

TOKEN=$(oc whoami -t)
curl -H "Authorization: Bearer $TOKEN" https://<inventory_route>/providers/vsphere -k
curl -H "Authorization: Bearer $TOKEN" https://<inventory_route>/providers/vsphere/<provider_id>/datastores/ -k

Jedes Quellnetz braucht ein Ziel – pod, multus (mit NAD und Namespace) oder ignored, wenn ein Netz bewusst nicht mitkommen soll.

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: NetworkMap
metadata:
  name: vmware-netmap
  namespace: openshift-mtv
spec:
  map:
    - destination:
        name: <network_name>
        type: pod
      source:
        id: <source_network_id>
    - destination:
        name: <network_attachment_definition>
        namespace: <nad_namespace>
        type: multus
      source:
        id: <source_network_id>
  provider:
    source:
      name: vsphere-source
      namespace: openshift-mtv
    destination:
      name: <destination_provider>
      namespace: openshift-mtv
EOF

Datastore-moRef auf StorageClass; accessMode (ReadWriteOnce/ReadWriteMany) ist bei normalen VMware-Migrationen Pflicht.

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: StorageMap
metadata:
  name: vmware-storagemap
  namespace: openshift-mtv
spec:
  map:
    - destination:
        storageClass: <storage_class>
        accessMode: ReadWriteOnce
      source:
        id: <source_datastore>
  provider:
    source:
      name: vsphere-source
      namespace: openshift-mtv
    destination:
      name: <destination_provider>
      namespace: openshift-mtv
EOF

Der Plan bündelt VMs, Maps und Verhalten. warm: false für cold; preserveStaticIPs: true, wenn Gäste statische IPs an Interface-Namen binden.

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Plan
metadata:
  name: vmware-plan
  namespace: openshift-mtv
spec:
  warm: false
  provider:
    source:
      name: vsphere-source
      namespace: openshift-mtv
    destination:
      name: <destination_provider>
      namespace: openshift-mtv
  map:
    network:
      name: vmware-netmap
      namespace: openshift-mtv
    storage:
      name: vmware-storagemap
      namespace: openshift-mtv
  preserveStaticIPs: true
  targetNamespace: <target_namespace>
  vms:
    - id: <vm_moref>
    - name: <vm_name>
EOF

Erst diese CR setzt den Plan in Bewegung. Bei warm gehört hier die Cutover-Zeit hinein – ohne sie läuft nur Precopy.

cat <<'EOF' | oc apply -f -
apiVersion: forklift.konveyor.io/v1beta1
kind: Migration
metadata:
  name: vmware-migration-1
  namespace: openshift-mtv
spec:
  plan:
    name: vmware-plan
    namespace: openshift-mtv
  cutover: 2026-08-10T22:00:00.000+02:00
EOF

Ab jetzt: keine Snapshots mehr auf den Quell-VMs anlegen.

Pro Disk entsteht ein DataVolume → PVC → Importer-Pod; danach der Conversion-Pod mit virt-v2v, dann die VirtualMachine-CR. Der Migration Controller startet die VM nur, wenn sie auch auf der Quelle lief.

oc get migration vmware-migration-1 -n openshift-mtv -o yaml
oc get pods -n <target_namespace> -w
# Logs des Conversion-Pods bei Hängern:
oc logs <conversion_pod> -n <target_namespace>

Plan-Status muss auf Completed stehen; danach in der Ziel-VM prüfen, dass sie bootet, alle Disks sieht und das Netz stimmt. Der Power-State der Quelle wird übernommen – eine ausgeschaltete Quell-VM bleibt auch am Ziel aus.

oc get plan vmware-plan -n openshift-mtv -o jsonpath='{.status.conditions}'
oc get vm -n <target_namespace>