summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLars Wirzenius <liw@liw.fi>2019-12-25 09:52:59 +0200
committerLars Wirzenius <liw@liw.fi>2020-02-29 10:46:21 +0200
commitfd8e7b5f3bb128895f396e35defed32f42751c65 (patch)
tree94118762182e47b5d162d1cb6e18ca67aeb59584
parente20201ca70249476cca259d9246a6f2d5ef317f2 (diff)
downloadv-i-fd8e7b5f3bb128895f396e35defed32f42751c65.tar.gz
Change: README.me to have hints of architecture and hacking
-rw-r--r--README.md34
1 files changed, 33 insertions, 1 deletions
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
+
+