LinuxKit mkimage-vmdk 镜像文档

1. 镜像概述和主要用途

本镜像基于 LinuxKit 项目的 mkimage-vmdk 工具构建，提供了一个容器化的环境用于创建 VMDK（Virtual Machine Disk）格式的磁盘镜像。VMDK 是 VMware 等虚拟化平台广泛支持的磁盘镜像格式，本镜像主要用途包括：生成定制化 VMDK 镜像、集成到自动化镜像构建流程、为虚拟机环境提供预配置磁盘介质。

2. 核心功能和特性

核心功能

• 生成符合 VMDK 1.1 或 2.0 规范的磁盘镜像文件
• 支持指定磁盘大小、扇区大小等底层存储参数
• 可基于原始文件系统（如 ext4）或目录结构创建 VMDK 镜像
• 与 LinuxKit 生态工具链兼容，支持结合 mkimage-iso-efi 等工具生成完整虚拟机镜像

特性

• 轻量级：基于 Alpine Linux 或 LinuxKit 最小运行时，镜像体积小
• 无依赖：容器化设计，无需在主机安装额外工具链
• 可定制：通过命令行参数灵活配置镜像属性
• 自动化友好：支持非交互式运行，易于集成到 CI/CD 流程

3. 使用场景和适用范围

使用场景

• 开发环境：快速生成用于本地 VMware 或 VirtualBox 测试的 VMDK 镜像
• 自动化部署：在流水线中自动创建包含应用或系统的 VMDK 镜像，用于虚拟机批量部署
• LinuxKit 定制系统：作为 LinuxKit 构建流程的一部分，生成可直接用于虚拟化平台的磁盘镜像

适用范围

• 开发者：需要为虚拟机环境构建定制磁盘镜像的开发人员
• DevOps 工程师：在自动化流程中集成 VMDK 镜像生成步骤
• 虚拟化平台用户：使用 VMware、VirtualBox 等依赖 VMDK 格式的环境

4. 使用方法和配置说明

4.1 基本使用方法

通过 docker run 命令运行镜像，核心是将主机目录挂载到容器内，以输入源文件并输出 VMDK 结果。基本语法：

docker run --rm -v <主机输入目录>:/input -v <主机输出目录>:/output linuxkit/mkimage-vmdk [参数]

4.2 配置参数说明

mkimage-vmdk 工具支持以下常用参数（完整列表可通过 --help 获取）：

4.3 环境变量

无特殊环境变量，所有配置通过命令行参数指定。

5. Docker部署方案示例

5.1 docker run 命令示例

示例1：基于目录生成 2GB VMDK 镜像

将主机 ./my-rootfs 目录作为源文件系统，生成 2GB 的流式优化 VMDK 镜像到 ./output 目录：

docker run --rm \
  -v $(pwd)/my-rootfs:/input \
  -v $(pwd)/output:/output \
  linuxkit/mkimage-vmdk \
  --input /input \
  --output /output/disk.vmdk \
  --size 2048 \
  --type streamOptimized

示例2：查看工具帮助

docker run --rm linuxkit/mkimage-vmdk --help

5.2 docker-compose 配置示例

适用于需要固定输入输出路径的场景，docker-compose.yml 内容：

version: '3'
services:
  vmdk-builder:
    image: linuxkit/mkimage-vmdk
    volumes:
      - ./my-rootfs:/input      # 主机源目录
      - ./output:/output        # 主机输出目录
    command: --input /input --output /output/disk.vmdk --size 1024 --type monolithicSparse

运行：

docker-compose up

6. 注意事项

• 输入源需确保文件系统完整（如包含 /boot、/bin 等核心目录），否则生成的 VMDK 可能无法启动
• 输出目录需提前创建，避免权限问题（可通过 chmod 777 ./output 临时开放权限测试）
• 大尺寸镜像（如 >10GB）需确保主机磁盘空间充足，并预留构建时间
• 如需更高兼容性，建议使用 streamOptimized 类型（VMware 推荐格式）