website view en/doc/cookbook/build-host.html @ rev 510
Update build-host cookbook page for tazdev
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Fri Jun 19 23:17:13 2009 +0200 (2009-06-19) |
| parents | c927e3ab1dd9 |
| children | dca66121459f |
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <title>SliTaz Cookbook (en) - Build Host</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz English cookbook" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2009-03-27 21:30:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="SliTaz contributors"/>
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" />
14 </head>
15 <body bgcolor="#ffffff">
17 <!-- Header and quick navigation -->
18 <div id="header">
19 <div align="right" id="quicknav">
20 <a name="top"></a>
21 <a href="boot-scripts.html">Boot Scripts</a> |
22 <a href="index.html">Table of contents</a>
23 </div>
24 <h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1>
25 </div>
27 <!-- Content. -->
28 <div id="content">
29 <div class="content-right"></div>
31 <h2><font color="#DF8F06">SliTaz Build Host (tank)</font></h2>
33 <p>
34 SliTaz build host info and howto.
35 </p>
37 <ul>
38 <li><a href="#folders">Folders in: /home/slitaz</a></li>
39 <li><a href="#tazdev">Using tazdev</a></li>
40 <li><a href="#undigest-pkgs">Cooking undigest packages</a></li>
41 <li><a href="#cooking-pkgs">Cooking official packages</a></li>
42 <li><a href="#stable-pkgs">Stable packages</a></li>
43 <li><a href="#mirror-up">Upload by hand on mirror.slitaz.org</a></li>
44 <li><a href="#website-up">Update website by hand</a></li>
45 </ul>
47 <a name="folders"></a>
48 <h3>Folders in: /home/slitaz</h3>
49 <ul>
50 <li>cooking/ - Cooking chroot and flavors.</li>
51 <li>stable/ - Stable tree.</li>
52 <li>repos/ - All the project repos (where the commits are pushed).</li>
53 <li>www/ - Virtual hosts (website, hg, boot, people, etc).</li>
54 </ul>
56 <a name="tazdev"></a>
57 <h3>Using tazdev</h3>
58 <p>
59 To help maintain the mirror, flavors and other services, some tazdev
60 is used. It is mostly all configured for the cooking version. Usage :
61 </p>
62 <pre>
63 $ tazdev usage
64 </pre>
66 <a name="undigest-pkgs"></a>
67 <h3>Cooking undigest packages</h3>
68 <p>
69 You can use the undigest wok in the chroot environment to cook some
70 non supported packages. If you maintain official packages and they cook
71 successfully on tank, then you can test on your local machine and commit
72 in the official wok. Mirror maintainers will then rebuild and upload the
73 packages on mirror.slitaz.org.
74 </p>
75 <p>
76 To build packages in the undigest wok and in the chroot environment:
77 commands are sometimes better than a long text:
78 </p>
79 <pre> $ ln -s /home/slitaz/cooking/chroot/home/undigest .
80 </pre>
81 <p>
82 You can copy files with gFTP-sftp-scp directly into the wok or from the
83 current directory:
84 </p>
85 <pre> $ cp -a package undigest/wok
86 $ su -c "tazdev chroot"
87 /# cd home/undigest
88 /# tazwok cook package
89 /# exit
90 $ ls undigest/packages
91 </pre>
93 <a name="cooking-pkgs"></a>
94 <h3>Cooking official packages</h3>
95 <p>
96 Maintainers have root access and some have write access to the
97 main mirror at mirror.slitaz.org, if you want to help in this task please
98 contact one of the active developers (check hg repos).
99 </p>
100 <p>
101 Everything is cooked in a chroot environment, the default path for the build
102 wok is $CHROOT/home/slitaz/wok. Some changes can be made directly in this wok: the
103 real Hg is copied in the chroot by tazbb (Build Bot). To chroot in cooking :
104 </p>
105 <pre>
106 # tazdev chroot
107 </pre>
108 <p>
109 Cook all last commited packages or cook everything with 'cook-all', note
110 that comparison it not required if you know which packages to cook. If you
111 want to force a cook of some package by tazbb you can clean then with tazwok.
112 By default cook only last commit :
113 </p>
114 <pre>
115 /# tazbb cook-commit
116 </pre>
117 <p>
118 Tip: Remove all the old packages and then rebuild the lists manually:
119 </p>
120 <pre>
121 /# tazwok cmp --remove
122 /# tazwok gen-list --text
123 /# exit
124 </pre>
125 <p>
126 If you have write access to the mirror you can make a dry-push to check
127 and then upload; push will also remove any old packages on the mirror.
128 </p>
130 <a name="stable-pkgs"></a>
131 <h3>Stable packages</h3>
132 <p>
133 Packages for the stable release are also built in a chroot environment like
134 the Cooking packages:
135 </p>
136 <pre>
137 # tazdev chroot stable
138 </pre>
140 <a name="mirror-up"></a>
141 <h3>Upload by hand on mirror.slitaz.org</h3>
142 <p>
143 Mirror maintainers can upload by hand with the script mirror.sh:
144 </p>
145 <pre>
146 # tazdev -p `echo $USER`
147 </pre>
149 <a name="website-up"></a>
150 <h3>Update website by hand</h3>
151 <p>
152 The Website and packages web interface are updated nightly by cron and can
153 also be updated by hand (used on the day of release for example):
154 </p>
155 <pre>
156 # tazdev update-website
157 </pre>
159 <!-- End of content -->
160 </div>
162 <!-- Footer. -->
163 <div id="footer">
164 <div class="footer-right"></div>
165 <a href="#top">Top of the page</a> |
166 <a href="index.html">Table of contents</a>
167 </div>
169 <div id="copy">
170 Copyright © 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> -
171 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
172 Documentation is under
173 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
174 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
175 </div>
177 </body>
178 </html>