Date: Fri, 25 Mar 2016 19:26:31 +0000 (UTC) From: Bjoern Heidotting <bhd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r48469 - head/de_DE.ISO8859-1/books/handbook/ports Message-ID: <201603251926.u2PJQVZ3065584@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: bhd Date: Fri Mar 25 19:26:31 2016 New Revision: 48469 URL: https://svnweb.freebsd.org/changeset/doc/48469 Log: Update to r44016: Introduction to using Poudriere Reviewed by: bcr Differential Revision: https://reviews.freebsd.org/D5740 Modified: head/de_DE.ISO8859-1/books/handbook/ports/chapter.xml Modified: head/de_DE.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/ports/chapter.xml Fri Mar 25 03:09:49 2016 (r48468) +++ head/de_DE.ISO8859-1/books/handbook/ports/chapter.xml Fri Mar 25 19:26:31 2016 (r48469) @@ -5,7 +5,7 @@ $FreeBSD$ $FreeBSDde: de-docproj/books/handbook/ports/chapter.xml,v 1.111 2011/12/19 17:13:33 bcr Exp $ - basiert auf: r43886 + basiert auf: r44016 --> <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="ports"> <info><title>Installieren von Anwendungen: Pakete und Ports</title> @@ -1596,6 +1596,212 @@ Thee deinstallation will free 229 kB </sect2> </sect1> + <sect1 xml:id="ports-poudriere"> + <title>Pakete mit <application>Poudriere</application> + bauen</title> + + <para><application>Poudriere</application> ist ein unter der + <acronym>BSD</acronym>-Lizenz stehendes Werkzeug zum Erstellen + und Testen von &os;-Paketen. Dieses Programm nutzt &os; Jails, + um die Pakete in einer isolierten Umgebung zu bauen. Diese + Jails können verwendet werden, um Pakete für andere Versionen + von &os; zu bauen, oder um auf einem &arch.amd64;-System Pakete + für i386 zu bauen. Sobald die Pakete gebaut sind, haben sie das + gleiche Format wie auf den offiziellen Spiegeln. Die Pakete + können dann mit &man.pkg.8; oder anderen + Paketverwaltungswerkzeugen benutzt werden.</para> + + <para><application>Poudriere</application> wird über das Paket + oder den Port <package>ports-mgmt/poudriere</package> + installiert. Die Installation beinhaltet eine + Beispielkonfiguration in + <filename>/usr/local/etc/poudriere.conf.sample</filename>. + Kopieren Sie diese Datei nach + <filename>/usr/local/etc/poudriere.conf</filename>. Bearbeiten + Sie dann die kopierte Datei, um die Konfiguration + anzupassen.</para> + + <para>Obwohl <acronym>ZFS</acronym> für + <application>poudriere</application> nicht zwingend erforderlich + ist, so hat die Nutzung doch einige Vorteile. Wird + <acronym>ZFS</acronym> eingesetzt, muss in + <filename>/usr/local/etc/poudriere.conf</filename> die Variable + <varname>ZPOOL</varname> definiert, und die Variable + <varname>FREEBSD_HOST</varname> auf einen nahe gelegenen + Spiegel gesetzt werden. Die Definition von + <varname>CCACHE_DIR</varname> erlaubt die Verwendung von + <package>devel/ccache</package>, um die Bauzeit für häufig + kompilierten Code verkürzen. Es kann vorteilhaft sein, die + <application>poudriere</application>-Datasets in einem separaten + Verzeichnis auf <filename>/poudriere</filename> einzuhängen. + Die Werte der anderen Konfigurationsvariablen sind in der Regel + angemessen und brauchen nicht geändert werden.</para> + + <para>Die Anzahl der Kerne im Prozessor wird verwendet um zu + bestimmen, wie viele Bauprozesse parallel ausgeführt werden + sollen. Stellen Sie ausreichend virtuellen Speicher bereit, + entweder in Form von <acronym>RAM</acronym> oder als + Swap-Speicher. Ist der virtuelle Speicher aufgebraucht, bricht + der Bauprozess ab und die Jails stürzen ab, was zu seltsamen + Fehlermeldungen führt.</para> + + <sect2 xml:id="poudriere-initialization"> + <title>Jails und Ports-Sammlung initialisieren</title> + + <para>Nach der Konfiguration muss + <application>poudriere</application> initialisiert werden, + damit es eine Jail mit der benötigten Ports-Sammlung startet. + Geben Sie mit <option>-j</option> den Namen der Jail und mit + <option>-v</option> die gewünschte &os;-Version an. Auf + &os;/&arch.amd64;-Systemen kann die Architektur mit dem + Schalter <option>-a</option> und <literal>i386</literal> oder + <literal>amd64</literal> gesetzt werden. Der voreingestellte + Wert für die Architektur können Sie sich mit + <command>uname</command> anzeigen lassen.</para> + + <screen>&prompt.root; <userinput>poudriere jail -c -j <replaceable>10amd64</replaceable> -v <replaceable>10.0-RELEASE</replaceable></userinput> +====>> Creating 10amd64 fs... done +====>> Fetching base.txz for FreeBSD 10.0-RELEASE amd64 +/poudriere/jails/10amd64/fromftp/base.txz 100% of 59 MB 1470 kBps 00m42s +====>> Extracting base.txz... done +====>> Fetching src.txz for FreeBSD 10.0-RELEASE amd64 +/poudriere/jails/10amd64/fromftp/src.txz 100% of 107 MB 1476 kBps 01m14s +====>> Extracting src.txz... done +====>> Fetching games.txz for FreeBSD 10.0-RELEASE amd64 +/poudriere/jails/10amd64/fromftp/games.txz 100% of 865 kB 734 kBps 00m01s +====>> Extracting games.txz... done +====>> Fetching lib32.txz for FreeBSD 10.0-RELEASE amd64 +/poudriere/jails/10amd64/fromftp/lib32.txz 100% of 14 MB 1316 kBps 00m12s +====>> Extracting lib32.txz... done +====>> Cleaning up... done +====>> Jail 10amd64 10.0-RELEASE amd64 is ready to be used</screen> + + <screen>&prompt.root; <userinput>poudriere ports -c -p <replaceable>local</replaceable></userinput> +====>> Creating local fs... done +====>> Extracting portstree "local"... +Looking up portsnap.FreeBSD.org mirrors... 7 mirrors found. +Fetching public key from ec2-eu-west-1.portsnap.freebsd.org... done. +Fetching snapshot tag from ec2-eu-west-1.portsnap.freebsd.org... done. +Fetching snapshot metadata... done. +Fetching snapshot generated at Tue Feb 11 01:07:15 CET 2014: +94a3431f0ce567f6452ffde4fd3d7d3c6e1da143efec76100% of 69 MB 1246 kBps 00m57s +Extracting snapshot... done. +Verifying snapshot integrity... done. +Fetching snapshot tag from ec2-eu-west-1.portsnap.freebsd.org... done. +Fetching snapshot metadata... done. +Updating from Tue Feb 11 01:07:15 CET 2014 to Tue Feb 11 16:05:20 CET 2014. +Fetching 4 metadata patches... done. +Applying metadata patches... done. +Fetching 0 metadata files... done. +Fetching 48 patches. +(48/48) 100.00% done. +done. +Applying patches... +done. +Fetching 1 new ports or files... done. +/poudriere/ports/tester/CHANGES +/poudriere/ports/tester/COPYRIGHT + +[...] + +Building new INDEX files... done.</screen> + + <para><application>poudriere</application> kann auf einem + einzelnen Rechner Ports mit mehreren Konfigurationen + bauen, in mehreren Jails und aus unterschiedlichen + Ports-Sammlungen. Spezifische Konfigurationen für diese + Kombinationen werden <emphasis>Sets</emphasis> + genannt. Lesen Sie den Abschnitt CUSTOMIZATION in + &man.poudriere.8; für weitere Einzelheiten nach der + Installation von <package>port-mgmt/poudriere</package> oder + <package>ports-mgmt/poudriere-devel</package>.</para> + + <para>Die hier gezeigte Konfiguration verwendet eine einzelne + Jail-, Port- und Set-spezifische + <filename>make.conf</filename> in + <filename>/usr/local/etc/poudriere.d</filename>. Der + verwendete Dateiname in diesem Beispiel wird aus einer + Kombination von Jailnamen, Portnamen und Setnamen zusammen + gesetzt: + <filename><replaceable>10amd64-local-workstation</replaceable>-make.conf</filename>. + Die <filename>make.conf</filename> des Systems und diese neue + Datei werden verwendet, um die <filename>make.conf</filename> + für die Jail zu erzeugen.</para> + + <para>Die zu bauenden Pakete werden in + <filename><replaceable>10amd64-local-workstation</replaceable>-pkglist</filename> + eingetragen:</para> + + <programlisting>editors/emacs +devel/git +ports-mgmt/pkg +...</programlisting> + + <para>Die Optionen und Abhängigkeiten für die Ports werden wie + folgt konfiguriert:</para> + + <screen>&prompt.root; <userinput>poudriere options -j <replaceable>10amd64</replaceable> -p <replaceable>local</replaceable> -z <replaceable>workstation</replaceable> -f <replaceable>10amd64-local-workstation-pkglist</replaceable></userinput></screen> + + <para>Schließlich werden die Pakete gebaut und ein + Paket-Repository erstellt:</para> + + <screen>&prompt.root; <userinput>poudriere bulk -j <replaceable>10amd64</replaceable> -p <replaceable>local</replaceable> -z <replaceable>workstation</replaceable> -f <replaceable>10amd64-local-workstation-pkglist</replaceable></userinput></screen> + + <para><keycombo + action="simul"><keycap>Ctrl</keycap><keycap>t</keycap></keycombo> + zeigt den aktuellen Status des Baus an. + <application>Poudriere</application> speichert zudem Dateien + in <filename>/poudriere/logs/bulk/jailname</filename>. Diese + Dateien kann ein Webserver nutzen, um Informationen über den + Bau anzuzeigen.</para> + + <para>Die Pakete stehen jetzt im + <application>poudriere</application> Repository für die + Installation zur Verfügung.</para> + + <para>Weitere Informationen zu + <application>poudriere</application> finden Sie in + &man.poudriere.8; und unter <link + xlink:href="https://github.com/freebsd/poudriere/wiki"></link>.</para>; + </sect2> + + <sect2> + <title>Konfiguration des pkg-Clients für das Poudriere + Repository</title> + + <para>Obwohl es möglich ist ein eigenes Repository zusammen mit + dem offiziellen Repository zu nutzen, ist es manchmal + sinnvoll das offizielle Repository zu deaktivieren. Dazu + wird eine Konfigurationsdatei erstellt, welche die offizielle + Konfigurationsdatei überschreibt. Erzeugen Sie dazu + <filename>/usr/local/etc/pkg/repos/FreeBSD.conf</filename> + mit dem folgenden Inhalt:</para> + + <programlisting>FreeBSD: { + enabled: no +}</programlisting> + + <para>Am einfachsten ist es, das poudriere Repository über + <acronym>HTTP</acronym> zur Verfügung zu stellen. Setzen Sie + einen Webserver auf, der die Dateien des Paketverzeichnisses + ausliefert, zum Beispiel + <filename>/usr/local/poudriere/data/packages/<replaceable>10amd64</replaceable></filename>. + <filename>10amd64</filename> bezeichnet dabei den Namen des + Baus.</para> + + <para>Wenn die <acronym>URL</acronym> des Paket Repositories + <literal>http://pkg.example.com/10amd64</literal>; ist, dann + sollte die Konfiguration des Repositories in + <filename>/usr/local/etc/pkg/repos/custom.conf</filename> + wie folgt aussehen:</para> + + <programlisting>custom: { + url: "<replaceable>http://pkg.example.com/10amd64</replaceable>", + enabled: yes, +}</programlisting> + </sect2> + </sect1> + <sect1 xml:id="ports-nextsteps"> <title>Nach der Installation</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201603251926.u2PJQVZ3065584>