91 lines
3.0 KiB
Plaintext
91 lines
3.0 KiB
Plaintext
|
|
parabola-arm-imagebuilder
|
|
=========================
|
|
|
|
image creation
|
|
--------------
|
|
|
|
this is a collection of scripts creating parabola arm images for use with qemu
|
|
with the original goal of building parabola arm packages on these machines.
|
|
Development focus has since shifted towards creating parabola-arm release
|
|
tarballs.
|
|
|
|
to create a new virtual machine image, run
|
|
$> sudo ./create.sh
|
|
|
|
by default, the creation script will perform a full bootstrap, installing an
|
|
archlinuxarm release tarball and migrating the installed system to parabola
|
|
in-place. This behaviour can be changed by setting the environment variable
|
|
NOBOOTSTRAP to 1:
|
|
|
|
$> sudo NOBOOTSTRAP=1 ./create.sh
|
|
|
|
In this case, a parabola arm release tarball is used instead.
|
|
|
|
optionally, to create a new virtual machine with a packaging environment, set
|
|
the environment variable DEVSETUP to 1:
|
|
|
|
$> sudo DEVSETUP=1 ./create.sh
|
|
|
|
The packaging environment setup script makes use of several files and packages
|
|
present on already setup parabola development machines. if your setup is
|
|
different, you might have to modify src/stage3.sh accordingly.
|
|
|
|
Places the scripts check the host machine for configuration files are:
|
|
/etc/makepkg.conf - for PACKAGER and GPGKEY
|
|
~/.gnupg ~/.ssh ~/.gitconfig - copied verbatim to the VM
|
|
|
|
The scripts assume that the following programs are available and in $PATH:
|
|
qemu-img, qemu-system-arm
|
|
wget
|
|
parted
|
|
mkfs.vfat, mkfs.ext4, mkswap
|
|
bsdtar
|
|
scp, ssh, ssh-keygen
|
|
pacman
|
|
|
|
The scripts also assume that you like vim :)
|
|
|
|
virtual machine start
|
|
---------------------
|
|
|
|
to open a shell into the created machine, run
|
|
$> ./start.sh [path to created image]
|
|
|
|
the start.sh script assumes that you want a throwaway session, so it will start
|
|
the virtual machine in snapshot mode and drop you into an ssh session. Once you
|
|
exit that session, the machine is shutdown and changes made to the image are
|
|
discarded. This behavior can be changed using the following environment
|
|
variables:
|
|
|
|
FOREGROUND : set this to 1 to start a qemu serial connection instead of a ssh
|
|
session. Useful to capture boot output.
|
|
|
|
PERSISTENT : set this to 1 to make persistent changes to the image that are
|
|
not discarded on shutdown.
|
|
|
|
The username and password for the created image is parabola:parabola, or
|
|
root:parabola respectively. If a packaging environment is setup, the system is
|
|
configured for passwordless sudo for the parabola user and the package tree and
|
|
a build chroot are prepared. have fun. also check out the .bashrc of the
|
|
parabola user in the created virtual machine, for batch build integration based
|
|
on task-spooler.
|
|
|
|
tarball creation
|
|
----------------
|
|
|
|
to create a tarball from the created vm image, run
|
|
|
|
$> sudo ./make_tarball.sh [path to created image]
|
|
|
|
the tarball creation script assumes to operate on an image *without* packaging
|
|
environment setup and will not perform additional cleanup operations if used on
|
|
the wrong image. Things that are cleaned up are:
|
|
|
|
/root/.ssh
|
|
/etc/ssh/ssh_host_*
|
|
/etc/pacman.d/gnupg
|
|
/var/log/*
|
|
/var/cache/*
|
|
/lost+found
|