• Objet : Installation, configuration et utilisation de git-buildpackage
• Niveau requis :

  avisé
• Commentaires : Pour maintenir vos paquets Debian sous git avec git-buildpackage.
• À savoir : Contribuer à Debian
• Suivi :

  en-chantier, à-tester
  • Création par captnfab 28/02/2014
  • Testé par <…> le <…>
• Commentaires sur le forum : Lien vers le forum concernant ce tuto ¹⁾

Nota :

Contributeurs, les sont là pour vous aider, supprimez-les une fois le problème corrigé ou le champ rempli !

Les paquets évoluent, au fil des versions, les patchs à effectuer pour intégrer correctement les paquets à Debian diffèrent. Les corrections de bugs sont intégrées par upstream²⁾. Pour s'y retrouver, il est conseillé de maintenir les sources de son paquet Debian via un VCS³⁾, tel que subversion, mercurial ou git.

Nous allons traiter ici le cas d'un paquet géré sous git via les utilitaires git-buildpackage.

On installe git-buildpackage ainsi que quelques outils qui nous seront utiles :

apt-get install git gitk git-buildpackage pristine-tar

git config --global user.name "Votre Nom"
git config --global user.email votre@adresse-email.org

Si vous avez une clé GPG  :

git config --global user.signingkey "0xXXXXXXXX"

Créer le fichier ~/.gbp.conf contenant le texte suivant :

~/.gbp.conf

[DEFAULT]
# Sign tags by default:
sign-tags = True
keyid = 0xXXXXXXXX
# use pristine tar by defaul
pristine-tar = True
 
[dch]
# Parse meta tags like Closes: from commit messages
meta = True
# Add seven digits of the commits sha1 to the commit message
id-length = 7
# Regex for matching bugs to close
meta-closes = Closes|LP|BZ
# Use the full commit message instead of the first line only
full = True
# Ignore these in commit messages
ignore-regex = (Signed-off|Acked)-by:
 
[buildpackage]
# Automatically push to remote repo after tagging a new release
posttag = /usr/share/doc/git-buildpackage/examples/gbp-posttag-push
# Run Lintian after a succesful build
postbuild = lintian $GBP_CHANGES_FILE
# Build command
builder = dpkg-buildpackage -i -I -uc -us
# Clean command
cleaner = /bin/true
 
[import-orig]
# Automatically forward the changelog after importing a new upstream version
postimport = git-dch -N%(version)s -S -a --debian-branch=$GBP_BRANCH

gbp pq import

gbp pq rebase

gbp pq export

À faire depuis la branche patch-queue/master à jour :

DEB_HOST_ARCH=amd64 ARCH=amd64 DIST=sid git-buildpackage --git-pbuilder --git-arch=$ARCH --git-dist=$DIST --git-tag --git-debian-branch=patch-queue/master

• Supprimer un tag localement et à distance :

git tag -d nomdutag && git push origin nomdutag

• Revenir irréversiblement à un ancien commit :

git reset --hard hashprefix-du-commit

• Établir une branche basée sur un ancien commit :

git checkout -b nomdelabranche hashprefix-du-commit

• How do you remove a tag from a remote repository
• How to revert to a previous git commit

• Debian Mentors
• Debian packages in git
• Building Debian Packages with git-buildpackage
• Utiliser Git sur Alioth