svn commit: r48469 - head/de_DE.ISO8859-1/books/handbook/ports

Bjoern Heidotting bhd at FreeBSD.org
Fri Mar 25 19:26:32 UTC 2016


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>
 


More information about the svn-doc-all mailing list