preskoči na sadržaj
.
| Zadnja izmjena 9. 2. 2012. u 15:10 sati |

Politika izrade CARNetovih programskih paketa

Autor: Božo Juretić , Grupa za izradu paketa (23.12.2004.)

Pregled dokumenta

Popis paketa
Slanje zahtjeva za izdavanjem programskog paketa
Predaja paketa na testiranje
Davanje podrške za izrađene pakete
Primarni i sekundarni održavatelj
Rokovi izrade paketa
Testiranje programskih paketa (QA - Quality Assurance)
Računala za izradu i testiranje paketa
Općenite tehničke napomene za izradu paketa
Slanje pohvala i kritika

Dodaci

Dodatak A - popis CARNetovih programskih paketa
Dodatak B - popis održavatelja s programskim paketima koje održavaju
Dodatak C - primjer slanja molbe za testiranje programskih paketa
Dodatak D - primjeri kontrolnih i ostalih nužnih datoteka u CARNetovim programskim paketima

Posebni dodatak - korisni linkovi za izradu paketa


Popis paketa

Popis paketa koje izrađuje grupa za izradu CARNetovih programskih paketa dostupan je u Dodatku A.

Osim navedenih paketa, voditelj grupe može dopustiti izradu i dodatnih programskih paketa, ukoliko procjeni kako su nužni za pružanje kvalitetne programske podrške na CARNetovim mrežnim poslužiteljima.


Slanje zahtjeva za izdavanjem programskog paketa

Zahtjev za izradu novog programskog paketa upućuje se voditelju grupe za izradu programskih paketa, a u zahtjevu je potrebno navesti:

  • puni naziv paketa
  • razlog izdavanja

Paketi se izdaju kod otkrivanja sigurnosne ranjivosti u postojećem paketu, ispravljanja nedostataka u samom programskom paketu ili radi dodatne funkcionalnosti koju nosi nova verzija paketa.

Ukoliko je razlog izdavanja paketa opravdan, održavatelj šalje paket na testiranje.

Napomena:
Za ispravke pogrešaka u izvedbi samih CARNetovih paketa (greške održavatelja), kao i za izdavanje paketa koji popravljaju sigurnosne nedostatke, nije potrebno tražiti dozvolu za izdavanje, već se takvi paketi šalju direktno na testiranje.


Predaja paketa na testiranje (QA - Quality Assurance)

Paketi se predaju na testiranje slanjem e-maila na adresu paketi(at)sistemac.carnet.hr, sa
subjectom oblika:

QA: [SEC]

npr.
Subject: QA: aide-cn_1.01-1_i386.deb SEC

Ukoliko paket ispravlja sigurnosni nedostatak, potrebno je na kraj subjecta poruke navesti i SEC oznaku (vidi primjer iznad).

U tijelu poruke obavezno je navesti izvadak iz changelog-a vezan uz verziju
paketa koju se daje na testiranje, i to na hrvatskom. Na primjer:

apache (1.3.29-3) stable; urgency=medium

* init skripte uvijek koriste /sbin/sh, izbacene ksh konstrukcije.
* Sigurnosna ispravka koda


-- Zoran Dzelajlija Wed, 21 Jan 2004 13:31:40 +0100

Pri zadavanju paketa na testiranje navodi se i vrijeme izlaska upstream izvodnog koda, i to na način da se u tijelu poruke navede linija oblika:

UPSTREAM: 20040222

Primjer cjelokupnog maila pogledati u Dodatku C.

Osim predavanja paketa na testiranja, potrebno je paket uspjesno instalirati na lokalno računalo, te ga iskopirati u lokalni APT repozitorij. Lokaciju lokalnog APT repozitorija određuju kontrolori paketa, te je objavljuju na distribucijskoj listi.


Davanje podrške za izrađene pakete

Održavatelju su dužni pružati podršku e-mailom za programske pakete koje održavaju, a upiti su valjani samo ukoliko su ih održavateljima preusmjerili djelatnici CARNetovog helpdeska za sistem-inženjere.

Pri odgovaranju na opite koristi se TT sustav kojega koristi CARNetov helpdesk za sistem-inženjere, dostupan ovdje.


Primarni i sekundarni održavatelj

Svaki programski paket ima određenog primarnog i sekundarnog održavatelja. Popis primarnih i sekundarnih održavatelja za sve pakete dostupan je u Dodatku B.

Primarni održavatelj održava paket, no ukoliko zakaže u svojim dužnostima njegov paket preuzima sekundarni održavatelj. Ukoliko primarni održavatelj dva puta uzastopce ne ispuni svoje dužnosti, primarni održavatelj paketa postaje do sada sekundarni.

Paket privremeno preuzima sekundarni održavatelj također ukoliko primarni ne izradi programski paket 2 dana nakon maksimalnog vremena izrade paketa za sigurnosne ispravke, odnosno 5 dana u slučaju normalnih paketa.


Rokovi izrade paketa

Pakete koji ispravljaju sigurnosne nedostatke potrebno je izraditi u roku od 3 dana nakon objavljivanja ispravljene verzije izvornog koda, odnosno ispravljenog Debian paketa sa security.debian.org.

Normalne pakete potrebno je izraditi u roku od 10 dana nakon što je dopuštena izrada programskog paketa.


Testiranje programskih paketa (QA - Quality Assurance)

Testiranje se obavlja na temelju zahtjeva za testiranjem poslanog na distribucijsku listu, s pravilno formatiranim naslovom i tijelom poruke.

Paket će pregledati dva neovisna kontrolora, te utvrditi dali programski paket ispravno funkcionira.

Kada prvi kontrolor paketa ustvrdi da je paket ispravno izrađen te da funkcionira kako bi trebao, putem distribucijske liste obaviještava održavatelja i ostale, korištenjem posebno označenog naslova poruke:

npr.
FAIL: mysql-cn_4.0.16-2_all.deb
ili
PASS: openssl-cn_0.9.7c-5_all.deb

PASS u naslovu poruke znači da paket ispravno funkcionira, dok FAIL označava da postoje problemi u implementaciji paketa, pa je isti paket održavatelj dužan i popraviti.

Dok god prvi kontrolor ne objavi kako je paket prošao njegovu kontrolu kvalitete, te dok isto ne potvrdi i drugi kontrolor u drugom stupnju kontrole, paket se ne objavljuje na CARNetovom FTP poslužitelju.

Kada je paket prošao prvi i drugi stupanj kontrole kvalitete na distribucijsku listu se šalje obavijest s naslovom

FTP: openssl-cn_0.9.7c-5_all.deb

te se paket objavljuje se na FTP-u.

Napomena:
Kontrolori paketa dužni su pakete poslane na testiranje koji ispravljaju sigurnosne nedostatke pregledati u roku od 1 radni dan od slanja u slučaju sigurnosnih ispravki, odnosno u roku od 2 radna dana u slučaju normalnih paketa.


Računala za izradu i testiranje paketa

Paketi se testiraju na računalima:

java.srce.hr - Intel CARNet Debian 1
testd2.srce.hr - Intel CARNet Debian 2
xterm6.srce.hr - Sparc CARNet Debian 2


Općenite tehničke napomene za izradu paketa

Imenovanje paketa

CARNetovi paketi nazivaju se po pravilu: -cn_-_-.deb

Depends i binary paketi

Ukoliko paket postoji u Debianovoj standardnoj distribuciji, CARNetov paket se na njega Dependa, a eventualne izmjene se vrše u postinstalacijskoj skripti CARNetovog paketa . Ukoliko paket ne postoji u Debianovoj distribuciji, ili je potrebno napraviti izmjene koje se ne mogu izvesti korištenjem mehanizma ovisnosti, izrađuje se paket koji nosi i binarne datoteke. Potrebno je paziti da se ispravno podese kontrolna polja (provides, replaces ...).

U control datoteci CARNetovog programskog paketa kao održavatelj se upisuje CARNetov održavatelj.

Ukoliko je za normalan rad paketa potreban još neki program, potrebno je koristiti mehanizam ovisnosti i više paketa, a ne pakiranje unutar istog programskog paketa.

Za svaku akciju na poslužitelju u postinst i prerm skriptama potrebno je provjeriti dali se mogu zadovoljiti uvjeti odvijanja te akcije (npr. postojanje fajlova, direktorija, potrebnih dozvola...).

Objava na FTP-u

Nakon izdavanja paketa, računa se md5 kontrolna suma paketa i upiše u datoteku md5sums u odgovarajućem poddirektoriju FTP stabla.

Izrada binary paketa

Kod izrade binary paketa održavatelji se ravnaju po uputama Debian Policy Manual-u.

Sve iznimke u kojima se održavatelji ne moraju pridržavati tog dokumenta biti će navedene posebno.


Kontakt - pohvale, kritike i dodatni upiti

S voditeljem grupe je moguće kontaktirati putem e-maila paketi-owner@bjesomar.srce.hr te mu uputiti pohvale i primjedbe na rad grupe za izradu programskih paketa, a on je na poslane e-mailove dužan i odgovoriti.

Službene odgovore o radu grupe za izradu programskih paketa može dati samo voditelj grupe.


Dodatak

Korisni linkovi za izradu paketa:

Razvojna sekcija na Debianovim stranicama - mnogo korisnih stvari za učenje izrade paketa.

New Maintainer's Guide - ovaj dokument opisuje pravljenje Debian paketa uobičajenim jezikom, i sadrži puno primjera koji rade. Ako želite biti razvijatelj (održavatelj paketa), sigurno ćete željeti ovo pročitati.

Filesystem Hierarchy Standard - standard rasporeda datoteka kojega je potrebno slijediti

Debian Policy Manual - dosta dijelova CARNetove politike je napravljeno po uzoru na Debianovu politiku ozrade programskih paketa


 
podrska@raspored-sati.hr jpetric@raspored-sati.hr petra.bradara@raspored-sati.hr webmaster@raspored-sati.hr pbenko@raspored-sati.hr gmarks@raspored-sati.hr admin@donja-dubrava.hr filip.lesic@donja-dubrava.hr jkovicic@donja-dubrava.hr racunovodstvo@donja-dubrava.hr benkovic@donja-dubrava.hr anamarija.peric@donja-dubrava.hr markovic@donja-dubrava.hr hrvoje@donja-dubrava.hr marijana@marijana-tkalec1.from.hr marijana.tkalec@marijana-tkalec1.from.hr mt@marijana-tkalec1.from.hr info@shire.zemris.fer.hr admin@shire.zemris.fer.hr info@laold.internetsegura.pt admin@laold.internetsegura.pt http://marijana-tkalec1.from.hr http://web.marijana-tkalec1.from.hr http://www.marijana-tkalec1.from.hr http://shire.zemris.fer.hr http://laold.internetsegura.pt
preskoči na navigaciju