Outils pour utilisateurs

Outils du site


doc:dak:readme.debian.fr
dak pour Debian
---------------

1. Folie
2. Répertoire de base
3. Configuration initiale
4. Crontabs/Scripts
5. Variables d'environnement
6. Étapes vers un dak fonctionnel

1. Folie
--------

Ceci est le paquet pour dak, le « Kit d'Archive Debian », parfois
connu sous le nom de katie (mais katie en est « seulement » une partie
(centrale)).

Primo : vous ne pourrez, ni ne pouvez, utiliser dak en installant
simplement ce paquet, mais il devrait aider en de nombreuses choses.
Au moins, j'ai essayé de l'amener à faire cela. Vous devez lire ce
« Readme ». Vraiment.

Secundo : 
	a. Lisez les docs.
	b. Regardez les examples de configurations.
	c. Installez mini-dinstall ou debarchiver et utilisez-les.
	d. Si vous lisez toujours ceci, vous êtes fou ou vous avez
           besoin d'un kit d'archive pour une gigantesque archive et
           vous ne voulez pas utiliser mini-dinstall -> allons-y pour
           dak.


2. Répertoire de base
---------------------

Ce paquet pose une question debconf pour le répertoire de base.
L'essentiel de dak va fonctionner dans ce répertoire, certains
fichiers par défaut sont aussi copiés là.
Ce paquet ne crée qu'un répertoire de base, mais en théorie, vous
pouvez avoir des milliers d'installations de dak sur une seule machine
-- copiez simplement le sous-répertoire katie/ dans le répertoire de 
base pour le nouveau dak et exécutez rose là-bas.

3. Configuration initiale
-------------------------

Après que le paquet est installé ou que vous avez ajouté un nouveau
répertoire de base, vous devriez éditer les fichiers de configuration.
Ce paquet produit certains fichiers de configurations élémentaires,
qui sont adaptés à l'emplacement que vous avez donné dans Debconf, et
qui sont alors copiés à cet emplacement. Si, plus tard, vous voulez
les consulter de nouveau, allez voir /usr/share/dak/config.

D'autres exemples de configuration, incluant ceux qui sont utilisés
pour l'archive Debian, peuvent être trouvés dans /usr/share/doc/dak au
coté d'un tas de « Readme » avec différents objets.

4. Crontabs/Scripts
-------------------

dak a besoin que certaines tâches soient lançées par cron pour
fonctionner correctement. Par exemple, pour traiter les nouveaux
fichiers dans le répertoire d'arrivée « incoming » il doit y avoir un
cronjob faisant exactement cela toutes les X minutes. Pour cela, il y
a un fichier prêt à l'emploi cron.unchecked dans votre répertoire
katie de base. Vous n'avez besoin que de paramétrer les entrées du
crontab de katie pour l'exécuter toutes les X minutes.

Le répertoire /usr/share/doc/dak/crontabs contient aussi quelques
autres exemples de scripts. Attention, s'il vous plaît : ce sont des
exemples réels utilisés sur les machines Debian. Vous ne devrez pas
les utiliser exactement comme ils sont, adaptez-les à vos besoins.
TOUT PARTICULIÈREMENT CHANGEZ TOUTES LES ADRESSES DE COURRIEL qui sont
dedans.

Un exemple de crontab pour katie est dans le fichier katie.crontab,
adaptez-le à vos besoins.

5. Variables d'environnement
----------------------------

Vous devez définir SCRIPTVARS dans votre environnement (et celui de
votre utilisateur dak) pour pointer vers votre fichier vars de base,
elle est utilisée par de nombreux scripts.

6. Étapes vers un dak fonctionnel
---------------------------------

a. Mettez votre postgresql en fonction. Je suppose qu'il tourne en local,
   sinon modifiez votre fichier de configuration (katie.conf) pour dak.
b. Exécutez createuser VOTRENOMDUTILISATEURDAK avec un utilisateur qui
   est autorisé à créer des bases de données et autorisez
   VOTRENOMDUTILISATEURDAK à créer une base de données. Cet
   utilisateur a besoin d'être superutilisateur dans la base de
   données car il exécute plus tard COPY à partir d'un fichier. 
c. su - VOTRENOMDUTILISATEURDAK
d. rose
e. Regardez comment les répertoires sont créés.
f. Ajoutez un groupe « ftpmaster » à votre base de données postgresql.
   Dans une invite psql, un CREATE GROUP ftpmaster; devrait le faire.
   Ajoutez votre VOTRENOMDUTILISATEURDAK à ce groupe.
g. Allez dans votre RÉPERTOIREDAK/katie et exécutez
   /usr/share/dak/neve -a puis regardez-là créer la base de données.
   Si cela se termine par quelques VACUUM et deux GRANTs cela a
   marché.
   Attention, neve DÉTRUIT votre base de données, donc ne l'exécutez
   pas si vous aimez les données qui sont dans cette base !
h. Vous avez besoin de mettre vos mainteneurs dans la base de
   données. L'archive Debian utilise un script (emilie) qui se
   met en phase avec le serveur LDAP, mais vous ne voulez probablement
   pas vous mettre en phase avec le LDAP de Debian. :)
   Si vous avez une configuration avec un serveur LDAP, regardez
   emilie et ses options de configuration. Sinon, il y a un script
   appelé uma qui vous aide à faire cela. Vous donnez juste un
   identifiant de clef (keyid) avec l'option -k et il fera le reste,
   après vous avoir demandé si vous approuvez l'action.
   Si vous lui dites de créer un utilisateur système pour le nouveau
   compte, il exécutera useradd pour faire le nécessaire, pour cela
   VOTRENOMDUTILISATEURDAK doit accéder par sudo à useradd, avec
   l'option NOPASSWD. Il va aussi ajouter les nouveaux utilisateurs au
   fichier de liste blanche de courriel, si vous avez cette option
   d'activée (elle l'est par défaut).
i. Repétez l'étape h pour chacun de vos utilisateurs.
j. Installez les cronjobs dont vous avez besoin. Commencez par
   cron.unchecked qui est déjà copié dans
   /VOTERÉPERTOIREDAK/katie/cron.unchecked et demande à jennifer
   de traiter les nouveaux dépôts. La Crontab que Debian utilise
   peut être trouvée comme exemple dans /usr/share/doc/dak/crontabs.
k. Vous devez maintenant mettre en place le trousseau de clefs pour katie.
   Faites une commande similaire à la suivante, mais en adaptant à
   votre emplacement :
   gpg --no-default-keyring --keyring /opt/dak/keyrings/keyring.gpg
l. Pour que ziyi puisse signer les fichiers Release vous avez besoin
   d'une clef s3kr1t.
   gpg --gen-key et suivez les invites. Ensuite, déplacez-là du
   répertoire par défaut de VOTRENOMDUTILISATEURDAK vers l'emplacement
   de « SigningKeyring » de la configuration. Les deux clefs,
   publiques comme privées. Écrivez votre identifiant de clef « Keyid »
   dans la valeur de configuration « SigningKeyIds ». Rappelez-vous
   que la signature fonctionne automagiquement, donc une phrase de
   passe (passphrase) sur la clef n'aide pas vraiment...
m. Si vous avez suivi jusqu'ici, vous avez préparé votre archive pour
   tourner et accepter les nouveaux dépôts. Sauf qu'ils ne sont pas
   installés -- vous avez besoin d'un autre script pour cela dans
   votre crontab. cron.daily, regardez dans les exemples. Modifiez-le
   pour convenir à vos besoins (désactivez billie pour le moment comme
   première étape, changez les adresses de courriel), et exécutez-le
   aussi souvent que vous le souhaitez. Je suggère chaque jour ou
   chaque heure.
n. Bien sûr, il doit y avoir un moyen pour faire rentrer les fichiers
   dans l'archive. Mettez en place un serveur ftp pour permettre aux
   utilisateurs de déposer dans queue/unchecked. Prenez seulement
   garde à ce que tous les fichiers soient accessible en
   lecture/écriture à votre VOTRENOMDUTILISATEURDAK ou vous aurez des
   problèmes. :)


 -- Joerg Jaspert <joerg@debian.org>, Mon, 29 Nov 2004 20:04:27 +0100
 -- Dernière révision de la traduction française par Frédéric Lehobey
    <Frederic.Lehobey@free.fr> 2005-08-03
doc/dak/readme.debian.fr.txt · Dernière modification: 2005/08/03 11:35 par lehobey