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.

If you already done this part and only want to 'update your build env.' then see bottom of this page.

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

• 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

NOTE: The trunk is constantly changing. You might want to use a tagged release like svn://svn.alpinelinux.org/alpine-builder/tags/release-1.7.7

• 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

• 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.

Updating the build env.

• 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

• 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.

• Update the portage snapshot from Gentoo

emerge --sync

• 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

• Build the alpine images (iso, usb, flash, etc.)

cd /usr/src/alpine
make clean iso