Pagan Linux – kanał rolling (od 1.0.0)
Dokument opisuje model wydawniczy, który builder obsługuje od 1.0.0, oraz to, co trzeba zrobić, żeby opublikować snapshot. Powstał razem ze zmianami w build-pagan.sh (blok „KANAŁ WYDAWNICZY”) i skryptem rolling-release.sh.
1. Dwa kanały
release (do 0.5.x) | rolling (1.0.0+) | |
|---|---|---|
| Wersja | numer + kryptonim („0.5.3 Mokosza”) | numer to BAZA, każdy snapshot dostaje datę |
| ISO | jest wydaniem | jest tylko snapshotem stanu repo |
| Aktualizacje | poprawki | pag upgrade na zainstalowanym systemie przewija całość |
| Nazwa artefaktu | Pagan-…-0.5.3-Mokosza-xfce.iso | Pagan-…-1.0.0-Rolling-20260926-xfce.iso |
Etykieta woluminu w obu kanałach zostaje PAGANLIVE – zależy od niej boot (search --label). Zmienia się wyłącznie nazwa pliku i tekst pozycji menu.
2. Numeracja i dlaczego działa
Wersja pakietów wydania (pagan-release, pagan-wallpapers):
release 0.5.3 → bez zmian
rolling 1.0.0.20260926 → baza + snapshot (albo 1.0.0.20260926.2 dla REV=2)
pag porównuje wersje semver-owo (_cmp_version w pag/pag): brakujące komponenty traktuje jako 0, więc 1.0.0.20260926 jest nowsze niż 1.0.0 i niż 1.0.0.20260901. To jest cały mechanizm rolling: publikujemy nowy pagan-release w repo, a pag upgrade u użytkownika podnosi wersję systemu – razem z /etc/os-release, bo te pliki są własnością pakietu wydania.
3. Co konkretnie zmienia builder w rollingu
PAGAN_SLUGdostaje znacznik snapshota → wszystkie nazwy artefaktów (ISO, IMG, raporty, banner) są z datą, bez łatania każdego miejsca osobno./etc/os-release:VERSION="1.0.0 Rolling 2026.09.26",VERSION_ID="1.0.0.20260926",VERSION_CODENAME="rolling".- pozycja menu rozruchu zawiera datę (
_pag_version_label) – koniec pomyłek „bootuję 0.5.2, a mam 0.5.0”. pagan-release/pagan-wallpapersdostają numer snapshota.- Kanał
release: zero różnic (sprawdzone:pkgver=0.5.3,slug=0.5.3-Mokosza).
4. Włączanie
- Automatycznie: wersja główna ≥ 1 (czyli
PAGAN_VERSION="1.0.0 Rolling"). - Jawnie:
PAGAN_CHANNEL=rolling(środowisko albobuild.conf). - Wymuszenie starego trybu:
PAGAN_CHANNEL=release. - Znacznik snapshota:
PAGAN_SNAPSHOT=2026.09.26(stała data),PAGAN_SNAPSHOT_REV=2(drugi snapshot tego samego dnia).
5. Publikacja snapshotu
sudo ./rolling-release.sh [de] [iso|img|both] [--publish] [--remote user@vps:/var/www/repo.paganlinux.eu/stable]
- respin ISO/IMG z istniejącego rootfs (bez przebudowy pakietów i jądra),
- odświeżenie plików wydania i pakietu
pagan-release→ nowy numer snapshota, - świeże
.paglądują wrepo-out/, --publishwysyła tylko paczki (*.pag*) na VPS.
Indeksu repo.json nie generujemy lokalnie i nie wysyłamy. Robi to pagsync --gen-repo --sign na VPS, gdzie leży kompletne repo. Indeks zbudowany z niepełnego katalogu podmieniłby repo.json i zepsuł pag upgrade wszystkim użytkownikom – ta sama zasada, co w build-repo.sh.
6. Receptury (recipes/, osobne repo git)
recipes/core/pagan-release/PAGBUILD.yaml: pkgver trzymaj jako wersję bazową (1.0.0). Znacznik snapshota dokłada builder, więc nie ma potrzeby zmieniać receptury przy każdym snapshocie. Kontrola spójności w finalize_build porównuje recepturę z wersją bazową – dla rollinga to właściwe zachowanie. Pozostałe receptury bez zmian.
7. Co trzeba zgadzać ze sobą (VPS + strona)
VERSION_IDniesie snapshot (1.0.0.20260926). Jeśli strona publikuje „najnowszą wersję” do porównania, musi być to ten sam string – inaczejpagan-welcome(porównujeVERSION_IDz wersją z repo/strony) będzie twierdził coś innego niżpag upgrade.- Kategoria repo zostaje
stable(PAGAN_REPO_URLwbuild.conf), chyba że zdecydujesz się rozdzielić kanały nastable/irolling/– wtedy zmianaPAGAN_REPO_URLw obrazie, a stare systemy zostają nastable/.
8. Do dokończenia
- Blok „KANAŁ WYDAWNICZY” w
build-pagan.shleży przyinstall_pagan_release, a nie w sekcji konfiguracji na początku pliku. Powód techniczny: zmiana w tamtej sekcji przesuwa offsety działającego builda (bash czyta skrypt przyrostowo). Do przeniesienia, gdy żaden build nie działa. - Wersja 1.0.0 to baza; przy kolejnej linii wydawniczej podnieś numer w
PAGAN_VERSION(np.1.1.0 Rolling). - Edycja serwerowa: ten sam mechanizm –
./rolling-release.sh server.