cowpoke - Online în cloud

PROGRAM:

NUME

cowpoke - Construiți un pachet sursă Debian într-o instanță de la distanță cowbuilder

REZUMAT

cowpoke [Opțiuni] packagename.dsc

DESCRIERE

Încarcă un pachet sursă Debian în a constructor de vaci găzduiește și îl construiește, opțional și
semnarea și încărcarea rezultatului într-o coadă de așteptare.

OPŢIUNI

Sunt disponibile următoarele opțiuni:

--arc=arhitectură
Specificați arhitectura (arhitecturile) Debian pentru care să construiți. O listă cu spații separate
Arhitecturile pot fi folosite pentru a construi pentru toate într-o singură trecere. Arc valabil
numele sunt cele returnate de dpkg-arhitectură(1) pentru DEB_BUILD_ARCH.

--dist=distribuire
Specificați distribuțiile Debian pentru care să creați. O listă cu spații separate
distribuțiile pot fi folosite pentru a construi pentru toate într-o singură trecere. Fie
nume de cod (cum ar fi sid, stoarce) sau nume de distribuție (cum ar fi instabil,
experimental) poate fi folosit, dar de obicei ar trebui să rămâneți să utilizați unul sau altul
în mod constant, deoarece acest nume poate fi folosit în căile de fișiere și pentru a localiza pachetele vechi pentru
raportare comparativă.

Acum este, de asemenea, posibil să folosiți nume definite local cu această opțiune, atunci când sunt utilizate în
împreună cu BASE_DIST opțiune într-un fișier de configurare. Acest lucru permite
întreținerea și utilizarea de build chroots special configurate, care pot sursa pachet
dependențe din arhivele backports sau dintr-un depozit local sau au altele
setate opțiuni de configurare neobișnuite, fără a polua chroot-urile pe care le folosiți pentru curățare
build-uri de pachete destinate încărcării în depozitele principale. Vezi descrierea
of BASE_DIST de mai jos.

--buildd=gazdă
Specificați gazda la distanță pe care să construiți.

--buildd-user=nume
Specificați utilizatorul de la distanță pentru a crea.

--crea
Creați telecomanda constructor de vaci root dacă nu există deja. Dacă această opțiune este
nu a trecut este o eroare pentru cele specificate --dist or --arc a nu avea o
existent constructor de vaci rădăcină în locația așteptată.

--buildd-user trebuie să aibă permisiunea de a crea RESULT_DIR pe gazda de construcție,
sau un administrator cu permisiunea necesară trebuie mai întâi să-l creeze și să-i dea utilizatorului respectiv
(sau un grup în care se află) acces de scriere la acesta, pentru ca această opțiune să reușească.

--întoarce=[cale]
Copiați rezultatele construcției în cale. Dacă cale nu este specificat, apoi returnați-le la
directorul curent. A dat cale trebuie să existe, nu va fi creat.

--fără întoarcere
Nu copiați rezultatele build-ului în RETURN_DIR (înlocuind o cale stabilită pentru aceasta în
fișiere de configurare).

--dpkg-opts=„opt1 opt2 ... '
Specificați opțiuni suplimentare către care să le transmiteți dpkg-buildpackage(1). Opțiuni multiple
sunt delimitate cu spații. Aceasta va suprascrie orice opțiuni specificate în
DEBBULDOPTS în gazda de construcție pbuilderrc.

--create-opts='vaci opțiune'
Specificați argumente suplimentare cărora să le transmiteți textul constructor de vaci când un chroot este
creat pentru prima dată (folosind --crea opțiunea de mai sus). Dacă trebuie să existe mai multe argumente
trecut, această opțiune ar trebui specificată separat pentru fiecare dintre ele.

De exemplu, --create-optează „--altă oglindă” --create-optează „deb http:// ... "

Această opțiune va înlocui orice CREATE_OPTS specificat pentru un chroot în cowpoke
fișiere de configurare.

--update-opts='vaci opțiune'
Specificați argumente suplimentare cărora să le transmiteți textul constructor de vaci dacă baza celui
chroot este actualizat. Dacă trebuie transmise mai multe argumente, această opțiune ar trebui să fie
specificate separat pentru fiecare dintre ele.

Această opțiune va înlocui orice UPDATE_OPTS specificat pentru un chroot în cowpoke
fișiere de configurare.

--build-opts='vaci opțiune'
Specificați argumente suplimentare cărora să le transmiteți textul constructor de vaci când un pachet
se realizează construirea. Dacă trebuie transmise mai multe argumente, această opțiune ar trebui să fie
specificate separat pentru fiecare dintre ele.

Această opțiune va înlocui orice BUILD_OPTS specificat pentru un chroot în cowpoke
fișiere de configurare.

--semn=keyid
Specificați cheia cu care să semnați pachetele. Aceasta va anula orice SIGN_KEYID specificată
pentru un chroot în fișierele de configurare cowpoke.

--upload=coadă
Specificați coada de intrare în care să încărcați pachetele semnate. Aceasta va anula orice
UPLOAD_QUEUE specificat pentru un chroot în fișierele de configurare cowpoke.

--Ajutor Afișează un scurt rezumat al opțiunilor disponibile și al configurației curente.

--versiune
Afișează informațiile despre versiunea curentă.

CONFIGURARE OPŢIUNI

Cand cowpoke se rulează următoarele opțiuni de configurare sunt citite de la nivel global, per utilizator,
și fișiere de configurare per proiect, dacă sunt prezente. Căile fișierelor pot fi absolute sau relative,
acesta din urmă fiind relativ la BUILDD_USERdirectorul principal al lui. Din moment ce căile sunt
de obicei citat atunci când este utilizat, extinderea tildei va nu să fie efectuate asupra lor.

Caritate implicite
Acestea se aplică tuturor arc si dist într-o singură invocare cowpoke.

BUILDD_HOST
Adresa de rețea sau fqdn a mașinii de construcție unde constructor de vaci este configurat.
Acest lucru poate fi anulat de --buildd opțiune linie de comandă.

BUILDD_USER
Numele de utilizator neprivilegiat pentru operațiunile pe mașina de construcție. Aceasta este implicită
numele local al utilizatorului care execută cowpoke (sau la un nume de utilizator care este specificat în
configurația dvs. SSH pentru BUILDD_HOST), și poate fi înlocuit de --buildd-user
opțiune linie de comandă.

BUILDD_ARCH
Arhitectura(e) Debian pentru care să construiți. Aceasta trebuie să se potrivească cu DEB_BUILD_ARCH a
build chroot fiind folosit. Este implicit la arhitectura mașinii locale unde
cowpoke este executat și poate fi înlocuit de --arc opțiunea de linie de comandă. A
(citat) lista de arhitecturi separate prin spații poate fi folosită aici pentru a construi pentru toate
le într-o singură trecere.

BUILDD_DIST
Distribuția(e) Debian pentru care să construiți. O listă (cotată) separată de spații de
distribuțiile pot fi folosite pentru a construi pentru toate într-o singură trecere. Aceasta ar putea fi
depășită de --dist opțiune linie de comandă.

INCOMING_DIR
Calea directorului de pe mașina de construcție unde va fi inițial pachetul sursă
plasat. Acest lucru trebuie să fie scris de către BUILDD_USER.

PBUILDER_BASE
Rădăcina sistemului de fișiere pentru toate fișierele pbuilder CoW și rezultat. Arc si dist specific
subdirectoarele vor fi în mod normal create sub aceasta. Cache-ul apt și temporar
directorul de compilare va fi de asemenea situat sub această cale.

SIGN_KEYID
Dacă această opțiune este setată, este de așteptat să conțină ID-ul cheii gpg către care să o transmiteți
debdesign(1) dacă pachetele urmează să fie semnate de la distanță. Vi se va solicita
confirmați dacă doriți să semnați pachetele după ce toate versiunile sunt finalizate. Dacă
această opțiune nu este setată sau este un șir gol, nu se va încerca să semneze pachete.
Poate fi suprascris pe un arc si dist baza specifică folosind
arhi_dist_SIGN_KEYID opțiunea descrisă mai jos sau per-invocare cu --semn
opțiune linie de comandă.

UPLOAD_QUEUE
Dacă această opțiune este setată, este de așteptat să conțină o specificație „gazdă” pentru dput(1)
care vor fi folosite pentru a le încărca după semnare. Vi se va solicita
confirmați dacă doriți să încărcați pachetele după ce acestea sunt semnate. Dacă aceasta
opțiunea este dezactivată sau este un șir gol, nu se va încerca să încărcați pachete. Dacă
SIGN_KEYID nu este setată, această opțiune va fi ignorată în întregime. Poate fi anulat
pe o arc si dist baza specifică folosind arhi_dist_UPLOAD_QUEUE opțiune
descrise mai jos, sau per-invocare cu --încărcare opțiune linie de comandă.

BUILDD_ROOTCMD
Comanda de utilizat pentru a obține privilegii de root pe mașina de compilare la distanță. Dacă nesetat
implicit este sudo(8). Acest lucru este necesar doar pentru a invoca constructor de vaci și permiteți-i
introduceți chroot-ul său, așa că puteți restricționa acest utilizator doar pentru a putea rula asta
comanda cu privilegii crescute. Ceva de genul acesta în sudoers va activa
invocante constructor de vaci fără a fi necesară introducerea unei parole suplimentare:

utilizatorul tău ALL = NOPASSWD: /usr/sbin/cowbuilder

Alternativ, puteți utiliza SSH cu o cheie redirecționată sau orice alt mecanism
se potrivește cu politica dvs. locală de acces. Folosind su -c nu este chiar potrivit aici din cauza ei
cerinţele de citare fiind oarecum diferite de restul.

DEBOOTSTRAP
Utilitarul de utilizat când se creează o nouă rădăcină de construcție. Alternativele sunt bootstrap or
cdebootstrap.

RETURN_DIR
Dacă este setat, fișierele pachet rezultate din compilare vor fi copiate în calea (locală sau
remote) la care este setat, după finalizarea construcției. Calea trebuie să existe, ea
nu va fi creat. Această opțiune este dezactivată în mod implicit și poate fi înlocuită cu
--întoarcere or --fără întoarcere.

Arc si dist specific Opțiuni
Acestea sunt variabile de forma: $arch_$dist_VAR care se aplică numai pentru o anumită țintă
arch/dist build.

arhi_dist_RESULT_DIR
Calea directorului de pe mașina de construcție unde pachetele rezultate (sursă și
binar) vor fi găsite și unde versiunile mai vechi ale pachetului care au fost construite
anterior poate fi găsită. Dacă există astfel de pachete mai vechi, debdiff va fi obișnuit
comparați noul pachet cu versiunea anterioară după finalizarea construcției și
rezultatul va fi inclus în jurnalul de construcție. Fișierele din acesta trebuie să fie citite de către
BUILDD_USER pentru verificarea sanatatii cu lintian(1) și debdiff(1), și pentru încărcare cu
dput(1). Dacă această opțiune nu este specificată pentru o combinație de arc și distanță, atunci
va fi implicit $PBUILDER_BASE/$arch/$dist/rezultat

arhi_dist_BASE_PATH
Directorul în care se găsesc fișierele master CoW (sau creat dacă
--crea a fost trecută opțiunea de linie de comandă). Dacă această opțiune nu este specificată pentru unii
arch sau dist, atunci va fi implicit $PBUILDER_BASE/$arch/$dist/base.cow

arhi_dist_BASE_DIST
Numele de cod care trebuie transmis ca --distributie opțiune pentru cowbuilder în loc de dist.
Acest lucru este necesar atunci când dist este un nume semnificativ la nivel local atribuit unora
build chroot special configurat, cum ar fi „wheezy_backports”, și nu cel formal
numele suită al unei versiuni de distribuție cunoscută pentru debootstrap. Această opțiune nu poate fi
suprascris pe linia de comandă, deoarece rareori, dacă vreodată, ar avea sens
schimba-l pentru invocari individuale ale cowpoke. Dacă această opțiune nu este specificată
pentru o combinație arc și distanță, atunci va fi implicit dist.

arhi_dist_CREATE_OPTS
O matrice bash care conține opțiuni suplimentare la care să se transmită text constructor de vaci Când asta
chroot este creat pentru prima dată (folosind programul --crea opțiune). Acest lucru este util
când opțiunile ca --altă oglindă se dorește să creeze chroot specializat
configurații precum „wheezy_backports”. În mod implicit, acesta este nesetat. Toate valorile
setat în el va fi anulat dacă --create-optează opțiunea este transmisă la comandă
linia.

Fiecare element din această matrice corespunde unui singur argument (în sensul ARGV)
care va fi trecut la cowbuilder. Acest lucru asigură că argumentele care pot conține
spații albe sau au cerințe ciudate de citare sau alte caractere speciale vor
să nu fie stricat înainte de a ajunge la cowbuilder.

Matricele Bash sunt inițializate folosind următoarea formă:

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

arhi_dist_UPDATE_OPTS
O matrice bash care conține opțiuni suplimentare la care să se transmită text constructor de vaci de fiecare data
baza acestui chroot este actualizată. Se comportă similar cu CREATE_OPTS opțiune
mai sus, cu excepția faptului că acționează atunci când chroot-ul este actualizat.

arhi_dist_BUILD_OPTS
O matrice bash care conține opțiuni suplimentare la care să se transmită text constructor de vaci de fiecare data
se realizează o construcție a pachetului în acest chroot. Acest lucru este util atunci când doriți să utilizați
vreo optiune ca --de două ori de care cowpoke nu trebuie să-i pese direct. Aceasta
altfel se comportă similar cu UPDATE_OPTS mai sus cu excepţia faptului că acţionează în timpul
faza de construire a constructor de vaci.

arhi_dist_SIGN_KEYID
O modificare opțională specifică arcului și distanței pentru global SIGN_KEYID opțiune.

arhi_dist_UPLOAD_QUEUE
O modificare opțională specifică arcului și distanței pentru global UPLOAD_QUEUE opțiune.

CONFIGURARE DOSARE

/etc/cowpoke.conf
Opțiuni de configurare globale. Va suprascrie valorile implicite codificate.

~/.cowpoke
Opțiuni de configurare per utilizator. Va suprascrie orice configurație globală.

.cowpoke
Opțiuni de configurare per proiect. Va suprascrie pe orice utilizator sau global
configuratie daca cowpoke este apelat din directorul în care există.

Dacă variabila de mediu COWPOKE_CONF este setat, specifică un suplimentar
fișier de configurare care le va înlocui pe toate cele de mai sus. Opțiuni specificate
în mod explicit pe linia de comandă, suprascrieți toate fișierele de configurare.

CONSTRUCTOR DE VACI CONFIGURARE

Nu este nimic deosebit de necesar pentru a configura a constructor de vaci exemplu pentru utilizare
cu cowpoke. Pur și simplu creați-le în aroma de care aveți nevoie cu `constructor de vaci --crea`
in conformitate cu constructor de vaci documentație, apoi configurați cowpoke cu utilizatorul, arc și
informațiile de cale necesare pentru a-l accesa, pe mașinile de pe care doriți să o invocați (sau
configurați alternativ cowpoke cu traseu, arc și informații despre distribuție și trecere
il --crea opțiune la aceasta la prima invocare). Gazda de compilare rulează constructor de vaci
nu necesită cowpoke instalat local.

Mașina de construcție ar trebui să aibă lintian si devscripturi pachete instalate pentru post-build
verificarea sanatatii. La finalizare, jurnalul de construire și rezultatele verificărilor automate vor fi
fi înregistrate în INCOMING_DIR. Dacă doriți să încărcați pachete semnate, mașina de construcție
va avea nevoie de asemenea dput(1) instalat și configurat pentru a utiliza „gazdă' alias specificat de
UPLOAD_QUEUE. Dacă rsync(1) este disponibil atât pe mașina locală, cât și pe mașina de construcție, atunci va fi
poate fi folosit pentru a transfera pachetul sursă (acest lucru poate economisi unele transferuri ale orig.tar.*
la construirea versiunilor ulterioare Debian).

Utilizatorul care execută cowpoke trebuie să aibă acces SSH la mașina de compilare ca BUILDD_USER.
Acest utilizator trebuie să poată invoca constructor de vaci ca rădăcină folosind BUILDD_ROOTCMD. Semnare
cheile nu trebuie să fie instalate pe mașina de construcție (și vor fi ignorate acolo dacă
sunt). Dacă pachetul este semnat, cheile vor fi așteptate pe mașina care se execută
cowpoke.

Cand cowpoke este invocat, va încerca mai întâi să actualizeze constructor de vaci imagine dacă asta are
nu a fost deja făcută în aceeași zi. Acest lucru este verificat de prezența sau absența unui
cowbuilder-$arch-$dist-update-log-$date de fișier în INCOMING_DIR. Puteți muta, elimina,
sau atingeți acest fișier dacă doriți ca imaginea să fie actualizată mai mult sau mai rar decât atât. Este
conținutul înregistrează ieșirea din constructor de vaci în timpul actualizării (sau creării) rădăcinii de compilare.

NOTE

Întrucât constructor de vaci creează un chroot și pentru a face asta aveți nevoie de root, cowpoke necesită, de asemenea
un anumit grad de acces la rădăcină. Deci toate lucrurile oribile care pot merge prost cu asta pot
ei bine, într-o zi ploua peste tine. constructor de vaci se știe că șterge accidental legătura
sisteme de fișiere montate în afara chroot-ului și mai rău decât asta se poate întâmpla cu ușurință. Așa să fie
Atenție, păstrați copii de siguranță bune ale lucrurilor pe care nu doriți să le pierdeți pe mașina dvs. de construcție și utilizați
cowpoke pentru a păstra toate acestea pe o mașină care nu este cutia ta de dezvoltare de vârf cu ultima ta
câteva ore de muncă neangajată.

Utilizați cowpoke online folosind serviciile onworks.net