Etersoft-build-utils howto

HOWTO по сопровождению пакетов с помощью etersoft-build-utils

Данные ситуации описываются для сборки пакетов из git-репозитория, но для сборки старым способом (через ~/RPM/SPECS/спек) они применяются совершенно также.

Применение etersoft-build-utils позволяет резко снизить порог вхождения в сборку пакетов, увеличить скорость выполнения рутинных действий, снизить количество ошибок за счёт встроенных проверок и алгоритмизации типичных действий мантейнеров. Целью создания набора команд из этого пакета было создать высокоуровневую обвязку над существующими низкоуровневыми инструментами.

Описывается версия etersoft-build-utils 1.7.6.

Основные преимущества:

• автоматическое бэкпортирование
• автоматизирование отправки на сборку
• автоматическая установка собранного пакета на проверку
• автоматическое обновление пакета до следующей версии исходников

Все команды выполняются в каталоге репозитория, как правило в том же каталоге, где лежит спек. Для получения описания всех параметров, допустимых для команды, её нужно вызвать с параметром -h. Для указания сборки для бранча, нужно задать его параметром -M51 (-M50 и т.п.).

Получение готового к сборке репозитория

С чего начинаем, чтобы получить репозиторий.

Проверка наличия пакета в Сизифе

$ rpmgp -c название_пакета

Команда выведет доступные репозитории у разных пользователей с этим пакетов, указав дату последнего изменения в репозитории. Если пакет установлен в системе, или вместо названия пакета указан файл спека, то будет проверено наличие данной версии пакета в Сизифе. Это удобно для выявления необходимости пересборки пакета.

Результат: выведенная в консоль информация о пакете.

Подхватываем пакет, уже собранный в Сизиф

$ rpmgp -g название_пакета

Команда возьмёт репозиторий, из которого последний раз пакет собирался в Сизиф (из git.alt /srpms или /gears), клонирует в git.alt:packages/название_пакета.git, из git.alt клонирует локально (создав репозиторий в текущем каталоге), причём все имеющиеся ветки.

Эта команда удобна для быстрого перехода со сборки по устаревшей схеме на git.

Результат: локальный и удалённый репозитории с последней версией пакета.

Берём имеющийся src.rpm для ALT

$ rpmgp -m файл.src.rpm

или

$ rpmgp -m спек

Команда создаст репозиторий с названием пакета в текущем каталоге (можно задать переменной GITREPODIR и импортирует в него указанный пакет с помощью gear-srpmimport.

Результат: локальный git-репозиторий с пакетом.

Берём src.rpm от другого дистрибутива

$ rpmgp -m файл.src.rpm

Команда будет вести себя также, как и для src.rpm из ALT Linux. Как минимум в пакете нужно почистить спек и привести его надлежащему виду командой

$ rpmcs спек

После автоматической конвертации спека его нужно привести в соответствие принятым в ALT Linux требованиям к спеку. TODO: ссылку.

Результат: локальный git-репозиторий с пакетом.

Сборка пакета

Собрать пакет в системе

$ rpmbb спек

Если нужно отладить только шаг установки файлов, достаточно запускать

$ rpmbb -i спек

Если нужно отладить только шаг упаковки пакета, достаточно запускать

$ rpmbb -p спек

Результат: собранный пакет в ~/RPM/RPMS.

Собрать пакет в hasher

$ rpmbsh спек

Пакет будет собран в hasher. После сборки над пакетом будут произведены проверки.

Результат: собранный пакет в ~/hasher-SS/repo/i586/RPMS.hasher/.

Для установки в тестовый hasher (для ручной проверки работоспособности пакета) после сборки пакета и последующей отправки на сборку:

$ rpmbsh -i -u спек

Компиляция исходников

В случае ручного запуска компиляции (например внутри ~/RPM/BUILD) удобно использовать команду jmake. Она соберёт с использованием всех ядер (параметр -j для make), невысоким приоритетом (nice)и задействует ccache для ускорения повторных сборок.

Отправка пакета на сборку

Отправить пакет на сборку в Сизиф

$ rpmbs -u спек

Будет создан тег, соответствующей текущему состоянию пакета, репозиторий опубликован (удалённый репозиторий будет создан при необходимости) и создано задание на сборку по тегу (вида VERSION-RELEASE).

Результат: созданное задание на сборку пакета.

Бэкпортировать в 5.1 и отправить

$ rpmbph -u -M51 спек

Команда обновит ветку M51 из текущей (создаст ветку M51, если её ещё не было), сконвертирует текущий спек (предложив посмотреть на выполненные изменения, от которых можно отказаться нажатием Ctrl-\ перед выходом кнопкой q), соберёт полученный репозиторий локально и отправит пакет на сборку в соответствующий бранч. Параметр -n запретит сборку локально (используйте только, если уверены в том, что всё будет хорошо).

Как правило, лучше использовать

$ rpmbph -i -u -M51 спек

После сборки пакета локально он будет установлен в тестовый репозиторий, где можно убедиться в его работоспособности.

Результат: созданное задание на сборку пакета.

Обновление пакета

Обновление исходников

Если в Source указан URL к файлу с исходниками, команда

$ rpmgs спек новая_версия

скачает их автоматом, перебрав все возможные варианты форматов и сконвертировав в tar (tar.bz2), если в Source указано расширение .tar ( .tar.bz2).

Рассказать про Source-url, Source-svn в случае нестандартных ситуаций.

TODO: Source-git

TODO: команды для выборочной упаковки / исключения файлов

Для сборки старым способом рекомендуется устанавливать расширение для файлов в Source в tar.bz2.

Для сборки через git рекомендуется указывать .tar (одновременно нужно сменить указание способа архивации и в ~/.gear/rules).

Результат: обновление каталога с исходниками в виде одного коммита.

Автоматическое обновление

Если в спеке правильно указан URL в Source, и в новой версии не произошло изменений в структуре файлов, достаточно выполнить команду

$ rpmrb спек новая_версия

Она выполняет достаточно простые действия, выполняя последовательно команды rpmgs, rpmbsh -i, rpmbs: скачивает новые исходники, обновляет спек, собирает пакет в hasher, ставит собранный пакет в тестовый hasher и предлагает командную строку для тестирования пакета. После выхода из тестирования проверяется отсутствие проблем при удалении пакетов (проверка post-скриптов) и пакет отправляется на сборку в Сизиф.

Результат: собранный и проверенный пакет, задание на сборку пакета.