website view en/doc/cookbook/build-host.html @ rev 562
cn:update and fix some bugs
author | Chen Yufei <tsjz@ymail.com> |
---|---|
date | Sat Nov 07 12:58:44 2009 +0800 (2009-11-07) |
parents | 489aa5f8f2f0 |
children | 0e0bc81a63ee |
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="build-bot.html">Build Bot</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="build-host.html#folders">Folders in: /home/slitaz</a></li>
39 <li><a href="build-host.html#tazdev">Using tazdev</a></li>
40 <li><a href="build-host.html#undigest-pkgs">Cooking undigest packages</a></li>
41 <li><a href="build-host.html#cooking-pkgs">Cooking official packages</a></li>
42 <li><a href="build-host.html#stable-pkgs">Stable packages</a></li>
43 <li><a href="build-host.html#mirror-up">Upload by hand on mirror.slitaz.org</a></li>
44 <li><a href="build-host.html#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, the tazdev command
60 is used. It is mostly configured for the cooking version. Usage:
61 </p>
62 <pre> $ tazdev usage
63 </pre>
65 <a name="undigest-pkgs"></a>
66 <h3>Cooking undigest packages</h3>
67 <p>
68 You can use the undigest wok in the chroot environment to cook some
69 non supported packages. If you maintain official packages and they cook
70 successfully on tank, then you can test on your local machine and commit
71 in the official wok. Mirror maintainers will then rebuild and upload the
72 packages on mirror.slitaz.org.
73 </p>
74 <p>
75 To build packages in the undigest wok and in the chroot environment:
76 commands are sometimes better than a long text:
77 </p>
78 <pre> $ ln -s /home/slitaz/cooking/chroot/home/undigest .
79 </pre>
80 <p>
81 You can copy files with gFTP-sftp-scp directly into the wok or from the
82 current directory:
83 </p>
84 <pre> $ cp -a package undigest/wok
85 $ su -c "tazdev chroot"
86 /# cd home/undigest
87 /# tazwok cook package
88 /# exit
89 $ ls undigest/packages
90 </pre>
92 <a name="cooking-pkgs"></a>
93 <h3>Cooking official packages</h3>
94 <p>
95 Maintainers have root access and some have write access to the
96 main mirror at mirror.slitaz.org, if you want to help in this task please
97 contact one of the active developers (check hg repos).
98 </p>
99 <p>
100 Everything is cooked in a chroot environment, the default path for the build
101 wok is $CHROOT/home/slitaz/wok. Some changes can be made directly in this wok: the
102 real Hg is copied into the chroot by tazbb (Build Bot). To chroot in cooking:
103 </p>
104 <pre> # tazdev chroot
105 </pre>
106 <p>
107 Cook all the last commited packages or cook everything with 'cook-all', note
108 that comparison it not required if you know which packages to cook. If you
109 want to force the cooking of some of the packages by tazbb, you can then
110 clean with tazwok. By default tazbb cooks only the last commit:
111 </p>
112 <pre> /# tazbb cook-commit
113 </pre>
114 <p>
115 If needed (tazbb does this automatically), you can remove all the old packages
116 and then rebuild the lists manually:
117 </p>
118 <pre> /# tazbb clean-up
119 /# tazwok gen-list --text
120 /# exit
121 </pre>
122 <p>
123 If you have write access to the mirror, you can make a dry-push to check
124 and then upload; push will also remove any old packages on the mirror.
125 </p>
127 <a name="stable-pkgs"></a>
128 <h3>Stable packages</h3>
129 <p>
130 Packages for the stable release are also built in a chroot environment like
131 the Cooking packages:
132 </p>
133 <pre> # tazdev chroot stable
134 </pre>
136 <a name="mirror-up"></a>
137 <h3>Upload by hand on mirror.slitaz.org</h3>
138 <p>
139 Mirror maintainers can upload by hand with tazdev (-dp for a dry push):
140 </p>
141 <pre> # tazdev -p $USER
142 </pre>
144 <a name="website-up"></a>
145 <h3>Update website by hand</h3>
146 <p>
147 The Website and packages web interface are updated nightly by cron and can
148 also be updated by hand (used on the day of release for example):
149 </p>
150 <pre> # tazdev update-www
151 </pre>
153 <!-- End of content -->
154 </div>
156 <!-- Footer. -->
157 <div id="footer">
158 <div class="footer-right"></div>
159 <a href="build-host.html#top">Top of the page</a> |
160 <a href="index.html">Table of contents</a>
161 </div>
163 <div id="copy">
164 Copyright © 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> -
165 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
166 Documentation is under
167 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
168 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
169 </div>
171 </body>
172 </html>