Overview

This epic tracks the implementation of a Kubernetes-native solution for recovering individual files from KubeVirt Virtual Machine backups created with OADP in OpenShift.

Design Document

Full design available in PR: https://github.com/openshift/oadp-operator/pull/1992

Feature pulled into OADP via https://github.com/openshift/oadp-operator/pull/2003

Notes on testing, which ultimately worked, but were not doc'd but follow the same steps as

https://github.com/openshift/oadp-operator/pull/2003#issuecomment-3559012821

Key Technologies

• libguestfs — Provides access to VM disk images without booting the virtual machine
• Privileged Containers — Required for filesystem mounting operations (mount/umount are kernel-level operations requiring CAP_SYS_ADMIN or privileged: true)

Important Notes

• FUSE (Filesystem in Userspace) mounting requires elevated privileges in Kubernetes
• Solution requires running in privileged container mode for performant operations
• Design focuses on Kubernetes-native approach for file-level recovery from VM backups

Related

• Design PR: #1992
• Approved: October 14, 2025