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

Материал из ALT Linux Wiki
Нет описания правки
Строка 2: Строка 2:
{{MovedFromFreesourceInfo|AltLinux/Sisyphus/devel/СборкаПакетов}}
{{MovedFromFreesourceInfo|AltLinux/Sisyphus/devel/СборкаПакетов}}


Здесь рассмотрена процедура сборки [http://ru.wikipedia.org/wiki/RPM RPM-] пакетов для [[Main Page|ALT Linux]].
Здесь рассмотрена процедура сборки [http://ru.wikipedia.org/wiki/RPM RPM-пакетов] для [[Main Page|ALT Linux]].
Это облегчённая инструкция для начинающих разработчиков, написанная с учётом использования пакета etersoft-build-utils.
Это облегчённая инструкция для начинающих разработчиков, написанная с учётом использования пакета [[etersoft-build-utils]].
[http://tigro.info/blog/index.php?id=375 Сборка пакетов RPM и DEB в других системах.]
Описана процедура сборки пакета устаревшим способом, с получением src.rpm, без использования [[Краткое руководство по сборке с gear git/gear]].


== Первоначальная настройка ==
== Первоначальная настройка ==
Строка 21: Строка 21:
%_gpg_name Vitaly Lipatov <lav@altlinux.ru>
%_gpg_name Vitaly Lipatov <lav@altlinux.ru>
%packager Vitaly Lipatov <lav@altlinux.ru></pre>
%packager Vitaly Lipatov <lav@altlinux.ru></pre>
Если вы являетесь мантейнером, то для того, чтобы подписывать пакеты и отправлять их для сборки в Сизиф, вы должны указать данные адреса, под которым вы зарегистрированы в ALT Linux.
 
Если вы [[Процедура принятия в Team|являетесь мантейнером]], то для того, чтобы подписывать пакеты и отправлять их для сборки в Сизиф, вы должны указать адреса, под которым вы зарегистрированы в ALT Linux.
<div style="display: inline; color: red;">ВНИМАНИЕ! Сборка принципиально невозможна под учётной записью root.</div>
<div style="display: inline; color: red;">ВНИМАНИЕ! Сборка принципиально невозможна под учётной записью root.</div>


== Сборка пакетов ==
== Сборка пакетов ==
Образец того, как надо оформлять спек, вы можете посмотреть в пакете [http://sisyphus.ru/srpm/wcalc wcalc] или [http://sisyphus.ru/srpm/gnubiff gnubiff]. Настоятельно рекомендуется обратиться
Образец того, как надо оформлять спек, вы можете посмотреть в пакете [http://sisyphus.ru/srpm/wcalc wcalc] или [http://sisyphus.ru/srpm/gnubiff gnubiff]. Настоятельно рекомендуется обратиться к [[Spectips|документации]], а также смотреть «как это сделано в другом пакете».
к документации, а также смотреть «как это сделано в другом пакете».
Получить src.rpm для установленного в систему пакета можно командой <tt>$ rpmgp название_пакета</tt>
Получить src.rpm для установленного в систему пакета можно командой <tt>$ rpmgp название_пакета</tt>
Также образцы спеков для разных типов пакетов доступны [http://wiki.sisyphus.ru/devel/SampleSpecs здесь].
Также образцы спеков для разных типов пакетов доступны [http://wiki.sisyphus.ru/devel/SampleSpecs здесь].
Строка 39: Строка 39:
Если спек взят из другого дистрибутива, то сначала делаем
Если спек взят из другого дистрибутива, то сначала делаем
<pre>$ rpmcs название.spec</pre>
<pre>$ rpmcs название.spec</pre>
чтобы привести спек в пригодный для использования вид. Далее его нужно поправить вручную, используя взятый из ALT Linux пример спека в качестве образца.
чтобы привести спек в пригодный для использования вид. Далее его нужно поправить вручную, мысленно используя взятый из ALT Linux пример спека в качестве образца.


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


<tt>$ rpmbb название.spec</tt>
<tt>$ rpmbb название.spec</tt>
::: для сборки двоичного пакета (он будет создан в ~/RPM/RPMS)
::: для сборки двоичного пакета (он будет записан в ~/RPM/RPMS)


<tt>$ rpmbb -r название.spec</tt>
<tt>$ rpmbb -r название.spec</tt>
::: для того, чтобы в пакет автоматически прописались зависимости на пакеты, необходимые при сборке. Если пересобирается уже имеющийся пакет из Сизифа, то это не обязательно. (см. также [http://wiki.sisyphus.ru/devel/spectips/buildreq Использование buildreq])
::: для того, чтобы в пакет автоматически прописались зависимости на пакеты, необходимые при сборке. Если пересобирается уже имеющийся пакет из Сизифа, то это обычно не нужно. (см. также [[Buildreq Использование buildreq]])


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


== Ошибки при сборке ==
== Ошибки при сборке ==
Для начала, нужно локализовать проблему — определить, является ли она проблемой конкретного дистрибутива/системы (например: отсутствие или неверная версия необходимых для сборки библиотек, специфика дистрибутива) или более глобальной (например: несобираемость определённой версией компилятора, ошибки в коде, несоответствие кода новым стандартам).
Для начала, нужно локализовать проблему — определить, является ли она проблемой конкретного дистрибутива/системы (например: отсутствие или неверная версия необходимых для сборки библиотек, специфика дистрибутива) или более глобальной (например: несобираемость определённой версией компилятора, ошибки в коде, несоответствие кода новым стандартам).
В первом случае, поможет осуществить поиск по дистрибутиву/репозиторию, поискать решение проблемы в [http://lists.altlinux.org архивах почтовых рассылок] или непосредственно попросить помощи в тематических конференциях, посвещенных дистрибутиву (sisyphus, devel, community). <div style="display: inline; color: red;">ВНИМАНИЕ: порядок действий, для решения проблемы имеет значение (репозиторий -&gt; поиск в архиве -&gt; рассылки)</div>.
В первом случае, поможет осуществить поиск по дистрибутиву/репозиторию, поискать решение проблемы в архивах [[Списки рассылки|почтовых рассылок]] или непосредственно попросить помощи в рассылке (sisyphus, devel, community).
Во втором случае, стоит начать с поиска готовых решений. В открытом сообществе, считается хорошим тоном публиковать решения найденных проблем. Зачастую, поисковики выдают море полезной информации по кратко описанной в трёх-пяти словах проблеме конкретного софта или тексту ошибки, полученной при сборке. Например, запроса вида « gcc4.1 mysoftware patch» может быть достаточно для поиска патча, решающего проблему сборки с новым gcc4.1).
Во втором случае, стоит начать с поиска готовых решений. В открытом сообществе, считается хорошим тоном публиковать решения найденных проблем. Зачастую, поисковики выдают море полезной информации по кратко описанной в трёх-пяти словах проблеме конкретного софта или тексту ошибки, полученной при сборке. Например, запроса вида «gcc4.1 mysoftware patch» может быть достаточно для поиска патча, решающего проблему сборки с новым gcc4.1).
Стоит также воспользоваться имеющимися [http://wiki.sisyphus.ru/devel/repositories репозиториями открытой разработки]. Зачастую, мейнтейнеры этих репозиториев, уже сталкивались с такими же проблемами, и возможно у них есть решение (патч) для сложившейся ситуации.
Стоит также воспользоваться другими [[Repositories|репозиториями с пакетами открытой разработки]]. Зачастую, мейнтейнеры этих репозиториев, уже сталкивались с такими же проблемами, и возможно у них есть решение (патч) для сложившейся ситуации.
О том, как устранить отсутствие необходимых библиотек или заголовочных файлов, рассказано в следующем пункте.
О том, как устранить отсутствие необходимых библиотек или заголовочных файлов, рассказано в следующем пункте.


Строка 73: Строка 68:
* [http://citkit.ru http://citkit.ru]
* [http://citkit.ru http://citkit.ru]
* [http://rpm.pbone.net http://rpm.pbone.net]
* [http://rpm.pbone.net http://rpm.pbone.net]
а также в [http://www.altlinux.org/Repositories репозитории открытой разработки].
а также в [[Repositories|репозиториях открытой разработки]].


== Сборочная среда Hasher ==
== Сборочная среда Hasher ==
Строка 81: Строка 76:
# hasher-useradd имя_пользователя
# hasher-useradd имя_пользователя
(после этого надо заново зайти в систему)
(после этого надо заново зайти в систему)
  См . README в /usr/share/doc/hasher-*/
  См. README в /usr/share/doc/hasher-*/


Для сборки пакета в hasher запускаем
Для сборки пакета в hasher запускаем
<pre>rpmbsh -i -u спек.spec</pre>
<pre>rpmbsh -i спек.spec</pre>
Эта команда соберёт пакет, установит его в тестовый hasher, после чего предложит отправить его в Incoming.
Эта команда соберёт пакет и установит его в тестовый hasher, где его можно будет проверить.
 
Если вы производите сборку на удалённом сервере, то рекомендуется воспользоваться командой screen.
Запускаете: $screen
Далее, для отключения от сеанса: Ctrl-A, D
Для подключения обратно команду $screen -r
 
=== Лимиты на сборку у инкамингера ===
При сборке пакетов в сборочном окружении используются следующие лимиты:
<pre>В терминах 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</pre>
ldv@ in [http://lists.altlinux.ru/pipermail/devel/2006-April/030876.html devel]
 
== Вспомогательные скрипты для сборки ==
Существует набор скриптов, облегчающих процесс сборки, собранный в пакет etersoft-build-utils. В параметрах скриптов обычно указываются названия спеков.


{| class="standard"
|-
!Вспомогательная
!Обычная
!Где результат
!Комментарий
|-
|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 спек {{nobr|[ новая_версия ]}}
|
|
|для указанного спека скачивает архив с исходниками новой (указанной) версии, собирает в hasher и устанавливает в тестовый hasher, после выхода из которого предлагает выложить в Incoming
|-
|rpmgs спек {{nobr|[ новая_версия ]}}
|
|
|для указанного спека скачивает архив с исходниками
|-
|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. Алексей Турбин поделился своими настройками:
<pre>~/.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</pre>
== Стандартная процедура ==
Если вы не хотите использовать etersoft-build-utils, вот описание использования стандартных команд:
Устанавливаем необходимые для сборки пакеты
<pre># apt-get install rpm-build</pre>
Приводим спек по возможности в пригодный для использования вид:
<pre>$ cleanup_spec название.spec</pre>
Собираем пакет командой <tt>rpm -bb</tt>.


== Дополнительная документация ==
== Дополнительная документация ==
* Sisyphus:/devel/RpmSetup
* Sisyphus:/devel/RpmSetup
* [[ОсобенностиСборкиПакетов|Описание нюансов сборки RPM-пакетов в ALT Linux и не только]]
* [[ОсобенностиСборкиПакетов|Описание нюансов сборки RPM-пакетов в ALT Linux и не только]]
* [http://tigro.info/blog/index.php?id=375 Сборка пакетов RPM и DEB в других системах.]


При сборке пакетов сверяйтесь со следующей документацией:
При сборке пакетов сверяйтесь со следующей документацией:
* [http://docs.altlinux.ru/alt/devel/ Документация разработчика ALT Linux]
* [http://docs.altlinux.ru/alt/devel/ Документация разработчика ALT Linux]
* [http://www.altlinux.org/Hasher Сборка программ для ALTLinux с использованием hasher]
* [[Hasher|Сборка программ для ALTLinux с использованием hasher]]
* [http://atmsk.altlinux.org.ua/index.php?option=articles&amp;Itemid=3&amp;topid=9 Статьи по сборке пакетов]
* [http://atmsk.altlinux.org.ua/index.php?option=articles&amp;Itemid=3&amp;topid=9 Статьи по сборке пакетов]
Краткие справочники команд RPM и APT — на странице [http://www.linux-os.ru/articles http://www.linux-os.ru/articles]  (спасти, поскольку сервер не работает)
Vitaly Lipatov &lt;lav@etersoft.ru&gt;, 11.01.04, 08.03.04, 28.10.04, 28.02.2005, 04.09.2005, 21.02.2006


[[Категория:Devel]]
[[Категория:Devel]]
[[Категория:Packaging]]
[[Категория:Packaging]]

Версия от 19:05, 19 сентября 2009

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

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


Здесь рассмотрена процедура сборки RPM-пакетов для ALT Linux. Это облегчённая инструкция для начинающих разработчиков, написанная с учётом использования пакета etersoft-build-utils. Описана процедура сборки пакета устаревшим способом, с получением src.rpm, без использования Краткое руководство по сборке с gear git/gear.

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

С правами 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 Использование buildreq)

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

для добавления строчки о данной сборке в секцию %changelog, в конце спека. После этого следует в спеке дописать комментарий, какие изменения были сделаны в данной сборке.

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

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

Для начала, нужно локализовать проблему — определить, является ли она проблемой конкретного дистрибутива/системы (например: отсутствие или неверная версия необходимых для сборки библиотек, специфика дистрибутива) или более глобальной (например: несобираемость определённой версией компилятора, ошибки в коде, несоответствие кода новым стандартам). В первом случае, поможет осуществить поиск по дистрибутиву/репозиторию, поискать решение проблемы в архивах почтовых рассылок или непосредственно попросить помощи в рассылке (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 спек.spec

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


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

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