Сборка пакетов (etersoft-build-utils): различия между версиями

Материал из ALT Linux Wiki
Нет описания правки
Строка 138: Строка 138:
|выполнить секцию установки и упаковать пакет, пропустив компиляцию
|выполнить секцию установки и упаковать пакет, пропустив компиляцию
|-
|-
|rpmrb спек [ новая_версия ]
|rpmrb спек {{nobr|[ новая_версия ]}}
|
|
|
|
|для указанного спека скачивает архив с исходниками новой (указанной) версии, собирает в hasher и устанавливает в тестовый hasher, после выхода из которого предлагает выложить в Incoming
|для указанного спека скачивает архив с исходниками новой (указанной) версии, собирает в hasher и устанавливает в тестовый hasher, после выхода из которого предлагает выложить в Incoming
|-
|-
|rpmgs спек [ новая_версия ]
|rpmgs спек {{nobr|[ новая_версия ]}}
|
|
|
|
Строка 165: Строка 165:
|rpmcs спек
|rpmcs спек
|cleanup_spec
|cleanup_spec
|-
|
|привести спек к стандартам ALT Linux
|привести спек к стандартам ALT Linux
|-
|-
Строка 174: Строка 174:
|}
|}


Ключ -r указывает произвести сборку на удалённом сервере
* Ключ -r указывает произвести сборку на удалённом сервере
Ключ -u указывает отправить в инкоминг после сборки (-U — в Updates, а не backports)
* Ключ -u указывает отправить в инкоминг после сборки (-U — в Updates, а не backports)
Также есть команда loginhsh для входа в (тестовый) hasher.
* Также есть команда loginhsh для входа в (тестовый) hasher.


== Использование ccache ==
== Использование ccache ==

Версия от 06:42, 19 марта 2009

Краткая инструкция по сборке пакетов с помощью etersoft-build-utils

Freesource-logo.png Blue Glass Arrow.svg MediaWiki logo.png
Эта страница была перемещена с freesource.info.
Эта страница наверняка требует чистки и улучшения — смело правьте разметку и ссылки.
Просьба по окончанию убрать этот шаблон со страницы.


Здесь рассмотрена процедура сборки RPM- пакетов для ALT Linux. Это облегчённая инструкция для начинающих разработчиков, написанная с учётом использования пакета etersoft-build-utils. Сборка пакетов RPM и DEB в других системах.

Первоначальная настройка

С правами root

Устанавливаем пакеты, необходимые для сборки:

# apt-get install etersoft-build-utils

Данный пакет «вытянет» по зависимостям всё остальное, обычно необходимое при сборке.

Под пользователем

Исправляем данные о сборщике в файле ~/.rpmmacros. Вот, например, содержимое моего файла ~/.rpmmacros:

%_topdir        %homedir/RPM
%_tmppath       %homedir/tmp
%_gpg_path %homedir/.gnupg
%_gpg_name Vitaly Lipatov <lav@altlinux.ru>
%packager Vitaly Lipatov <lav@altlinux.ru>

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

ВНИМАНИЕ! Сборка принципиально невозможна под учётной записью root.

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

Образец того, как надо оформлять спек, вы можете посмотреть в пакете wcalc или gnubiff. Настоятельно рекомендуется обратиться к документации, а также смотреть «как это сделано в другом пакете». Получить src.rpm для установленного в систему пакета можно командой $ rpmgp название_пакета Также образцы спеков для разных типов пакетов доступны здесь.

Подготовка уже имеющегося src.rpm

Устанавливаем файл *.src.rpm, который хотим собирать (под пользователем):

$ rpm -i название*.src.rpm

Исходники пакета при этом разместятся в ~/RPM/SOURCES, а спек — в ~/RPM/SPECS.

Заходим в каталог ~/RPM/SPECS, и видим там спек для собираемого пакета. Если спек взят из другого дистрибутива, то сначала делаем

$ rpmcs название.spec

чтобы привести спек в пригодный для использования вид. Далее его нужно поправить вручную, используя взятый из ALT Linux пример спека в качестве образца.

Сборка пакета «с нуля»

Вы должны разместить исходники пакета (архивы) в ~/RPM/SOURCES, а шаблон будущего спека (скопированный из образца) — в ~/RPM/SPEC.

Типовые действия

Находясь в каталоге SPEC:

$ rpmbb название.spec

для сборки двоичного пакета (он будет создан в ~/RPM/RPMS)

$ rpmbb -r название.spec

для того, чтобы в пакет автоматически прописались зависимости на пакеты, необходимые при сборке. Если пересобирается уже имеющийся пакет из Сизифа, то это не обязательно. (см. также Использование buildreq)

$ add_changelog название.spec

для добавления строчки о данной сборке в секцию %changelog, в конце спека. После этого следует в спеке дописать комментарий, какие изменения были сделаны в данной сборке. Иногда также бывает удобно сразу указать список изменений:
$ add_changelog example.spec -e 'Initial build'
Более подробно об использовании этого скрипта вы можете узнать здесь: http://wiki.sisyphus.ru/devel/spectips/addchangelog

Сформированные зависимости (строчка BuildRequires) нужно просмотреть, чтобы там не было ненужных пакетов. Правильность сборки проверяется пересборкой готового пакета в hasher (см. ниже).

Ошибки при сборке

Для начала, нужно локализовать проблему — определить, является ли она проблемой конкретного дистрибутива/системы (например: отсутствие или неверная версия необходимых для сборки библиотек, специфика дистрибутива) или более глобальной (например: несобираемость определённой версией компилятора, ошибки в коде, несоответствие кода новым стандартам).

В первом случае, поможет осуществить поиск по дистрибутиву/репозиторию, поискать решение проблемы в архивах почтовых рассылок или непосредственно попросить помощи в тематических конференциях, посвещенных дистрибутиву (sisyphus, devel, community).

ВНИМАНИЕ: порядок действий, для решения проблемы имеет значение (репозиторий -> поиск в архиве -> рассылки)

.

Во втором случае, стоит начать с поиска готовых решений. В открытом сообществе, считается хорошим тоном публиковать решения найденных проблем. Зачастую, поисковики выдают море полезной информации по кратко описанной в трёх-пяти словах проблеме конкретного софта или тексту ошибки, полученной при сборке. Например, запроса вида « gcc4.1 mysoftware patch» может быть достаточно для поиска патча, решающего проблему сборки с новым gcc4.1). Стоит также воспользоваться имеющимися репозиториями открытой разработки. Зачастую, мейнтейнеры этих репозиториев, уже сталкивались с такими же проблемами, и возможно у них есть решение (патч) для сложившейся ситуации. О том, как устранить отсутствие необходимых библиотек или заголовочных файлов, рассказано в следующем пункте.

Поиск пакетов

Возможно при сборке вам придётся доустанавливать недостающие библиотеки. Имейте в виду, что в ALT принято называть пакеты для разработки так: libX-devel, где X — название библиотеки. Пользуйтесь apt-cache search название для поиска недостающего пакета. Если пакета нет в вашей системе, поищите его в Сизифе. Если его нет и там, обратитесь к крупным собраниям информации о пакетах:

а также в репозитории открытой разработки.

Сборочная среда Hasher

Чтобы убедиться в том, что все зависимости правильны и сборка вашего пакета нормально пройдёт на сборочном сервере в ALT Linux, используется Hasher — среда, которая позволяет осуществить сборку пакета в «чистой» системе, куда установлены только пакеты, указанные в сборочных зависимостях.

$ sudo apt-get install hasher

Для настройки сборочной среды hasher нужно добавить пользователя:

  1. hasher-useradd имя_пользователя

(после этого надо заново зайти в систему)

См . README в /usr/share/doc/hasher-*/

Для сборки пакета в hasher запускаем

rpmbsh -i -u спек.spec

Эта команда соберёт пакет, установит его в тестовый hasher, после чего предложит отправить его в Incoming.

Если вы производите сборку на удалённом сервере, то рекомендуется воспользоваться командой screen. Запускаете: $screen Далее, для отключения от сеанса: Ctrl-A, D Для подключения обратно команду $screen -r

Лимиты на сборку у инкамингера

При сборке пакетов в сборочном окружении используются следующие лимиты:

В терминах hasher-priv.conf(5):
rlimit_hard_as=1073741824
rlimit_soft_cpu=7200
rlimit_hard_cpu=7260
wlimit_time_elapsed=14400
wlimit_time_idle=3600
wlimit_bytes_written=268435456

ldv@ in devel

Вспомогательные скрипты для сборки

Существует набор скриптов, облегчающих процесс сборки, собранный в пакет etersoft-build-utils. В параметрах скриптов обычно указываются названия спеков.

Вспомогательная Обычная Где результат Комментарий
rpmbb rpm -bb ~/RPM/RPMS полная сборка пакета
rpmbb -r buildreq Спек, строка BuildRequires: вычисление необходимых зависимостей сборки с занесением в спек
rpmbs -u ~/RPM/remote/upload собрать src.rpm, подписать его и выложить в Incoming; удалить buildroot
rpmbsh [-i ] [ -r ] [ -u ] ~/hasher/repo/i586/RPMS.hasher собрать из спека src.rpm и отправить его на сборку в hasher (если сразу указан src.rpm, собираем его)
rpmbb -i ~/RPM/RPMS выполнить секцию установки и упаковать пакет, пропустив компиляцию
rpmrb спек [ новая_версия ] для указанного спека скачивает архив с исходниками новой (указанной) версии, собирает в hasher и устанавливает в тестовый hasher, после выхода из которого предлагает выложить в Incoming
rpmgs спек [ новая_версия ] для указанного спека скачивает архив с исходниками
rpmgp пакет для указанного пакета скачивает src.rpm
rpmbph [-M50] -U спек выполняет бэкпорт указанного спека в указанный дистрибутив
rpmbs rpm -bs ~/RPM/SRPMS собрать src.rpm
rpmcs спек cleanup_spec привести спек к стандартам ALT Linux
rpmbb -c rpm -bc --short-circuit ~/RPM/BUILD компиляция без установки
  • Ключ -r указывает произвести сборку на удалённом сервере
  • Ключ -u указывает отправить в инкоминг после сборки (-U — в Updates, а не backports)
  • Также есть команда loginhsh для входа в (тестовый) hasher.

Использование ccache

Для ускорения сборки программного кода (если он пересобирается более одного раза) предлагается использовать ccache. Алексей Турбин поделился своими настройками:

~/.zshrc:
unset CCACHE_PATH
export GCC_USE_CCACHE=1
export CCACHE_DIR=$TMPDIR/.ccache
export CC=gcc CXX=g++

~/.rpmmacros:
%_tmppath       /tmp/.private/at
%__ccache_dir   %_tmppath/.ccache

Стандартная процедура

Если вы не хотите использовать etersoft-build-utils, вот описание использования стандартных команд:

Устанавливаем необходимые для сборки пакеты

# apt-get install rpm-build

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

$ cleanup_spec название.spec

Собираем пакет командой rpm -bb.

Дополнительная документация

При сборке пакетов сверяйтесь со следующей документацией:

Краткие справочники команд RPM и APT — на странице http://www.linux-os.ru/articles (спасти, поскольку сервер не работает)

Vitaly Lipatov <lav@etersoft.ru>, 11.01.04, 08.03.04, 28.10.04, 28.02.2005, 04.09.2005, 21.02.2006