Перейти к содержанию
zoryn/ maintainer-assistant

Быстрый старт

От свежей установки ALT Linux до subtask в sisyphus — две команды на основном пути (zoryn upzoryn submit) плюс несколько вспомогательных в первый раз.

1. Начальная настройка

Выполняется один раз на машину разработчика. zoryn gen environment создаёт ~/.zoryn, SSH-алиасы для gitery/gyle, ~/.hasher/config, ~/.rpmmacros, и — если их ещё нет — ed25519 SSH-ключ и RSA 4096-bit GPG-ключ.

# Создать конфиги (~/.zoryn, ~/.ssh/config, ~/.hasher/config, ~/.rpmmacros, ~/.gitconfig)
zoryn gen environment

# Добавить удалённый сборочник (опционально — только если нужна не локальная сборка)
zoryn builder add

gen environment по умолчанию интерактивный; для скриптуемого провижининга — см. описание опций zoryn gen environment.

2. Работа с пакетами

Типичный цикл для одного пакета выглядит так:

# Клонировать пакет из sisyphus
zoryn clone mypackage
cd mypackage

# Обновить пакет до новой upstream-версии (fetch → merge → spec → changelog → build)
zoryn up

# Отправить в sisyphus (commit, tag, push, task new/add — одной командой)
zoryn submit

# Отправить в стабильную ветку с авто-зависимостями от заданий sisyphus
zoryn submit -B p11

# Проверить, есть ли более новая upstream-версия
zoryn check version

# Найти spec-файл в gear-репозитории
zoryn spec find

Две основные команды — zoryn up и zoryn submit — плюс вспомогательные дают готовый subtask в sisyphus. Остальное (clone, check, spec find) — обвязка для краевых случаев.

Что читать дальше

  • zoryn up — 14-стадийный пайплайн с --continue / --abort / --stage
  • zoryn submit — позиционирование сабтасков через --with, замена через --replace
  • zoryn task manage — интерактивный TUI для approve/run задач
  • Конфигурация — настроить ~/.zoryn один раз, переопределить для пакета в .gear/version-up