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