website view en/doc/cookbook/build-host.html @ rev 513
Tiny update to build host Cookbook page
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sat Jun 20 12:49:15 2009 +0200 (2009-06-20) |
| parents | 7a4bd9bced35 |
| children | 53c742148045 |
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 If needed (tazbb does it automaticaly) you can remove all the old packages
119 and then rebuild the lists manually:
120 </p>
121 <pre>
122 /# tazbb clean-up
123 /# tazwok gen-list --text
124 /# exit
125 </pre>
126 <p>
127 If you have write access to the mirror you can make a dry-push to check
128 and then upload; push will also remove any old packages on the mirror.
129 </p>
131 <a name="stable-pkgs"></a>
132 <h3>Stable packages</h3>
133 <p>
134 Packages for the stable release are also built in a chroot environment like
135 the Cooking packages:
136 </p>
137 <pre>
138 # tazdev chroot stable
139 </pre>
141 <a name="mirror-up"></a>
142 <h3>Upload by hand on mirror.slitaz.org</h3>
143 <p>
144 Mirror maintainers can upload by hand with tazdev (-pd for a dry push):
145 </p>
146 <pre>
147 # tazdev -p $USER
148 </pre>
150 <a name="website-up"></a>
151 <h3>Update website by hand</h3>
152 <p>
153 The Website and packages web interface are updated nightly by cron and can
154 also be updated by hand (used on the day of release for example):
155 </p>
156 <pre>
157 # tazdev update-www
158 </pre>
160 <!-- End of content -->
161 </div>
163 <!-- Footer. -->
164 <div id="footer">
165 <div class="footer-right"></div>
166 <a href="#top">Top of the page</a> |
167 <a href="index.html">Table of contents</a>
168 </div>
170 <div id="copy">
171 Copyright © 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> -
172 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
173 Documentation is under
174 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
175 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
176 </div>
178 </body>
179 </html>