Backports Policy
Backports policy
Этот документ регламентирует правила оформления, сборки и публикации пакетов в стабильные репозитории ALT Linux Team.
Назначение репозитория
Репозиторий созаётся для хранения пакетов, предназначенных для формирования соответствующего семейства дистрибутивов. Для каждого семейства дистрибутивов создается отдельный репозиторий. Список репозиториев можно получить, например, с помощью команды сборочнице task new --help
В настоящее время это c9f1, c9f2, c9m2, p8, p9 и p10.
Часть пакетов репозитория не изменяется с момента его возникновения, несмотря на выход новых версий, другая часть — обновляется или как минимум модифицируется (например, из соображений безопасности).
«Копирование» пакетов
Если возможна успешная сборка пакета из исходников, полностью совпадающих с аналогичным пакетом в Sisyphus (т. е. имеющим тот же Source ID), например, из того же тега в git-е, рекомендуется пользоваться механизмом сборочницы task … copy.
В этом случае ничего в спеке менять не надо (иначе это приведёт к изменению Source ID), пакет будет пересобран и помещён в репозиторий с тем же идентификатором Name-Epoch-Version-Release (NEVR), что и в исходном репозитории.
Полученный таким образом бинарный пакет будет заведомо отличаться от исходного, в том числе полями disttag и %_priority_distbranch, которые будут определять его приоритет при обновлении.
Оформление бекпорта
Если пакет невозможно собрать в стабильный репозиторий без изменения исходных текстов — требуются патчи, изменения списка зависимостей или названия инструментов в спеке, модификация документации и т. п. — пакет обязан иметь другой NEVR, конкретно — отличаться полем «Release».
Требования к полю Release:
- Отличие должно быть (разные исходники — разные NEVR)
- Релиз бекпорта должен быть версионно меньше релиза исходного пакета
Рекомендации по именованию релиза:
- Предлагается формат «(Исходный_релиз-1).(Название_репозитория).(Релиз_в_репозитории)»
- Например, если исходный релиз был «-alt1», то релиз в репозитории p10 будет равен «-alt0.p10.1».
- Бывают случаи (например, «-alt0.git0ea78d»), когда правило «-1» не срабатывает — здесь поможет только здравый смысл.
- (возможно, здравый смысл стоило проявить ранее, и в исходном пакете добавить .1 — «-alt0.git0ea78d.1»)
- Если пакет приходится сопровождать в рамках репозитория, изменяется часть «Релиз_в_репозитории».
- В первом примере выше после очередных правок того же пакета его релиз станет «-alt0.p10.2».
- При очередном бекпорте нового релиза из исходного репозитория продолжает соблюдаться правило «-1», а поле «Релиз_в_репозитории» сбрасывается в 1
- Например, если в предыдущем примере было принято решение о бекпортировании следующего релиза «-alt2», то поле «Release» в p10 будет равно «-alt1.p10.1».
В остальном спек оформляется согласно общим правилам.
Сборка
- Сборка пакета в стабильный репозиторий отличается только указанием названия репозитория в командах сборочницы.
- Как правило, права на сборку в стабильный репозиторий есть не у всех членов Team, и соответствующее успешное задание должно быть одобрено командой, сопровождающей конкретный репозиторий (например, сначала пройти тестирование).