community.aegirproject.org

Building and working with the debian packages

Tagged:
Updated by anarcat on 06/20/2011 - 20:24
AddedChangedDeleted

Debian is one of the main supported operating systems in Aegir. For other systems, see Operating System Support. See also the following instructions:

The following is aimed at developpers wishing to maintain their own Debian packages or work within the packaging framework.

1. Building a package for a new release

Assuming we have just released 1.0-rc4, those instructions will merge that code into the upstream branch (which is used to create the Debian diff) and then merged again in the debian branch (where the Debian code lives). We then use git-buildpackage to build the package and tag it, then push those changes back in the repository.

git fetch
git checkout upstream
git rebase origin/upstream
git merge 6.x-1.0-rc4
git checkout debian
git rebase origin/debian
git merge upstream
dch -v 1.0~rc4-1
git-buildpackage --git-tag -kanarcat@koumbit.org
dput builder ../build-area/aegir-provision_1.0~rc4-1_i386.changes
git push
git push --tags

Note: notice how the version number is slightly different in Debian - we use the "magic" ~ separator to indicate that 1.0~rc4 is actually lower than 1.0...

Back to top

2. Building a branch package

Sometimes you want to have a test package for a given branch without going through a full release. Here how it's done.

git checkout upstream
git merge 6.x-1.x
git checkout debian
git merge upstream
git describe
dch -v 1.0~rc3+28-1
git-buildpackage --git-tag -kanarcat@koumbit.org

Back to top

3. Installing packages manually

dpkg -i aegir-provision_1.0~rc3+g6632e6e-1_all.deb

We also make sure our custom makefile fetches the right one from provision:

-includes[aegir] = "http://drupalcode.org/project/provision.git/blob_plain/6.x-1.0-rc3:/aegir.make"
+includes[aegir] = "http://drupalcode.org/project/provision.git/blob_plain/6.x-1.x:/aegir.make"

Back to top

4. Developping on Debian

To develop third party extensions to Aegir on Debian, it is recommended to install the Debian packages. If you are workin on Aegir core, this could be a bit trickier since the files are not where you expect them to be and are not deployed as git repositories however.

You can, however, copy in place a .git directory using the following:

git clone --branch=6.x-1.0-rc7 http://git.drupal.org/project/provision
cp -Rp provision/.git /usr/share/drush/commands/provision/.git
cd /usr/share/drush/commands/provision
git stash

This will bring back a bunch of files that are removed from the Debian package, so it will yield warnings on uninstall of the Debian package but it should otherwise work.

You can do something similar with the frontend.

Back to top