zoryn — помощник мейнтейнера ALT Linux¶

Zoryn ведёт пакет от upstream-релиза до сборки в sisyphus — автоматизируя то, что можно автоматизировать, и оставляя контроль за вами.

Название происходит от древнего корня со значением свет и ясное зрение. Zoryn помогает увидеть путь сквозь лабиринт upstream-тегов, spec-файлов и очередей сборки.

В основе — две команды: zoryn up → zoryn submit. Остальное вспомогательное.

Установить Быстрый старт Команды

Руководство¶

Начните отсюда, если настраиваете zoryn впервые или масштабируете сборочную ферму.

Установка — apt-get install zoryn из Sisyphus или сборка из исходников через dune.
Быстрый старт — bootstrap ~/.zoryn и полный per-package цикл в шесть команд.
Конфигурация — ~/.zoryn, конфиг билдеров, per-package .gear/version-up, источники CVE, подсказки для merge.
Сборочная ферма — добавление удалённых hasher'ов, параллельные локальные hasher'ы, пошаговые примеры ферм на 3/4/5 архитектур.
Хуки — скрипты в .gear/merge-up.d/ и .gear/up.d/, подсветка логов, окружение.
Песочница — режимы hybrid / bwrap / direct — защита ~/.ssh и ~/.gnupg от скриптов-хуков.
Batch-конфигурация — группы связанных пакетов (PHP-extensions, OCaml-toolchains), собирающихся вместе.

Команды¶

Каждая подкоманда zoryn, сгруппированная по назначению — полный справочник.

Пакеты: clone, up, commit, submit.
Сборка: build, builder.
Задачи: task — new, ls, show, add, run, abort, approve, download, delete, refresh, rebuild, test-rebuild, batch, manage, …
Проверки: check — version, upstream, spec, packages, version-up.
Spec и тэги: spec, tag.
Генераторы: gen — opam2spec, pypi2spec, watch, environment, version-up.

Что умеет zoryn¶

zoryn up — полный пайплайн обновления: fetch → merge → spec → changelog → build. С сохранением состояния и --continue / --abort.
Сборка где угодно — локальные и удалённые hasher-машины, паттерны @all / @host:basalt, --top TUI для мониторинга.
Управление задачами — task new / add / run / approve, интерактивный TUI, колонки состояний, подсветка логов.
Проверки до submit — валидация spec, CVE-скан, sisyphus_check, проверка закрытия багов через Bugzilla.
Генераторы — opam2spec, pypi2spec, watch, version-up, environment — spec и .gear из двух команд.
Sandboxed hooks — хуки из .gear/*.d/ запускаются в bwrap + hasher chroot; ~/.ssh и ~/.gnupg остаются защищёнными.

Типичный день мейнтейнера¶

Две основные команды плюс несколько вспомогательных — от «вышел новый релиз» до subtask в sisyphus:

$ zoryn clone libnghttp2
$ zoryn up
$ zoryn submit --run
$ zoryn task manage