cookutils annotate doc/cookutils.fr.html @ rev 935
Fix previous commit.
But we can - not remove packages at all - while we working inside aufs chroot.
Only several packages builds not using aufs (and that builds almost always are buggy).
But we can - not remove packages at all - while we working inside aufs chroot.
Only several packages builds not using aufs (and that builds almost always are buggy).
author | Aleksej Bobylev <al.bobylev@gmail.com> |
---|---|
date | Sun Jun 18 23:27:33 2017 +0300 (2017-06-18) |
parents | |
children | dc3ff2ae7314 |
rev | line source |
---|---|
pascal@831 | 1 <!DOCTYPE html> |
pascal@831 | 2 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr"> |
pascal@831 | 3 <head> |
pascal@831 | 4 <meta charset="utf-8" /> |
pascal@831 | 5 <title>Documentation de Cookutils</title> |
pascal@831 | 6 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" /> |
pascal@831 | 7 <script type="text/javascript" src="../slitaz-doc.js"></script> |
pascal@831 | 8 </head> |
pascal@831 | 9 <body> |
pascal@831 | 10 |
pascal@831 | 11 <header> |
pascal@831 | 12 <h1>Documentation de Cookutils</h1> |
pascal@831 | 13 </header> |
pascal@831 | 14 |
pascal@831 | 15 <!-- Start content --> |
pascal@831 | 16 <div id="content"> |
pascal@831 | 17 |
pascal@831 | 18 <h2>SliTaz Cook & Cooker</h2> |
pascal@831 | 19 |
pascal@831 | 20 <p> |
pascal@831 | 21 Les Cookutils SliTaz fournissent les outils et utilitaires pour |
pascal@831 | 22 faciliter la construction de paquets SliTaz. Ils sont faciles à |
pascal@831 | 23 utiliser et à apprendre, rapides et légers. Vous pourrez créer |
pascal@831 | 24 des paquets SliTaz avec quelques commandes. Les Cookutils fournissent |
pascal@831 | 25 l'utilitaire 'cook' et le <a href="#cooker">Cooker</a>. |
pascal@831 | 26 </p> |
pascal@831 | 27 <p> |
pascal@831 | 28 Cook vous permet de créer et de compiler un paquet, fournit un |
pascal@831 | 29 fichier journal et vérifie la qualité du paquet et de la recette. |
pascal@831 | 30 Le Cooker est un robot de fabrication avec plus d'automatismes et |
pascal@831 | 31 peut être utilisé comme outil de fabrication car il fournit |
pascal@831 | 32 une interface CGI/Web qui vous parmet de voir des journaux de |
pascal@831 | 33 cuisson agréables et coloriés. Cook et le Cooker se servent des |
pascal@831 | 34 mêmes wok et base de fichiers, il partagent les paquets |
pascal@831 | 35 <a href="#blocked">bloqués</a> et cassés tout comme leur activité. |
pascal@831 | 36 </p> |
pascal@831 | 37 <p> |
pascal@831 | 38 Pour toute information technique, par exemple le style de codage, etc, |
pascal@831 | 39 veuillez vous référer au README qui se trouve dans les fichiers |
pascal@831 | 40 source ou dans /usr/share/doc/cookutils. |
pascal@831 | 41 </p> |
pascal@831 | 42 |
pascal@831 | 43 <h3>Usage de Cook</h3> |
pascal@831 | 44 <p> |
pascal@831 | 45 Cook donne une aide intégrée succinte que vous pouvez afficher |
pascal@831 | 46 avec la commande 'usage'. Il a aussi quelques options pour faire |
pascal@831 | 47 des tâches spécifiques avant ou après la cuisson. Pour avoir |
pascal@831 | 48 l'aide et l'usage : |
pascal@831 | 49 </p> |
pascal@831 | 50 <pre> |
pascal@831 | 51 # cook usage |
pascal@831 | 52 </pre> |
pascal@831 | 53 |
pascal@831 | 54 <h3>Comment faire</h3> |
pascal@831 | 55 <p> |
pascal@831 | 56 La première chose à faire avant de cuire des paquets est de |
pascal@831 | 57 configurer votre environnement. Les 2 façons recommendées de |
pascal@831 | 58 travailler : cuire directement sur l'hôte ou cuire dans un chroot |
pascal@831 | 59 pour protéger votre hôte. Dans le cas où vous voulez travailler |
pascal@831 | 60 dans un chroot vous pouvez installer et utiliser Tazdev pour en |
pascal@831 | 61 créer un et vous placer à l'intérieur : |
pascal@831 | 62 </p> |
pascal@831 | 63 <pre> |
pascal@831 | 64 # tazdev gen-chroot && tazdev chroot |
pascal@831 | 65 </pre> |
pascal@831 | 66 <p> |
pascal@831 | 67 Par défaut Tazdev crée un chroot dans /home/slitaz/cooking/chroot |
pascal@831 | 68 mais vous pouvez spécifier un chemin quelconque en argument. L'endroit |
pascal@831 | 69 du chroot n'est pas important, lorsque vous serez dans le chroot vous |
pascal@831 | 70 utiliserez des chemins standards de SliTaz comme /home/slitaz/wok pour |
pascal@831 | 71 de répertoire du wok ou /home/slitaz/log pour tous les journaux de |
pascal@831 | 72 cuisson. Comme toujours vous pouvez afficher l'aide de tazdev avec : |
pascal@831 | 73 tazdev usage. |
pascal@831 | 74 </p> |
pascal@831 | 75 <p> |
pascal@831 | 76 Lorsque vous utilisez un chroot il y a 2 répertoires spéciaux montés |
pascal@831 | 77 avec l'option bind : src et packages. Les sources pour tous les paquets |
pascal@831 | 78 sont stockés par défaut dans /home/slitaz/src, ce répertoire est |
pascal@831 | 79 monté dans le chroot pour que les outils puissient l'utiliser. |
pascal@831 | 80 Cette méthode vous permet de partager les sources avec plusieurs |
pascal@831 | 81 chroots par exemple un pour cooking et un pour stable. Le répertoire |
pascal@831 | 82 par défaut est : /home/slitaz/[version]/packages ainsi ils ne sont pas |
pascal@831 | 83 dans le chroot et ne sont pas affectés si le chroot est effacé par |
pascal@831 | 84 erreur. |
pascal@831 | 85 </p> |
pascal@831 | 86 |
pascal@831 | 87 <h3>Pour commencer</h3> |
pascal@831 | 88 <p> |
pascal@831 | 89 Donc vous avez décidé de la façon dont vous voulez travailler, alors préparons |
pascal@831 | 90 l'environnement de cuisson. Cook se sert du fichier de configuration cook.conf, |
pascal@831 | 91 si vous voulez utiliser des chemins inhabituels pour les répertoires et fichiers |
pascal@831 | 92 SliTaz, vous devez le modifier. Le paramétrage va créer quelques répertoires |
pascal@831 | 93 et fichiers pour garder une trace de la l'activité et des erreurs, tous les |
pascal@831 | 94 fichiers sont des fichiers textes simples que vous pouvez ouvrir dans un |
pascal@831 | 95 éditeur de texte. Pour préparer votre environnement : |
pascal@831 | 96 </p> |
pascal@831 | 97 <pre> |
pascal@831 | 98 # cook setup |
pascal@831 | 99 </pre> |
pascal@831 | 100 <p> |
pascal@831 | 101 La commande de paramétrage à une option --wok qui vous permet de cloner un |
pascal@831 | 102 wok SliTaz pendant la creation de l'environnement de cuisson. Même si vous |
pascal@831 | 103 n'êtes pas un développeur officiel vous pouver le cloner et utiliser les |
pascal@831 | 104 paquets existants comme exemple pour créer le vôtre. |
pascal@831 | 105 Pour paramétrer et cloner le wok cooking ou le wok undisgest par défaut ; |
pascal@831 | 106 </p> |
pascal@831 | 107 <pre> |
pascal@831 | 108 # cook setup --wok |
pascal@831 | 109 # cook setup --undigest |
pascal@831 | 110 </pre> |
pascal@831 | 111 |
pascal@831 | 112 <h3>Testez votre environnement</h3> |
pascal@831 | 113 <p> |
pascal@831 | 114 Cook fournit une commande de test qui crée un paquet et le cuit. Cela vous |
pascal@831 | 115 permet de voir si votre environnement fonctionne et donne un paquet exemple |
pascal@831 | 116 avec une recette. Le paquet s'appelle 'cooktest' et peut être retiré après |
pascal@831 | 117 avoir été testé. Pour cuire le paquet de test : |
pascal@831 | 118 </p> |
pascal@831 | 119 <pre> |
pascal@831 | 120 # cook test |
pascal@831 | 121 </pre> |
pascal@831 | 122 |
pascal@831 | 123 <h3>Créer et cuire</h3> |
pascal@831 | 124 <p> |
pascal@831 | 125 Si votre environnement est correctement paramétré vous pouvez commencer |
pascal@831 | 126 à créer et compiler des paquets SliTaz depuis votre wok. Pour créer un |
pascal@831 | 127 nouveau pqauet avec une recette vide (vous pouvez aussi créer une recette |
pascal@831 | 128 interactivement) : |
pascal@831 | 129 </p> |
pascal@831 | 130 <pre> |
pascal@831 | 131 # cook new pkgname |
pascal@831 | 132 # cook new pkgname --interactive |
pascal@831 | 133 </pre> |
pascal@831 | 134 <p> |
pascal@831 | 135 Si vous venez de créer un nouveau paquet, vous devrez éditer le recette avec |
pascal@831 | 136 votre éditeur de texte favori. Alors la recette est prête ou si vous avez |
pascal@831 | 137 déjà un paquet existant, vous pouvez le cuire : |
pascal@831 | 138 </p> |
pascal@831 | 139 <pre> |
pascal@831 | 140 # cook pkgname |
pascal@831 | 141 </pre> |
pascal@831 | 142 <p> |
pascal@831 | 143 Si tout c'est bien passé vous trouverez votre paquet dans le répertoire |
pascal@831 | 144 $SLITAZ/packages et tous les fichiers produits dans $SLITAZ/wok/pkgname. |
pascal@831 | 145 </p> |
pascal@831 | 146 |
pascal@831 | 147 <h3>Cuire et installer</h3> |
pascal@831 | 148 <p> |
pascal@831 | 149 Si vous voulez cuire et installer le paquet en une commande : |
pascal@831 | 150 </p> |
pascal@831 | 151 <pre> |
pascal@831 | 152 # cook pkgname --install |
pascal@831 | 153 </pre> |
pascal@831 | 154 |
pascal@831 | 155 <h3>Obtenir les sources</h3> |
pascal@831 | 156 <p> |
pascal@831 | 157 Si vous voulez ou avez besion de seulement télécharger les sources d'un |
pascal@831 | 158 paquet sans le fabriquer, vous pouvez utiliser l'option --getsrc comme suit : |
pascal@831 | 159 </p> |
pascal@831 | 160 <pre> |
pascal@831 | 161 # cook pkgname --getsrc |
pascal@831 | 162 </pre> |
pascal@831 | 163 |
pascal@831 | 164 <h3>Nettoyer les paquets</h3> |
pascal@831 | 165 <p> |
pascal@831 | 166 Après compilation et empaquetage il y a plusieurs fichiers dans le wok qui |
pascal@831 | 167 prennent de la place disque. Pour nettoyer un pqauet unique : |
pascal@831 | 168 </p> |
pascal@831 | 169 <pre> |
pascal@831 | 170 # cook pkgname --clean |
pascal@831 | 171 </pre> |
pascal@831 | 172 <p> |
pascal@831 | 173 Vous pouvez aussi nettoyer le wok en entier ou vous pouvez choisir de garder |
pascal@831 | 174 les fichiers SliTaz et seulement retirer les sources : |
pascal@831 | 175 </p> |
pascal@831 | 176 <pre> |
pascal@831 | 177 # cook clean-wok |
pascal@831 | 178 # cook clean-src |
pascal@831 | 179 </pre> |
pascal@831 | 180 |
pascal@831 | 181 <h3>Recherche</h3> |
pascal@831 | 182 <p> |
pascal@831 | 183 Cook fournit une fonction de recherche simple pour trouver rapidement un |
pascal@831 | 184 paquet dans le wok. Elle utilise grep et supporte des expressions régulières : |
pascal@831 | 185 </p> |
pascal@831 | 186 <pre> |
pascal@831 | 187 # cook search busybox |
pascal@831 | 188 </pre> |
pascal@831 | 189 |
pascal@831 | 190 <h3>Functions de la recette</h3> |
pascal@831 | 191 <p> |
pascal@831 | 192 Beaucoup de paquets fournissent le même genre de fichiers comme les |
pascal@831 | 193 paquets *-dev avec les librairies statiques, les fichiers pkgconfig et |
pascal@831 | 194 les entêtes pour includes. Alors cook fournit une fonction à utiliser |
pascal@831 | 195 dans la recette : |
pascal@831 | 196 </p> |
pascal@831 | 197 <pre> |
pascal@831 | 198 get_dev_files : Install /usr/lib/{lib.*a,pkgconfig} /usr/include |
pascal@831 | 199 </pre> |
pascal@831 | 200 |
pascal@831 | 201 <h3>Liste de paquets</h3> |
pascal@831 | 202 <p> |
pascal@831 | 203 Cook peut lister les paquets dans le wok et ainsi créer une liste de paquets |
pascal@831 | 204 adaptée pour Tazpkg. Cela vous permet de créer votre dépôt de paquets assez |
pascal@831 | 205 facilement et c'est utiilisé pour créer la liste offcielle des paquets Slitaz |
pascal@831 | 206 sur les miroirs. Pour lister le wok actuellement utilisé par cook (il n'est |
pascal@831 | 207 pas nécessaire d'être root) : |
pascal@831 | 208 </p> |
pascal@831 | 209 <pre> |
pascal@831 | 210 $ cook list-wok |
pascal@831 | 211 </pre> |
pascal@831 | 212 <p> |
pascal@831 | 213 En créant la base (ou liste) de paquets, cook va vérifier si vous avez un |
pascal@831 | 214 dépôt de saveurs dans /home/slitaz/flavors ; si c'est la cas il va emballer |
pascal@831 | 215 toutes les saveurs en utilisant la dernière liste de paquets disponible. |
pascal@831 | 216 Pour créer une liste de paquets et les fichers de saveurs : |
pascal@831 | 217 </p> |
pascal@831 | 218 <pre> |
pascal@831 | 219 # cook pkgdb |
pascal@831 | 220 </pre> |
pascal@831 | 221 |
pascal@831 | 222 <h3 id="cooker">Le Cooker</h3> |
pascal@831 | 223 <p> |
pascal@831 | 224 Le Cooker est un robot de compilation, sa première fonction est de rechercher |
pascal@831 | 225 les commits dans le wok, créer une liste ordonnée et cuire tous les paquets |
pascal@831 | 226 modifiés. Il peut aussi être utilisé comme interface pour cook car ils |
pascal@831 | 227 utilisent les mêmes fichiers. Le Cooker peut aussi être utilisé pour cuire |
pascal@831 | 228 une longue liste de paquets en une fois comme tous les paquets d'une saveur. |
pascal@831 | 229 Le cooker fournit une interface CGI/Web agréable qui fonctionne par défaut |
pascal@831 | 230 sur n'importe quel système SliTaz car il fournit le support CGI via le serveur |
pascal@831 | 231 httpd de busybox. |
pascal@831 | 232 </p> |
pascal@831 | 233 <p> |
pascal@831 | 234 Le Cooker fournit une aide intégrée succinte et quelques commandes. |
pascal@831 | 235 Par exemple pour afficher l'usage vous pouvez faire : |
pascal@831 | 236 </p> |
pascal@831 | 237 <pre> |
pascal@831 | 238 # cooker usage |
pascal@831 | 239 # cooker -u |
pascal@831 | 240 </pre> |
pascal@831 | 241 |
pascal@831 | 242 <h3>Paramétrage du Cooker</h3> |
pascal@831 | 243 <p> |
pascal@831 | 244 Tout comme cook, le Cooker a besoin d'un environnement fonctionnel avant de |
pascal@831 | 245 commencer à l'utiliser. Le principale différence avec l'environnement de |
pascal@831 | 246 cook est que le Cooker a besoin de 2 woks. Un wok Hg propre comme référence |
pascal@831 | 247 et un wok de fabrication. De cette façon il est facile de comparer les 2 woks |
pascal@831 | 248 et d'obtenir les modifications. SI vous avez déjà un environnement pour cook, |
pascal@831 | 249 vous devez déplacer votre wok avant de paramétrer le Cooker ou il s'en |
pascal@831 | 250 plaindra. Le paramétrage installera aussi un ensemble de paquets de |
pascal@831 | 251 développement qui peuvent être définis dans le fichiers de configuration |
pascal@831 | 252 cook.conf avec la variable SETUP_PKGS. Pour paramétrer votre environnement |
pascal@831 | 253 cooker : |
pascal@831 | 254 </p> |
pascal@831 | 255 <pre> |
pascal@831 | 256 # cooker setup |
pascal@831 | 257 </pre> |
pascal@831 | 258 <p> |
pascal@831 | 259 Si tout ce passe correctement vous avez maintenant 2 woks, les paquets de |
pascal@831 | 260 developpement de base installés et tous les fichiers nécessaires créés. |
pascal@831 | 261 Le comportement par défaut est de rechercher les commits, vous pouvez lancer |
pascal@831 | 262 un test : |
pascal@831 | 263 </p> |
pascal@831 | 264 <pre> |
pascal@831 | 265 # cooker |
pascal@831 | 266 </pre> |
pascal@831 | 267 |
pascal@831 | 268 <h3>Cuire avec le Cooker</h3> |
pascal@831 | 269 <p> |
pascal@831 | 270 Encore 2 façons de travailler maintenant : faire des modifications dans |
pascal@831 | 271 le nouveau wok Hg et lancer le cooker sans arguments ou cuire les paquets |
pascal@831 | 272 manuellement. Le cooker vous permet de cuire un paquet unique ou tous les |
pascal@831 | 273 paquets d'un catégorie ou d'une saveur. Vous pouvez aussi essayer de |
pascal@831 | 274 fabriquer tous les paquets non construits, mais sachez que le Cooker n'a |
pascal@831 | 275 pas été fait pour gérer des milliers de paquets. |
pascal@831 | 276 </p> |
pascal@831 | 277 <p> |
pascal@831 | 278 Pour cuire un paquet unique comme 'cook pkgname' mais avec un journal en plus : |
pascal@831 | 279 </p> |
pascal@831 | 280 <pre> |
pascal@831 | 281 # cooker pkg pkgname |
pascal@831 | 282 </pre> |
pascal@831 | 283 <p> |
pascal@831 | 284 Pour cuire plus d'un paquet vous avez différentes possibilités. |
pascal@831 | 285 Vous pouvez utiliser un paquet existant comme ceux des saveurs live, |
pascal@831 | 286 vous pouvez aussi utiliser une liste personnelle avec des noms de paquet |
pascal@831 | 287 à chaque ligne. Enfin vous pouvez construire tous les paquets d'un catégorie. |
pascal@831 | 288 </p> |
pascal@831 | 289 <pre> |
pascal@831 | 290 # cooker flavor [name] |
pascal@831 | 291 # cooker list [/path/to/cooklist] |
pascal@831 | 292 # cooker cat [category] |
pascal@831 | 293 </pre> |
pascal@831 | 294 <p> |
pascal@831 | 295 Le cooker vous permet de recuire une révision spécifique de Hg. C'est |
pascal@831 | 296 utile en production ainsi si le robot de fabrication est interrompu |
pascal@831 | 297 pendant des commits en cooking, vous pouvez cuire les paquets à la main : |
pascal@831 | 298 </p> |
pascal@831 | 299 <pre> |
pascal@831 | 300 # cooker rev 9496 |
pascal@831 | 301 </pre> |
pascal@831 | 302 |
pascal@831 | 303 <h3 id="blocked">Le paquets bloqués</h3> |
pascal@831 | 304 <p> |
pascal@831 | 305 Cook et le Cooker gèrent un fichier contenant la liste des paquets bloqués |
pascal@831 | 306 afin de ne pas les cuire lors de commits ou si une liste de cuission est utilisée. |
pascal@831 | 307 C"est très utile pour un Robot de fabrication en production. Lorsque vous |
pascal@831 | 308 bloquez ou débloquez un paquet vous pouvez ajouter une note dans les cooknotes. |
pascal@831 | 309 Exemple de blocage de paquet : |
pascal@831 | 310 </p> |
pascal@831 | 311 <pre> |
pascal@831 | 312 # cook pkgname --block |
pascal@831 | 313 # cooker block pkgname |
pascal@831 | 314 # cooker -n "Blocked pkgname note" |
pascal@831 | 315 </pre> |
pascal@831 | 316 <p> |
pascal@831 | 317 La liste des paquets bloqués est affichée dans l'interface Web du Cooker. |
pascal@831 | 318 Pour débloquer un paquet vous devez utiliser la commande unblock ou l'option |
pascal@831 | 319 cook --unblock : |
pascal@831 | 320 </p> |
pascal@831 | 321 <pre> |
pascal@831 | 322 # cook pkgname --unblock |
pascal@831 | 323 # cooker unblock pkgname |
pascal@831 | 324 </pre> |
pascal@831 | 325 |
pascal@831 | 326 <h3>Cooker CGI/Web</h3> |
pascal@831 | 327 <p> |
pascal@831 | 328 Pour que vous puissiez voir les journaux de façon agréable, garder une |
pascal@831 | 329 trace de l'activité et vous aider à trouver les erreurs, vous pouvez |
pascal@831 | 330 utiliser l'interface Web du Cooker qui se trouve par défaut dans le dossier |
pascal@831 | 331 /var/www/cooker. Si vous n'utilisez pas un chroot et que le démon httpd de |
pascal@831 | 332 Busybox est lancé, l'interface Web fonctionnera sans configuration et sera |
pascal@831 | 333 visible en <a href="http://localhost/cooker/cooker.cgi"> |
pascal@831 | 334 http://localhost/cooker/cooker.cgi</a> |
pascal@831 | 335 </p> |
pascal@831 | 336 <p> |
pascal@831 | 337 Si vous utilisez un environnement de chroot, vous devriez aussi installer |
pascal@831 | 338 cookutils sur votre hôte et modifier la variable de chemin SLITAZ. |
pascal@831 | 339 Une façon standard est d'avoir un chroot dans : |
pascal@831 | 340 </p> |
pascal@831 | 341 <pre> |
pascal@831 | 342 /home/slitaz/cooking/chroot |
pascal@831 | 343 </pre> |
pascal@831 | 344 <p> |
pascal@831 | 345 Avec /etc/slitaz/cook.conf modifié comme suit : |
pascal@831 | 346 </p> |
pascal@831 | 347 <pre> |
pascal@831 | 348 SLITAZ="/home/slitaz/cooking/chroot/home/slitaz" |
pascal@831 | 349 </pre> |
pascal@831 | 350 <p> |
pascal@831 | 351 Note : il n'est pas obligatoire d'installer les cookutils sur votre hôte |
pascal@831 | 352 pour utiliser l'interface Web. Si vous utilisez Lighttpd vous pouvez aussi |
pascal@831 | 353 copier les fichiers cooker.cgi et style.css par exemple dans votre dossier |
pascal@831 | 354 ~/Public et utiliser un cook.conf perso avec. L'avantage d'installer |
pascal@831 | 355 cookutils sur l'hôte est d'avoir des mise à jour régulières par le |
pascal@831 | 356 gestionnaire de paquets Tazpkg. Disons que vous avez cloné ou téléchargé |
pascal@831 | 357 les cookutils : |
pascal@831 | 358 </p> |
pascal@831 | 359 <pre> |
pascal@831 | 360 $ cp -a cookutils/web ~/Public/cgi-bin/cooker |
pascal@831 | 361 $ cp -f cookutils/cook.conf ~/Public/cgi-bin/cooker |
pascal@831 | 362 </pre> |
pascal@831 | 363 <p> |
pascal@831 | 364 Editez le fichier de configuration : ~/Public/cgi-bin/cooker/cook.conf pour |
pascal@831 | 365 mettre votre chemin SLITAZ et c'est tout ! |
pascal@831 | 366 </p> |
pascal@831 | 367 |
pascal@831 | 368 <h3>Cooknotes</h3> |
pascal@831 | 369 <p> |
pascal@831 | 370 Le fonction cooknotes vous permet d'écrire de courtes notes personnelles |
pascal@831 | 371 au sujet de l'emballage et est utile pour travailler en groupe. Les |
pascal@831 | 372 cooknotes ont été codées pour que les mainteneur du Robot de fabrication |
pascal@831 | 373 de SliTaz partagent des informations avec les autres contributeurs. |
pascal@831 | 374 Les cooker peut bloquer la fabrication d'un paquet et recuire des paquets |
pascal@831 | 375 à la main, par exemple il est commode de faire une note si un paquet est |
pascal@831 | 376 bloqué afin que le mainteneur sache pourquoi l'administrateur a fait cela. |
pascal@831 | 377 Les cooknotes sont affichées dans l'interface Web et peuvent être vérifiées |
pascal@831 | 378 depuis la ligne de commande : |
pascal@831 | 379 </p> |
pascal@831 | 380 <pre> |
pascal@831 | 381 # cooker note "Blocked pkgname due to heavy CPU load" |
pascal@831 | 382 # cooker notes |
pascal@831 | 383 </pre> |
pascal@831 | 384 |
pascal@831 | 385 <h3>Le Cooker comme robot de fabrication</h3> |
pascal@831 | 386 <p> |
pascal@831 | 387 Le Cooker est conçu pour être le robot de fabrication de SliTaz, c'est à |
pascal@831 | 388 dire qu'il contrôle 2 woks, met à jour le wok Hg, obtient les différences |
pascal@831 | 389 et cuit tous les paquets qui ont été commités. La façon la plus sûre |
pascal@831 | 390 et la plus propre de lancer le Cooker comme robot de fabrication avec cron |
pascal@831 | 391 est d'utiliser un environnement de chroot, mais il peut tourner directement |
pascal@831 | 392 sur l'hôte si vous le voulez. |
pascal@831 | 393 </p> |
pascal@831 | 394 <p> |
pascal@831 | 395 Pour lance de Cooker automatiquement vous devez utiliser crom depuis le chroot |
pascal@831 | 396 et ajouter un ligne dans le crontab de root dans /var/spool/cron/crontabs. |
pascal@831 | 397 Disons que vous souhaitez lancer le Cooker toutes les 2 heures : |
pascal@831 | 398 </p> |
pascal@831 | 399 <pre> |
pascal@831 | 400 * */2 * * * /usr/bin/cooker |
pascal@831 | 401 </pre> |
pascal@831 | 402 |
pascal@831 | 403 <h3>Lancer le Robot Cooker au boot</h3> |
pascal@831 | 404 <p> |
pascal@831 | 405 L'environnement du Cooker et la tâche cron peut être automatiquement |
pascal@831 | 406 lancée au démarrage. Vous devez avoir installé le paquet |
pascal@831 | 407 cookutils-daemon sur l'hôte et utiliser une installation standard |
pascal@831 | 408 SliTaz pour qu'il fonctionne correctement (la cooking se trouve |
pascal@831 | 409 dans /home/slitaz/cooking). Ce script va monter les systèmes de |
pascal@831 | 410 fichiers virtuels nécessaires pour les sources et les paquets. |
pascal@831 | 411 Les fichiers sources se trouvent dans /home/slitaz/src et sont |
pascal@831 | 412 reliés au chroot pour que vous puissiez les partager entre plusieurs |
pascal@831 | 413 version (stable, cooking, undigest). Si ce paquet n'est pas encore |
pascal@831 | 414 installé : |
pascal@831 | 415 </p> |
pascal@831 | 416 <pre> |
pascal@831 | 417 # tazpkg get-install cookutils-daemon |
pascal@831 | 418 </pre> |
pascal@831 | 419 <p> |
pascal@831 | 420 Pour lancer le daemon vous devez avoir une définition de ficher cron pour |
pascal@831 | 421 root dans le chroot, le script daemon fonctionne comme tous les autres |
pascal@831 | 422 daemons système et peut être controllé avec : |
pascal@831 | 423 </p> |
pascal@831 | 424 <pre> |
pascal@831 | 425 # /etc/init.d/cooker [start|stop|restart] |
pascal@831 | 426 </pre> |
pascal@831 | 427 |
pascal@831 | 428 <!-- End content --> |
pascal@831 | 429 </div> |
pascal@831 | 430 |
pascal@831 | 431 <footer> |
pascal@831 | 432 Copyright © <span class="year"></span> <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a> |
pascal@831 | 433 </footer> |
pascal@831 | 434 |
pascal@831 | 435 </body> |
pascal@831 | 436 </html> |