Setting up the build environment 1.7: Difference between revisions
(Added instructions on howto update the build evn.) |
(svn up isntead of svn co) |
||
| Line 40: | Line 40: | ||
sudo chroot /opt/alpine/1.7 /bin/bash --login | sudo chroot /opt/alpine/1.7 /bin/bash --login | ||
echo 'PS1="(chroot)$PS1"' >> /etc/profile | |||
Now we are in the build environment chroot. | Now we are in the build environment chroot. | ||
| Line 78: | Line 78: | ||
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''. | 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''. | ||
'''NOTE when leaving chroot:''' When leaving your chroot, you should unmount the /proc | |||
exit | |||
sudo umount /opt/alpine/1.7/proc | |||
== Updating the build env. == | == Updating the build env. == | ||
If you already setup the build env earlier and only want to enter it, update it and maybe create a iso, then this part of the documentation is what you are looking for. | |||
* Mount proc. | |||
sudo mount -t proc proc /opt/alpine/1.7/proc | sudo mount -t proc proc /opt/alpine/1.7/proc | ||
| Line 88: | Line 93: | ||
sudo chroot /opt/alpine/1.7 /bin/bash --login | sudo chroot /opt/alpine/1.7 /bin/bash --login | ||
Now we are in the build environment chroot. | Now we are in the build environment chroot. | ||
| Line 94: | Line 98: | ||
* Update the portage snapshot from Gentoo | * Update the portage snapshot from Gentoo | ||
emerge --sync | emerge --sync | ||
When emerge has done syncing, you could be advised to update the portage. In such case, you just follow instructions. | |||
One instruction could be "* To update portage, run 'emerge portage'". | |||
emerge portage | |||
Another case could be that you see "* IMPORTANT: x config files in '/etc' need updating.". In that case run the dispatch-conf tool. | |||
dispatch-conf | |||
In most cases (when using the 'dispatch-conf') you should use the new config (by pressing 'u' in the console). | |||
* Check out the alpine-portage overlay from svn. | * Check out the alpine-portage overlay from svn. | ||
cd /usr/alpine-portage && svn up | |||
* Download all the [http://dl.alpinelinux.org/alpine/v1.7/tbz2 tbz2] packages into the var/cache/packages directory. This is probably easiest with rsync. | * Download all the [http://dl.alpinelinux.org/alpine/v1.7/tbz2 tbz2] packages into the var/cache/packages directory. This is probably easiest with rsync. | ||
| Line 105: | Line 117: | ||
* Check out the alpine-builder scripts in usr/src/ | * Check out the alpine-builder scripts in usr/src/ | ||
cd /usr/src/alpine && svn up | |||
* Build the alpine images (iso, usb, flash, etc.) | * Build the alpine images (iso, usb, flash, etc.) | ||
| Line 111: | Line 123: | ||
cd /usr/src/alpine | cd /usr/src/alpine | ||
make clean iso | make clean iso | ||
'''NOTE when leaving chroot:''' When leaving your chroot, you should unmount the /proc | |||
exit | |||
sudo umount /opt/alpine/1.7/proc | |||
Revision as of 09:58, 3 November 2007
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 echo 'PS1="(chroot)$PS1"' >> /etc/profile
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.
NOTE when leaving chroot: When leaving your chroot, you should unmount the /proc
exit sudo umount /opt/alpine/1.7/proc
Updating the build env.
If you already setup the build env earlier and only want to enter it, update it and maybe create a iso, then this part of the documentation is what you are looking for.
- Mount proc.
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
Now we are in the build environment chroot.
- Update the portage snapshot from Gentoo
emerge --sync
When emerge has done syncing, you could be advised to update the portage. In such case, you just follow instructions.
One instruction could be "* To update portage, run 'emerge portage'".
emerge portage
Another case could be that you see "* IMPORTANT: x config files in '/etc' need updating.". In that case run the dispatch-conf tool.
dispatch-conf
In most cases (when using the 'dispatch-conf') you should use the new config (by pressing 'u' in the console).
- Check out the alpine-portage overlay from svn.
cd /usr/alpine-portage && svn up
- 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/
cd /usr/src/alpine && svn up
- Build the alpine images (iso, usb, flash, etc.)
cd /usr/src/alpine make clean iso
NOTE when leaving chroot: When leaving your chroot, you should unmount the /proc
exit sudo umount /opt/alpine/1.7/proc