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 , Mon, 29 Nov 2004 20:04:27 +0100 -- Dernière révision de la traduction française par Frédéric Lehobey 2005-08-03