Project

General

Profile

Task #5882

Updated by Nico Schottelius about 6 years ago

* How we create it 
 * How we deploy it 

 h2. Introduction 

 The netboot images are basically a Devuan filesystem that is created by **debootstrap**. To be able to boot the servers, the kernel is extracted and the root filesystem is put into an cpio archive. 


 h2. How to build / update a netboot image  

 * Login to netboot-build.ungleich.ch 
 * Go to /srv 
 * /srv/devuan contains the current version 
 * /srv/devuan-VERSION.gz contains the available root filesystem 
 * /srv/kernel-VERSION 

 To update / make changes: 

 * chroot /srv/devuan 
 * [work work work] 

 <pre> 

 VERSION=your-version-name 
 cd /srv/devuan 
 printf "\\\\n \\\\l: version $VERSION\\n" $VERSION\n" > etc/issue 
 find . -print0 | cpio --null -ov --format=newc | gzip -9 > /srv/initramfs-${VERSION} 
 cp vmlinuz /srv/kernel-${VERSION} 

 </pre> 

 h2. How to deploy a new netboot image 

 * Copy the rootfs and the kernel on the respective routers: 
 ** router{1..2}.placeY.ungleich.ch:/var/www/html/ 
 ** initramfs.igz == production image 
 ** kernel == production kernel 

 h2. Upcoming improvements / things to be checked 

 * Use cdist preos for chroot building 
 * Ensure that the image cannot be downloaded publicly 
 ** Our password hash is visible otherwise 
 * Ensure that there is a menu for booting 
 ** production kernel selected by default 
 ** other kernels/setups for testing

Back