Environment
===========

Build environment creation
--------------------------

The following steps needs to be run just once for each arch and distro version.

### Setup cowbuilder chroots

This is the recommended method:

    sudo mkdir -p /var/cache/pbuilder/sid-amd64
    sudo -E cowbuilder --create

    sudo mkdir -p /var/cache/pbuilder/jessie-amd64
    sudo -E DIST=jessie cowbuilder --create

### Setup pbuilder chroots

If you want to setup directly using `pbuilder`:

    git-pbuilder create
    DIST=jessie git-pbuilder

### Compatibility with git-buildpackage

This is a workaround while we don't find a cleaner way to fix
[this issue](http://ramblingfoo.blogspot.com.br/2012/10/howto-sudo-cowbuilder-git-buildpackage.html)
with `git-buildpackage` not getting `~/.pbuilderrc` from the local user:

    ( cd /var/cache/pbuilder/ && sudo ln -s sid-amd64/base.cow )

External repo integration
-------------------------

If your package storage lives elsewhere, make a symlink like this:

    (
      cd /var/cache/pbuilder/jessie-amd64 && \
      sudo rm -rf result                  && \
      sudo ln -s /var/data/distros/debian/packages/build-area/jessie-amd64 result
    )

Environment maintenance
-----------------------

These steps should be run once in a while to ensure we have an up to date packaging environment.

### Pbuilder

    DIST=sid    git-pbuilder update
    DIST=jessie git-pbuilder update --override-config

### Cowbuilder

    DIST=sid    sudo -E cowbuilder --update
    DIST=jessie sudo -E cowbuilder --update --override-config