Setting up the build environment 1.7
Quick note on how to set up a build environment.
In this document the build environment will be created in /opt/alpine/1.7. You can ofcourse place it anywhere you have space. You will need a few Gigabytes to have enough space for kernel cmpiling and storing all the binary packages and iso image.
Requirements
You need a 2.6 kernel to use the chroot build environment.
- Note: Make sure your running kernel supports 16bit UIDs for backward compatibility. uCLibc needs them. Check it with:
zcat /proc/config.gz | grep CONFIG_UID16
or if you dont have /proc/config.gz:
grep CONFIG_UID16 /boot/config-`uname -r`
You should se something like:
CONFIG_UID16=y
Step-by-step
All packages are downloaded from http://dev.alpinelinux.org/alpine/v1.7
- Download latest buildroot package from [1] and unpack it in /opt/alpine, using the --preserve-permissions option and create a symblink named 1.7 for the development branch.
sudo mkdir -p /opt/alpine cd /opt/alpine wget -q -O - http://dev.alpinelinux.org/alpine/v1.7/buildroot/alpine-buildroot-latest.tar.bz2\ | sudo tar -vjxp sudo ln -s alpine-buildroot-1.7.6 1.7
- Copy your DNS configuration to the build environment and mount proc.
sudo cp /etc/resolv.conf /opt/alpine/1.7/etc/ sudo mount -t proc proc /opt/alpine/1.7/proc sudo mount -o bind /dev /opt/alpine/1.7/dev
- Enter the chroot and change the prompt to reflect your chroot environment
sudo chroot /opt/alpine/1.7 /bin/bash --login export PS1="(chroot) $PS1"
Now we are in the build environment chroot.
- Download latest portage snapshot portage-latest.tar.bz2 from Gentoo and unpack it to /usr
cd /usr wget -q -O - http://mirror.gentoo.se/snapshots/portage-latest.tar.bz2 portage-latest.tar.bz2 | tar -vjx
- Check out the alpine-portage overlay from svn.
svn co svn://svn.alpinelinux.org/alpine-portage/trunk /usr/alpine-portage
- Download all the tbz2 packages into the var/cache/packages directory. This is probably easiest with rsync.
rsync -rauv rsync://rsync.alpinelinux.org/alpine/v1.7/tbz2/* /var/cache/packages/
- Check out the alpine-builder scripts in usr/src/
svn co svn://svn.alpinelinux.org/alpine-builder/trunk /usr/src/alpine
- Configure portage to use the config from alpine-builder.
rm -r /etc/make.conf /etc/portage ln -s /usr/src/alpine/buildroot/etc/make.conf /etc ln -s /usr/src/alpine/buildroot/etc/portage /etc
- Update the portage tree (this takes some time first time you do it)
emerge --sync
- Install the kernel sources, using the downloaded tbz2.
This step is no longer neccessary as this is done automatically within the build script.
- Make sure that /usr/src/linux points to your kernel version: (the below mentioned steps are optional as this is done automatically by the alpine build process - in case your build breaks, check if the linux source link exists)
cd /usr/src rm -f linux ln -s linux-2.6.20-hardened-r10 linux
- Build the alpine images (iso, usb, flash, etc.)
cd /usr/src/alpine make
If you get failures while building kernel drivers then you can workaround that by commenting out the specific in /usr/src/alpine/kernel/generic/drivers.