website view en/doc/cookbook/build-host.html @ rev 342
en/cookbook: Add Build host info and howto
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sat Mar 28 01:15:01 2009 +0100 (2009-03-28) |
| parents | |
| children | 864829b32e9a |
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="#scripts">Using scripts: /home/slitaz/scripts</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>scripts/ - Small scripts to help maintaining host, project.</li>
53 <li>repos/ - All the project repos (where the commits are pushed).</li>
54 <li>www/ - Virtual hosts (website, hg, boot, people, etc).</li>
55 </ul>
57 <a name="scripts"></a>
58 <h3>Using scripts: /home/slitaz/scripts</h3>
59 <p>
60 To help maintaining the mirror, flavors and other services some scripts
61 are used, there are mostly all configured for the cooking version. To
62 add them to your default path:
63 </p>
64 <pre>
65 $ echo 'export PATH=/home/slitaz/scripts:$PATH' >> ~/.profile
66 </pre>
67 <p>
68 Each script should have a small help and description, if none, just open
69 it:
70 </p>
71 <pre>
72 $ cd /home/slitaz/script && ls
73 $ ./script.sh help
74 </pre>
76 <a name="undigest-pkgs"></a>
77 <h3>Cooking undigest packages</h3>
78 <p>
79 You can use the undigest wok in the chroot environement to cook some
80 non supported packages. If you maintain official packages and they cook
81 succefully on tank you can test it on your local machine and then commit
82 in the official wok. Mirror maintainers will then rebuild and upload the
83 packages on mirror.slitaz.org.
84 </p>
85 <p>
86 To build packages in the undigest wok and in the chroot environement,
87 some commands are better than a long text:
88 </p>
89 <pre>
90 $ ln -s /home/slitaz/cooking/chroot/home/undigest .
91 </pre>
92 <p>
93 You can copy file with gFTP-sftp-scp directly in the wok or from the
94 current directory:
95 </p>
96 <pre>
97 $ cp -a package undigest/wok
98 $ su -c chroot.sh
99 /# cd home/undigest
100 /# tazwok cook package
101 /# exit
102 $ ls undigest/packages
103 </pre>
105 <a name="cooking-pkgs"></a>
106 <h3>Cooking official packages</h3>
107 <p>
108 Mirror maintainers have root access and some have write access to the
109 main mirror at mirror.slitaz.org, if you want to help in this task please
110 contact one of the most active developpers (check hg repos).
111 </p>
112 <p>
113 Everything is cook in a chroot environement, default path for the main
114 wok is /home/slitaz, some changes can be done directly in this wok, the
115 real Hg is out of the chroot and copied in the chroot with wok.sh:
116 </p>
117 <pre>
118 # wok.sh hgup
119 # chroot.sh
120 </pre>
121 <p>
122 Cook all missing packages, one by one or with 'tazwok cmp --cook', note
123 that comparaison it not requiert, if you know witch packages you must
124 cook:
125 </p>
126 <pre>
127 /# tazwok cmp
128 /# tazwok cook package-name
129 </pre>
130 <p>
131 Remove all old packages and then rebuild the lists:
132 </p>
133 <pre>
134 /# tazwok cmp --remove
135 /# tazwok gen-list --text
136 /# exit
137 </pre>
138 <p>
139 If you have write access to the mirror you can make a dry-push to check
140 and then upload, push will also remove old packages on the mirror.
141 </p>
143 <a name="stable-pkgs"></a>
144 <h3>Stable packages</h3>
145 <p>
146 Packages for the stable release are build in a chroot environement like
147 the Cooking packages.
148 </p>
149 <pre>
150 # chroot.sh stable
151 </pre>
153 <a name="mirror-up"></a>
154 <h3>Upload by hand on mirror.slitaz.org</h3>
155 <p>
156 Mirror maintainers can upload by hand with the script mirror.sh:
157 </p>
158 <pre>
159 # mirror.sh help
160 </pre>
162 <a name="website-up"></a>
163 <h3>Update website by hand</h3>
164 <p>
165 Wesite and packages web interface are updated nightly by cron and can
166 also be update by hand (used the day of release for example):
167 </p>
168 <pre>
169 # website.sh up
170 # website.sh help
171 </pre>
173 <!-- End of content -->
174 </div>
176 <!-- Footer. -->
177 <div id="footer">
178 <div class="footer-right"></div>
179 <a href="#top">Top of the page</a> |
180 <a href="index.html">Table of contents</a>
181 </div>
183 <div id="copy">
184 Copyright © 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> -
185 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
186 Documentation is under
187 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
188 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
189 </div>
191 </body>
192 </html>