Provided by:
devscripts_2.11.1ubuntu3_i386 
NOM
cowpoke - Construire un paquet source Debian dans une instance de
cowbuilder distante
SYNOPSIS
cowpoke [options] paquet.dsc
DESCRIPTION
Envoyer un paquet source Debian a un hote cowbuilder et construire le
paquet. Le paquet resultant peut egalement etre signe et envoye dans
une file d'attente.
OPTIONS
Les options suivantes sont disponibles :
--arch=architecture
Indiquer la ou les architectures Debian pour lesquelles le
paquet doit etre construit. Une liste d'architectures separees
par des espaces peut etre utilisee pour construire le paquet
pour toutes ces architectures en une seule passe. Les noms
d'architecture supportes sont ceux renvoyes par
dpkg-architecture(1) pour DEB_BUILD_ARCH.
--dist=distribution
Indiquer la ou les distributions Debian pour lesquelles le
paquet doit etre construit. Une liste de distributions separees
par des espaces peut etre utilisee pour construire le paquet
pour toutes ces distributions en une seule passe. Des noms de
code (comme sid ou squeeze) ou des noms de distribution (comme
unstable ou experimental) peuvent etre utilises, mais vous
devriez toujours utiliser un type de noms ou l'autre parce que
c'est ce nom qui est utilise pour les chemins de fichier et pour
trouver les anciens paquets utilises pour les rapports de
comparaison.
--buildd=h^ote
Indiquer l'hote distant sur lequel se fera la construction.
--buildd-user=nom
Indiquer l'utilisateur distant a utiliser pour la construction.
--create
Creer la racine cowbuilder distante si elle n'existe pas encore.
Si cette option n'est pas fournie, une distribution ou
architecture (indiquees par --dist ou --arch) qui n'aurait pas
de racine cowbuilder sera consideree comme une erreur.
--return=[chemin]
Copier les fichiers resultant de la construction vers chemin. Si
aucun chemin n'est indique, ils sont alors renvoyes vers le
repertoire actuel. Le chemin donne doit exister, il ne sera pas
cree.
--no-return
Ne pas copier le resultat de la construction vers RETURN_DIR
(ecrase le chemin configure dans les fichiers de configuration).
--dpkg-opts='opt1 opt2 ...'
Indiquer des options supplementaires a fournir a
dpkg-buildpackage(1). les differentes options sont separees par
des espaces. Cela remplacera toute option fournie par la
variable DEBBUILDOPTS du fichier pbuilderrc de la machine de
construction.
--help Afficher un bref resume des options disponibles et de la
configuration en cours.
--version
Afficher les informations sur la version.
OPTIONS DE CONFIGURATION
Quand cowpoke est execute, les options de configuration suivantes sont
lues dans le fichier de configuration global, celui de l'utilisateur et
du projet, s'ils sont presents. Les chemins peuvent etre indiques de
facon absolue ou relative (les chemins etant alors relatifs au
repertoire personnel de l'utilisateur BUILDD_USER). Les chemins etant
generalement fournis entre guillemets, l'expansion des tildes ne sera
pas realisee.
Valeurs globales par d'efaut
Elles s'appliquent a chaque architecture et distribution lors d'un
appel a cowpoke.
BUILDD_HOST
L'adresse reseau ou le nom completement qualifie (FQDN) de la
machine de construction ou cowbuilder est configure. Elle peut
etre modifiee avec l'option en ligne de commande --buildd.
BUILDD_USER
Le nom de l'utilisateur, non privilegie, sur la machine de
construction. Le nom par defaut est le nom de l'utilisateur
local qui execute cowpoke (ou le nom d'utilisateur precise dans
la configuration SSH pour BUILDD_HOST), et le nom fournit par la
variable d'environnement peut etre remplace avec l'option
--buildd-user en ligne de commande.
BUILDD_ARCH
La ou les architectures Debian pour lesquelles il faut
construire les paquets. Cela doit correspondre a la valeur de
DEB_BUILD_ARCH du chroot de construction utilise. La valeur par
defaut est l'architecture de la machine sur laquelle cowpoke est
executee, et l'architecture peut etre remplacee avec l'option
--arch en ligne de commande. Une liste d'architectures separees
par des espaces (il peut etre necessaire de fournir le tout
entre guillemets) peut etre utilisee pour construire les paquets
pour toutes ces architectures en une seule passe.
BUILDD_DIST
La ou les distributions Debian pour lesquelles il faut
construire les paquets. Une liste de distributions separees par
des espaces (il peut etre necessaire de fournir le tout entre
guillemets) peut etre utilisee pour construire les paquets pour
toutes ces architectures en une seule passe. La ou les
distributions peuvent etre remplacees avec l'option --dist en
ligne de commande.
INCOMING_DIR
Le chemin du repertoire sur la machine de construction ou sont
places initialement les paquets source. Il doit etre accessible
en ecriture par l'utilisateur BUILDD_USER.
PBUILDER_BASE
La racine du systeme de fichiers pour tous les fichiers COW et
les fichiers resultats. Des sous-repertoires specifiques aux
architectures et aux distributions seront normalement crees sous
cette racine. Le cache d'apt et les repertoires temporaires de
construction se trouveront egalement sous ce chemin.
SIGN_KEYID
Si cette option est activee, elle doit contenir l'identifiant de
la clef GPG a fournir a debsign(1) si les paquets doivent etre
signes sur la machine distante. Il vous sera demande si vous
souhaitez signer les paquets apres que toutes les constructions
sont finies. Si cette option n'est pas activee ou si elle
contient une chaine vide, aucune tentative de signature ne sera
effectuee.
UPLOAD_QUEUE
Si cette option est activee, elle doit contenir une indication
d'hote pour dput(1) qui sera utilisee pour envoyer les paquets
apres qu'ils ont ete signes. Il vous sera demande de confirmer
si vous souhaitez envoyer les paquets apres qu'ils ont ete
signes. Si cette option n'est pas activee ou si elle contient
une chaine vide, aucune tentative d'envoi ne sera effectuee. Si
SIGN_KEYID n'est pas activee, cette option sera completement
ignoree.
BUILDD_ROOTCMD
La commande a utiliser pour obtenir les droits du
superutilisateur sur la machine distante de construction. Si
elle n'est pas definie, la commande par defaut est sudo(8). Elle
n'est necessaire que pour appeler cowbuilder et lui permettre
d'entrer dans son chroot. Vous pouvez donc n'autoriser cet
utilisateur a acquerir des droits supplementaires que pour
l'execution de cette commande. La ligne suivante dans sudoers
permettra d'appeler cowbuilder sans avoir a fournir de mot de
passe :
utilisateur ALL = NOPASSWD: /usr/sbin/cowbuilder
Autrement, vous pouvez utiliser SSH avec une clef ou tout autre
mecanisme correspondant a votre politique locale. su -c n'est
pas vraiment utilisable ici parce qu'il necessite de placer des
guillemets autour, contrairement aux autres.
DEBOOTSTRAP
L'utilitaire a utiliser pour creer une nouvelle racine de
construction. Les possibilites sont debootstrap ou cdebootstrap.
RETURN_DESTDIR
Si elle est definie, les fichiers de paquet issus de la
construction seront copies a l'endroit (local ou distant)
configure, une fois la construction terminee. Le chemin doit
exister, il ne sera pas cree. Cette option n'est pas definie par
defaut et peut etre ecrasee par --return ou --no-return.
Options sp'ecifiques `a des architectures ou distributions
Ce sont des variables de la forme $arch_$dist_VAR qui ne s'appliquent
qu'a une cible de construction specifique a une architecture et a une
distribution.
arch_dist_RESULT_DIR
Le chemin du repertoire de la machine de construction ou les
paquets resultants (source et binaires) seront trouves, et ou
les versions ulterieures des paquets ayant ete precedemment
construits pourront etre trouvees. Si des anciens paquets sont
trouves, debdiff sera utilise pour comparer le nouveau paquet
avec la version precedente une fois la construction finie, et le
resultat se trouvera dans le journal de construction. Les
fichiers du repertoire doivent etre lisibles par BUILDD_USER
pour les verifications par lintian(1) et debdiff(1) ainsi que
pour les envois par dput(1). Si cette option n'est pas definie
pour certaines combinaisons d'architectures et de distributions,
alors le chemin par defaut sera
$PBUILDER_BASE/$arch/$dist/result
arch_dist_BASE_PATH
Le repertoire ou les fichiers COW maitres se trouvent (ou la ou
ils sont crees si l'option en ligne de commande --create est
utilisee). Si cette option n'est pas definie pour une
combinaison d'architecture et de distribution, alors le chemin
par defaut est $PBUILDER_BASE/$arch/$dist/base.cow
FICHIERS DE CONFIGURATION
/etc/cowpoke.conf
Options de configuration globales. Elles remplaceront les
valeurs par defaut codees en dur.
~/.cowpoke
Options de configuration de l'utilisateur. Elles remplaceront
les valeurs des options de configuration globales.
.cowpoke
Options de configuration du projet. Elles remplaceront les
valeurs des options de configuration globale ou de l'utilisateur
si cowpoke est appele depuis le repertoire ou se trouve le
fichier.
Si la variable d'environnement COWPOKE_CONF est definie, elle
indique un fichier de configuration supplementaire qui
remplacera tous les autres. Les options utilisees explicitement
sur la ligne de commande remplacent les options provenant des
fichiers de configuration.
CONFIGURATION DE COWBUILDER
Il n'y a rien de particulier a faire pour configurer une instance de
cowbuilder pour qu'elle puisse etre utilisee avec cowpoke. Creer la
simplement telle que vous en avez besoin avec << cowbuilder --create >>
en suivant la documentation de cowbuilder, puis configurez cowpoke avec
les informations sur l'utilisateur, l'architecture et le chemin
necessaire pour y acceder sur les machines ou vous souhaitez l'appeler
(ou configurez cowpoke avec les informations sur le chemin,
l'architecture et la distribution et fournissez lui l'option --create
lors du premier appel). L'hote de construction sur lequel cowbuilder
tourne n'a pas besoin que cowpoke soit installe localement.
La machine de construction doit avoir les paquets lintian et devscripts
installes pour les verifications en fin de construction. Une fois la
construction finie, un journal et les resultats des tests automatiques
seront enregistres dans INCOMING_DIR. Si vous souhaitez envoyer des
paquets signes, dput(1) devra egalement etre installe sur la machine de
construction et devra etre configure pour utiliser l'alias h^ote indique
par UPLOAD_QUEUE. Si rsync(1) est disponible a la fois sur la machine
locale et la machine de construction, alors il peut etre utilise pour
transferer le paquet source (cela permet d'economiser quelques echanges
de orig.tar.* lors de la construction des revisions Debian suivantes).
L'utilisateur qui execute cowpoke doit avoir un acces SSH a la machine
de construction en tant que BUILDD_USER. Cet utilisateur doit pouvoir
executer cowbuilder en tant que superutilisateur en utilisant
BUILDD_ROOTCMD. Les clefs pour les signatures n'ont pas necessairement
a etre installees sur la machine de construction (et elles seront
ignorees si elles le sont). Si un paquet est signe, les clefs seront
necessaires sur la machine qui execute cowpoke.
Quand cowpoke est appele, il cherche d'abord a mettre a jour l'image
cowbuilder si cela n'a pas deja ete fait le meme jour. Cette
verification se base sur la presence d'un fichier
cowbuilder-$arch-$dist-update-log-$date dans le repertoire
INCOMING_DIR. Vous pouvez deplacer, renommer ou toucher ce fichier si
vous souhaitez que l'image soit mise a jour plus ou moins souvent. Son
contenu liste les sorties de cowbuilder pendant la mise a jour (ou la
creation) de la racine de construction.
NOTES
Puisque cowbuilder cree un chroot, et qu'il faut pour cela etre
superutilisateur, cowpoke necessite egalement certains des droits du
superutilisateur. Et toutes les horreurs qui peuvent arriver a cause de
ca pourront vous arriver un jour. cowbuilder est connu pour avoir
accidentellement ecrase des systemes de fichiers montes avec l'option
<< bind >> en dehors de son chroot, et pire encore peut arriver. Soyez
prudents, conservez des sauvegardes de ce que vous ne souhaitez pas
perdre sur vos machines de construction et utilisez cowpoke pour isoler
tous ces problemes sur une machine qui n'est pas votre machine de
developpement avec vos quelques heures de travail non committe.
VOIR AUSSI
cowbuilder(1), pbuilder(1), ssh-agent(1), sudoers(5).
AUTEUR
cowpoke a ete ecrit par Ron <ron@debian.org>.
TRADUCTION
Ce document est une traduction, maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone du projet Debian.
Nicolas Francois, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux
et David Prevot ont realise cette traduction.
L'equipe de traduction a fait le maximum pour realiser une adaptation
francaise de qualite. Veuillez signaler toute erreur de traduction en
ecrivant a <debian-l10n-french@lists.debian.org> ou par un rapport de
bogue sur le paquet devscripts.
La version anglaise la plus a jour de ce document est toujours
consultable en ajoutant l'option << -L C >> a la commande man.
28 avril 2008 COWPOKE(1)