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>
|