Differences between revisions 33 and 34
Revision 33 as of 2011-12-02 12:00:59
Size: 4862
Revision 34 as of 2012-02-23 18:38:08
Size: 4798
Comment: Don't recommand pdebuild: it is not tidy, leaves files created as root in the source directory
Deletions are marked like this. Additions are marked like this.
Line 69: Line 69:
At the end you should add:
Line 81: Line 77:
dget http://ftp.de.debian.org/debian/pool/main/n/nano/nano_2.2.6-1.dsc
cd nano-2.2.6
dget -x http://ftp.de.debian.org/debian/pool/main/n/nano/nano_2.2.6-1.dsc
Line 84: Line 79:
sudo DIST=squeeze ARCH=i386 pdebuild sudo DIST=squeeze ARCH=i386
Line 86: Line 81:
sudo DIST=hardy ARCH=amd64 pdebuild sudo DIST=hardy ARCH=amd64 cowbuilder --build nano_2.2.6-1.dsc

This is a tutorial for cowbuilder. See also qemubuilder.



Create the base image:

sudo cowbuilder --create

And a new and shiny build image is created in /var/cache/pbuilder/base.cow/

Every day usage

Update the base image

sudo cowbuilder --update

Build a package:

sudo cowbuilder --build somepackage.dsc


Bash and SVN tips

Setup your .bashrc according to: http://upsilon.cc/~zack/blog/posts/2007/09/svn-cowbuilder/

Building your package for many distributions at once

cowbuilder is really handy to build your pet project for many distributions at once. If you have got an amd64 system, you can easily build a package for i386 and amd64 architectures and for say stable, sid and lucid.

  • The first step involves creating as many basepaths as you need. I chose to put them in /var/cache/pbuilder/$DIST-$ARCH/base.cow.

sudo mkdir  /var/cache/pbuilder/squeeze-i386/
  • Then create the base image :

sudo cowbuilder \
--create \
--basepath /var/cache/pbuilder/squeeze-i386/base.cow\
 --distribution squeeze\
 --debootstrapopts --arch --debootstrapopts i386

Creating an ubuntu base path is trickier because one must :

  1. import ubuntu signing keys
  2. exclude packages of priority important in /usr/share/cdebootstrap/generic-ubuntu/packages

  3. add universe to complete creation of chroot because the cowdancer package is in universe.

$ DIST=gutsy sudo cowbuilder --create \
--distribution gutsy \
--components "main universe" \
--basepath /var/cache/pbuilder/gutsy-amd64.cow \
--mirror http://apt:9999/ubuntu \
--debootstrapopts --exclude=udev,pcmciautils,initramfs-tools
  • Create a ~/.pbuilderrc file, taking the one from Ubuntu pbuilder howto, in the Multiple pbuilders section, uncommenting the line

  • Bring your cowbuilder chroot up to date by running

sudo DIST=sid cowbuilder --update
  • You can now build up a package. For instance a backport of nano for squeeze:

dget -x http://ftp.de.debian.org/debian/pool/main/n/nano/nano_2.2.6-1.dsc
# For a Debian Squeeze on i386 target
sudo DIST=squeeze ARCH=i386 
# Ubuntu a Hardy on amd64 target
sudo DIST=hardy ARCH=amd64 cowbuilder --build nano_2.2.6-1.dsc

The result will be available in: /var/cache/pbuilder/squeeze-i386/result

  • Once everything is set up, you can use a script in a debian source package directory to build it for every distribution.

set -e

[ -d $RESULTDIR ] || mkdir $RESULTDIR

DISTLIST=$(ls -d /var/cache/pbuilder/*.cow)

for chrootdir in $DISTLIST
    sudo cowbuilder --update --basepath $chrootdir
    DIST=$(basename $chrootdir | cut -d'-' -f1)
    [ -d $RESULTDIR/$DIST ] || mkdir $RESULTDIR/$DIST
    DIST=$DIST pdebuild --pbuilder cowbuilder\
                        --buildresult $RESULTDIR/$DIST\
                        -- --basepath $chrootdir
  • You can use an apt cache to reduce the downloads on mirrors, so if the mirror is http://apt:9999/debian or http://apt:9999/ubuntu.

( you shoud then add --mirror http://apt:9999/debian 

  • You can use eatmydata inside the cowbuilder chroot to speed up dpkg

DIST=sid cowbuilder --login --save
apt-get install eatmydata
  • And add this /etc/pbuilderrc

if [ -z "$LD_PRELOAD" ]; then


Using with git-buildpackage

The above config can be adapted to work with the defaults of git-buildpackage:


Then the images can be created with:

DIST=sid ARCH=amd64 git-pbuilder create

And packages be built with:

DIST=sid ARCH=amd64 git-buildpackage --builder=git-pbuilder

A bug was opened to make sure the ARCH argument is coherent with the pbuilder way (ie. that it's optional), see: #646882


Slow copying and removing of the COW directory

What cowbuilder does is:

cp -al /var/cache/pbuilder/base.cow /tmp/new
rm -rf /tmp/new

Of course cowbuilder uses a different location than /tmp/new. You need to optimize those 2 commands on your computer. They should take around 0.2s each. If not, try to use the ext3 filesystem, for more details, see our benchmarks.