From fd8e7b5f3bb128895f396e35defed32f42751c65 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Wed, 25 Dec 2019 09:52:59 +0200 Subject: Change: README.me to have hints of architecture and hacking --- README.md | 34 +++++++++++++++++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7e20de3..5755eb3 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -Install Debian using vmdb2 +Install Debian using vmdb2 (v-i) ============================================================================= This is a hack for my own amusement. It's not meant to be taken @@ -20,3 +20,35 @@ known as d-i. I use d-i, but would like something better: On the other hand, d-i is mature software and tested by thousands. v-i can just barely install my own Thinkpad x220 laptop. + + +Architecture +----------------------------------------------------------------------------- + +The vmdb2-installer builds a bootable disk image with Debian. The +image boots with UEFI, and has everything you need to run vmdb2. You +write the image to a USB drive, boot off that, and run vmdb2 in the +booted system to install Debian onto the hard drive. + +Thus: + +- build system -> installer image +- installer image -> USB drive +- boot from USB drive +- run vmdb2 to install onto laptop hard drive + +The image building uses vmdb2 as well. Things get a little recursive. + + +Hacking +----------------------------------------------------------------------------- + +The main files are: + +* v-i.vmdb -- the vmdb2 specification file for the installer image +* v-i.yml -- the Ansible playbook used by v-i.vmdb +* x220.vmdb -- the vmdb2 specification file to install onto an x220; + this is used from the system booted from the image built by v-i.vmdb +* x220.yml -- the Ansible playbook used by x220.vmdb + + -- cgit v1.2.1