maqet 0.0.1.3__py3-none-any.whl → 0.0.5__py3-none-any.whl

maqet/storage.py

@@ -1,196 +1,736 @@
+"""
+Unified Storage Management System
 
-from abc import ABCMeta, abstractmethod
-from pathlib import Path
+Provides extensible storage device management with integrated snapshot support.
+Supports multiple storage types (QCOW2, Raw, VirtFS) with plugin-style extensibility.
+"""
 
-from benedict import benedict
+import fcntl
+import os
+import re
+import shutil
+import subprocess
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Type
 
-from .functions import parse_args
-from .functions import shell_command as cmd
 from .logger import LOG
 
-MESSAGE = r"""
- _                _      __  __           _   _         _   _                 _     _ 
-| |    ___   ___ | | __ |  \/  | __ _    | \ | | ___   | | | | __ _ _ __   __| |___| |
-| |   / _ \ / _ \| |/ / | |\/| |/ _` |   |  \| |/ _ \  | |_| |/ _` | '_ \ / _` / __| |
-| |__| (_) | (_) |   <  | |  | | (_| |_  | |\  | (_) | |  _  | (_| | | | | (_| \__ \_|
-|_____\___/ \___/|_|\_\ |_|  |_|\__,_( ) |_| \_|\___/  |_| |_|\__,_|_| |_|\__,_|___(_)
-                                     |/
-"""
 
+class StorageError(Exception):
+    """Storage operation errors."""
 
-class DriveError(Exception):
-    """
-    Exception called when error in Drive happens
-    """
 
+class BaseStorageDevice(ABC):
+    """Abstract base class for all storage devices.
 
-class IDrive(metaclass=ABCMeta):
-    """
-    Interface for drive classes
+    # NOTE: Good - abstract base classes with @abstractmethod decorators
+    # enforce
+    # a consistent interface across all storage types. This makes the system
+    #       predictable and extensible.
     """
 
+    def __init__(self, config: Dict[str, Any], vm_id: str, index: int):
+        """
+        Initialize storage device.
+
+        Args:
+            config: Storage device configuration dictionary
+            vm_id: VM identifier
+            index: Device index for naming/ordering
+        """
+        self.config = config
+        self.vm_id = vm_id
+        self.index = index
+        self.name = config.get("name", f"storage{index}")
+
     @abstractmethod
-    def __init__(self, path: Path, *args, **kwargs):
-        """INTERFACE METHOD"""
+    def get_qemu_args(self) -> List[str]:
+        """
+        Get QEMU command line arguments for this storage device.
+
+        Returns:
+            List of QEMU arguments
+        """
 
     @abstractmethod
-    def __call__(self) -> str:
-        """INTERFACE METHOD"""
+    def create_if_needed(self) -> None:
+        """Create storage device if it doesn't exist and should be auto-created."""
 
+    @abstractmethod
+    def supports_snapshots(self) -> bool:
+        """Check if this storage type supports snapshots."""
 
-class FileDrive(IDrive):
-    """
-    Superclass of drives using files like raw or QCOW2
-    """
+    def get_info(self) -> Dict[str, Any]:
+        """
+        Get information about this storage device.
+
+        Returns:
+            Dictionary with device information
+        """
+        return {
+            "name": self.name,
+            "type": self.get_type(),
+            "config": self.config,
+            "supports_snapshots": self.supports_snapshots(),
+        }
+
+    @abstractmethod
+    def get_type(self) -> str:
+        """Get storage device type name."""
+
+
+class FileBasedStorageDevice(BaseStorageDevice):
+    """Base class for file-based storage devices (QCOW2, Raw)."""
+
+    VALID_INTERFACES = {"virtio", "sata", "ide", "scsi", "none"}
+
+    def __init__(self, config: Dict[str, Any], vm_id: str, index: int):
+        """Initialize file-based storage device."""
+        super().__init__(config, vm_id, index)
+
+        # Get or generate file path
+        self.file_path = self._get_file_path()
+        self.size = config.get("size", "10G")
+        self.interface = config.get("interface", "virtio")
+
+        # Validate configuration
+        self._validate_size(self.size)
+        self._validate_interface(self.interface)
+
+    def _get_file_path(self) -> Path:
+        """Get storage file path, generating default if needed."""
+        file_config = self.config.get("file")
+        if file_config:
+            return Path(file_config)
+
+        # Generate default path in /tmp
+        file_extension = self.get_type().lower()
+        return Path(f"/tmp/maqet-{self.vm_id}-{self.name}.{file_extension}")
+
+    def _validate_size(self, size: str) -> None:
+        """Validate size format is compatible with qemu-img."""
+        size_pattern = r"^\d+[KMGT]?$"
+        if not re.match(size_pattern, str(size), re.IGNORECASE):
+            raise ValueError(
+                f"Invalid size format '{size}'. "
+                "Expected format: number[KMGT] (e.g., 10G, 512M)"
+            )
+
+    def _validate_interface(self, interface: str) -> None:
+        """Validate interface type is supported."""
+        if interface not in self.VALID_INTERFACES:
+            raise ValueError(
+                f"Invalid interface '{interface}'. "
+                f"Valid interfaces: {', '.join(sorted(self.VALID_INTERFACES))}"
+            )
+
+    def create_if_needed(self) -> None:
+        """Create storage file if it doesn't exist and should be auto-created."""
+        if not self.file_path.exists() and self._should_auto_create():
+            self._create_storage_file()
+
+    def _should_auto_create(self) -> bool:
+        """Determine if we should auto-create this storage file."""
+        try:
+            path_str = str(self.file_path)
+
+            # Don't auto-create in system directories
+            system_paths = [
+                "/etc",
+                "/var",
+                "/usr",
+                "/bin",
+                "/boot",
+                "/sys",
+                "/proc",
+            ]
+            if any(path_str.startswith(sys_path) for sys_path in system_paths):
+                return False
+
+            # Check if we can write to parent directory
+            try:
+                self.file_path.parent.mkdir(parents=True, exist_ok=True)
+                return True
+            except PermissionError:
+                return False
+
+        except Exception:
+            return False
+
+    def _create_storage_file(self) -> None:
+        """Create storage file using qemu-img.
+
+        Includes disk space validation, concurrency protection via file locking,
+        and cleanup of partial files on failure.
+        """
+        lock_file = None
+        partial_file_created = False
+
+        try:
+            # Verify qemu-img binary exists
+            qemu_img_path = shutil.which("qemu-img")
+            if not qemu_img_path:
+                raise StorageError(
+                    "qemu-img binary not found in PATH. "
+                    "Please install QEMU tools (qemu-utils or qemu-img package)."
+                )
+
+            self.file_path.parent.mkdir(parents=True, exist_ok=True)
+
+            # Check available disk space before creating file
+            required_bytes = self._parse_size_to_bytes(self.size)
+            stat = os.statvfs(self.file_path.parent)
+            available_bytes = stat.f_bavail * stat.f_frsize
+
+            # Add 10% buffer for QCOW2 metadata overhead
+            if self.get_type().lower() == "qcow2":
+                required_bytes = int(required_bytes * 1.1)
+
+            if required_bytes > available_bytes:
+                raise StorageError(
+                    f"Insufficient disk space for {self.file_path}. "
+                    f"Required: {self._format_bytes(required_bytes)}, "
+                    f"Available: {self._format_bytes(available_bytes)}. "
+                    f"Free up disk space and try again."
+                )
+
+            # Use file locking to prevent concurrent creation of same file
+            lock_file_path = (
+                self.file_path.parent / f".{self.file_path.name}.lock"
+            )
+            lock_file = open(lock_file_path, "w")
+
+            try:
+                # Try to acquire exclusive lock (non-blocking)
+                fcntl.flock(lock_file.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB)
+            except BlockingIOError:
+                raise StorageError(
+                    f"Storage file {self.file_path} is being created by another process. "
+                    f"Wait for completion or remove lock: {lock_file_path}"
+                )
+
+            # Check again if file was created while we were waiting for lock
+            if self.file_path.exists():
+                LOG.warning(
+                    f"Storage file {self.file_path} already exists, skipping creation"
+                )
+                return
+
+            LOG.info(
+                f"Creating {self.get_type()} storage file: "
+                f"{self.file_path} ({self.size})"
+            )
+
+            cmd = [
+                "qemu-img",
+                "create",
+                "-f",
+                self.get_type().lower(),
+                str(self.file_path),
+                self.size,
+            ]
+
+            result = subprocess.run(
+                cmd, capture_output=True, text=True, check=True
+            )
+            partial_file_created = True  # Mark that file was created
+            LOG.info(f"Successfully created storage file: {self.file_path}")
+
+        except subprocess.CalledProcessError as e:
+            # Remove partial file if creation failed
+            if partial_file_created and self.file_path.exists():
+                LOG.warning(f"Removing partial storage file: {self.file_path}")
+                try:
+                    self.file_path.unlink()
+                except Exception as cleanup_error:
+                    LOG.error(f"Failed to remove partial file: {cleanup_error}")
+
+            LOG.error(
+                f"Failed to create storage file {self.file_path}: {e.stderr}"
+            )
+            raise StorageError(f"Failed to create storage file: {e.stderr}")
+
+        except Exception as e:
+            # Remove partial file on any error
+            if partial_file_created and self.file_path.exists():
+                LOG.warning(f"Removing partial storage file: {self.file_path}")
+                try:
+                    self.file_path.unlink()
+                except Exception as cleanup_error:
+                    LOG.error(f"Failed to remove partial file: {cleanup_error}")
+
+            LOG.error(
+                f"Unexpected error creating storage file {self.file_path}: {e}"
+            )
+            raise StorageError(f"Failed to create storage file: {e}")
+
+        finally:
+            # Release lock and clean up lock file
+            if lock_file:
+                try:
+                    fcntl.flock(lock_file.fileno(), fcntl.LOCK_UN)
+                    lock_file.close()
+                    Path(lock_file.name).unlink(missing_ok=True)
+                except Exception as e:
+                    LOG.debug(f"Error cleaning up lock file: {e}")
+
+    def _parse_size_to_bytes(self, size_str: str) -> int:
+        """Parse size string (e.g., '10G', '512M') to bytes."""
+        match = re.match(r"^(\d+)([KMGT]?)$", str(size_str), re.IGNORECASE)
+        if not match:
+            raise ValueError(f"Invalid size format: {size_str}")
+
+        number = int(match.group(1))
+        unit = match.group(2).upper() if match.group(2) else ""
+
+        multipliers = {
+            "": 1,
+            "K": 1024,
+            "M": 1024**2,
+            "G": 1024**3,
+            "T": 1024**4,
+        }
+
+        return number * multipliers[unit]
+
+    def _format_bytes(self, bytes_value: int) -> str:
+        """Format bytes to human-readable string."""
+        for unit in ["B", "KB", "MB", "GB", "TB"]:
+            if bytes_value < 1024.0:
+                return f"{bytes_value:.1f}{unit}"
+            bytes_value /= 1024.0
+        return f"{bytes_value:.1f}PB"
+
+    def get_qemu_args(self) -> List[str]:
+        """Get QEMU arguments for file-based storage."""
+        drive_spec = (
+            f"file={self.file_path},if={self.interface},"
+            f"format={self.get_type().lower()}"
+        )
+        return ["-drive", drive_spec]
+
+    def get_info(self) -> Dict[str, Any]:
+        """Get detailed information about file-based storage."""
+        info = super().get_info()
+        info.update(
+            {
+                "file_path": str(self.file_path),
+                "size": self.size,
+                "interface": self.interface,
+                "exists": self.file_path.exists(),
+            }
+        )
+        return info
+
+
+class QCOW2StorageDevice(FileBasedStorageDevice):
+    """QCOW2 storage device with snapshot support."""
+
+    def get_type(self) -> str:
+        """Get storage type."""
+        return "qcow2"
+
+    def supports_snapshots(self) -> bool:
+        """QCOW2 supports snapshots."""
+        return True
+
+    @staticmethod
+    def __default_options():
+        return {
+            'security_model': 'none',
+            'writeout': 'immediate',
+        }
+
+class RawStorageDevice(FileBasedStorageDevice):
+    """Raw storage device without snapshot support."""
+
+    def get_type(self) -> str:
+        """Get storage type."""
+        return "raw"
+
+    def supports_snapshots(self) -> bool:
+        """Raw storage does not support snapshots."""
+        return False
+
+
+class VirtFSStorageDevice(BaseStorageDevice):
+    """VirtFS (9p) storage device for folder sharing."""
+
+    VALID_SECURITY_MODELS = {
+        "passthrough",
+        "mapped-xattr",
+        "mapped-file",
+        "none",
+    }
+
+    def __init__(self, config: Dict[str, Any], vm_id: str, index: int):
+        """Initialize VirtFS storage device."""
+        super().__init__(config, vm_id, index)
+
+        self.share_path = config.get("path", "./share")
+        self.options = config.get("options", {})
+        self.mount_tag = self.options.get("mount_tag", self.name)
+        self.fs_id = self.options.get("id", self.name)
+        self.readonly = self.options.get("readonly", False)
+
+        # Validate configuration
+        self._validate_security_model()
+        self._validate_share_path()
+
+    def get_type(self) -> str:
+        """Get storage type."""
+        return "virtfs"
+
+    def supports_snapshots(self) -> bool:
+        """VirtFS does not support snapshots."""
+        return False
+
+    def _validate_security_model(self) -> None:
+        """Validate security_model is one of the supported values."""
+        security_model = self.options.get("security_model", "passthrough")
+        if security_model not in self.VALID_SECURITY_MODELS:
+            raise ValueError(
+                f"Invalid security_model '{security_model}'. "
+                f"Valid models: {', '.join(sorted(self.VALID_SECURITY_MODELS))}"
+            )
+
+    def _validate_share_path(self) -> None:
+        """Validate share_path exists, is accessible, and is safe to share."""
+        share_path = Path(self.share_path)
+
+        # Security: Check for dangerous paths
+        # Canonicalize path to resolve symlinks and relative paths
+        try:
+            canonical_path = share_path.resolve()
+        except (OSError, RuntimeError) as e:
+            raise ValueError(
+                f"Cannot resolve VirtFS share path {share_path}: {e}"
+            )
+
+        # Define dangerous paths that should not be shared
+        dangerous_paths = {
+            Path("/"),
+            Path("/etc"),
+            Path("/sys"),
+            Path("/proc"),
+            Path("/dev"),
+            Path("/root"),
+            Path("/boot"),
+            Path("/var"),
+            Path("/usr"),
+            Path("/bin"),
+            Path("/sbin"),
+            Path("/lib"),
+            Path("/lib64"),
+        }
+
+        # Check if canonical path matches or is parent of any dangerous path
+        for dangerous in dangerous_paths:
+            try:
+                dangerous_canonical = dangerous.resolve()
+                # Check if share path is the dangerous path or a parent of it
+                if canonical_path == dangerous_canonical:
+                    raise ValueError(
+                        f"Refusing to share dangerous system path: {canonical_path}. "
+                        f"Sharing {dangerous} would expose critical system files to the VM."
+                    )
+                # Check if any dangerous path is within the share path
+                try:
+                    dangerous_canonical.relative_to(canonical_path)
+                    raise ValueError(
+                        f"Refusing to share {canonical_path} because it contains "
+                        f"dangerous system path {dangerous}. This would expose critical "
+                        f"system files to the VM."
+                    )
+                except ValueError:
+                    # relative_to raises ValueError if not a subpath - this is
+                    # good
+                    pass
+            except (OSError, RuntimeError):
+                # Can't resolve dangerous path - skip this check
+                pass
+
+        # Warn if symlink (path is different from canonical path)
+        if canonical_path != share_path.resolve():
+            LOG.warning(
+                f"VirtFS share path {share_path} is a symlink to {canonical_path}. "
+                f"The resolved path will be shared."
+            )
+
+        # Use canonical path for remaining checks
+        share_path = canonical_path
+
+        # Check if path exists
+        if not share_path.exists():
+            LOG.warning(
+                f"VirtFS share path does not exist: {share_path}. "
+                "It will be created when VM starts."
+            )
+            return
+
+        # Check if it's a directory
+        if not share_path.is_dir():
+            raise ValueError(
+                f"VirtFS share path must be a directory: {share_path}"
+            )
+
+        # Check if readable
+        if not os.access(share_path, os.R_OK):
+            raise ValueError(
+                f"VirtFS share path is not readable: {share_path}"
+            )
+
+        # Check if writable (unless readonly mode)
+        if not self.readonly and not os.access(share_path, os.W_OK):
+            raise ValueError(
+                f"VirtFS share path is not writable: {share_path}. "
+                "Set readonly=true in options if read-only access is intended."
+            )
+
+    def create_if_needed(self) -> None:
+        """Ensure share directory exists."""
+        share_dir = Path(self.share_path)
+        try:
+            share_dir.mkdir(parents=True, exist_ok=True)
+            LOG.debug(f"VirtFS share directory ready: {share_dir}")
+        except Exception as e:
+            LOG.warning(f"Could not create VirtFS directory {share_dir}: {e}")
+
+    def get_qemu_args(self) -> List[str]:
+        """Get QEMU arguments for VirtFS."""
+        security_model = self.options.get("security_model", "passthrough")
+
+        # Build VirtFS arguments starting with required fields
+        virtfs_args = (
+            f"local,path={self.share_path},mount_tag={self.mount_tag},"
+            f"security_model={security_model},id={self.fs_id}"
+        )
 
-    def size(self) -> int:
-        r = cmd(
-            f"qemu-img info {self._path} | grep 'virtual size' | "
-            "grep -o '(.*)' | grep -o '[0-9]*'")
-        return int(r.stdout)
+        # Add readonly if specified
+        if self.readonly:
+            virtfs_args += ",readonly=on"
+
+        # Add any additional options from config
+        for key, value in self.options.items():
+            if key not in ["mount_tag", "id", "security_model", "readonly"]:
+                virtfs_args += f",{key}={value}"
+
+        return ["-virtfs", virtfs_args]
+
+    def get_info(self) -> Dict[str, Any]:
+        """Get VirtFS information."""
+        info = super().get_info()
+        info.update(
+            {
+                "share_path": self.share_path,
+                "mount_tag": self.mount_tag,
+                "fs_id": self.fs_id,
+                "exists": Path(self.share_path).exists(),
+            }
+        )
+        return info
 
-    def __call__(self) -> str:
-        argument = benedict({'drive': {'file': self._path}})
-        if 'options' in self._config:
-            argument.drive.merge(self._config.options)
 
-        return parse_args([argument])
+def validate_storage_config(storage_configs: List[Dict[str, Any]]) -> None:
+    """
+    Validate storage configuration without creating device objects.
 
-    def _fix_suffix(self, path: Path | str) -> Path:
-        path = Path(path).resolve()
-        if path.suffix == '':
-            path = path.parent / (path.name + '.' + self._config.type)
-        return path
+    This allows early validation during config parsing to fail fast
+    with clear errors before VM creation. Called from ConfigParser.
 
+    Args:
+        storage_configs: List of storage configuration dictionaries
 
-class RawDrive(FileDrive):
+    Raises:
+        ValueError: If storage configuration is invalid
     """
-    Drive in RAW format, no COW snapshots
+    if not isinstance(storage_configs, list):
+        raise ValueError("Storage configuration must be a list")
+
+    for index, config in enumerate(storage_configs):
+        if not isinstance(config, dict):
+            raise ValueError(f"Storage {index}: Configuration must be a dictionary")
+
+        storage_type = config.get("type", "qcow2").lower()
+
+        # Validate storage type
+        supported_types = ["qcow2", "raw", "virtfs"]
+        if storage_type not in supported_types:
+            raise ValueError(
+                f"Storage {index}: Unknown type '{storage_type}'. "
+                f"Supported types: {', '.join(supported_types)}"
+            )
+
+        # Validate type-specific config
+        if storage_type in ("qcow2", "raw"):
+            # Validate size format (if provided)
+            if "size" in config:
+                size = config["size"]
+                size_pattern = r"^\d+[KMGT]?$"
+                if not re.match(size_pattern, str(size), re.IGNORECASE):
+                    raise ValueError(
+                        f"Storage {index}: Invalid size format '{size}'. "
+                        "Expected format: number[KMGT] (e.g., 10G, 512M)"
+                    )
+
+            # Validate interface (if provided)
+            if "interface" in config:
+                interface = config["interface"]
+                valid_interfaces = {"virtio", "sata", "ide", "scsi", "none"}
+                if interface not in valid_interfaces:
+                    raise ValueError(
+                        f"Storage {index}: Invalid interface '{interface}'. "
+                        f"Valid interfaces: {', '.join(sorted(valid_interfaces))}"
+                    )
+
+        elif storage_type == "virtfs":
+            # Validate security model (if provided)
+            options = config.get("options", {})
+            if "security_model" in options:
+                security_model = options["security_model"]
+                valid_security_models = {
+                    "passthrough",
+                    "mapped-xattr",
+                    "mapped-file",
+                    "none",
+                }
+                if security_model not in valid_security_models:
+                    raise ValueError(
+                        f"Storage {index}: Invalid security_model '{security_model}'. "
+                        f"Valid models: {', '.join(sorted(valid_security_models))}"
+                    )
+
+            # Validate path is provided
+            if "path" not in config:
+                raise ValueError(
+                    f"Storage {index}: VirtFS storage requires 'path' field"
+                )
+
+
+class StorageManager:
+    """
+    Manages VM storage devices with extensible type system.
+
+    Provides unified interface for different storage types and integrates
+    with snapshot functionality.
+
+    # NOTE: Good - plugin architecture with device type registry allows easy
+    #       addition of new storage types without modifying existing code.
+    #       Just implement BaseStorageDevice and register.
+    # NOTE: Storage validation happens both at config parse time
+    # (validate_storage_config)
+    # and at device creation time (device __init__). Early validation provides
+    # clear errors before VM creation. Device validation includes runtime
+    # checks
+    #       like path resolution and disk space.
     """
 
-    def __init__(self, path: Path,
-                 *args, **kwargs):
-        self._path = self._fix_suffix(path)
-        self._config = benedict(kwargs)
+    # Registry of storage device types
+    _device_types: Dict[str, Type[BaseStorageDevice]] = {
+        "qcow2": QCOW2StorageDevice,
+        "raw": RawStorageDevice,
+        "virtfs": VirtFSStorageDevice,
+    }
 
-        self._path.parent.mkdir(parents=True, exist_ok=True)
-        if not self._path.exists():
-            LOG.info(f'Creating RawDrive on path {self._path}')
-            cmd(f"qemu-img create -f raw {self._path} {kwargs['size']}")
-        else:
-            LOG.info(f'Collecting RawDrive on path {self._path}')
+    def __init__(self, vm_id: str):
+        """
+        Initialize storage manager for a VM.
 
-    def clean(self) -> None:
-        LOG.info(f'Recreating {self._config.type} drive on path {self._path}')
-        size = self.size()
-        cmd(f"rm -f {self._path}")
-        cmd(f"qemu-img create -f {self._config.type} {self._path} {size}")
+        Args:
+            vm_id: VM identifier
+        """
+        self.vm_id = vm_id
+        self.devices: List[BaseStorageDevice] = []
 
+    @classmethod
+    def register_device_type(
+        cls, type_name: str, device_class: Type[BaseStorageDevice]
+    ):
+        """
+        Register a new storage device type.
 
-class QCOW2Drive(FileDrive):
-    """
-    Drive in QCOW2 format
-    """
+        Args:
+            type_name: Storage type name (e.g., 'nvme', 'scsi')
+            device_class: Storage device class
+        """
+        cls._device_types[type_name.lower()] = device_class
+        LOG.debug(f"Registered storage device type: {type_name}")
 
-    def __init__(self,
-                 path: Path,
-                 *args, **kwargs):
-        self._path = path
-        self._config = benedict(kwargs)
-
-        self._path = self._fix_suffix(path)
-        self._path.parent.mkdir(parents=True, exist_ok=True)
-
-        self.__create()
-
-    def __create(self):
-        if not self._path.exists():
-            if 'backing' in self._config:
-                self._config.backing = Path(self._config.backing).resolve()
-                LOG.info(f'Creating QCOW2Drive at {self._path} '
-                         f'using backing image at {self._config.backing}')
-                r = cmd(f"qemu-img create -f qcow2 {self._path} "
-                        f"-b {self._config.backing} -F qcow2")
-            else:
-                LOG.info(f'Creating QCOW2Drive on path {self._path}')
-                r = cmd("qemu-img create -f qcow2 "
-                        f"{self._path} {self._config.size}")
-            if r.rc > 0:
-                raise DriveError(f"Error on creating QCOW2Drive:\n{r}")
-        else:
-            LOG.info(f'Collecting QCOW2Drive on path {self._path}')
-
-    def clean(self) -> None:
-        LOG.info(f'Recreating {self._config.type} drive on path {self._path}')
-        cmd(f"rm -f {self._path}")
-        self.__create()
-
-    def snapshot(self, name: str, overwrite=False) -> None:
-        """
-        create or revert to internal image snapshot
-        If overwrite stated - existing snapshot deleted and created
-        If not stated - existing snapshot loaded
-        """
-        if name in self.snapshots:
-            if overwrite:
-                LOG.info(f'Recreating snapshot {
-                         name} QCOW2Drive on path {self._path}')
-                cmd(f"qemu-img snapshot {self._path} -d {name}")
-                cmd(f"qemu-img snapshot {self._path} -c {name}")
-            else:
-                LOG.info(f'Reverting QCOW2Drive on path {
-                         self._path} to snapshot {name}')
-                cmd(f"qemu-img snapshot {self._path} -a {name}")
-        else:
-            LOG.info(f'Creating snapshot {
-                     name} QCOW2Drive on path {self._path}')
-            cmd(f"qemu-img snapshot {self._path} -c {name}")
-
-    @property
-    def snapshots(self):
-        return cmd("qemu-img snapshot {path} -l | awk 'NR>2 {{print $2}}'"
-                   .format(path=self._path)).stdout.split('\n')
-
-    @property
-    def backing_chain(self) -> list[Path]:
-        """
-        Backing chain as list of paths
-        """
-        paths = cmd(f"qemu-img info --backing-chain {self._path} "
-                    "| grep image | awk '{{print $2}}'").stdout.split('\n')
-        paths.reverse()
-        paths = [str(Path(x)) for x in paths]
-        return paths
-
-
-DRIVE_TYPES = {
-    'raw': RawDrive,
-    'qcow2': QCOW2Drive,
-}
-
-
-def Drive(*args, **kwargs):
-    """
-    Drive factory. Returns IDrive object according to arguments
-    Also checks that size is stated in case if drive doesn't exist
-    """
-    LOG.debug(f'Drive factory: creating with arguments {kwargs}')
+    @classmethod
+    def get_supported_types(cls) -> List[str]:
+        """Get list of supported storage types."""
+        return list(cls._device_types.keys())
 
-    kwargs['path'] = Path(kwargs['path'])
+    def add_storage_from_config(self, storage_configs: List[Dict[str, Any]]):
+        """
+        Add storage devices from configuration list.
 
-    if (not kwargs['path'].exists()
-            and 'size' not in kwargs
-            and 'backing' not in kwargs):
-        raise DriveError(
-            f"Drive on {kwargs['path']} doesn't exists "
-            "and size or backing not stated"
-        )
+        Args:
+            storage_configs: List of storage configuration dictionaries
+        """
+        for index, config in enumerate(storage_configs):
+            storage_type = config.get("type", "qcow2").lower()
+
+            if storage_type not in self._device_types:
+                LOG.warning(
+                    f"Unknown storage type '{storage_type}', "
+                    f"defaulting to qcow2. Supported types: "
+                    f"{', '.join(self.get_supported_types())}"
+                )
+                storage_type = "qcow2"
+
+            device_class = self._device_types[storage_type]
+            device = device_class(config, self.vm_id, index)
+            self.devices.append(device)
+
+    def create_storage_files(self):
+        """Create storage files for all devices that need them."""
+        for device in self.devices:
+            try:
+                device.create_if_needed()
+            except StorageError as e:
+                LOG.error(f"Failed to create storage for {device.name}: {e}")
+                raise
+
+    def get_qemu_args(self) -> List[List[str]]:
+        """
+        Get all QEMU arguments for storage devices.
+
+        Returns:
+            List of QEMU argument lists (each device returns a list of args)
+        """
+        args = []
+        for device in self.devices:
+            args.append(device.get_qemu_args())
+        return args
 
-    if 'type' not in kwargs:
-        raise DriveError("Drive type not stated")
+    def get_device_by_name(self, name: str) -> Optional[BaseStorageDevice]:
+        """
+        Get storage device by name.
+
+        Args:
+            name: Device name
+
+        Returns:
+            Storage device or None if not found
+        """
+        for device in self.devices:
+            if device.name == name:
+                return device
+        return None
+
+    def get_snapshot_capable_devices(self) -> List[BaseStorageDevice]:
+        """Get list of devices that support snapshots."""
+        return [
+            device for device in self.devices if device.supports_snapshots()
+        ]
+
+    def get_storage_info(self) -> List[Dict[str, Any]]:
+        """
+        Get information about all storage devices.
 
-    t = kwargs['type'].lower()
-    if t in DRIVE_TYPES:
-        return DRIVE_TYPES[t](*args, **kwargs)
-    else:
-        raise DriveError("Invalid/unsupported drive type")
+        Returns:
+            List of device information dictionaries
+        """
+        return [device.get_info() for device in self.devices]