Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
doc:dak:readme.debian.fr [2005/08/03 11:29] lehobey |
doc:dak:readme.debian.fr [2005/08/03 11:35] lehobey |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | <file> | ||
- | 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. | ||
- | |||
- | Secondo : | ||
- | 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-07-27 | ||
- | </file> |