Initial import

1 files changed, 95 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..91330b0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,95 @@
+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.