Modifications entre les versions 17 et 30 (s'étendant sur 13 versions)
Version 17 à la date du 2008-02-12 09:46:32
Taille: 5521
Éditeur: ThomasNoël
Commentaire: encore des précisions mineures
Version 30 à la date du 2011-03-11 03:14:48
Taille: 4766
Commentaire: adél réelle mais masquée
Texte supprimé. Texte ajouté.
Ligne 1: Ligne 1:
Cette page présente le dépôt de paquets Debian/Ubuntu spécifiques à l'AUF. = Que peut-on proposer ? Qui peut ? =
Ligne 3: Ligne 3:
## ajouter un blabla ici pour dire à quoi ça sert/servira, etc... Si vous savez fabriquer des paquets Debian ou Ubuntu, vous pouvez les mettre à disposition sur le dépôt AUF. Pour cela, il faut :
 * savoir faire des paquets Debian corrects : `dh-make`, `debuild`, retro-portages, ...
 * savoir à quelle distribution sont destinés les paquets :
  * Debian lenny ou squeeze
  * Ubuntu lucid, maverick, natty, etc
 * avoir un accès au réseau privé de l'AUF (aucun autre accès spécifique n'est nécessaire, ni mot de passe, ni clé ssh, rien).
Ligne 5: Ligne 10:
 ||<#ffaa00> Il s'agit d'un système en cours de mise en place, ne pas utiliser pour l'instant merci !|| Tout le monde peut envoyer des paquets selon deux niveaux :
 * '''niveau experimental''' : paquets destinés à expérimenter de nouvelles idées, de nouvelles façons de faire
 * '''niveau test''' : paquets qui demandent à être testés et qui sont des candidats pour devenir des paquets « officiels » de l'AUF.
Ligne 7: Ligne 14:
= Accès aux paquets disponibles = Une fois qu'un paquet est correctement testé, il est validé : il faut alors demander son inclusion dans le '''niveau stable'''. Il suffit d'envoyer votre demande sur la liste de discussion technique de l'AUF, un des « ftp-masters » se fera un plaisir d'y répondre.
Ligne 9: Ligne 16:
== Ajout de la clé GPG utilisée pour signer le dépôt == = Concrétement =
Ligne 11: Ligne 18:
Il faut d'abord installer la clé publique GPG qui signe ce dépôt[[FootNote(et ça ajoute aussi la clé de celui de Dakar, en cadeau)]]. Pour envoyer un paquet, on utilise '''dput''' : `aptitude install dput`.
Ligne 13: Ligne 20:
 . Ajouter dans le `sources.list` le dépôt AUF concernant votre distribution :
 {{{# à ajouter dans /etc/apt/sources.list (ou créer un /etc/apt/sources.list.d/auf)
# remplacer distrib par etch, lenny, feisty, gutsy, hardy, ... selon votre système.
deb http://apt.auf.org/ distrib auf
}}}
 . Puis installer le paquet `auf-keyring` :
Voici une configuration typique, à placer dans `$HOME/.dput.cf` :
Ligne 20: Ligne 22:
# aptitude update
# aptitude install auf-keyring}}}
 . '''Note''' : lors de la première installation de `auf-keyring` ''aptitude'' va vous demander de confirmer l'installation car il ne juge pas la source "sûre". Confirmez l'installation, la clé sera ajoutée, ''aptitude'' fera désormais confiance au dépôt AUF[[FootNote(On peut aussi faire "{{{wget -qO - http://apt.auf.org/auf-keyring.gpg | sudo apt-key add -}}}". C'est un peu plus rapide, mais ça ne mettra pas à jour automatiquement les clés AUF si on en ajoute dans le paquet auf-keyring.)]].
# Exemple de configuration de "dput" pour envoyer des paquets
# pour Ubuntu "Hardy" (8.04) dans les sections "test" et "experimental".
[DEFAULT]
hash = md5
allow_unsigned_uploads = 1
run_dinstall = 0
scp_compress = 1
default_host_main = precisez-la-section
fqdn = apt.auf
method = ftp
login = anonymous
Ligne 24: Ligne 34:
== Configuration des sources de paquets (sources.list) ==
Ensuite ajouter les sources qui vous conviennent en fonction de ce que vous avez à mettre en place. Les lignes à ajouter dans le `sources.list` sont de la forme :
 {{{
deb http://apt.auf.org/ distribution composant
}}}
Exemples (non fonctionnels à l'heure de la rédaction) :
 {{{
# paquets pour la mise en place d'un serveur VoIP Asterisk AUF :
deb http://apt.auf.org/ etch voip
# paquets spécifiques à Dakar pour les postes clients Ubuntu Feisty :
# deb http://apt.auf.org/ feisty sn
# paquets pour "lucid-tests auf"
[lucid-test]
incoming = test/lucid

# paquets pour "lucid-experimental auf"
[lucid-experimental]
incoming = experimental/lucid
Ligne 37: Ligne 43:
= Pour ajouter ses petits paquets dans le dépôt =

Il faut :
 * savoir faire des beaux paquets Debian : `dpkg-buildpackage`, `dh-make`, retroportages, ...
 * savoir à quelle distribution sont destinés les paquets : etch, lenny, feisty, gutsy, hardy, ...
 * trouver un nom pour le composant : voip, rpv2, auf-desktop, votre-iso-pays, votre-nom, ...
 * avoir un compte ''ssh'' sur la machine `apt.auf` (accès à `apt.auf.org` via le RPV, demander à Moussa)
 * avoir un répertoire (''incoming'' ou tout autre nom poétique) configuré pour recevoir les paquets (le groupe `reprepro` doit y avoir les droits d'écriture)

Pour envoyer un paquet, on utilise '''dput''' (`aptitude install dput`) que l'on configure ainsi (dans `~/.dput.cf`) :
Pour envoyer un paquet en mode experimental il suffit alors de faire :
Ligne 48: Ligne 45:
# extrait de ~/.dput.cf (inspiré de /etc/dput.cf) :
[DEFAULT]
method = rsync
hash = md5
allow_unsigned_uploads = 0
run_lintian = 0
run_dinstall = 0
check_version = 0
default_host_main = test
fqdn = apt.auf

# par défaut on envoie ici :
[test]
incoming = ~/incoming/test

# mais on peut aussi envoyer ici en précisant "voip" comme paramètre [section] lors de l'appel à dput :
[voip]
incoming = ~/incoming/voip
$ dput lucid-experimental le-nom-du-paquet.changes
Ligne 68: Ligne 48:
Pour envoyer un paquet il suffit de faire :
 {{{
$ dput [section] nom-du-paquet.changes
}}}
Si tout va bien le paquet sera ajouté dans le dépôt 5 minutes plus tard (par cron). Vous pourrez voir le résultat de votre demande en suivant [[http://apt.auf.org/rss.xml|le flux RSS de apt.auf.org]]. Si la version expérimentale fonctionne chez vous, envoyez dans `lucid-test` et demandez à des collègues de tester.
Ligne 73: Ligne 50:
Si tout va bien le paquet sera ajouté dans le dépôt 5 minutes plus tard (par cron) et un rapport vous sera envoyé par courriel.
Ligne 75: Ligne 51:
= Comment ça marche à l'intérieur = == Annexe : proposer un paquet binaire pour plusieurs architecture (i386 et amd64) ==
Ligne 77: Ligne 53:
attachment:reprepro-apt-auf-org.png Pour proposer un paquet binaires dans plusieurs architectures (typiquement i386 et amd64) :
  * il faut compiler d'abord une architecture classiquement et inclure les sources dans l'upload (donc `dpkg-buildpackage` avec l'option `-sa`)
  * envoyer par `dput` le `...changes`
  * puis compiler la ou les autres architectures avec l'option `-b` qui ne construit ''que'' le paquet binaire...
  * envoyer par `dput` le ou les `...changes` obtenus
Ligne 79: Ligne 59:
Le système est basé sur [http://mirrorer.alioth.debian.org/ reprepro] ([http://packages.debian.org/etch/reprepro version etch]). C'est ce logiciel qui gère le dépot : on lui dit quel paquet ajouter à quel composant de quelle distribution, et il gère le pool, les fichiers Release, Packages, Sources, etc. A côté, un serveur ''apache2'' propose le dépôt en HTTP. = Pour les curieux : comment ça marche à l'intérieur =

{{attachment:reprepro-apt-auf-org.png}}

Le système est basé sur [[http://mirrorer.alioth.debian.org/|reprepro]] ([[http://packages.debian.org/etch/reprepro|version etch]]). C'est ce logiciel qui gère le dépot : on lui dit quel paquet ajouter à quel composant de quelle distribution, et il gère le pool, les fichiers Release, Packages, Sources, etc. A côté, un serveur ''apache2'' propose le dépôt en HTTP.
Ligne 90: Ligne 74:
#
Ligne 93: Ligne 77:
#
# voip : la config AUF d'asterisk 1.2 pour etch
etch voip /home/thomas/incoming/voip thomas.noel@auf.org
# voip-test : backport de asterisk 1.4 en cours
etch test-thomas /home/thomas/incoming/test thomas.noel@auf.org

squeeze-test auf /home/ftp/test/squeeze root+aptauf_À_auf.org
squeeze-experimental auf /home/ftp/experimental/squeeze root+aptauf_À_auf.org
Ligne 102: Ligne 84:
Pour info, le script dans sa version du 11 février 15h TU : attachment:reprepro-incoming Pour info, le script dans sa version du 11 février 15h TU : [[attachment:reprepro-incoming]]
Ligne 106: Ligne 88:
 * regarder le [http://packages.debian.org/etch-backports/reprepro backport de reprepro] et notamment son "processincoming"

------
N
otes de bas de page :
 * regarder le [[http://packages.debian.org/etch-backports/reprepro|backport de reprepro]] et notamment son "processincoming"
 * mettre tout le code sur git.auf.org

Que peut-on proposer ? Qui peut ?

Si vous savez fabriquer des paquets Debian ou Ubuntu, vous pouvez les mettre à disposition sur le dépôt AUF. Pour cela, il faut :

  • savoir faire des paquets Debian corrects : dh-make, debuild, retro-portages, ...

  • savoir à quelle distribution sont destinés les paquets :
    • Debian lenny ou squeeze
    • Ubuntu lucid, maverick, natty, etc
  • avoir un accès au réseau privé de l'AUF (aucun autre accès spécifique n'est nécessaire, ni mot de passe, ni clé ssh, rien).

Tout le monde peut envoyer des paquets selon deux niveaux :

  • niveau experimental : paquets destinés à expérimenter de nouvelles idées, de nouvelles façons de faire

  • niveau test : paquets qui demandent à être testés et qui sont des candidats pour devenir des paquets « officiels » de l'AUF.

Une fois qu'un paquet est correctement testé, il est validé : il faut alors demander son inclusion dans le niveau stable. Il suffit d'envoyer votre demande sur la liste de discussion technique de l'AUF, un des « ftp-masters » se fera un plaisir d'y répondre.

Concrétement

Pour envoyer un paquet, on utilise dput : aptitude install dput.

Voici une configuration typique, à placer dans $HOME/.dput.cf :

  • # Exemple de configuration de "dput" pour envoyer des paquets
    # pour Ubuntu "Hardy" (8.04) dans les sections "test" et "experimental".
    [DEFAULT]
    hash                    = md5
    allow_unsigned_uploads  = 1
    run_dinstall            = 0
    scp_compress            = 1
    default_host_main       = precisez-la-section
    fqdn                    = apt.auf
    method                  = ftp
    login                   = anonymous
    
    # paquets pour "lucid-tests auf"
    [lucid-test]
    incoming                = test/lucid
    
    # paquets pour "lucid-experimental auf"
    [lucid-experimental]
    incoming                = experimental/lucid

Pour envoyer un paquet en mode experimental il suffit alors de faire :

  • $ dput lucid-experimental le-nom-du-paquet.changes

Si tout va bien le paquet sera ajouté dans le dépôt 5 minutes plus tard (par cron). Vous pourrez voir le résultat de votre demande en suivant le flux RSS de apt.auf.org. Si la version expérimentale fonctionne chez vous, envoyez dans lucid-test et demandez à des collègues de tester.

Annexe : proposer un paquet binaire pour plusieurs architecture (i386 et amd64)

Pour proposer un paquet binaires dans plusieurs architectures (typiquement i386 et amd64) :

  • il faut compiler d'abord une architecture classiquement et inclure les sources dans l'upload (donc dpkg-buildpackage avec l'option -sa)

  • envoyer par dput le ...changes

  • puis compiler la ou les autres architectures avec l'option -b qui ne construit que le paquet binaire...

  • envoyer par dput le ou les ...changes obtenus

Pour les curieux : comment ça marche à l'intérieur

reprepro-apt-auf-org.png

Le système est basé sur reprepro (version etch). C'est ce logiciel qui gère le dépot : on lui dit quel paquet ajouter à quel composant de quelle distribution, et il gère le pool, les fichiers Release, Packages, Sources, etc. A côté, un serveur apache2 propose le dépôt en HTTP.

Le principe : il y a un utilisateur virtuel "reprepro" sur le système, qui gère le dépôts. C'est cet utilisateur qui va lancer le logiciel "reprepro" avec les bons arguments. Il est le seul à avoir accès en écriture sur le dépôt.

  • /srv/www/apt.auf.org/pool et .../dists : le dépôt lui-même

  • ~reprepro/conf/ : configuration de reprepro, voir man reprepro pour explication :

  • ~reprepro/db/ : contient les bases de données internes de reprepro

Un script shell appelé reprepro-incoming lance le logiciel reprepro en lui disant d'aller chercher les paquets de tel composant pour telle distribution dans tel répertoire. La liste de ces paramètres est dans ~reprepro/incomings :

  • # Fichier ~reprepro/incomings
    
    # Format d'une ligne :
    # distrib composant repertoire email-pour-rapport
    
    squeeze-test           auf     /home/ftp/test/squeeze              root+aptauf_À_auf.org
    squeeze-experimental   auf     /home/ftp/experimental/squeeze      root+aptauf_À_auf.org

Le script reprepro-incoming gère l'envoie de rapport par mail (dernier paramètre de chaque ligne d'appel). Il est lancé par cron toutes les 5 minutes.

Pour info, le script dans sa version du 11 février 15h TU : reprepro-incoming

Il reste à faire

  • regarder le backport de reprepro et notamment son "processincoming"

  • mettre tout le code sur git.auf.org

DépôtAPT/EnvoyerSesPaquets (dernière édition le 2011-03-11 03:14:48 par JeanChristopheAndré)