Innhold
1 Les retningslinjene
Hvis du ikke vet hvordan man lager en RPM-pakke, les følgende web-sider fra Fedora:
Les følgende dokumenter:
Disse dokumentene autoritative for pakker i UiOs yum-repo.
2 Meld deg på e-postlisten
Vi har en e-postliste pkg-devel for maintainers og ev. andre interesserte. Alle som pakkeeiere skal være medlem av denne listen. For å melde deg på, klikk på lenken under:
Du må ha en UiO-adresse for å melde deg på.
Det finnes også en e-postliste hvor det commits fra Git-repository sendes:
Det er valgfritt om man vil melde seg på pkg-commits.
3 Sjekk at pakken din passer
Pakken kan være ethvert fritt open source-program, men du må sjekke følgende:
- At pakken ikke finnes i uio-free fra før
- At pakken ikke finnes i uio-nonfree fra før
- At pakken ikke finnes i RHEL
- At pakken ikke finnes i EPEL
I tillegg gjelder følgende hvis pakken finnes for Fedora, men ikke i EPEL:
- Lag en sak i Red Hats Bugzilla for den aktuelle pakken, der du ber om å få den tilgjengelig i EPEL.
- Vent minst en måned på svar fra pakkens maintainer i Fedora.
- Kun dersom det ikke er aktuelt å tilby pakken for EPEL kan pakken lages for uio-free.
For at pakken skal kunne gjøres tilgjengelig i uio-free må den ikke inneholde deler med en proprietær lisens, eller noe annet som gjør det umulig å gjøre den tilgjengelig for hele verden. Vi har et repository uio-nonfree for pakker som vi enten ikke kan eller ikke vil dele med alle andre.
4 Lag en pakke
Lag en ferdig RPM-pakke, der du følger Retningslinjer for pakking og Retningslinjer for pakkenavn. Dersom du ikke vet hvordan man lager en pakke, se A Short RPM Tutorial og How to create an RPM package.
5 Gjør pakken tilgjengelig for review
Last opp den ferdigbygde pakken, SRPM-fila og SPEC-fila et sted hvor vi kan få tak i dem. For eksempel kan du laste dem opp under ditt eget web-område på hjemmeområdet:
mkdir ~/www_docs/<pakkenavn> mv <rpm-pakke> <srpm-pakke> <spec-fil> ~/www_docs/<pakkenavn> chmod -R a+rX ~/www_docs/<pakkenavn>
Dette vil gjøre filene tilgjengelig under følgende URL: http://folk.uio.no/<brukernavn>/<pakkenavn>/.
6 Be om review av pakken
Send en e-post til pkg-core@usit.uio.no og be om review.
7 Vent på svar
Nå må du vente på review av pakken. Rett opp eventuelle feil i pakken, og vurder og diskuter ev. forslag til endringer. Når pakken er godkjent, vil følgende skje:
- Du får opprettet en konto i Koji slik at du kan bygge pakken der
- Du får et git-repo for pakken
8 Installer verktøy for bygging
Vi bruker verktøyet koji til å bygge pakker. Dette må installeres, slik:
yum -y install koji
Du må også lage en fil ~/.koji/config som inneholder følgende:
[koji] ;configuration for koji cli tool ;set authentication type authtype = ssl ;url of XMLRPC server server = http://koji.uio.no/kojihub ;url of web interface weburl = http://koji.uio.no/koji ;path to the koji top directory topdir = /mnt/koji ;configuration for SSL authentication ;client certificate cert = ~/.koji/client.crt ;certificate of the CA that issued the client certificate ca = ~/.koji/clientca.crt ;certificate of the CA that issued the HTTP server certificate serverca = ~/.koji/serverca.crt
Når du får opprettet koji-konto, får du tildelt fire filer:
- client.crt
- clientca.crt
- serverca.crt
- <brukernavn>_browser_cert.p12
Disse filene skal legges under katalogen ~/.koji, og ikke være lesbare for andre enn deg:
mv {client,clientca,serverca}.crt *.p12 ~/.koji/ chmod 0600 ~/.koji/*
Når dette er gjort kan du bruke koji til bygging m.m.:
$ koji list-targets Name Buildroot Destination --------------------------------------------------------------------------------------------- uio-el6-free uio-el6-free-build uio-el6-free-testing
For å bruke web-grensesnittet til Koji, må du importere "<brukernavn>_browser_cert.p12" inn i Firefox slik som beskrevet her: Installing SSL Certificates in Firefox. Passordet til sertifikatet skal du ha fått per e-post.