cowpoke - En ligne dans le Cloud

PROGRAMME:

Nom

cowpoke - Construire un paquet source Debian dans une instance de cowbuilder distante

SYNOPSIS

cow-boy [Options] nom_paquet.dsc

DESCRIPTION

Télécharge un paquet source Debian sur un constructeur de vaches hôte et le construit, éventuellement aussi
signer et télécharger le résultat dans une file d'attente entrante.

OPTIONS

Les options suivantes sont disponibles:

--arche=architecture
Spécifiez la ou les architectures Debian pour lesquelles construire. Une liste séparée par des espaces de
les architectures peuvent être utilisées pour construire pour chacun d'eux en un seul passage. Arc valide
les noms sont ceux renvoyés par architecture-dpkg(1) pour DEB_BUILD_ARCH.

--dist=pour la distribution
Spécifiez la ou les distributions Debian pour lesquelles construire. Une liste séparée par des espaces de
les distributions peuvent être utilisées pour construire pour chacun d'eux en un seul passage. Soit
noms de code (tels que sid, ou Filet) ou des noms de distribution (tels que instable, ou
expérimental) peut être utilisé, mais vous devez généralement vous en tenir à l'un ou l'autre
systématiquement car ce nom peut être utilisé dans les chemins de fichiers et pour localiser les anciens packages pour
rapport de comparaison.

Il est désormais également possible d'utiliser des noms définis localement avec cette option, lorsqu'elle est utilisée dans
conjonction avec le BASE_DIST option dans un fichier de configuration. Cela permet au
maintenance et utilisation de chroots de construction spécialement configurés, qui peuvent sourcer le paquet
dépendances des archives de backports ou d'un référentiel local, ou avoir d'autres
ensemble d'options de configuration inhabituelles, sans polluer les chroots que vous utilisez pour nettoyer
builds de packages destinés à être téléchargés vers les référentiels principaux. Voir le descriptif
of BASE_DIST ci-dessous.

--buildd=hôte
Spécifiez l'hôte distant sur lequel construire.

--buildd-user=prénom
Spécifiez l'utilisateur distant sous lequel créer.

--créer
Créer la télécommande constructeur de vaches root s'il n'existe pas déjà. Si cette option est
pas passé c'est une erreur pour le spécifié --dist or --cambre ne pas avoir de
existant constructeur de vaches racine à l'emplacement prévu.

La --buildd-utilisateur doit avoir l'autorisation de créer le RESULT_DIR sur l'hôte de construction,
ou un administrateur avec l'autorisation nécessaire doit d'abord le créer et donner à cet utilisateur
(ou à un groupe dans lequel ils se trouvent) un accès en écriture, pour que cette option réussisse.

--retour=[chemin]
Copiez les résultats de la construction dans chemin. Si chemin n'est pas spécifié, puis renvoyez-les à
le répertoire courant. Le donné chemin doit exister, il ne sera pas créé.

--non-retour
Ne copiez pas les résultats de la construction vers RETURN_DIR (remplacer un chemin défini pour lui dans le
fichiers de configuration).

--dpkg-opts='opt1 opt2 ... »
Spécifiez les options supplémentaires à transmettre à dpkg-buildpackage(1). Plusieurs options
sont délimités par des espaces. Cela remplacera toutes les options spécifiées dans
DÉBUILDOPTS dans l'hôte de construction pbuilderrc.

--create-opts='cowbuilder option'
Spécifiez les arguments supplémentaires à transmettre textuellement à constructeur de vaches quand un chroot est
créé pour la première fois (à l'aide du --créer option ci-dessus). Si plusieurs arguments doivent être
passé, cette option doit être spécifiée séparément pour chacun d'eux.

Par exemple --create-opt "--autre miroir" --create-opt "deb http:// ... "

Cette option remplacera tout CREATE_OPTS spécifié pour un chroot dans le cowpoke
fichiers de configuration.

--update-opts='cowbuilder option'
Spécifiez les arguments supplémentaires à transmettre textuellement à constructeur de vaches si la base du
chroot est mis à jour. Si plusieurs arguments doivent être transmis, cette option doit être
spécifiés séparément pour chacun d'eux.

Cette option remplacera tout UPDATE_OPTS spécifié pour un chroot dans le cowpoke
fichiers de configuration.

--build-opt='cowbuilder option'
Spécifiez les arguments supplémentaires à transmettre textuellement à constructeur de vaches quand un paquet
la construction est effectuée. Si plusieurs arguments doivent être transmis, cette option doit être
spécifiés séparément pour chacun d'eux.

Cette option remplacera tout CONSTRUIRE_OPTS spécifié pour un chroot dans le cowpoke
fichiers de configuration.

--signe=identifiant de clé
Spécifiez la clé avec laquelle signer les packages. Cela remplacera tout SIGN_KEYID spécifié
pour un chroot dans les fichiers de configuration cowpoke.

--télécharger=file
Spécifiez la file d'attente de sortie vers laquelle télécharger les packages signés. Cela remplacera tout
TÉLÉCHARGER_FILE D'ATTENTE spécifié pour un chroot dans les fichiers de configuration cowpoke.

--Aidez-moi Affiche un bref résumé des options disponibles et de la configuration actuelle.

--version
Afficher les informations sur la version actuelle.

CONFIGURATION OPTIONS

Lorsque cow-boy est exécuté les options de configuration suivantes sont lues à partir de global, par utilisateur,
et les fichiers de configuration par projet s'ils sont présents. Les chemins de fichiers peuvent être absolus ou relatifs,
ce dernier étant relatif au BUILDD_USERle répertoire personnel de . Puisque les chemins sont
généralement cité lorsqu'il est utilisé, l'expansion tilde sera pas être effectué sur eux.

Global par défaut
Celles-ci s'appliquent à chaque arche et dist en une seule invocation de cow-boy.

BUILDD_HOST
L'adresse réseau ou le nom de domaine complet de la machine de construction où constructeur de vaches est configuré.
Ceci peut être annulé par le --buildd commande option de ligne.

BUILDD_USER
Le nom d'utilisateur non privilégié pour les opérations sur la machine de build. Cette valeur par défaut est
le nom local de l'utilisateur exécutant cow-boy (ou à un nom d'utilisateur spécifié dans
votre configuration SSH pour BUILDD_HOST), et peut être annulé par le --buildd-utilisateur
commande option de ligne.

CONSTRUCTION_ARCH
La ou les architectures Debian pour lesquelles construire. Cela doit correspondre au DEB_BUILD_ARCH des
build chroot utilisé. Il s'agit par défaut de l'architecture de la machine locale où
cow-boy est exécuté et peut être annulé par le --cambre option de ligne de commande. UNE
(cité) une liste d'architectures séparées par des espaces peut être utilisée ici pour construire pour tous
eux en un seul passage.

BUILDD_DIST
La ou les distributions Debian pour lesquelles construire. Une liste (entre guillemets) séparée par des espaces de
les distributions peuvent être utilisées pour construire pour chacun d'eux en un seul passage. Cela peut être
dépassé par le --dist commande option de ligne.

INCOMING_DIR
Le chemin du répertoire sur la machine de build où le package source sera initialement
mis. Celui-ci doit être accessible en écriture par le BUILDD_USER.

PBUILDER_BASE
La racine du système de fichiers pour tous les fichiers de résultats et CoW de pbuilder. Ponts en arc et dist groupe de neurones
les sous-répertoires seront normalement créés sous ce fichier. Le cache apt et temporaire
Le répertoire build sera également situé sous ce chemin.

SIGN_KEYID
Si cette option est définie, elle devrait contenir l'ID de clé gpg à transmettre
conception(1) si les colis sont à signer à distance. Vous serez invité à
confirmez si vous souhaitez signer les packages une fois toutes les versions terminées. Si
cette option n'est pas définie ou est une chaîne vide, aucune tentative de signature de packages ne sera effectuée.
Il peut être outrepassé sur un arche et dist base spécifique en utilisant le
arch_dist_SIGN_KEYID option décrite ci-dessous, ou par appel avec le --signe
commande option de ligne.

TÉLÉCHARGER_FILE D'ATTENTE
Si cette option est définie, elle devrait contenir une spécification « hôte » pour sortie(1)
qui sera utilisé pour les télécharger après leur signature. Vous serez invité à
confirmez si vous souhaitez télécharger les packages après leur signature. Si ce
option n'est pas définie ou une chaîne vide, aucune tentative de téléchargement de packages ne sera effectuée. Si
SIGN_KEYID n'est pas défini, cette option sera entièrement ignorée. Il peut être outrepassé
sur un arche et dist base spécifique en utilisant le arch_dist_UPLOAD_QUEUE option
décrit ci-dessous, ou par invocation avec le --télécharger commande option de ligne.

BUILDD_ROOTCMD
La commande à utiliser pour obtenir les privilèges root sur la machine de construction distante. Si non défini
la valeur par défaut est sudo(8). Ceci n'est requis que pour invoquer constructeur de vaches et lui permettre de
entrez son chroot, vous pouvez donc restreindre cet utilisateur à ne pouvoir exécuter que
commande avec des privilèges élevés. Quelque chose comme ça dans sudoers permettra
invoquer constructeur de vaches sans saisie de mot de passe supplémentaire requise :

votreutilisateur ALL = NOPASSWD : /usr/sbin/cowbuilder

Alternativement, vous pouvez utiliser SSH avec une clé transférée, ou tout autre mécanisme
convient à votre politique d'accès locale. À l'aide de su -c n'est pas vraiment adapté ici en raison de sa
les exigences de citation étant quelque peu différentes des autres.

DÉBOOTSTRAP
L'utilitaire à utiliser lors de la création d'une nouvelle racine de build. Les alternatives sont debootstrap or
cdebootstrap.

RETURN_DIR
S'il est défini, les fichiers de package résultant de la construction seront copiés dans le chemin (local ou
remote) sur lequel il est défini, 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 remplacée par
--revenir or --non-retour.

Ponts en arc et dist groupe de neurones Options
Ce sont des variables de la forme : $arch_$dist_VAR qui ne s'appliquent qu'à une cible particulière
construction arch/dist.

arch_dist_RESULT_DIR
Le chemin du répertoire sur la machine de construction où les packages résultants (source et
binaire) seront trouvés, et où les anciennes versions du paquet qui ont été construites
précédemment peut être trouvé. Si de tels packages plus anciens existent, debdiff sera utilisé pour
comparer le nouveau package avec la version précédente une fois la construction terminée, et
le résultat sera inclus dans le journal de construction. Les fichiers qu'il contient doivent être lisibles par le
BUILDD_USER pour vérifier la santé mentale avec lintiende Géographie (1) et avec la debdiff(1), et pour le téléchargement avec
sortie(1). Si cette option n'est pas spécifiée pour certaines combinaisons arch et dist, alors
il sera par défaut $PBUILDER_BASE/$arch/$dist/résultat

arch_dist_BASE_PATH
Le répertoire où se trouvent les fichiers maîtres CoW (ou créé si le
--créer l'option de ligne de commande a été transmise). Si cette option n'est pas spécifiée pour certains
arch ou dist alors il sera par défaut $PBUILDER_BASE/$arch/$dist/base.vache

arch_dist_BASE_DIST
Le nom de code à passer comme --Distribution option pour cowbuilder au lieu de dist.
Ceci est nécessaire lorsque dist est un nom localement significatif attribué à certains
chroot de construction spécialement configuré, tel que 'wheezy_backports', et non le formel
nom de la suite d'une version de distribution connue de debootstrap. Cette option ne peut pas être
remplacé sur la ligne de commande, car il serait rarement, voire jamais, de sens de
le changer pour les appels individuels de cow-boy. Si cette option n'est pas spécifiée
pour une combinaison arch et dist, il sera par défaut dist.

arch_dist_CREATE_OPTS
Un tableau bash contenant des options supplémentaires à transmettre textuellement constructeur de vaches quand cela
chroot est créé pour la première fois (en utilisant le --créer option). C'est utile
quand des options comme --othermiroir sont recherchés pour créer un chroot spécialisé
des configurations telles que « wheezy_backports ». Par défaut, ce paramètre n'est pas défini. Toutes les valeurs
défini dans celui-ci sera annulé si le --create-opt l'option est passée sur la commande
ligne.

Chaque élément de ce tableau correspond à un seul argument (au sens ARGV)
qui sera transmis au cowbuilder. Cela garantit que les arguments qui peuvent contenir
des espaces ou des guillemets étranges ou d'autres caractères spéciaux
ne pas être mutilés avant d'arriver au cowbuilder.

Les tableaux Bash sont initialisés sous la forme suivante :

OPTS=( "arg1" "arg 2" "--option" "value" "--opt=val" "etc. etc." )

arch_dist_UPDATE_OPTS
Un tableau bash contenant des options supplémentaires à transmettre textuellement constructeur de vaches à chaque fois
la base de ce chroot est mise à jour. Il se comporte de la même manière que le CREATE_OPTS option
ci-dessus, sauf pour agir lorsque le chroot est mis à jour.

arch_dist_CONSTRUIRE_OPTS
Un tableau bash contenant des options supplémentaires à transmettre textuellement constructeur de vaches à chaque fois
une construction de paquet est effectuée dans ce chroot. Ceci est utile lorsque vous souhaitez utiliser
une option comme --à deux reprises dont cowpoke n'a pas directement besoin de se soucier. Ce
sinon se comporte de la même manière que UPDATE_OPTS ci-dessus sauf qu'il agit pendant la
phase de construction de constructeur de vaches.

arch_dist_SIGN_KEYID
Un remplacement optionnel spécifique à l'arch et à la dist pour le global SIGN_KEYID option.

arch_dist_UPLOAD_QUEUE
Un remplacement optionnel spécifique à l'arch et à la dist pour le global TÉLÉCHARGER_FILE D'ATTENTE option.

CONFIGURATION DES DOSSIERS

/etc/cowpoke.conf
Options de configuration globales. Remplacera les valeurs par défaut codées en dur.

~/.cowpoke
Options de configuration par utilisateur. Ignorera toute configuration globale.

.cowpoke
Options de configuration par projet. Remplacera tout par utilisateur ou global
configuration si cow-boy est appelé depuis le répertoire où ils existent.

Si la variable d'environnement COWPOKE_CONF est défini, il spécifie un
fichier de configuration qui remplacera tous ceux ci-dessus. Options spécifiées
explicitement sur la ligne de commande, remplacez tous les fichiers de configuration.

CONSTRUCTEUR DE VACHES CONFIGURATION

Il n'y a rien de particulièrement spécial requis pour configurer un constructeur de vaches exemple d'utilisation
avec cow-boy. Créez-les simplement dans la saveur dont vous avez besoin avec `constructeur de vaches --créer`
selon l' constructeur de vaches documentation, puis configurer cow-boy avec l'utilisateur, arch et
les informations de chemin requises pour y accéder, sur les machines à partir desquelles vous souhaitez l'invoquer (ou
configurer alternativement cow-boy avec le chemin, l'arche et les informations de distribution et pass
le --créer option à la première invocation). L'hôte de construction en cours d'exécution constructeur de vaches
ne nécessite pas d' cow-boy installé localement.

La machine de construction doit avoir le lintien et scripts de développement paquets installés pour la post-construction
vérification de la santé mentale. Une fois terminé, le journal de construction et les résultats des contrôles automatisés seront
être enregistré dans le INCOMING_DIR. Si vous souhaitez télécharger des packages signés, la machine de construction
aura également besoin sortie(1) installé et configuré pour utiliser le 'hôte' alias spécifié par
TÉLÉCHARGER_FILE D'ATTENTE. Si rsync(1) est disponible à la fois sur la machine locale et sur la machine de build, alors il sera
être utilisé pour transférer le package source (cela peut économiser sur certains transferts du orig.tar.*
lors de la construction des révisions Debian suivantes).

L'utilisateur exécutant cow-boy doit avoir un accès SSH à la machine de construction en tant que BUILDD_USER.
Cet utilisateur doit pouvoir invoquer constructeur de vaches en tant que root en utilisant le BUILDD_ROOTCMD. Signature
les clés ne doivent pas nécessairement être installées sur la machine de construction (et y seront ignorées si
elles sont). Si le package est signé, des clés seront attendues sur la machine qui exécute
cow-boy.

Lorsque cow-boy est invoqué, il tentera d'abord de mettre à jour le constructeur de vaches image si cela a
pas déjà été fait le même jour. Ceci est vérifié par la présence ou l'absence d'un
cowbuilder-$arch-$dist-update-log-$date déposer dans le INCOMING_DIR. Vous pouvez déplacer, supprimer,
ou touchez ce fichier si vous souhaitez que l'image soit mise à jour plus ou moins souvent que cela. Son
contenu journal la sortie de constructeur de vaches lors de la mise à jour (ou création) de la racine de build.

NOTES

Depuis que constructeur de vaches crée un chroot, et pour ce faire vous avez besoin de root, cow-boy exige aussi
un certain degré d'accès root. Donc toutes les choses horribles qui peuvent mal tourner avec ça peuvent
eh bien un jour il pleuvra sur toi. constructeur de vaches a été connu pour effacer accidentellement bind-
systèmes de fichiers montés en dehors du chroot, et pire que cela peut facilement arriver. Alors sois
attention, gardez de bonnes sauvegardes des choses que vous ne voulez pas perdre sur votre machine de construction, et utilisez
cow-boy pour garder tout cela sur une machine qui n'est pas votre boîte de développement à la pointe de la technologie avec votre dernier
quelques heures de travail non engagé.

Utilisez cowpoke en ligne en utilisant les services onworks.net