====== Debian Archive Kit ======

Quelques notes sur mon exploration de dak.

Des [[anomalies à corriger]].

===== Mes installations =====

[[Installation de dak sur ondine]]. Installation de tests.

[[Installation de dak sur abonde]]. Installation de production pour [[doc:abonde]].

[[Installation de dak sur melusine]]. Installation de production en vue d'[[doc:avant-premières]].

===== Analyse des tâches répétitives =====
J'analyse ici les différentes tâches répétitives présentes dans le répertoire ///usr/share/doc/dak/crontabs//.

Les fichiers originels (extraits du paquet dak) sont suivis de leur analyse.

==== Pour l'archive principale ====
  * [[analyse /usr/share/doc/dak/crontabs/katie.crontab]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.unchecked]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.buildd]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.hourly]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.daily]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.weekly]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.monthly]]

==== Pour -non-US (caduque) ====
  * [[analyse /usr/share/doc/dak/crontabs/cron.unchecked-non-US]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.hourly-non-US]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.daily-non-US]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.weekly-non-US]]

==== Pour -security (censé être plus simple) ====
  * [[analyse /usr/share/doc/dak/crontabs/cron.unchecked-security]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.buildd-security]]
  * [[analyse /usr/share/doc/dak/crontabs/cron.daily-security]]

===== Analyse de certaines commandes =====
J'analyse ici les commandes qui sont dans ///usr/share/doc/dak/scripts//.

  * [[analyse /usr/share/doc/dak/scripts/mkchecksums]]
  * [[analyse /usr/share/doc/dak/scripts/mklslar]]
  * [[analyse /usr/share/doc/dak/scripts/update-bugdoctxt]]
  * [[analyse /usr/share/doc/dak/scripts/update-mailingliststxt]]
  * [[analyse /usr/share/doc/dak/scripts/update-mirrorlists]]

===== Configuration =====
Comparaison des différents fichiers katie.conf.

  * [[analyse /usr/share/doc/dak/example/katie.conf.gz]]
  * [[analyse /usr/share/doc/dak/example/katie.conf-non-US.gz]]
  * [[analyse /usr/share/doc/dak/example/katie.conf-security.gz]]
  * [[analyse /usr/share/dak/katie.conf-dak]]

  * [[élaboration de mon katie.conf sur ondine]]

====== Le paquet dak (officiel) de debian ======
  * Il est fait par Joerg Jaspert.
  * [[Analyse de dak_1.0-8.diff]].

====== Ressources ======


===== Les sources =====

  * bzr : http://ftp-master.debian.org/bzr/debian-archive-kit/

  * Le [[http://cvs.debian.org/dak/?cvsroot=dak|cvs de dak]]. Pour le récupérer :

  $ cvs -d :pserver:anonymous@cvs.debian.org:/cvs/dak co dak

  * [[http://ftp-master.debian.org/]].
  * Les explication de [[http://ftp-master.debian.org/reject.html|rejet]].
  * [[http://ftp-master.debian.org/unmet-deps/|Dépendances]].

===== Le vrai =====
  * [[http://ftp-master.debian.org/new.html|NEW et BYHAND]].
  * [[http://incoming.debian.org/|incoming]]
  * Les [[http://ftp-master.debian.org/removals.txt|paquets supprimés]] avec des abbréviations :
    - ANAIS
    - ASM
    - NDB
    - NPOASR
    - NVIT
    - NVIU
    - ROM, RoM Request of Maintainer (?)
    - RoQA Request of Quality Assurance (?)

===== Contributeurs =====

Contributeurs relevés dans le code source de dak:
  - [[James Troup]] [[james@nocrew.org]] (melanie)
  - Christian Reis (journal des modifications de melanie).
  - [[Otavio Salvador]] ([[http://lists.enterprise-debian.de/pipermail/dak-nm/2005-January/000051.html|journal des modifications]] du paquet dak 1.0-5, a suggéré de n'utiliser que la « white list »).
  - Martin Michlmayr [[tbm@cyrius.com]] (journal des modifications de melanie)

  * http://ncommander.blogspot.com/2009/01/notes-from-underground-part-1.html

===== Expérimentateurs =====

Ceux qui ont déjà essayé / réussi une installation de dak :
  * Brian May
  * [[http://blogs.turmzimmer.net/2004/12/19|Andreas Barth]] pour [[http://blogs.turmzimmer.net/2005/01/02#whois-20050101|volatile]]. Voir aussi [[http://blog.zugschlus.de/archives/127-Updates-to-clamav-data-build-process-for-volatile.html|ici]].
    * http://blogs.turmzimmer.net/2006/04/17#dpkg-source-2a
  * [[http://lists.debian.org/debian-newmaint/2004/12/msg00041.html|Joerg Jaspert]] (responsable du paquet dak) pour [[http://dak.ganneff.de/|Ganneff]] et [[http://lists.jj21.de/mailman/listinfo|ses listes]]. [[http://lists.enterprise-debian.de/pipermail/dak-bcc/2004-December/000009.html|Message historique]].
  * [[http://sft.if.usp.br/debian-marillat/|Christian Marillat]] pour son archive (le 2005-06-09).
  * [[http://www.advogato.org/person/otavio/|Otavio Salvador]] et [[http://www.freedom.ind.br/otavio/|ici]] pour [[http://www.advogato.org/person/otavio/diary.html?start=1|Debian-BR-CDD]].
  * Gustavo Noronha Silva <kov@debian.org> [[http://lists.debian.org/debian-devel/2002/12/msg00895.html|ici]]
  * Selon http://kitenet.net/~joey/blog/entry/secure_testing_ramping_up-2005-08-28-20-40.html, Aba (Andreas Barth) et Zobel ont installé [[http://secure-testing.debian.net/|secure-testing]]. L'un des deux serait Kenshi Muto :  http://kmuto.jp/b.cgi/2005/08/29#etch-secure et est aussi de la partie : http://www.grep.be/blog/2005/08/29/

  * [[http://lists.agnula.org/pipermail/developers/2004-February/004868.html|Demudi]] et [[http://lists.alioth.debian.org/pipermail/partial-mirror-devel/2004-July/000008.html|ici]].

  * Skolelinux :
    * http://wiki.debian.org/DebianEdu/ftpmaster-howto
    * http://wiki.debian.org/DebianEdu/ArchivePolicy

  * Debian VoIP Team : http://www.tribulaciones.org/blog/computers/debian/debian_voip_team-19-03-2006

Ou qui projettent d'y passer :
  * [[http://repositories.alioth.debian.org/|Alioth]] (Mark Howard) mais cela semble essoufflé.


===== Autres docs =====

  * Un japonais ([[http://kmuto.jp/|Kenshi Muto]]) qui semble avoir [[http://kmuto.jp/open.cgi?dak&l=en|bossé sur dak]] et dont le [[http://kmuto.jp/open.cgi?l=en|wiki]] semble très intéressant. Avec un [[http://ftp-master.debian.org/testing/update_out_code/|pointeur]] fourni par lui dont je ne comprends pas l'objet.
  * Un [[http://ukai.org/wiliki/wiliki.cgi?Debian:dak&l=en|autre japonais sur dak]].
  * Une [[http://lists.debian.org/debian-devel/2002/12/msg00735.html|vieille doc d'installation]] avec une [[http://lists.debian.org/debian-devel/2002/12/msg00746.html|correction de James Troup]], [[http://lists.debian.org/debian-devel/2002/12/msg00741.html|une autre]] et [[http://lists.debian.org/debian-devel/2002/12/msg00751.html|encore une autre]]. Sur le même fil, une [[http://lists.debian.org/debian-devel/2002/12/msg00742.html|remarque pour ne pas envoyer de messages]].
  * La [[http://mailman.nocrew.org/cgi-bin/mailman/listinfo/dak-disc|liste de développement historique]].
  * Une mention de dak dans cette doc sur [[http://people.linux.org.tw/~chihchun/CDDP/www/devel/testing|testing]] et [[http://debui.vlsm.org/doc/developers-reference/ch-pkgs.fr.html#s-nmu-katie|ici]] aussi.
  * Debconf3 : http://people.debian.org/~mjb/talks/debconf3/
  * Martin Michlmayr avait fait un exposé sur dak au [[http://www.fosdem.org/2004/index/dev_room_java|FOSDEM 2004]].
  * Il semble que pour gérer « incoming », il faille utiliser [[ftp://ftp.debian.org/debian/project/misc/|debianqueued-0.9]]. [[ftp://ftp.debian.org/debian/project/misc/debianqueued-0.9.tar.gz|Précisément.]]

==== dsync-flist ====
  * Appelé par [[mkchecksums]].
  * Dur à trouver :
    * http://lists.debian.org/debian-dak/2005/06/msg00001.html
  * http://www.roeckx.be/packages/dsync/

===== Des idées =====

  * http://blog.madduck.net/debian


===== Travail en cours =====
  * AJT :
    * http://azure.humbug.org.au/~aj/blog/2005/11/16#2005-11-16-dak
    * http://azure.humbug.org.au/~aj/blog/2005/11/17#2005-11-17-q-unapproved
    * http://azure.humbug.org.au/~aj/blog/2005/11/26#2005-11-26-niv2
    * http://azure.humbug.org.au/~aj/blog/2005/11/26#2005-11-26-queuebuild
    * http://azure.humbug.org.au/~aj/blog/2005/12/06#2005-12-06-detailed-sec-plan
    * (Détails) http://azure.humbug.org.au/~aj/blog/2005/12/12#2005-12-12-impl1
  * http://ganneff.de/blog/2006/07/28#ftp

  * Thomas Viehmann
    * http://amayita.livejournal.com/82898.html?thread=159698#t159698
    * http://people.debian.org/~tviehmann/debian/unstable/

====== Méthode ======

Voir aussi [[http://lists.debian.org/debian-devel/2002/12/msg00632.html|Brian May]].

===== Nouveau paquet =====

  * Selon [[http://lists.debian.org/debian-devel/2002/12/msg00735.html|Brian May]], on utilise [[lisa]] pour accepter à la main un paquet dans queue/new ou queue/byhand : aller dans le répertoire correspondant et
  lisa *.changes

  * [[kelly]] installe un paquet qui a déjà été accepté.

===== Usages marginaux =====

  * [[alyson]] initialise certaines tables de la base de données (selon --help).
  * [[amber]] pour les avertissements de sécurité.
  * [[andrea]] pour les différences entre stable et unstable.
  * [[ashley]] crée un fichier //.katie//.
  * [[catherine]] transforme les vieilles archives en //pool// (réservoir).
  * [[emilie]] synchronise les signatures avec la base LDAP de Debian
  * [[halle]] supprime les //.changes// obsolètes de proposed-updates.
  * [[jeri]] vérifie les dépendances pour proposed-updates.
  * [[julia]] sychronise la base postgresql avec le /etc/passwd du système.
  * [[rene]] recherche les paquets obsolètes ou en double.
  * [[rosamund]] recherche les utilisateurs sans paquets.
  * [[rose]] crée les répertoires selon //katie.conf//.
  * [[rhona]] fait le ménage des vieux paquets.
  * [[shania]] nettoie incoming (ou autre).
  * [[uma]] nouvel utilisateur « à la main ».

===== Maintenance =====

  * [[madison]] donne de l'information sur les paquets.
  * [[melanie]] (ajoute (?) ou) supprime des paquets.
  * [[heidi]] modifie le contenu d'une //suite//.
  * [[jenna]] prépare les fichiers nécessaires pour apt-ftparchive.
  * [[jennifer]] fait passer le paquet dans new (ou dans l'archive ?).
  * [[lauren]] rejette « à la main » le .change.
  * [[ziyi]] produit les fichiers //Release//.

===== Bilans, audit, statistiques, etc. =====

  * [[charisma]] fabrique l'index des mainteneurs de paquets.
  * [[helena]] fait le bilan des paquets dans un répertoire (typiquement new et byhand).
  * [[saffron]] affiche des stats pour //arch-space//, //pkg-nums//, //daily-install//.
  * [[tea]] vérifie archive et base de données pour //md5sums//, //files// et //dsc-syntax//, //missing-overrides//, //source-in-one-dir//, //timestamps//, //tar-gz-in-dsc//, //validate-indices//, //files-not-symlinks// et //validate-builddeps//.

===== Gestion des surclassements  =====
C'est comme cela que je traduis pour l'instant les //overrides//.

  * C'est le boulot de [[natalie]] (général) et de [[alicia]] (finement, détails).
  * [[denise]] sort les tables de surclassements en fichiers texte.

===== Le chemin d'un paquet =====
Comme je le comprends pour l'instant, après lecture de : http://kmuto.jp/open.cgi?dak&l=en et [[http://ukai.org/wiliki/wiliki.cgi?Debian:dak&l=en]].

  * Le paquet est d'abord déposé (avec son //.changes//) dans un ftp public //incoming//.
    * Chez moi : ///home/ftp/incoming/// pour //vsftpd//.

  * Il est ensuite transféré de ce répertoire vers ///opt/dak/queue/unchecked// par [[.debianqueued|debianqueued0.9]].
    * Chez moi : c'est le cas.

  * Une fois dans //unchecked// il est automatiquement traité par [[jennifer]] qui l'envoie soit directement dans //unstable// (déjà présent) soit dans ///opt/dak/queue/new//.

  * Selon le modèle de message [[jennifer.new]] de [[jennifer]], il faut aussi mettre à jour (parfois au moins) les surclassements.

  * Du répertoire ///opt/dak/queue/new//, on appelle [[lisa]] sur le fichier .changes :

  lisa nom_du_paquet.changes

  * Une fois acceptés (choix A), les paquets se retrouvent dans ///opt/dak/queue/accepted//. Les paquets dans cette queue sont gérés par [[kelly]], invoquée par les tâches quotidiennes (voir [[kelly]]).

====== Traduction ======
Sur la page de [[traduction]] de dak.