doc/build_system_fr.md
2014-10-04 15:16:16 +02:00

78 lines
2.7 KiB
Markdown

#Création de paquet Debian
## Architecture du sytème de build
Le système se compose de rebuildd qui est un front-end pour pbuilder, des chroot pbuilder pour i386 et amd64 et reprepro pour le sytème repo debian
## Workflow
### Pour les paquets yunhost
Il existe trois repo (daily, test et stable), les paquets sont tous disponible dans la dernière version du git dans le repo daily. Le repo test permet de mettre en place une nouvelle version d'un paquet qui sera ensuite testé. Une fois le paquet testé et validé il passera dans le repo stable.
### Pour les paquet non yunohost
Pour les paquets non yunohost (exemple python-bottle) le paquet ne passe pas par le repo daily (TODO)
## Build des paquets
### Daily build
Un cron défini dans l'utilisateur pbuilder se lance tous les jours à 01:00. Ce script va mettre a jours le repo git de packages et des submodule (ssowat, moulinette, moulinette-yunohost, adminjs).
Une fois les sources mise à jour les cript va rebuilder les paquets qui on était mise à jour la veille.
Pour se faire un va créé des paquets sources qui va ensuite mettre dans le répertoire /var/www/repo.yunohost.org/daily/incomming
Puis lancé l'ajout de ces fichier source au repo se qui va automatiquement lancé un job dans rebuildd (voir configuration du repo daily dans /var/www/repo.yunohost.org/daily/conf/distribustion)
Quand les paquets sont terminé d'etre buildé, ils sont ajouté au repo daily
### Rebuild d'un paquet yunohost
Il est possible de relancer manuellement le rebuild d'un paquet, pour se faire il faut lancer la commande :
```bash
daily_build -p nom_du_paquet
```
## Build d'un paquet non yunohost
TODO
### Passage de daily à test
Le passage de daily à test se fait avec la commande :
```bash
push-packages-test -p nom_du_paquet
```
il est possible d'utiliser l'option -v pour définir la version du paquet
Le script va récuperer les sources du paquet daily puis il va ouvrir le changelog pour y definir la version mais aussi le changelog
Après avoir rempli le changelog le paquet va être ajouté la liste des jobs de rebuildd pour etre ajouté au repo test.
Attention le nom de version ne doit pas contenir daily sinon le paquet sera ajouté au repo daily.
### Passage de test à stable
le passage du paquet en stable est réalisé avec la commande :
```bash
push-package-stable -p nom_du_paquet
```
Le n'est pas rebuildé il est récupéré du repo test est ajouté au repo stable
## Gestion repo
### Suppression d'un paquet
```bash
reprepro -V -b /var/www/repo.yunohost.org/nom_du_repo/ remove megusta nom_du_paquet
```
### Ajout d'un paquet debian dans un repo
```bash
reprepro -V -b /var/www/repo.yunohost.org/nom_du_repo/ includedeb megusta nom_du_paquet.deb
```