Debian packaging effort!
========================

In the past, we used to be [heavy slackware users](https://simplepkg.sarava.org) when we just
had a few boxes to manage. Then we had to change our whole packaging paradigm when we switched
to Debian.

These notes are mainly references to the detailed Debian/Ubuntu documentations we're using in
the course of learning the intricacies of Debian packaging.

Configuration files
-------------------

All the commands in this guide assumes that you're using [these configuration
files](https://git.sarava.org/?p=rhatto/dotfiles/debian.git;a=summary).

Starting a new package
----------------------

We use the `packages/` folder from this repo to store sources:

    mkdir package/$package
    cd package/$package

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

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

### Setup pbuilder chroots

    git-pbuilder create
    DIST=wheezy git-pbuilder

### Setup cowbuilder chroots

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

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

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=wheezy git-pbuilder update --override-config

### Cowbuilder

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

### 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 )

Building
--------

    DIST=wheezy sudo -E cowbuilder --build $package*.dsc

Uploading
---------

Simply run

    dupload *changes

This assumes a `~/.dupload.conf` like the following:

    package config;
    $default_host = "myremote";

    $cfg{'myremote'} = {
            fqdn     => "myremote.example.org",
            login    => "user",
            method   => "scpb",
            incoming => "/var/reprepro/incoming/",
            # The dinstall on ftp-master sends emails itself
            #dinstall_runs => 1,
    };

It's also important that:

  1. The host remote port is correctly defined at your `~/.ssh/config`.
  2. The user is in the `reprepro` group in the server.