How to make a custom ISO image: Difference between revisions

From Alpine Linux
mNo edit summary
mNo edit summary
Line 1: Line 1:


The easiest way is to use a script like [https://github.com/alpinelinux/alpine-make-vm-image alpine-make-vm-image].
One way to completely re-build images is to use a script like [https://github.com/alpinelinux/alpine-make-vm-image alpine-make-vm-image].
 
But there is also an alternative:


== Live Disk customizations with APKOVL configurations ==
== Live Disk customizations with APKOVL configurations ==


Once you have booted and customized the system that was booted from an ISO, you may save the state and arrange for the ISO to load the customizations:
Once you have booted and customized the diskless system that was booted from an ISO, you may save the state and arrange for the ISO to load the customizations on the next boot:


* Generate an APKOVL file with [[Alpine_local_backup|lbu]], <code>lbu ci</code>
* Generate an APKOVL file with [[Alpine_local_backup|lbu]], <code>lbu ci</code>
Line 18: Line 20:
* If you want to make a customized installer, you need to create <code>.default_boot_services</code> which will cause <code>mkinitfs</code> to create the defaults for the live image.
* If you want to make a customized installer, you need to create <code>.default_boot_services</code> which will cause <code>mkinitfs</code> to create the defaults for the live image.


== Testing your ISO image ==
== Test example: Booting an ISO image with customizations ==


[[Qemu#Live_mode| Qemu]] is useful for a quick test of ISO image customizations.
[[Qemu#Live_mode| Qemu]] is useful for a quick test of ISO image customizations.

Revision as of 12:01, 6 May 2020

One way to completely re-build images is to use a script like alpine-make-vm-image.

But there is also an alternative:

Live Disk customizations with APKOVL configurations

Once you have booted and customized the diskless system that was booted from an ISO, you may save the state and arrange for the ISO to load the customizations on the next boot:

  • Generate an APKOVL file with lbu, lbu ci
  • The "diskless" Alpine ISO images look for an APKOVL Volume in mountpoints below /media/, and may alternatively be pointed to a web server.
  • If you put the APKOVL file on a webserver, you need to supply a customized url with the APKOVL boot parameter.

Notes:

  • Any packages you add to /etc/apk/world of your lbu will automatically be installed in the live system.
  • See Alpine_Linux_package_management#Local_Cache about managing included packages.
  • If you don't have a web server you can run busybox's httpd temporarily - busybox httpd -p 127.0.0.1:80
  • See lbu about how to customize it to cover files outside of /etc.
  • If you want to make a customized installer, you need to create .default_boot_services which will cause mkinitfs to create the defaults for the live image.

Test example: Booting an ISO image with customizations

Qemu is useful for a quick test of ISO image customizations.