Valeurs globales par défaut¶

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

Si cette option est activée, elle doit contenir l'identifiant de la clef GPG à fournir à debsign(1) si les paquets doivent être signés sur la machine distante. Il vous sera demandé si vous souhaitez signer les paquets après que toutes les constructions sont finies. Si cette option n'est pas activée ou si elle contient une chaîne vide, aucune tentative de signature ne sera effectuée. Elle peut être remplacée de façon spécifique à une architecture et une distribution avec l’option arch_dist_SIGN_KEYID décrite ci-dessous, ou par invocation avec l’option --sign en ligne de commande.

UPLOAD_QUEUE

Si cette option est activée, elle doit contenir une indication d'hôte pour dput(1) qui sera utilisée pour envoyer les paquets après qu'ils ont été signés. Il vous sera demandé de confirmer si vous souhaitez envoyer les paquets après qu'ils ont été signés. Si cette option n'est pas activée ou si elle contient une chaîne vide, aucune tentative d'envoi ne sera effectuée. Si SIGN_KEYID n'est pas activée, cette option sera complètement ignorée. Elle peut être remplacée de façon spécifique à une architecture et une distribution avec l’option arch_dist_UPLOAD_QUEUE décrite ci-dessous, ou par invocation avec l’option --upload en ligne de commande.

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 :

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¶

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.

Chaque élément de ce tableau correspond à un seul argument (dans le sens de ARGV) qui sera passé à cowbuilder. Cela permet à ces arguments, qui pourraient contenir des espaces, avoir des besoins de protection bizarre ou d’autres caractères spéciaux, de pas ne pas être déformés avant d’atteindre cowbuilder.

Les tableaux bash sont initialisés un utilisant le format suivant :

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.