PaganOS Luna 0.6.0
PL EN DE
🔒 Repository is read-only – file editing is disabled.

PaganLinux/ROLLING.md main

97 lines Raw ← Back

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_SLUG dostaje 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-wallpapers dostają 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 albo build.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]
  1. respin ISO/IMG z istniejącego rootfs (bez przebudowy pakietów i jądra),
  2. odświeżenie plików wydania i pakietu pagan-release → nowy numer snapshota,
  3. świeże .pag lądują w repo-out/,
  4. --publish wysył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_ID niesie snapshot (1.0.0.20260926). Jeśli strona publikuje „najnowszą wersję” do porównania, musi być to ten sam string – inaczej pagan-welcome (porównuje VERSION_ID z wersją z repo/strony) będzie twierdził coś innego niż pag upgrade.
  • Kategoria repo zostaje stable (PAGAN_REPO_URL w build.conf), chyba że zdecydujesz się rozdzielić kanały na stable/ i rolling/ – wtedy zmiana PAGAN_REPO_URL w obrazie, a stare systemy zostają na stable/.

8. Do dokończenia

  • Blok „KANAŁ WYDAWNICZY” w build-pagan.sh leży przy install_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.