website 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 | 06ff692df9a8 |
| children | 8f41f1e024ea |
| files | en/doc/cookbook/build-host.html en/doc/cookbook/index.html en/doc/cookbook/receipts.html |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/en/doc/cookbook/build-host.html Sat Mar 28 01:15:01 2009 +0100 1.3 @@ -0,0 +1,192 @@ 1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 1.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 1.7 +<head> 1.8 + <title>SliTaz Cookbook (en) - Build Host</title> 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="slitaz English cookbook" /> 1.11 + <meta name="expires" content="never" /> 1.12 + <meta name="modified" content="2009-03-27 21:30:00" /> 1.13 + <meta name="publisher" content="www.slitaz.org" /> 1.14 + <meta name="author" content="SliTaz contributors"/> 1.15 + <link rel="shortcut icon" href="favicon.ico" /> 1.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 1.17 +</head> 1.18 +<body bgcolor="#ffffff"> 1.19 + 1.20 +<!-- Header and quick navigation --> 1.21 +<div id="header"> 1.22 +<div align="right" id="quicknav"> 1.23 + <a name="top"></a> 1.24 + <a href="boot-scripts.html">Boot Scripts</a> | 1.25 + <a href="index.html">Table of contents</a> 1.26 +</div> 1.27 +<h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1> 1.28 +</div> 1.29 + 1.30 +<!-- Content. --> 1.31 +<div id="content"> 1.32 +<div class="content-right"></div> 1.33 + 1.34 +<h2><font color="#DF8F06">SliTaz Build Host (tank)</font></h2> 1.35 + 1.36 +<p> 1.37 +SliTaz build host info and howto. 1.38 +</p> 1.39 + 1.40 +<ul> 1.41 + <li><a href="#folders">Folders in: /home/slitaz</a></li> 1.42 + <li><a href="#scripts">Using scripts: /home/slitaz/scripts</a></li> 1.43 + <li><a href="#undigest-pkgs">Cooking undigest packages</a></li> 1.44 + <li><a href="#cooking-pkgs">Cooking official packages</a></li> 1.45 + <li><a href="#stable-pkgs">Stable packages</a></li> 1.46 + <li><a href="#mirror-up">Upload by hand on mirror.slitaz.org</a></li> 1.47 + <li><a href="#website-up">Update website by hand</a></li> 1.48 +</ul> 1.49 + 1.50 +<a name="folders"></a> 1.51 +<h3>Folders in: /home/slitaz</h3> 1.52 +<ul> 1.53 + <li>cooking/ - Cooking chroot and flavors.</li> 1.54 + <li>stable/ - Stable tree.</li> 1.55 + <li>scripts/ - Small scripts to help maintaining host, project.</li> 1.56 + <li>repos/ - All the project repos (where the commits are pushed).</li> 1.57 + <li>www/ - Virtual hosts (website, hg, boot, people, etc).</li> 1.58 +</ul> 1.59 + 1.60 +<a name="scripts"></a> 1.61 +<h3>Using scripts: /home/slitaz/scripts</h3> 1.62 +<p> 1.63 +To help maintaining the mirror, flavors and other services some scripts 1.64 +are used, there are mostly all configured for the cooking version. To 1.65 +add them to your default path: 1.66 +</p> 1.67 +<pre> 1.68 + $ echo 'export PATH=/home/slitaz/scripts:$PATH' >> ~/.profile 1.69 +</pre> 1.70 +<p> 1.71 +Each script should have a small help and description, if none, just open 1.72 +it: 1.73 +</p> 1.74 +<pre> 1.75 + $ cd /home/slitaz/script && ls 1.76 + $ ./script.sh help 1.77 +</pre> 1.78 + 1.79 +<a name="undigest-pkgs"></a> 1.80 +<h3>Cooking undigest packages</h3> 1.81 +<p> 1.82 +You can use the undigest wok in the chroot environement to cook some 1.83 +non supported packages. If you maintain official packages and they cook 1.84 +succefully on tank you can test it on your local machine and then commit 1.85 +in the official wok. Mirror maintainers will then rebuild and upload the 1.86 +packages on mirror.slitaz.org. 1.87 +</p> 1.88 +<p> 1.89 +To build packages in the undigest wok and in the chroot environement, 1.90 +some commands are better than a long text: 1.91 +</p> 1.92 +<pre> 1.93 + $ ln -s /home/slitaz/cooking/chroot/home/undigest . 1.94 +</pre> 1.95 +<p> 1.96 +You can copy file with gFTP-sftp-scp directly in the wok or from the 1.97 +current directory: 1.98 +</p> 1.99 +<pre> 1.100 + $ cp -a package undigest/wok 1.101 + $ su -c chroot.sh 1.102 + /# cd home/undigest 1.103 + /# tazwok cook package 1.104 + /# exit 1.105 + $ ls undigest/packages 1.106 +</pre> 1.107 + 1.108 +<a name="cooking-pkgs"></a> 1.109 +<h3>Cooking official packages</h3> 1.110 +<p> 1.111 +Mirror maintainers have root access and some have write access to the 1.112 +main mirror at mirror.slitaz.org, if you want to help in this task please 1.113 +contact one of the most active developpers (check hg repos). 1.114 +</p> 1.115 +<p> 1.116 +Everything is cook in a chroot environement, default path for the main 1.117 +wok is /home/slitaz, some changes can be done directly in this wok, the 1.118 +real Hg is out of the chroot and copied in the chroot with wok.sh: 1.119 +</p> 1.120 +<pre> 1.121 + # wok.sh hgup 1.122 + # chroot.sh 1.123 +</pre> 1.124 +<p> 1.125 +Cook all missing packages, one by one or with 'tazwok cmp --cook', note 1.126 +that comparaison it not requiert, if you know witch packages you must 1.127 +cook: 1.128 +</p> 1.129 +<pre> 1.130 + /# tazwok cmp 1.131 + /# tazwok cook package-name 1.132 +</pre> 1.133 +<p> 1.134 +Remove all old packages and then rebuild the lists: 1.135 +</p> 1.136 +<pre> 1.137 + /# tazwok cmp --remove 1.138 + /# tazwok gen-list --text 1.139 + /# exit 1.140 +</pre> 1.141 +<p> 1.142 +If you have write access to the mirror you can make a dry-push to check 1.143 +and then upload, push will also remove old packages on the mirror. 1.144 +</p> 1.145 + 1.146 +<a name="stable-pkgs"></a> 1.147 +<h3>Stable packages</h3> 1.148 +<p> 1.149 +Packages for the stable release are build in a chroot environement like 1.150 +the Cooking packages. 1.151 +</p> 1.152 +<pre> 1.153 + # chroot.sh stable 1.154 +</pre> 1.155 + 1.156 +<a name="mirror-up"></a> 1.157 +<h3>Upload by hand on mirror.slitaz.org</h3> 1.158 +<p> 1.159 +Mirror maintainers can upload by hand with the script mirror.sh: 1.160 +</p> 1.161 +<pre> 1.162 + # mirror.sh help 1.163 +</pre> 1.164 + 1.165 +<a name="website-up"></a> 1.166 +<h3>Update website by hand</h3> 1.167 +<p> 1.168 +Wesite and packages web interface are updated nightly by cron and can 1.169 +also be update by hand (used the day of release for example): 1.170 +</p> 1.171 +<pre> 1.172 + # website.sh up 1.173 + # website.sh help 1.174 +</pre> 1.175 + 1.176 +<!-- End of content --> 1.177 +</div> 1.178 + 1.179 +<!-- Footer. --> 1.180 +<div id="footer"> 1.181 + <div class="footer-right"></div> 1.182 + <a href="#top">Top of the page</a> | 1.183 + <a href="index.html">Table of contents</a> 1.184 +</div> 1.185 + 1.186 +<div id="copy"> 1.187 + Copyright © 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> - 1.188 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 1.189 + Documentation is under 1.190 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 1.191 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 1.192 +</div> 1.193 + 1.194 +</body> 1.195 +</html>
2.1 --- a/en/doc/cookbook/index.html Fri Mar 27 22:03:09 2009 +0100 2.2 +++ b/en/doc/cookbook/index.html Sat Mar 28 01:15:01 2009 +0100 2.3 @@ -34,14 +34,14 @@ 2.4 <ul> 2.5 <li><a href="wok-tools.html">Wok & Tools</a> - SliTaz Package Tools.</li> 2.6 <li><a href="receipts.html">Receipts</a> - Receipts for creating SliTaz packages.</li> 2.7 - <li><a href="rootcd.html">Root cdrom (rootcd)</a> - Descriptions of files contained on the cdrom.</li> 2.8 + <li><a href="build-host.html">Build Host</a> - SliTaz Buils host (tank).</li> 2.9 <li><a href="boot-scripts.html">Boot Scripts</a> - The startup and shutdown scripts.</li> 2.10 <li><a href="slitaz-tools.html">SliTaz Tools</a> - The Toolbox.</li> 2.11 <li><a href="reltasks.html">Release Tasks</a> - List of things to do before publishing a new version (Cooking or stable).</li> 2.12 + <li><a href="rootcd.html">Root cdrom (rootcd)</a> - Descriptions of files contained on the cdrom.</li> 2.13 </ul> 2.14 2.15 <h3>About this Cookbook</h3> 2.16 - 2.17 <p> 2.18 The Cookbook brings together information about the project management, operation and 2.19 development of the distribution. It talks about creating packages, receipts, the wok,
3.1 --- a/en/doc/cookbook/receipts.html Fri Mar 27 22:03:09 2009 +0100 3.2 +++ b/en/doc/cookbook/receipts.html Sat Mar 28 01:15:01 2009 +0100 3.3 @@ -18,7 +18,7 @@ 3.4 <div id="header"> 3.5 <div align="right" id="quicknav"> 3.6 <a name="top"></a> 3.7 - <a href="wok-tools.html">Wok & Tools.</a> | 3.8 + <a href="build-host.html">Build Host</a> | 3.9 <a href="index.html">Table of contents</a> 3.10 </div> 3.11 <h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1>