Make Alpine Linux VM Image
This project provides a script for making customized Alpine Linux disk images for virtual machines. It’s quite simple (300 LoC of shell), fast (~32 seconds on GitHub Actions) and requires minimum dependencies (QEMU and filesystem tools).
|
Tip
|
Don’t need VM, just wanna chroot into Alpine Linux? Try alpine-chroot-install! Or do you want to create a custom rootfs? Then alpine-make-rootfs is for you! |
Requirements
-
Linux system with common userland (Busybox or GNU coreutils)
-
POSIX-sh compatible shell (e.g. Busybox ash, dash, Bash, ZSH)
-
qemu-img and qemu-nbd
-
rsync (needed only for
--fs-skel-dir) -
sfdisk (needed only for
--partition) -
mdev or udevadm (needed only for
--partitionwhen device hotplug doesn’t work) -
e2fsprogs (for ext4), btrfs-progs (for Btrfs), or xfsprogs (for XFS)
All dependencies except the first two are automatically installed by the script when running on Alpine.
Usage
Read documentation in alpine-make-vm-image. See .github/workflows/ci.yml for GitHub Actions example.
You can copy alpine-make-vm-image into your repository or download it on demand, e.g.:
wget https://raw.githubusercontent.com/alpinelinux/alpine-make-vm-image/v0.11.1/alpine-make-vm-image \
&& echo '0d5d3e375cb676d6eb5c1a52109a3a0a8e4cd7ac alpine-make-vm-image' | sha1sum -c \
|| exit 1Or, if you are on Alpine Linux, you can simply install the alpine-make-vm-image package.
Pitfalls
Creating Image for VMware (ESXi)
VMware and disk images (virtual disks) is one big mess. You can find that VMware uses the VMDK format, but the problem is that this is not a single format. Actually it has many subformats with very different structure and various (in)compatibility with VMware hypervisors.
When I’ve created a disk image using qemu-img create -f vmdk or converted Qcow2 to VMDK using qemu-img convert -O vmdk, vSphere client loaded this image without any problem, but the data was corrupted.
Eventually I found in some old documentation that ESXi does not support “sparse” disks…
So after many trials I found out that the least bad and functional solution is to create Qcow2 image and then convert it to VMDK using:
qemu-img convert -f qcow2 -O vmdk -o adapter_type=lsilogic,subformat=monolithicFlat alpine.qcow2 alpine.vmdkUnfortunately, this creates a “thick” image, i.e. its size equals the “provisioned space”, not actually used space as in Qcow2. However, you can compress it with gzip to avoid transferring multiple gigabytes of zeros over network.
License
This project is licensed under MIT License. For the full text of the license, see the LICENSE file.