website annotate 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
rev   line source
pankso@342 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@342 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@342 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
pankso@342 4 <head>
pankso@342 5 <title>SliTaz Cookbook (en) - Build Host</title>
pankso@342 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@342 7 <meta name="description" content="slitaz English cookbook" />
pankso@342 8 <meta name="expires" content="never" />
pankso@342 9 <meta name="modified" content="2009-03-27 21:30:00" />
pankso@342 10 <meta name="publisher" content="www.slitaz.org" />
pankso@342 11 <meta name="author" content="SliTaz contributors"/>
pankso@342 12 <link rel="shortcut icon" href="favicon.ico" />
pankso@342 13 <link rel="stylesheet" type="text/css" href="book.css" />
pankso@342 14 </head>
pankso@342 15 <body bgcolor="#ffffff">
pankso@342 16
pankso@342 17 <!-- Header and quick navigation -->
pankso@342 18 <div id="header">
pankso@342 19 <div align="right" id="quicknav">
pankso@342 20 <a name="top"></a>
pankso@342 21 <a href="boot-scripts.html">Boot Scripts</a> |
pankso@342 22 <a href="index.html">Table of contents</a>
pankso@342 23 </div>
pankso@342 24 <h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1>
pankso@342 25 </div>
pankso@342 26
pankso@342 27 <!-- Content. -->
pankso@342 28 <div id="content">
pankso@342 29 <div class="content-right"></div>
pankso@342 30
pankso@342 31 <h2><font color="#DF8F06">SliTaz Build Host (tank)</font></h2>
pankso@342 32
pankso@342 33 <p>
pankso@342 34 SliTaz build host info and howto.
pankso@342 35 </p>
pankso@342 36
pankso@342 37 <ul>
pankso@342 38 <li><a href="#folders">Folders in: /home/slitaz</a></li>
pankso@342 39 <li><a href="#scripts">Using scripts: /home/slitaz/scripts</a></li>
pankso@342 40 <li><a href="#undigest-pkgs">Cooking undigest packages</a></li>
pankso@342 41 <li><a href="#cooking-pkgs">Cooking official packages</a></li>
pankso@342 42 <li><a href="#stable-pkgs">Stable packages</a></li>
pankso@342 43 <li><a href="#mirror-up">Upload by hand on mirror.slitaz.org</a></li>
pankso@342 44 <li><a href="#website-up">Update website by hand</a></li>
pankso@342 45 </ul>
pankso@342 46
pankso@342 47 <a name="folders"></a>
pankso@342 48 <h3>Folders in: /home/slitaz</h3>
pankso@342 49 <ul>
pankso@342 50 <li>cooking/ - Cooking chroot and flavors.</li>
pankso@342 51 <li>stable/ - Stable tree.</li>
pankso@342 52 <li>scripts/ - Small scripts to help maintaining host, project.</li>
pankso@342 53 <li>repos/ - All the project repos (where the commits are pushed).</li>
pankso@342 54 <li>www/ - Virtual hosts (website, hg, boot, people, etc).</li>
pankso@342 55 </ul>
pankso@342 56
pankso@342 57 <a name="scripts"></a>
pankso@342 58 <h3>Using scripts: /home/slitaz/scripts</h3>
pankso@342 59 <p>
pankso@342 60 To help maintaining the mirror, flavors and other services some scripts
pankso@342 61 are used, there are mostly all configured for the cooking version. To
pankso@342 62 add them to your default path:
pankso@342 63 </p>
pankso@342 64 <pre>
pankso@342 65 $ echo 'export PATH=/home/slitaz/scripts:$PATH' >> ~/.profile
pankso@342 66 </pre>
pankso@342 67 <p>
pankso@342 68 Each script should have a small help and description, if none, just open
pankso@342 69 it:
pankso@342 70 </p>
pankso@342 71 <pre>
pankso@342 72 $ cd /home/slitaz/script &amp;&amp; ls
pankso@342 73 $ ./script.sh help
pankso@342 74 </pre>
pankso@342 75
pankso@342 76 <a name="undigest-pkgs"></a>
pankso@342 77 <h3>Cooking undigest packages</h3>
pankso@342 78 <p>
pankso@342 79 You can use the undigest wok in the chroot environement to cook some
pankso@342 80 non supported packages. If you maintain official packages and they cook
pankso@342 81 succefully on tank you can test it on your local machine and then commit
pankso@342 82 in the official wok. Mirror maintainers will then rebuild and upload the
pankso@342 83 packages on mirror.slitaz.org.
pankso@342 84 </p>
pankso@342 85 <p>
pankso@342 86 To build packages in the undigest wok and in the chroot environement,
pankso@342 87 some commands are better than a long text:
pankso@342 88 </p>
pankso@342 89 <pre>
pankso@342 90 $ ln -s /home/slitaz/cooking/chroot/home/undigest .
pankso@342 91 </pre>
pankso@342 92 <p>
pankso@342 93 You can copy file with gFTP-sftp-scp directly in the wok or from the
pankso@342 94 current directory:
pankso@342 95 </p>
pankso@342 96 <pre>
pankso@342 97 $ cp -a package undigest/wok
pankso@342 98 $ su -c chroot.sh
pankso@342 99 /# cd home/undigest
pankso@342 100 /# tazwok cook package
pankso@342 101 /# exit
pankso@342 102 $ ls undigest/packages
pankso@342 103 </pre>
pankso@342 104
pankso@342 105 <a name="cooking-pkgs"></a>
pankso@342 106 <h3>Cooking official packages</h3>
pankso@342 107 <p>
pankso@342 108 Mirror maintainers have root access and some have write access to the
pankso@342 109 main mirror at mirror.slitaz.org, if you want to help in this task please
pankso@342 110 contact one of the most active developpers (check hg repos).
pankso@342 111 </p>
pankso@342 112 <p>
pankso@342 113 Everything is cook in a chroot environement, default path for the main
pankso@342 114 wok is /home/slitaz, some changes can be done directly in this wok, the
pankso@342 115 real Hg is out of the chroot and copied in the chroot with wok.sh:
pankso@342 116 </p>
pankso@342 117 <pre>
pankso@342 118 # wok.sh hgup
pankso@342 119 # chroot.sh
pankso@342 120 </pre>
pankso@342 121 <p>
pankso@342 122 Cook all missing packages, one by one or with 'tazwok cmp --cook', note
pankso@342 123 that comparaison it not requiert, if you know witch packages you must
pankso@342 124 cook:
pankso@342 125 </p>
pankso@342 126 <pre>
pankso@342 127 /# tazwok cmp
pankso@342 128 /# tazwok cook package-name
pankso@342 129 </pre>
pankso@342 130 <p>
pankso@342 131 Remove all old packages and then rebuild the lists:
pankso@342 132 </p>
pankso@342 133 <pre>
pankso@342 134 /# tazwok cmp --remove
pankso@342 135 /# tazwok gen-list --text
pankso@342 136 /# exit
pankso@342 137 </pre>
pankso@342 138 <p>
pankso@342 139 If you have write access to the mirror you can make a dry-push to check
pankso@342 140 and then upload, push will also remove old packages on the mirror.
pankso@342 141 </p>
pankso@342 142
pankso@342 143 <a name="stable-pkgs"></a>
pankso@342 144 <h3>Stable packages</h3>
pankso@342 145 <p>
pankso@342 146 Packages for the stable release are build in a chroot environement like
pankso@342 147 the Cooking packages.
pankso@342 148 </p>
pankso@342 149 <pre>
pankso@342 150 # chroot.sh stable
pankso@342 151 </pre>
pankso@342 152
pankso@342 153 <a name="mirror-up"></a>
pankso@342 154 <h3>Upload by hand on mirror.slitaz.org</h3>
pankso@342 155 <p>
pankso@342 156 Mirror maintainers can upload by hand with the script mirror.sh:
pankso@342 157 </p>
pankso@342 158 <pre>
pankso@342 159 # mirror.sh help
pankso@342 160 </pre>
pankso@342 161
pankso@342 162 <a name="website-up"></a>
pankso@342 163 <h3>Update website by hand</h3>
pankso@342 164 <p>
pankso@342 165 Wesite and packages web interface are updated nightly by cron and can
pankso@342 166 also be update by hand (used the day of release for example):
pankso@342 167 </p>
pankso@342 168 <pre>
pankso@342 169 # website.sh up
pankso@342 170 # website.sh help
pankso@342 171 </pre>
pankso@342 172
pankso@342 173 <!-- End of content -->
pankso@342 174 </div>
pankso@342 175
pankso@342 176 <!-- Footer. -->
pankso@342 177 <div id="footer">
pankso@342 178 <div class="footer-right"></div>
pankso@342 179 <a href="#top">Top of the page</a> |
pankso@342 180 <a href="index.html">Table of contents</a>
pankso@342 181 </div>
pankso@342 182
pankso@342 183 <div id="copy">
pankso@342 184 Copyright &copy; 2009 <a href="http://www.slitaz.org/en/">SliTaz</a> -
pankso@342 185 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
pankso@342 186 Documentation is under
pankso@342 187 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
pankso@342 188 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
pankso@342 189 </div>
pankso@342 190
pankso@342 191 </body>
pankso@342 192 </html>