[Pkg-clojure-maintainers] Clojure packaging team and our infrastructure

[Wolodja Wentland]

Hi all,

I just wanted to give you all a short overview of the infrastructure that we
have in place as a team. I am sure that Gergely and Paul find not many things
that are new to the, but Eugene might be happy about a little overview. First
and foremost there is the project and mailing list alioth:

    https://alioth.debian.org/projects/pkg-clojure/
    https://lists.alioth.debian.org/mailman/listinfo/pkg-clojure-maintainers

that you might want to join. Simply register a new account on alioth [0] and
then join the project on our page. Information about alioth can be found on
[1] and the most important bit is probably [2] which explains how to
configure/get SSH access. Note, in particular, the configuration in
~/.ssh/config which should resemble something along the lines of:

    --- snip ---
    Host alioth.debian.org svn.debian.org git.debian.org bzr.debian.org hg.debian.org darcs.debian.org arch.debian.org
        User USERNAME-guest
        IdentityFile ~/.ssh/id_debian
    --- snip ---

which then takes care of choosing the correct key and username whenever you
want to access one of the many Debian hosts. As you might have guessed: Yes,
this is in particular important as it allows you to get commit access to our
git repositories. The git repositories can be found on
git.debian.org:/git/pkg-clojure/ which, as of now, contains a single
repository right now, namely slingshot-clojure.

You'll also find a script to setup new repositories (creatively called
"setup-repositories") which I stole^Wadapted from similar ones used by other
teams. So in order to create a new repository you login to git.debian.org,
move into /git/pkg-clojure and run "./setup-repository SOURCE-PACKAGE-NAME"
which creates a directory, setups a git repository therein and does a little
bit of additional magic. This allows you to then add it as a remote in your
local repository with

    git remote add alioth git+ssh://git.debian.org/git/pkg-clojure/<package>.git

and run an initial push to it with (run with "--dry-run" first!)

    git push --tags -u alioth master
    git push --all

There are, as always, many ways to clone a directory:

    $ git clone git://git.debian.org/pkg-clojure/slingshot-clojure.git
      read only
    $ git clone git+ssh://git.debian.org/git/pkg-clojure/slingshot-clojure.git
      read and write

For packages already in the archive you can, naturally, also use debcheckout
(from devscripts) or gbp-pull (from git-buildpackage) or ...

So, I think that's it for now. We also have a bunch of packages in pkg-java
and I would recommend to take a look at

    $ git clone git://git.debian.org/pkg-java/librobert-hooke-clojure.git
    $ git clone git+ssh//git.debian.org/git/pkg-java/librobert-hooke-clojure.git

All these packages use git-buildpackage [3] and can be build with
"git-buildpackage" on suitably configured systems. If you have problems
getting this to run then let me know, Eugene. I configured git-buildpackage in
~/.gbp.conf [4] to use a builder called debuild and you find the file attached
to this mail. You naturally have to adapt it to your wishes and local
environment.

I'm sure there is many more that I could say (e.g. confuse you with
cowbuilder, git-pbuilder and so on) but this should be enough to give an
overview. Let me know if something is unclear, not working.

[0] https://alioth.debian.org/account/register.php
[1] http://wiki.debian.org/Alioth
[2] http://wiki.debian.org/Alioth/SSH
[3] Install git-buildpackage and read file:///usr/share/doc/git-buildpackage/manual-html/gbp.html
[4] See /etc/git-buildpackage/gbp.conf for the global one
-- 
Wolodja <debian at babilen5.org>

4096R/CAF14EFC
081C B7CD FF04 2BA9 94EA  36B2 8B7F 7D30 CAF1 4EFC
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-clojure-maintainers/attachments/20130422/1b6c3258/attachment.pgp>