COWPOKE(1)

BEZEICHNUNG
cowpoke - baut ein Debian-Quellpaket in einer fernen Cowbuilder-Instanz

ÜBERSICHT
cowpoke [Optionen] Paketname.dsc

BESCHREIBUNG
lädt ein Debian-Quellpaket auf einen cowbuilder-Rechner hoch und baut es, wahlweise signiert es außerdem das Ergebnis und lädt es in eine »incoming«-Warteschlange hoch.

OPTIONEN
Die folgenden Optionen sind verfügbar:

--arch=Architektur
    gibt die Debian-Architektur(en) an, für die gebaut wird. Es kann eine durch Leerzeichen getrennte Liste von Architekturen benutzt werden, um für alle in einem einzigen Durchgang zu bauen. Gültige Architekturnamen sind jene, die durch dpkg-architecture(1) für DEB_BUILD_ARCH zurückgegeben werden.

--dist=Distribution
    gibt die Debian-Distribution(en) an, für die gebaut wird. Es kann eine durch Leerzeichen getrennte Liste von Distributionen benutzt werden, um für alle in einem einzigen Durchgang zu bauen. Es können entweder Codenamen (wie sid oder squeeze) oder Distributionsnamen (wie unstable oder experimental) verwendet werden, aber Sie sollten üblicherweise durchgehend dabei bleiben, den einen oder anderen zu benutzen, da dieser Name in Dateipfaden benutzt wird und um alte Pakete für Vergleichsberichte zu orten.

    Es ist nun auch möglich, mit dieser Option lokal definierte Namen zu benutzen, wenn sie zusammen mit der Option BASE_DIST in einer Konfigurationsdatei verwendet werden. Dies erlaubt die Verwaltung und Benutzung eigens konfigurierter Bau-Chroots, die Paketabhängigkeiten aus den Backports-Archiven oder einem lokalen Depot beziehen können. Außerdem sind andere ungewöhnliche Optionszusammenstellungen möglich, ohne die Chroots zu verunreinigen, die zum sauberen Bauen und Hochladen in die Hauptdepots gedacht sind. Lesen Sie die die Beschreibung von BASE_DIST weiter unten.

--buildd=Rechner
    gibt den fernen Rechner an, auf dem gebaut werden soll.

--buildd-user=Name
    gibt den fernen Benutzernamen an, unter dem gebaut wird.

--create
    erstellt das ferne cowbuilder-Wurzelverzeichnis, falls es noch nicht existiert. Falls diese Option nicht übergeben wird, ist es für die angegebene --dist oder --arch ein Fehler, über kein existierendes cowbuilder-Wurzelverzeichnis an der erwarteten Stelle zu verfügen.

    Der --buildd-user muss das Recht haben, auf dem Baurechner das RESULT_DIR zu erstellen oder ein Administrator mit den nötigen Rechten muss es zuerst erstellen und diesem Benutzer (oder einer Gruppe, der er angehört) Schreibzugriff darauf geben, damit diese Option erfolgreich ist.

--return=[Pfad
    kopiert Ergebnisse des Bauens nach Pfad. Falls Pfad nicht angegeben wurde, dann werden sie an das aktuelle Verzeichnis zurückgegeben. Der angegebene Pfad muss existieren, er wird nicht erstellt.

--no-return
    kopiert Ergebnisse des Bauens nicht nach RETURN_DIR (setzt eine Pfadeinstellung hierfür in den Konfigurationsdateien außer Kraft).

--dpkg-opts='Option1 Option2 …'
    gibt zusätzliche Optionen an, die an dpkg-buildpackage(1) übergeben werden. Mehrere Optionen werden durch Leerzeichen getrennt. Dies wird alle in DEBBUILDOPTS angegebenen Optionen in der pbuilderrc des Baurechners außer Kraft setzen.

--create-opts='Cowbuilder-Option'
    gibt zusätzliche Argumente an, die unverändert an Cowbuilder weitergereicht werden, wenn eine Chroot zum ersten Mal (mittels der obigen Option --create) erstellt wird. Falls mehrere Optionen weitergereicht werden müssen, sollte diese Option separat für jede einzelne angegeben werden.

    Z.B. --create-opts "--othermirror" --create-opts "deb http://…"

    Diese Option wird jede für eine Chroot in den Cowpoke-Konfigurationsdateien angegebene CREATE_OPTS außer Kraft setzen.

--update-opts='Cowbuilder-Option'
    gibt zusätzliche Argumente an, die unverändert an Cowbuilder weitergereicht werden, wenn die Chroot aktualisiert wird. Falls mehrere Optionen weitergereicht werden müssen, sollte diese Option separat für jede einzelne angegeben werden.

    Diese Option wird jede für eine Chroot in den Cowpoke-Konfigurationsdateien angegebene UPDATE_OPTS außer Kraft setzen.

--build-opts='Cowbuilder-Option'
    gibt zusätzliche Argumente an, die unverändert an Cowbuilder weitergereicht werden, wenn ein Paket gebaut wird. Falls mehrere Optionen weitergereicht werden müssen, sollte diese Option separat für jede einzelne angegeben werden.

    Diese Option wird jede für eine Chroot in den Cowpoke-Konfigurationsdateien angegebene BUILD_OPTS außer Kraft setzen.

--sign=Schlüsselkennung
    gibt den Schlüssel an, mit dem Pakete signiert werden. Dies wird jedes SIGN_KEYID, das für eine Chroot in den Cowpoke-Konfigurationsdateien angegeben wurde, außer Kraft setzen.

--upload=Warteschlange
    gibt die Dput-Warteschlange an, in die signierte Pakete hochgeladen werden. Dies wird jede UPLOAD_QUEUE, die für eine Chroot in den Cowpoke-Konfigurationsdateien angegeben wurde, außer Kraft setzen.

--help
    zeigt eine kurze Zusammenfassung der verfügbaren Optionen und der aktuellen Konfiguration.

--version
    zeigt die aktuelle Versionsinformation.

KONFIGURATIONSOPTIONEN
Wenn cowpoke ausgeführt wird, werden die folgenden Optionen von globalen, benutzer- und objektbezogenen Konfigurationsdateien gelesen, falls vorhanden. Dateipfade können absolut oder relativ sein, letztere sind zum BUILDD_USER-Home-Verzeichnis relativ. Da die Pfade bei der Benutzung typischerweise in Anführungszeichen stehen, wird darauf keine Tilde-Expandierung durchgeführt.

  Globale Vorgaben
Dies gilt für jede Architektur und Distribution in einem einzelnen Cowpoke-Aufruf.

BUILDD_HOST
    die Netzwerkadresse oder FQDN der Baumaschine auf der cowbuilder konfiguriert ist. Dies könnte durch die Befehlszeilenoption --buildd außer Kraft gesetzt werden.

BUILDD_USER
    der nicht privilegierte Benutzername für Operationen auf der Baumaschine. Dies ist standardmäßig der lokale Name des Benutzers, der cowpoke ausführt (oder ein Benutzername, der in der SSH-Konfiguration für BUILDD_HOST angegeben wurd), und kann durch die Befehlszeilenoption --buildd-user außer Kraft gesetzt werden.

BUILDD_ARCH
    die Debian-Architektur(en), für die gebaut wird. Dies muss zu DEB_BUILD_ARCH der benutzten Bau-Chroot passen. Standardmäßig ist es die Architektur des lokalen Rechners, auf der cowpoke ausgeführt wird. Sie könnte durch die Befehlszeilenoption --arch außer Kraft gesetzt werden. Hier könnte eine durch Kommas getrennte Liste (in Anführungszeichen) verwendet werden, um um für alle hieraus in einem einzigen Durchgang zu bauen.

BUILDD_DIST
    die Debian-Distribution(en), für die gebaut wird. Eine durch Leerzeichen getrennte Liste von Distributionen (in Anführungszeichen) kann benutzt werden, um alle in einem einzigen Durchgang zu bauen. Dies könnte durch die Befehlszeilenoption --dist außer Kraft gesetzt werden.

INCOMING_DIR
    der Installationspfad auf der Baumaschine, in der das Quellpaket anfangs platziert wird. Dies muss durch den BUILDD_USER schreibbar sein.

PBUILDER_BASE
    die Wurzel des Dateisystems für alle Pbuilder-COW- und Ergebnisdateien. Architektur- und distributionsspezifische Unterverzeichnisse werden normalerweise darunter erstellt. Der APT-Zwischenspeicher und die temporären Bauverzeichnisse werden ebenso unterhalb dieses Pfads liegen.

SIGN_KEYID
    Falls diese Option gesetzt ist, wird erwartet, dass sie die GPG-Schlüsselkennung zur Übergabe an debsign(1) enthält, falls die Pakete aus der Ferne signiert werden sollen. Sie werden um Bestätigung gebeten, ob Sie die Pakete signieren möchten, nachdem das Bauen aller Pakete abgeschlossen ist. Falls diese Option nicht gesetzt oder eine leere Zeichenkette ist, wird kein Versuch unternommen, Pakete zu signieren. Sie kann auf einer Architektur- oder Distributionsspezifischen Basis mittels der weiter unten beschriebenen Option Architektur_Distribution_SIGN_KEYID oder jeweils beim Aufruf mit der Befehlszeilenoption --sign außer Kraft gesetzt werden.

UPLOAD_QUEUE
    Falls diese Option gesetzt ist, wird erwartet, dass sie eine »host«-Angabe für dput(1) enthält, die verwendet wird, um sie nach dem Signieren hochzuladen. Sie werden um Bestätigung gebeten, ob Sie die Pakete nach dem Signieren hochladen möchten. Falls diese Option nicht gesetzt oder eine leere Zeichenkette ist, wird kein Versuch unternommen, diese Pakete hochzuladen. Falls SIGN_KEYID nicht gesetzt ist, wird diese Option ganz ignoriert. Sie kann auf einer architektur- oder distributionsspezifischen Basis mittels der weiter unten beschriebenen Option Architektur_Distribution_UPLOAD_QUEUE oder jeweils beim Aufruf mit der Befehlszeilenoption --upload außer Kraft gesetzt werden.

BUILDD_ROOTCMD
    der Befehl, der zum Erlangen von Root-Rechten auf der fernen Baumaschine benutzt wird. Falls nicht gesetzt, ist die Vorgabe sudo(8). Dies ist nur nötig, um cowbuilder aufzurufen und ihm zu erlauben, in seine Chroot zu gelangen, daher könnten Sie diesen Nutzer darauf beschränken, diesen Befehl mit ausgeweiteten Rechten auszuführen. Ein Eintrag wie der folgende in »sudoers« wird es ermöglichen, cowbuilder ohne einen zusätzlich nötigen Passworteintrag aufzurufen:

    Ihrbenutzer ALL = NOPASSWD: /usr/sbin/cowbuilder

    Alternativ könnten Sie SSH mit einem weitergeleiteten Schlüssel oder irgendeinem anderen Mechanismus, der Ihrer lokalen Zugriffsrichtlinie entspricht, verwenden. Die Benutzung von su -c ist hier nicht wirklich passend, da seine Maskierungsanforderungen sich etwas vom Rest unterscheiden.

DEBOOTSTRAP
    das Hilfswerkzeug, das beim Erstellen einer neuen Chroot benutzt wird. Alternativen sind debootstrap oder cdebootstrap.

RETURN_DIR
    Falls gesetzt, werden Paketdateien, die Ergebnis des Bauens sind, in den Pfad (lokal oder in der Ferne) kopiert, auf den dies gesetzt ist. Der Pfad muss existieren, er wird nicht angelegt. Diese Option ist standardmäßig nicht gesetzt und kann mit --return oder --no-return überschrieben werden.

  Architekur- und distributionsspezifische Optionen
Dies sind Variablen der Form $arch_$dist_VAR, die nur für ein bestimmtes Architektur-/Distributions-Bauziel gelten.

Architektur_Distribution_RESULT_DIR
    Der Verzeichnispfad auf der Baumaschine, in dem die resultierenden (Quell- und Binär-)Pakete abgelegt werden und wo ältere Versionen der Pakete, die vorher gebaut wurden, gefunden werden können. Falls irgendwelche derartigen älteren Pakete existieren, wird debdiff benutzt, um das neue Paket mit der vorhergehenden Version zu vergleichen, nachdem das Bauen abgeschlossen ist. Das Ergebnis wird in das Bauprotokoll eingefügt. Dateien darin müssen für den BUILDD_USER für Plausibilitätsprüfungen mit lintian(1) und debdiff(1) und das Hochladen mit dput(1) lesbar sein. Falls diese Option für irgendwelche Architektur- und Distributionskombinationen nicht angegeben ist, dann wird $PBUILDER_BASE/$arch/$dist/result vorgegeben.

Architektur_Distribution_BASE_PATH
    das Verzeichnis, in dem die CoW-Master-Dateien vorliegen werden (oder erzeugt werden, falls die Befehlszeilenoption --create übergeben wurde). Falls diese Option für irgendwelche Architekturen und Distributionen nicht angegeben wurde, dann wird $PBUILDER_BASE/$arch/$dist/base.cow vorgegeben.

Architektur_Distribution_BASE_DIST
    der Codename, der anstelle von Distribution als Option --distribution an Cowbuilder übergeben wird. Dies ist nötig, wenn Distribution ein lokal bedeutsamer Name ist, der irgendeiner speziell konfigurierten Bau-Chroot wie »wheezy_backports« zugewiesen wurde und nicht der Debootstrap bekannte offizielle Suite-Name einer Distributionsveröffentlichung ist. Diese Option kann nicht auf der Befehlszeile außer Kraft gesetzt werden, da dies selten, wenn nicht sogar nie, für einzelne Aufrufe von Cowpoke sinnvoll wäre. Falls diese Option nicht für eine Architektur- und Distributionskombination angegeben wurde, wird als Voreinstellung Distribution genommen.

Architektur_Distribution_CREATE_OPTS
    ein Bash-Feld, das zusätzliche Optionen enthält, die unverändert an Cowbuilder weitergegeben werden, wenn diese Chroot zum ersten Mal (mittels der Option --create) erstellt wird. Dies ist nützlich, wenn Optionen wie --othermirror zum Erstellen spezialisierter Chroots wie »wheezy_backports« erwünscht werden. Standardmäßig ist dies nicht gesetzt. Alle darin gesetzten Werte werden außer Kraft gesetzt, falls auf der Befehlszeile die Option --create-opts übergeben wird.

    Jedes Element dieses Feldes entspricht einem einzelnen Argument (im Sinne von ARGV), das an Cowbuilder übergeben wird. Dadurch wird sichergestellt, dass Argumente, die Leerräume enthalten oder merkwürdige Maskierungsanforderungen oder andere Sonderzeichen haben, nicht verwürfelt werden, ehe Cowbuilder sie bekommt.

    Die Initialisierung von Bash-Feldern geschieht in folgender Form:

        OPTS=( "Arg1" "Arg 2" "--option" "Wert" "--opt=Wert" "etc. etc." )

Architektur_Distribution_UPDATE_OPTS
    ein Bash-Feld, das zusätzliche Optionen enthält, die jedesmal, wenn die Basis dieser Chroot aktualisiert wird, unverändert an Cowbuilder weitergereicht werden. Es verhält sich ähnlich der oben beschriebenen CREATE_OPTS-Optionen, außer dass es beim Aktualisieren der Chroot tätig wird.

Architektur_Distribution_BUILD_OPTS
    ein Bash-Feld, das zusätzliche Optionen enthält, die jedesmal, wenn in dieser Chroot ein Paket gebaut wird, unverändert an Cowbuilder weitergereicht werden. Dies ist nützlich, wenn Sie Optionen wie --twice verwenden, um die sich Cowpoke nicht direkt kümmern muss. In anderen Fällen verhält es sich ähnlich der oben beschriebenen CREATE_OPTS, außer dass es während der Bauphase von Cowbuilder tätig wird.

Architektur_Distribution_SIGN_KEYID
    ein optionales Architektur- und ein distributionsspezifisches Außer-Kraft-Setzen für die globale Option SIGN_KEYID.

Architektur_Distribution_UPLOAD_QUEUE
    ein optionales Architektur- und ein distributionsspezifisches Außer-Kraft-Setzen für die globale Option UPLOAD_QUEUE

KONFIGURATIONSDATEIEN

/etc/cowpoke.conf
    globale Konfigurationsoptionen; setzen die fest kodierten Vorgaben außer Kraft

~/.cowpoke
    Konfigurationsoptionen pro Benutzer; werden jede globale Konfiguration ignorieren

.cowpoke
    Konfigurationsoptionen pro Projekt; werden jede Konfiguration pro Benutzer oder globale Konfiguration überstimmen, falls cowpoke aus dem Verzeichnis aufgerufen wird, in dem sie existieren.

    Falls die Umgebungsvariable COWPOKE_CONF gesetzt ist, gibt sie eine zusätzliche Konfigurationsdatei an, die alles vorhergehende außer Kraft setzt. Optionen, die explizit auf der Befehlszeile angegeben werden, ignorieren alle Konfigurationsdateien.

COWBUILDER-KONFIGURATION
Um eine cowbuilder-Instanz zu konfigurieren. die mit cowpoke benutzt wird, wird nichts sonderlich Spezielles benötigt. Erstellen Sie sie einfach in der Variante, die Sie mit »cowbuilder --create« gemäß der cowbuilder-Dokumentation benötigen. Dann konfigurieren Sie cowpoke mit dem Benutzer, der Architektur und den zum Zugriff benötigten Pfadinformationen auf den Rechnern, von denen Sie es aufrufen wollen (oder konfigurieren Sie cowpoke alternativ mit dem Pfad, der Architektur und der Distributionsinformation und übergeben Sie ihm beim ersten Aufruf die Option --create). Der Baurechner, der cowbuilder ausführt, benötigt kein lokal installiertes cowpoke.

Auf der Baumaschine sollten die Pakete lintian und devscripts für Plausibilitätsprüfungen nach dem Bauen installiert sein. Nach Beendigung werden das Bauprotokoll und die Ergebnisse der automatischen Prüfungen in INCOMING_DIR aufgezeichnet. Falls Sie signierte Pakete hochladen möchten, wird die Baumaschine außerdem erforden, dass dput(1) installiert und für die Benutzung des durch die UPLOAD_QUEUE angegebenen Alias »Rechner« konfiguriert ist. Falls rsync(1) sowohl auf der lokalen als auch auf der Baumaschine verfügbar ist, wird es für die Übertragung des Quellpakets benutzt (dies könnte bei einigen Übertragungen der orig.tar.* Bandbreite sparen, wenn aufeinander folgende Debian-Revisionen gebaut werden).

Der Benutzer, der cowpoke ausführt, muss SSH-Zugriff auf die Baumschine als BUILDD_USER haben. Dieser Benutzer muss in der Lage sein, cowbuilder als Root durch Benutzen von BUILDD_ROOTCMD aufzurufen. Zur Installation auf der Baumaschine werden keine Schlüssel zum Signieren benötigt (und werden ignoriert, wenn sie dort sind). Falls das Paket signiert ist, werden die Schlüssel auf dem Rechner, die cowpoke ausführt, erwartet.

Wenn cowpoke aufgerufen wird, wird es zuerst versuchen, das cowbuilder-Image zu aktualisieren, falls dies nicht bereits am selben Tag getan wurde. Dies wird durch das Vorhandensein oder Fehlen einer cowbuilder-$arch-$dist-update-log-$date-Datei im Verzeichnis INCOMING_DIR geprüft. Sie können die Datei verschieben, entfernen oder mit touch aktualisieren, falls Sie wünschen, dass das Image außerhalb des üblichen Zyklus aktualisiert wird. Ihr Inhalt protokolliert die Ausgabe von cowbuilder während des Aktualisierens (oder Erstellens) des Bauwurzelverzeichnisses.

ANMERKUNGEN
Da cowbuilder eine Chroot erstellt und Sie, um dies zu tun, Root-Rechte benötigen, erfordert cowpoke außerdem zu einem bestimmten Grad Root-Zugriff. Daher ist es denkbar, dass all die schrecklichen Dinge, die dabei schiefgehen können, auch bei Ihnen schiefgehen. cowbuilder war bekannt dafür, versehentlich Dateisysteme, die mit der Option »bind« außerhalb der Chroot eingehängt sind, zu vernichten und es ist leicht möglich, dass noch Schlimmeres passiert. Seien Sie daher vorsichtig, bewahren Sie gute Sicherheitskopien der Dinge auf, die Sie nicht auf Ihrer Baumaschine verlieren möchten und verwenden Sie cowpoke, um alles auf einem Rechner zu verwahren, die nicht Ihre modernste Entwicklerkiste mit Ihren letzten paar Stunden nicht übergebener Arbeit ist.

SIEHE AUCH
cowbuilder(1), pbuilder(1), ssh-agent(1), sudoers(5)

AUTOR
cowpoke wurde von Ron <ron@debian.org> geschrieben.

ÜBERSETZUNG
Diese Übersetzung wurde mit dem Werkzeug po4a <URL:https://po4a.org/> durch Chris Leick c.leick@vollbio.de im Juli 2012 erstellt und vom deutschen Debian-Übersetzer-Team korrekturgelesen. Bitte melden Sie alle Fehler in der Übersetzung an debian-l10n-german@lists.debian.org oder als Fehlerbericht an das Paket devscripts. Sie können mit dem folgenden Befehl das englische Original anzeigen »man -L C Abschnitt deutsche_Handbuchseite«.