other versions
- wheezy 2.12.6+deb7u2
- wheezy-backports 2.14.11~bpo70+1
- jessie 2.15.3+deb8u1
- jessie-backports 2.17.5~bpo8+1
- testing 2.17.6
- unstable 2.17.6
COWPOKE(1) | General Commands Manual | COWPOKE(1) |
NOM¶
cowpoke - Construire un paquet source Debian dans une instance de cowbuilder distanteSYNOPSIS¶
cowpoke [options] paquet.dscDESCRIPTION¶
Envoyer un paquet source Debian à un hôte cowbuilder et construire le paquet. Le paquet résultant peut également être signé et envoyé dans une file d'attente.OPTIONS¶
Les options suivantes sont disponibles :- --arch=architecture
- Indiquer la ou les architectures Debian pour lesquelles le
paquet doit être construit. Une liste d'architectures
séparées par des espaces peut être utilisée pour
construire le paquet pour toutes ces architectures en une seule passe. Les
noms d'architecture supportés sont ceux renvoyés par
dpkg-architecture(1) pour DEB_BUILD_ARCH.
- --dist=distribution
- Indiquer la ou les distributions Debian pour lesquelles le
paquet doit être construit. Une liste de distributions
séparées par des espaces peut être utilisée 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
être utilisés, mais vous devriez toujours utiliser un type de
noms ou l'autre parce que c'est ce nom qui est utilisé pour les
chemins de fichier et pour trouver les anciens paquets utilisés pour
les rapports de comparaison.
- --buildd=hôte
- Indiquer l'hôte distant sur lequel se fera la
construction.
- --buildd-user=nom
- Indiquer l'utilisateur distant à utiliser pour la
construction.
- --create
- Créer la racine cowbuilder distante si elle
n'existe pas encore. Si cette option n'est pas fournie, une distribution
ou architecture (indiquées par --dist ou --arch) qui
n'aurait pas de racine cowbuilder sera considérée comme
une erreur.
- --return=[chemin]
- Copier les fichiers résultant de la construction vers
chemin. Si aucun chemin n'est indiqué, ils sont alors
renvoyés vers le répertoire actuel. Le chemin donné
doit exister, il ne sera pas créé.
- --no-return
- Ne pas copier le résultat de la construction vers
RETURN_DIR (écrase le chemin configuré dans les fichiers
de configuration).
- --dpkg-opts='opt1 opt2 ...'
- Indiquer des options supplémentaires à fournir
à dpkg-buildpackage(1). les différentes options sont
séparées par des espaces. Cela remplacera toute option fournie
par la variable DEBBUILDOPTS du fichier pbuilderrc de la
machine de construction.
- --create-opts='option de cowbuilder'
- Indiquer des arguments supplémentaires à passer
directement à cowbuilder quand un chroot est créé
(en utilisant l’option --create précédente). Si
plusieurs arguments doivent être passés, cette option devrait
être indiquée séparément pour chacun.
- --update-opts='option de cowbuilder'
- Indiquer des arguments supplémentaires à passer
directement à cowbuilder si la base du chroot est mise à
jour. Si plusieurs arguments doivent être passés, cette option
devrait être indiquée séparément pour chacun.
- --build-opts='option de cowbuilder'
- Indiquer des arguments supplémentaires à passer
directement à cowbuilder quand un paquet est construit. Si
plusieurs arguments doivent être passés, cette option devrait
être indiquée séparément pour chacun.
- --sign=identifiant_clef
- Specify the key to sign packages with. This will override
any SIGN_KEYID specified for a chroot in the cowpoke configuration
files.
- --upload=queue
- Specify the dput queue to upload signed packages to. This
will override any UPLOAD_QUEUE specified for a chroot in the
cowpoke configuration files.
- --help
- Afficher un bref résumé des options disponibles
et de la configuration en cours.
- --version
- Afficher les informations sur la version.
OPTIONS DE CONFIGURATION¶
Quand cowpoke est exécuté, les options de configuration suivantes sont lues dans le fichier de configuration global, celui de l'utilisateur et du projet, s'ils sont présents. Les chemins peuvent être indiqués de façon absolue ou relative (les chemins étant alors relatifs au répertoire personnel de l'utilisateur BUILDD_USER). Les chemins étant généralement fournis entre guillemets, l'expansion des tildes ne sera pas réalisée.Valeurs globales par défaut¶
Elles s'appliquent à chaque architecture et distribution lors d'un appel à cowpoke.- BUILDD_HOST
- L'adresse réseau ou le nom complètement qualifié (FQDN) de la machine de construction où cowbuilder est configuré. Elle peut être modifiée avec l'option en ligne de commande --buildd.
- BUILDD_USER
- Le nom de l'utilisateur, non privilégié, sur la machine de construction. Le nom par défaut est le nom de l'utilisateur local qui exécute cowpoke (ou le nom d'utilisateur précisé dans la configuration SSH pour BUILDD_HOST), et le nom fournit par la variable d'environnement peut être remplacé 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 à la valeur de DEB_BUILD_ARCH du chroot de construction utilisé. La valeur par défaut est l'architecture de la machine sur laquelle cowpoke est exécutée, et l'architecture peut être remplacée avec l'option --arch en ligne de commande. Une liste d'architectures séparées par des espaces (il peut être nécessaire de fournir le tout entre guillemets) peut être utilisée 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 séparées par
des espaces (il peut être nécessaire de fournir le tout entre
guillemets) peut être utilisée pour construire les paquets pour
toutes ces architectures en une seule passe. La ou les distributions
peuvent être remplacées avec l'option --dist en ligne de
commande.
- INCOMING_DIR
- Le chemin du répertoire sur la machine de construction où sont placés initialement les paquets source. Il doit être accessible en écriture par l'utilisateur BUILDD_USER.
- PBUILDER_BASE
- La racine du système de fichiers pour tous les
fichiers CoW et les fichiers résultats. Des sous-répertoires
spécifiques aux architectures et aux distributions
seront normalement créés sous cette racine. Le cache d'apt et
les répertoires temporaires de construction se trouveront
également sous ce chemin.
- SIGN_KEYID
- If this option is set, it is expected to contain the gpg
key ID to pass to debsign(1) if the packages are to be remotely
signed. You will be prompted to confirm whether you wish to sign the
packages after all builds are complete. If this option is unset or an
empty string, no attempt to sign packages will be made. It may be
overridden on an arch and dist specific basis using the
arch _dist_SIGN_KEYID option described below,
or per-invocation with the --sign command line option.
- UPLOAD_QUEUE
- If this option is set, it is expected to contain a 'host'
specification for dput(1) which will be used to upload them after
they are signed. You will be prompted to confirm whether you wish to
upload the packages after they are signed. If this option is unset or an
empty string, no attempt to upload packages will be made. If
SIGN_KEYID is not set, this option will be ignored entirely. It may
be overridden on an arch and dist specific basis using the
arch_dist_UPLOAD_QUEUE option described below,
or per-invocation with the --upload command line option.
- BUILDD_ROOTCMD
- La commande à utiliser pour obtenir les droits du superutilisateur sur la machine distante de construction. Si elle n'est pas définie, la commande par défaut est sudo(8). Elle n'est nécessaire que pour appeler cowbuilder et lui permettre d'entrer dans son chroot. Vous pouvez donc n'autoriser cet utilisateur à acquérir des droits supplémentaires que pour l'exécution de cette commande. La ligne suivante dans sudoers permettra d'appeler cowbuilder sans avoir à fournir de mot de passe :
utilisateur ALL = NOPASSWD:
/usr/sbin/cowbuilder
- Autrement, vous pouvez utiliser SSH avec une clef ou tout
autre mécanisme correspondant à votre politique locale. su
-c n'est pas vraiment utilisable ici parce qu'il nécessite de
placer des guillemets autour, contrairement aux autres.
- DEBOOTSTRAP
- L'utilitaire à utiliser pour créer une nouvelle
racine de construction. Les possibilités sont debootstrap ou
cdebootstrap.
- RETURN_DESTDIR
- Si elle est définie, les fichiers de paquet issus de
la construction seront copiés à l'endroit (local ou distant)
configuré, une fois la construction terminée. Le chemin doit
exister, il ne sera pas créé. Cette option n'est pas
définie par défaut et peut être écrasée par
--return ou --no-return.
Options spécifiques à des architectures ou distributions¶
Ce sont des variables de la forme $arch_$dist _VAR qui ne s'appliquent qu'à une cible de construction spécifique à une architecture et à une distribution.- arch_dist_RESULT_DIR
- Le chemin du répertoire de la machine de construction
où les paquets résultants (source et binaires) seront
trouvés, et où les versions ultérieures des paquets ayant
été précédemment construits pourront être
trouvées. Si des anciens paquets sont trouvés, debdiff
sera utilisé pour comparer le nouveau paquet avec la version
précédente une fois la construction finie, et le résultat
se trouvera dans le journal de construction. Les fichiers du
répertoire doivent être lisibles par BUILDD_USER pour les
vérifications par lintian(1) et debdiff(1) ainsi que
pour les envois par dput(1). Si cette option n'est pas définie
pour certaines combinaisons d'architectures et de distributions, alors le
chemin par défaut sera $PBUILDER_BASE/$arch/$dist/result
- arch_dist_BASE_PATH
- Le répertoire ou les fichiers CoW maîtres se
trouvent (ou là où ils sont créés si l'option en ligne
de commande --create est utilisée). Si cette option n'est pas
définie pour une combinaison d'architecture et de distribution, alors
le chemin par défaut est $PBUILDER_BASE/$arch/$dist/base.cow
- arch_dist_BASE_DIST
- Le nom de code à passer à l’option
--distribution de cowbuilder à la place de dist.
C’est nécessaire quand dist est un nom localement
significatif utilisé pour un chroot de construction configuré
spécialement, comme par exemple
« wheezy_backports », et non le nom de suite formel
d’une distribution connue de debootstrap. Cette option ne
peut pas être remplacée en ligne de commande, puisqu’il
n’y pas vraiment de raison de la modifier pour les appels
individuels de cowpoke. Si cette option n’est pas
indiquée pour une combinaison d’ architecture et de
distribution, alors la distribution est utilisée par
défaut.
- arch_dist_CREATE_OPTS
- Un tableau bash contenant des options supplémentaires
à passer directement à cowbuilder quand un chroot est
créé (en utilisant l’option --create). C’est
pratique quand des options comme --othermirror sont voulues pour
créer des configurations spéciales de chroot, comme par exemple
« wheezy_backports ». Par défaut il n’est
pas défini. Toutes les valeurs définie dans ce tableaux seront
ignorées si l’option --create-opts est passée en
ligne de commande.
OPTS=( "arg1" "arg 2" "--option" "valeur" "--opt=val" "etc." )
- arch_dist_UPDATE_OPTS
- Un tableau bash contenant des options supplémentaires
à passer directement à cowbuilder à chaque fois que
la base de ce chroot est mise à jour. Le comportement est similaire
à l’option CREATE_OPTS précédente, à part
qu’il est déclenché quand le chroot est mis à jour.
- arch_dist_BUILD_OPTS
- Un tableau bash contenant des options supplémentaires
à passer directement à cowbuilder quand un paquet est
construit. C’est pratique pour utiliser une option comme
--twice que cowpoke n’a pas besoin de gérer directement.
Le comportement est sinon similaire à l’option
UPDATE_OPTS précédente, à part qu’il est
déclenché pendant la phase de construction par
cowbuilder.
- arch_dist_SIGN_KEYID
- Un remplacement facultatif de l’option
SIGN_KEYID globale, spécifique à une architecture
et une distribution.
- arch_dist_UPLOAD_QUEUE
- Un remplacement facultatif de l’option
UPLOAD_QUEUE globale, spécifique à une
architecture et une distribution.
FICHIERS DE CONFIGURATION¶
- /etc/cowpoke.conf
- Options de configuration globales. Elles remplaceront les valeurs par défaut codées 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 appelé depuis le répertoire où se trouve
le fichier.
CONFIGURATION DE COWBUILDER¶
Il n'y a rien de particulier à faire pour configurer une instance de cowbuilder pour qu'elle puisse être utilisée avec cowpoke. Créez-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 nécessaire pour y accéder sur les machines où 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'hôte de construction sur lequel cowbuilder tourne n'a pas besoin que cowpoke soit installé localement.NOTES¶
Puisque cowbuilder crée un chroot, et qu'il faut pour cela être superutilisateur, cowpoke nécessite également certains des droits du superutilisateur. Et toutes les horreurs qui peuvent arriver à cause de ça pourront vous arriver un jour. cowbuilder est connu pour avoir accidentellement écrasé des systèmes de fichiers montés 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 problèmes sur une machine qui n'est pas votre machine de développement avec vos quelques heures de travail non committé.VOIR AUSSI¶
cowbuilder(1), pbuilder(1), ssh-agent(1), sudoers(5)AUTEUR¶
cowpoke a été écrit par Ron <ron@debian.org>.TRADUCTION¶
Ce document est une traduction, maintenue à l'aide de l'outil po4a < https://po4a.alioth.debian.org/> par l'équipe de traduction francophone du projet Debian.28 avril 2008 |