Chroot for package testing

From Gentoo Wiki
Jump to: navigation, search

Preparing a chroot environment

An efficient way of preparing a reusable chroot environment is by using a btrfs file system [1] and use snapshots. If one do not have access to such a file system then one can use a subdirectory instead of a btrfs subvolume.

root #btrfs subvolume create /mnt/gentoo

Get the stage 3 tarball [2]. Then unpack stage 3 in it

root # cp stage3-*.tar.xz /mnt/gentoo
root # cd /mnt/gentoo
root # tar xpvf stage3-*.tar.xz --xattrs-include='*.*' --numeric-owner

If you are using a btrfs file system, you may want to make a snapshot

root # btrfs subvolume snapshot /mnt/gentoo /mnt/stage3

Then you can chroot and set up a stable gentoo from stage 3 by following [3]. Inside the chroot, you may want to install repoman and portage with the gentoo-dev use flag enabled :

root # echo "sys-apps/portage gentoo-dev" >> /etc/portage/package.use/portage
root # emerge -1av sys-apps/portage app-portage/repoman

At this point if you are using a btrfs file system, exit the chroot and then make a snapshot. You may then delete the original subvolume :

root # btrfs subvolume snapshot /mnt/gentoo /mnt/stable_stage3

Testing the package foo

If you are using a btrfs filesystem, create a snapshot of your stable stage 3 and chroot in it. If not, just chroot in your stable stage 3.

root # btrfs subvolume snapshot /mnt/stable_stage3 /mnt/foo
root # mount --types proc /proc /mnt/foo/proc
root # mount --rbind /sys /mnt/foo/sys
root # mount --make-rslave /mnt/foo/sys
root # mount --rbind /dev /mnt/foo/dev
root # mount --make-rslave /mnt/foo/dev
root # chroot /bin/bash /mnt/foo

If you are testing multiple packages, you may want to rename the prompt according to the package you are testing :

root # export PS1="(foo) ${PS1}"

Next create a custom repository [4] and copy in it the ebuild you want to test. Before testing the package foo/bar , emerge all its test depencencies.

root # emerge -1av --onlydeps --with-test-deps foo

Then make the adjustments of the make.conf [5], and then emerge the package

root # emerge -1av foo

Once you are done with the test, if you are using a btrfs file system you may delete your test subvolume :

root # btrfs subvolume delete /mnt/foo

And make another test by going back to the beginning of this section. If you are using another file system, then execute the following after each test to get back to a stable stage 3.

root # emerge --depclean

Keeping up to date

Do not forget to keep your stable_stage3 up to date by chrooting in it from time to time and execute :

root # emerge --sync && emerge --quiet --update --deep --newuse @world


  1. [1] - Btrfs file system
  2. [2] - Download the stage 3 tarball
  3. [3] - Chrooting
  4. [4] - Defining a custom repository
  5. [5] - Package testing