Технология сборки пакетов RPM: различия между версиями
(не показана 71 промежуточная версия 7 участников) | |||
Строка 1: | Строка 1: | ||
{{Тимовец| ruslandh | Автор статьи }} | |||
== Классическая сборка пакетов rpm == | == Классическая сборка пакетов rpm == | ||
Прежде всего, всем советую прочесть [https://alt-packaging-guide.github.io Новое "Руководство по сборке RPM-пакетов для дистрибутивов Альт"] | |||
Во многом эта статья повторяет статью [[Сборка_пакета_с_нуля]], и возможно со временем их надо объединить. | |||
Классическая сборка пакета '''rpm''' состоит из следующих этапов: | |||
=== Нахождение исходного текста пакета === | === Нахождение исходного текста пакета === | ||
Обычно мы находим | Обычно мы находим исходный текст программы. Часто исходный текст программы можно получить на официальном сайте программы. | ||
Это может быть | Это может быть готовый архив в виде tar, упакованный каким-нибудь компрессором, типа gzip, bzip и т.п. | ||
Также, это может быть репозиторий git, cvs, меркурий и т.п. | |||
В любом случае мы получаем каталог с текстом программы и инструкцией, как можно программу собрать. | В любом случае мы получаем каталог с текстом программы и инструкцией, как можно программу собрать. | ||
Отдельным источником можно назвать пакет src.rpm или deb-src из другого дистрибутива. | Отдельным источником можно назвать пакет src.rpm или deb-src из другого дистрибутива. | ||
В этом случае можно | В этом случае можно «подсмотреть» как собирают этот пакет другие. | ||
На этом этапе надо понять как в принципе собирается данный пакет. | На этом этапе надо понять как в принципе собирается данный пакет. | ||
Строка 21: | Строка 25: | ||
=== Написание инструкции сборки пакета === | === Написание инструкции сборки пакета === | ||
Хорошая статья, как писать spec файл [[Spec | Хорошая статья, как писать spec-файл<ref>Для совсем начинающих две ссылкм | ||
* [http://www.tldp.org/HOWTO/RPM-HOWTO/ RPM-HOWTO] | |||
* [https://www.opennet.ru/docs/HOWTO-RU/RPM-HOWTO-48.html RPM-HOWTO перевод на русский]</ref> | |||
[[Spec | Руководство по написанию спек файла для rpm]]. И ещё одна: [[Общие_правила_написания_спек_файлов_в_ALT_Linux]]. | |||
На втором этапе, зная алгоритм сборки пакета, мы записываем алгоритм в виде '''spec'''-файла. | На втором этапе, зная алгоритм сборки пакета, мы записываем алгоритм в виде '''spec'''-файла. | ||
Сборку пакета | Сборку пакета из исходников можно разделить на следующие основные этапы: | ||
* | * распаковка исходного текста пакета и наложение патчей на него (например, исправляющие makefile пакета, чтобы он собирался не куда-нибудь в {{path|/opt}}, а каталог предназначенный для сборки пакета) (секция '''%prep'''); | ||
(секция '''%prep''') | |||
* | * компиляция и линковка программ пакета (секция '''%build'''); | ||
* | * размещение программ в каталог, который будет упаковываться в rpm (секция '''%install'''); | ||
* | * написание скриптов нестандартных действий, которые выполняются при установке и удалении пакета (секции '''%post''' и '''%postust'''); | ||
* | * сама упаковка пакета и проверка его «правильности» (верификация пакета). | ||
Для тренировки сборки пакета, советую попробовать взять готовый пакет [https://git.altlinux.org/gears/h/hello.git], готовый src.rpm можно взять из репозитория, | Для тренировки сборки пакета, советую попробовать взять готовый пакет [https://git.altlinux.org/gears/h/hello.git], готовый src.rpm можно взять из репозитория, например из Сизифа | ||
(ссылка скоро может устареть,в случае смены версии пакета) [http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/files/SRPMS/hello-2.10-alt1.1.src.rpm] | (ссылка скоро может устареть, в случае смены версии пакета) [http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/files/SRPMS/hello-2.10-alt1.1.src.rpm]. | ||
=== Непосредственная | === Непосредственная сборка пакета === | ||
Полезная ссылка для начинающего [[Сборка_пакетов_(etersoft-build-utils) | Краткая инструкция по сборке пакетов с помощью etersoft-build-utils ]] | Полезная ссылка для начинающего [[Сборка_пакетов_(etersoft-build-utils) | Краткая инструкция по сборке пакетов с помощью etersoft-build-utils]]. | ||
Кстати, для генерации основы spec-файла, установите пакет {{pkg|genspec}}, запустите скрипт {{cmd|gensprec}} и ответьте на вопросы. А скрипт из пакета {{pkg|github2spec}} умеет создавать полный gear репозиторий для сборки пакета. | |||
Это лучше делать внутри хэшера, так как установка кучи необходимых для сборки программ, во первых грозит безопасности вашей операционной системы, а во вторых, засоряет её ненужными вам в дальнейшем пакетами. | После того как вы написали спек и подготовили исходники, можно переходить непосредственно к сборке пакета. | ||
Это лучше делать внутри хэшера, так как установка кучи необходимых для сборки программ, во-первых грозит безопасности вашей операционной системы, а во-вторых, засоряет её ненужными вам в дальнейшем пакетами. | |||
Каждому этапу сборки можно привести опцию rpm, которая это выполняет: | Каждому этапу сборки можно привести опцию rpm, которая это выполняет: | ||
* '''Распаковка исходника''' : | * '''Распаковка исходника (секция %prep)''': | ||
rpmbuild -bp имя_спек_файла.spec | '''rpmbuild -bp имя_спек_файла.spec''' | ||
* '''Компиляция и линковка программ (сборка) пакета (секция % | * '''Компиляция и линковка программ (сборка) пакета (секция %build)''': | ||
rpm -bc имя_спек_файла.spec | '''rpm -bc имя_спек_файла.spec''' | ||
или | или | ||
rpm -bc --short-circuit имя_спек_файла.spec | '''rpm -bc --short-circuit имя_спек_файла.spec''' | ||
разница состоит в том, что если запустить с ключом -bc, то rpm заново повторит распаковку пакета , а потом уже начнёт компиляцию. Если вы собираете пакет первый раз | разница состоит в том, что если запустить с ключом -bc, то rpm заново повторит распаковку пакета, а потом уже начнёт компиляцию. Если вы собираете пакет первый раз по шагам, то вы могли внести в исходный текст пакета исправления, которые можно потом оформить в патчи, то распаковка исходников заново уничтожит ваши исправления. | ||
* '''Установка пакета в заданный каталог (%install)''' | * '''Установка пакета в заданный каталог (%install)''': | ||
rpm -bi --short-circuit имя_спек_файла.spec | '''rpm -bi --short-circuit имя_спек_файла.spec''' | ||
* '''Создание непосредственно самого пакета rpm (и src.rpm) | * '''Создание непосредственно самого пакета rpm (и src.rpm)''': | ||
''' | |||
rpm -ba --short-circuit имя_спек_файла.spec | '''rpm -ba --short-circuit имя_спек_файла.spec''' | ||
* '''Упаковка src.rpm пакета''' | * '''Упаковка src.rpm пакета''': | ||
rpm -bs - имя_спек_файла.spec | '''rpm -bs - имя_спек_файла.spec''' | ||
Для ключа bs не требуется параметр --short-circuit , так как он непосредственно упаковывает ваши исходники и патчи в src.rpm, не выполняя действий по распаковке, компиляции и установке пакета. | Для ключа '''bs''' не требуется параметр '''--short-circuit''', так как он непосредственно упаковывает ваши исходники и патчи в src.rpm, не выполняя действий по распаковке, компиляции и установке пакета. | ||
=== Пример классической сборки пакета === | === Пример классической сборки пакета === | ||
Для всех примеров мы будем использовать пакет hello. Он есть и в репозитории и в git.altlinux.org. | Для всех примеров мы будем использовать пакет {{pkg|hello}}. Он есть и в репозитории и в git.altlinux.org [https://git.altlinux.org/gears/h/hello.git https://git.altlinux.org/gears/h/hello.git]. | ||
[ | Готовый src.rpm можно взять их сорцов Сизифа [http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/files/SRPMS/hello-2.10-alt1.1.src.rpm http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/files/SRPMS/hello-2.10-alt1.1.src.rpm] — ссылка может устареть с выходом новой версии пакета, поэтому текущую версию пакета, всегда можно найти здесь: [https://packages.altlinux.org/ru/sisyphus/srpms/hello/rpms/ https://packages.altlinux.org/ru/sisyphus/srpms/hello/rpms/ ] | ||
Допустим, мы скачали {{pkg|hello-2.10-alt1.1.src.rpm}}, устанавливаем его от имени пользователя: | |||
$ '''rpm -ihv путь_до_каталога_с_файлом/hello-2.10-alt1.1.src.rpm | |||
''' | ''' | ||
В результате в каталоге пользователя ~/RPM/SPEC/<ref>в '''.rpmmacros''' прописаны стандартные для ALT пути: | В результате в каталоге пользователя {{path|~/RPM/SPEC/}}<ref>в '''.rpmmacros''' прописаны стандартные для ALT пути: | ||
%_topdir %homedir/RPM | %_topdir %homedir/RPM | ||
Строка 97: | Строка 103: | ||
%_tmppath %homedir/tmp | %_tmppath %homedir/tmp | ||
</ref> | </ref> появляется файл '''hello.spec''', а в {{path|~/RPM/SOURCE}} файл '''hello-2.10.tar.gz'''. | ||
Теперь зайдем в каталог | Теперь зайдем в каталог {{path|~/RPM/SPEC/}} и изучим содержание файла spec: | ||
Шапка пакета | Шапка пакета — его описание, лицензия, откуда можно скачать исходник, или домашняя страница проекта, параметр '''BuildRequires''' указывает какой «нестандартный» пакет требуется для сборки: | ||
< | <syntaxhighlight lang="ini"> | ||
Name: hello | Name: hello | ||
Version: 2.10 | Version: 2.10 | ||
Строка 123: | Строка 129: | ||
would otherwise be unavailable to them. Because it is protected by the | would otherwise be unavailable to them. Because it is protected by the | ||
GNU General Public License, users are free to share and change it. | GNU General Public License, users are free to share and change it. | ||
</ | </syntaxhighlight> | ||
Описание распаковки исходников и наложение патчей ( | Описание распаковки исходников и наложение патчей (этап '''rpmbuild -bp'''): | ||
< | <syntaxhighlight lang="ini"> | ||
%prep | %prep | ||
%setup - | %setup -a0 | ||
</ | </syntaxhighlight> | ||
Распаковывается первый исходник (Source — hello-2.10.targz) в каталог {{path|~/RPM/BUILD/hello-2.10}}. | |||
Этап построения пакета (этап '''rpm -bc --short-circuit'''), выполняются команды | Этап построения пакета (этап '''rpm -bc --short-circuit'''), выполняются команды {{cmd|autoreconf}}, {{cmd|configure}}, {{cmd|make}} с параметрами по умолчанию для сборки пакетов '''rpm''': | ||
<syntaxhighlight lang="ini"> | |||
< | |||
%build | %build | ||
%autoreconf | %autoreconf | ||
%configure | %configure | ||
%make_build | %make_build | ||
</ | </syntaxhighlight> | ||
Этап перемещения пакетов в каталог упаковки ('''rpm -bi --short-circuit'''), выполняются команды | Этап перемещения пакетов в каталог упаковки ('''rpm -bi --short-circuit'''), выполняются команды make install и поиск файлов перевода на различные языки: | ||
<syntaxhighlight lang="ini"> | |||
< | |||
%install | %install | ||
%makeinstall | %makeinstall | ||
%find_lang %name | %find_lang %name | ||
</ | </syntaxhighlight> | ||
Перечень файлов, которые должны войти в пакет (этап '''rpm -ba --short-circuit'''): | Перечень файлов, которые должны войти в пакет (этап '''rpm -ba --short-circuit'''): | ||
< | <syntaxhighlight lang="ini"> | ||
%files -f %name.lang | %files -f %name.lang | ||
%doc AUTHORS ChangeLog ChangeLog.O NEWS README THANKS TODO | %doc AUTHORS ChangeLog ChangeLog.O NEWS README THANKS TODO | ||
Строка 165: | Строка 164: | ||
%_infodir/* | %_infodir/* | ||
%_mandir/man?/* | %_mandir/man?/* | ||
</ | </syntaxhighlight> | ||
Перечень людей пересобиравших пакет и изменения в пакете: | Перечень людей пересобиравших пакет и изменения в пакете: | ||
< | <syntaxhighlight lang="ini"> | ||
%changelog | %changelog | ||
* Thu Dec 03 2015 Igor Vlasenko <viy@altlinux.ru> 2.10-alt1.1 | * Thu Dec 03 2015 Igor Vlasenko <viy@altlinux.ru> 2.10-alt1.1 | ||
Строка 179: | Строка 178: | ||
</ | </syntaxhighlight> | ||
Расшифровку макросов входящих в spec файл, можно получить выдав команду<ref>нужно установить пакет '''rpm-utils'''</ref> : | Расшифровку макросов входящих в spec файл, можно получить выдав команду<ref>нужно установить пакет '''rpm-utils'''</ref>: | ||
$'''rpm -bE hello.spec''' | |||
Теперь попробуем собрать пакет hello в вашем текущем | Теперь попробуем собрать пакет {{pkg|hello}} в вашем текущем бранче, даём команду: | ||
$ '''rpm -ba hello.spec''' | |||
Скорей всего в вам выскочит сообщение, что для сборки пакета, нужно установить пакет texinfo | Скорей всего в вам выскочит сообщение, что для сборки пакета, нужно установить пакет {{pkg|texinfo}}: | ||
'''apt-get install texinfo''' | # '''apt-get install texinfo''' | ||
Это просто для одного недостающего пакета, сложнее для установки | Это просто для одного недостающего пакета, сложнее для установки «кучи» необходимых для сборки пакетов. | ||
Для этого можно применить интересный приём : | Для этого можно применить интересный приём: | ||
* Собираем пакет src.rpm (если его у вас нет, или вы добавили в spec свои патчи) : | * Собираем пакет src.rpm (если его у вас нет, или вы добавили в spec свои патчи): | ||
$ '''rpm -bs --nodeps hello.spec'''<ref>Дальше для простоты, я не буду указывать путь до файла, подразумевая, что вы предварительно перешли в каталог с файлом</ref> | |||
результат сборки вы увидите в ~/RPM/SRPMS/ | результат сборки вы увидите в {{path|~/RPM/SRPMS/}}. | ||
Далее настраиваем свой конфиг apt, что-бы он умел ставить пакеты, необходимые для сборки пакета указываем, где лежат пакеты src.rpm. | Далее настраиваем свой конфиг apt, что-бы он умел ставить пакеты, необходимые для сборки пакета указываем, где лежат пакеты src.rpm. | ||
Например, у меня локальное зеркало Сизифа с источниками установки прописаны в файле | Например, у меня локальное зеркало Сизифа с источниками установки прописаны в файле {{path|/etc/apt/sources.list.d/10-local.list}} c следующим содержанием: | ||
< | <syntaxhighlight lang="ini"> | ||
# local (ALT Linux) | # local (ALT Linux) | ||
Строка 218: | Строка 215: | ||
rpm-src [p10] file:/mnt/Arhiv_ext/Branch-p10/ noarch classic | rpm-src [p10] file:/mnt/Arhiv_ext/Branch-p10/ noarch classic | ||
</ | </syntaxhighlight> | ||
=== Установка пакетов, необходимых для сборки === | |||
Тогда можно установить пакеты, необходимые для сборки пакета {{pkg|hello}}, одной из команд: | |||
<syntaxhighlight lang="bash">$ rpmgp -i hello.src.rpm</syntaxhighlight> | |||
(требуется установить {{pkg|etersoft-build-utils}}) | |||
<syntaxhighlight lang="bash"># apt-get build-dep hello.src.rpm</syntaxhighlight> | |||
(сейчас не работает) <ref>смотри {{altbug|}}</ref> | |||
== Сборка внутри хэшера == | == Сборка внутри хэшера == | ||
Описанный выше способ сборки пакета, как уже описано выше, имеет один существенный недостаток | Описанный выше способ сборки пакета, как уже описано выше, имеет один существенный недостаток — в живую систему приходится устанавливать пакеты, не нужные в обычной жизни, например для сборки пакета {{pkg|hello}}, требуется пакет {{pkg|texinfo}}. | ||
Для сборки внутри хэшера, надо установить и настроить пакет [[hasher]], кратко смотри [[Hasher/Краткое_руководство | Hasher быстрый старт]], [[Hasher/FAQ | Hasher Faq]]. | |||
=== Классическое использование хэшера === | |||
Классическое использование хэшера, это запуск его командой: | Классическое использование хэшера, это запуск его командой: | ||
$ hsh путь/имя.src.rpm | |||
Возьмём для примера наш hello...src.rpm | |||
Для начала настроим работу хэшера: | |||
* установим hasher<ref># - это не комментарий, а знак что для выполнения команды apt-get нужно получить права [[root |root]] </ref>: | |||
<syntaxhighlight lang="bash"># apt-get install hasher</syntaxhighlight> | |||
* добавим аккаунты псевдопользователей для работы с хэшером: | |||
<syntaxhighlight lang="bash"># hasher-useradd имя_вашего_пользователя</syntaxhighlight> | |||
С версии 2.0 пакета hasher-priv (бренча <= p10 не касается) нужно запустить сервис hasher-privd: | |||
<syntaxhighlight lang="bash"># systemctl enable --now hasher-privd.service</syntaxhighlight> | |||
* создадим окружение для работы хэшера: | |||
В домашнем каталоге пользователя создаём каталог, имя которого начинается с точки <ref> $ — это знак, что команду {{cmd|cd}} надо выполнять вашим обычным пользователем </ref>: | |||
<syntaxhighlight lang="bash">$ cd$ mkdir .hasher | |||
$ cd .hasher | |||
$ > config | |||
$ mcedit config | |||
</syntaxhighlight> | |||
В файле {{path|~.hasher/config}} прописываются значения опций пользователя по умолчанию. Эти опции можно изменить, указав их непосредственно в самой команде вызова хэшера, например: | |||
<syntaxhighlight lang="ini"> | |||
def_repo=/home/$USER/hasher-repo | |||
install -d /tmp/private/$HOME/hasher | |||
ln -fs /tmp/private/$HOME/hasher /home/$HOME/hasher | |||
known_mountpoints=/dev/pts | |||
lock_nowait=1 | |||
apt-config=$HOME/apt/apt.conf.s64 | |||
if [ ! `uname -m` = x86_64 ]; then def_target=i586; fi | |||
</syntaxhighlight> | |||
Создаём файл {{path|~/apt/apt.conf.s64}} такого содержания: | |||
<syntaxhighlight lang="ini"> | |||
Dir::Etc::main "/dev/null"; | |||
Dir::Etc::parts "/var/empty"; | |||
Dir::Etc::SourceParts "/var/empty"; | |||
Dir::Etc::sourcelist "/home/$USER/apt/sources.list.s64"; | |||
RPM::Ignore { "vim-plugin-vimruby"; }; | |||
</syntaxhighlight> | |||
И файл {{path|apt/sources.list.s64}}, например, такого содержания: | |||
<syntaxhighlight lang="ini"> | |||
rpm [p10] file:/mnt/Arhiv/Branch-p10/ x86_64 classic gostcrypto | |||
rpm [p10] file:/mnt/Arhiv/Branch-p10/ x86_64-i586 classic | |||
rpm [p10] file:/mnt/Arhiv/Branch-p10/ noarch classic | |||
</syntaxhighlight> | |||
Здесь {{path|/mnt/Arhiv/Branch-p10/}} — путь для локального репозитория p10. | |||
Создаем символьную ссылку на расположение хэшера, например, так: | |||
<syntaxhighlight lang="ini">$ ln -fs /tmp/private/$USER/hasher /home/$USER/hasher</syntaxhighlight> | |||
И теперь запускаем саму сборку в хэшере, заходим в каталог с файлом и даём команду: | |||
<syntaxhighlight lang="ini">$ hsh hello-2.10-alt1.1.src.rpm</syntaxhighlight> | |||
В результате этой команды внутри хэшера соберётся пакет {{pkg|hello-2.10-alt1.1.x86_64.rpm}}, который мы увидим (при приведённом выше конфиге) | |||
в {{path|~/hasher_repo}}. | |||
В качестве примера приведу команду сбора 32 разрядного приложения в хэшере на 64-битной машине: | |||
<syntaxhighlight lang="ini">$ setarch i586 hsh -v --apt-config=$HOME/apt/apt.conf.s32 $HOME/hasher</syntaxhighlight> | |||
где apt/apt.conf.s32 — описание 32 битного репозитория. | |||
=== Использование хэшера как изолированной среды сборки === | |||
То есть для сборки пакета {{pkg|hello}}, со своими патчами, мы можем собрать свою версию src.rpm командой: | |||
<syntaxhighlight lang="ini">$ rpm -bs hello.spec</syntaxhighlight> | |||
И дальше собираем свой вариант hello: | И дальше собираем свой вариант hello: | ||
<syntaxhighlight lang="ini">$ hsh hello-2.10-alt1.1.src.rpm</syntaxhighlight> | |||
Но гораздо интереснее, использовать хэшер на этапе изучения пакета. | Но гораздо интереснее, использовать хэшер на этапе изучения пакета. | ||
Устанавливаем "чистый" хэшер: | Устанавливаем "чистый" хэшер: | ||
<syntaxhighlight lang="ini">$ hsh --initroot --pkg-build-list=+mc,rpm-utils</syntaxhighlight> | |||
Кладём в hasher/in нужные исходники, заходим внутрь хэшера: | Кладём в hasher/in нужные исходники, заходим внутрь хэшера: | ||
<syntaxhighlight lang="ini">$ hsh-shell --mount=/dev/pts shell=mc</syntaxhighlight> | |||
Теперь копируем эти файлы в {{path|/usr/src/RPM/BUILD}} хэшера, и начинаем экспериментировать со сборкой пакета. | |||
Расположив спек в {{path|/src/RPM/SPECS}}, а исходники в {{path|/src/RPM/SOURCE}}, можно внутри хэшера собирать пакеты «классическим» способом. | |||
Для установки пакета внутрь пакета, нужно выйти из хэшера: | |||
<syntaxhighlight lang="ini">$ exit</syntaxhighlight> | |||
и дать команду: | |||
<syntaxhighlight lang="ini">$ hsh-install имя_пакета</syntaxhighlight> | |||
== Сборка с использованием инструментов работы с git репозиториями == | == Сборка с использованием инструментов работы с git репозиториями == | ||
== | [[Git]] репозиторий, это удобное место для хранения исходного кода пакетов. | ||
Для работы с ними и для сборки из них '''rpm''' существует пакет [[gear]]. | |||
Для примера рассмотрим сборку пакета hello из git репозитория [https://git.altlinux.org/gears/h/hello.git https://git.altlinux.org/gears/h/hello.git]. | |||
Для начала склонируем git репозиторий в то место, где вы будете хранить свои рабочие исходники, например: | |||
<syntaxhighlight lang="bash"> | |||
$ mkdir My_Repo (необязательно) | |||
$ cd My_Repo | |||
$ git clone https://git.altlinux.org/gears/h/hello.git | |||
</syntaxhighlight> | |||
Заходим в каталог hello и изучаем его. | |||
<syntaxhighlight lang="bash">$ cd hello | |||
$ ls -al | |||
итого 24 | |||
drwxr-xr-x 5 writer writer 4096 мая 15 19:58 . | |||
drwxr-xr-x 32 writer writer 4096 мая 15 19:58 .. | |||
drwxr-xr-x 2 writer writer 4096 мая 15 19:58 .gear | |||
drwxr-xr-x 8 writer writer 4096 мая 15 19:58 .git | |||
drwxr-xr-x 11 writer writer 4096 мая 15 19:58 hello | |||
-rw-r--r-- 1 writer writer 1680 мая 15 19:58 hello.spec | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash"> | |||
$ cd .gear | |||
$ cat rules | |||
tar.gz: hello | |||
</syntaxhighlight> | |||
Правило tar.gz: hello, указывает, что каталог hello упаковывается в hello.tar.gz. | |||
Установим пакет {{pkg|gear}}: | |||
<syntaxhighlight lang="bash"># apt-get install gear</syntaxhighlight> | |||
И дадим команду из каталога hello: | |||
<syntaxhighlight lang="bash">$ gear-hsh </syntaxhighlight> | |||
И у нас в хэшере собирается пакет (для 64 битной архитектуры) {{pkg|hello-2.10-alt1.1.x86_64.rpm}}. | |||
== Примечания == | |||
<references/> | |||
== Ссылки == | |||
Полезные ссылки: | |||
* [http://www.tldp.org/HOWTO/RPM-HOWTO/ RPM-HOWTO] | |||
* [https://www.opennet.ru/docs/HOWTO-RU/RPM-HOWTO-48.html RPM-HOWTO перевод на русский] | |||
* [[Сборка_пакета_с_нуля]] | |||
* [[О_стратегии_сборки_RPM_пакетов]] | |||
* [[Spec | Руководство по написанию спек файла для rpm]] | |||
* [[Сборка_пакетов_(etersoft-build-utils) | Краткая инструкция по сборке пакетов с помощью etersoft-build-utils ]] | |||
* [[Краткое_руководство_по_сборке_с_gear]] | |||
* [[RPMMacrosDescription | Макросы RPM]] | |||
* [[git]] | |||
* [[gear]] | |||
* [[hasher]] | |||
* [https://alt-packaging-guide.github.io Разрабатываемое новое "Руководство по сборке RPM-пакетов для дистрибутивов Альт"] | |||
{{Category navigation|title=devel|category=devel|sortkey={{SUBPAGENAME}}}} | |||
{{Category navigation|title=Сборка пакетов|category=Сборка пакетов|sortkey={{SUBPAGENAME}}}} |
Текущая версия от 04:17, 12 апреля 2024
![]() |
Этот участник состоит в ALT Linux Team под ником ruslandh / ruslandh .
e-mail: [mailto: ruslandh @altlinux.org ruslandh @altlinux.org] |
Классическая сборка пакетов rpm
Прежде всего, всем советую прочесть Новое "Руководство по сборке RPM-пакетов для дистрибутивов Альт"
Во многом эта статья повторяет статью Сборка_пакета_с_нуля, и возможно со временем их надо объединить.
Классическая сборка пакета rpm состоит из следующих этапов:
Нахождение исходного текста пакета
Обычно мы находим исходный текст программы. Часто исходный текст программы можно получить на официальном сайте программы.
Это может быть готовый архив в виде tar, упакованный каким-нибудь компрессором, типа gzip, bzip и т.п. Также, это может быть репозиторий git, cvs, меркурий и т.п.
В любом случае мы получаем каталог с текстом программы и инструкцией, как можно программу собрать.
Отдельным источником можно назвать пакет src.rpm или deb-src из другого дистрибутива. В этом случае можно «подсмотреть» как собирают этот пакет другие.
На этом этапе надо понять как в принципе собирается данный пакет.
Написание инструкции сборки пакета
Хорошая статья, как писать spec-файл[1] Руководство по написанию спек файла для rpm. И ещё одна: Общие_правила_написания_спек_файлов_в_ALT_Linux.
На втором этапе, зная алгоритм сборки пакета, мы записываем алгоритм в виде spec-файла.
Сборку пакета из исходников можно разделить на следующие основные этапы:
- распаковка исходного текста пакета и наложение патчей на него (например, исправляющие makefile пакета, чтобы он собирался не куда-нибудь в /opt, а каталог предназначенный для сборки пакета) (секция %prep);
- компиляция и линковка программ пакета (секция %build);
- размещение программ в каталог, который будет упаковываться в rpm (секция %install);
- написание скриптов нестандартных действий, которые выполняются при установке и удалении пакета (секции %post и %postust);
- сама упаковка пакета и проверка его «правильности» (верификация пакета).
Для тренировки сборки пакета, советую попробовать взять готовый пакет [1], готовый src.rpm можно взять из репозитория, например из Сизифа (ссылка скоро может устареть, в случае смены версии пакета) [2].
Непосредственная сборка пакета
Полезная ссылка для начинающего Краткая инструкция по сборке пакетов с помощью etersoft-build-utils.
Кстати, для генерации основы spec-файла, установите пакет genspec, запустите скрипт gensprec и ответьте на вопросы. А скрипт из пакета github2spec умеет создавать полный gear репозиторий для сборки пакета.
После того как вы написали спек и подготовили исходники, можно переходить непосредственно к сборке пакета.
Это лучше делать внутри хэшера, так как установка кучи необходимых для сборки программ, во-первых грозит безопасности вашей операционной системы, а во-вторых, засоряет её ненужными вам в дальнейшем пакетами.
Каждому этапу сборки можно привести опцию rpm, которая это выполняет:
- Распаковка исходника (секция %prep):
rpmbuild -bp имя_спек_файла.spec
- Компиляция и линковка программ (сборка) пакета (секция %build):
rpm -bc имя_спек_файла.spec
или
rpm -bc --short-circuit имя_спек_файла.spec
разница состоит в том, что если запустить с ключом -bc, то rpm заново повторит распаковку пакета, а потом уже начнёт компиляцию. Если вы собираете пакет первый раз по шагам, то вы могли внести в исходный текст пакета исправления, которые можно потом оформить в патчи, то распаковка исходников заново уничтожит ваши исправления.
- Установка пакета в заданный каталог (%install):
rpm -bi --short-circuit имя_спек_файла.spec
- Создание непосредственно самого пакета rpm (и src.rpm):
rpm -ba --short-circuit имя_спек_файла.spec
- Упаковка src.rpm пакета:
rpm -bs - имя_спек_файла.spec
Для ключа bs не требуется параметр --short-circuit, так как он непосредственно упаковывает ваши исходники и патчи в src.rpm, не выполняя действий по распаковке, компиляции и установке пакета.
Пример классической сборки пакета
Для всех примеров мы будем использовать пакет hello. Он есть и в репозитории и в git.altlinux.org https://git.altlinux.org/gears/h/hello.git.
Готовый src.rpm можно взять их сорцов Сизифа http://ftp.altlinux.org/pub/distributions/ALTLinux/Sisyphus/files/SRPMS/hello-2.10-alt1.1.src.rpm — ссылка может устареть с выходом новой версии пакета, поэтому текущую версию пакета, всегда можно найти здесь: https://packages.altlinux.org/ru/sisyphus/srpms/hello/rpms/
Допустим, мы скачали hello-2.10-alt1.1.src.rpm, устанавливаем его от имени пользователя:
$ rpm -ihv путь_до_каталога_с_файлом/hello-2.10-alt1.1.src.rpm
В результате в каталоге пользователя ~/RPM/SPEC/[2] появляется файл hello.spec, а в ~/RPM/SOURCE файл hello-2.10.tar.gz.
Теперь зайдем в каталог ~/RPM/SPEC/ и изучим содержание файла spec:
Шапка пакета — его описание, лицензия, откуда можно скачать исходник, или домашняя страница проекта, параметр BuildRequires указывает какой «нестандартный» пакет требуется для сборки:
Name: hello
Version: 2.10
Release: alt1.1
Summary: GNU hello, THE greeting printing program
Group: Development/C
License: GPLv3+
Url: ftp://ftp.gnu.org/gnu/hello/
Source: %name-%version.tar.gz
# explicitly added texinfo for info files
BuildRequires: texinfo
%description
The GNU `hello' program produces a familiar, friendly greeting. It
allows nonprogrammers to use a classic computer science tool which
would otherwise be unavailable to them. Because it is protected by the
GNU General Public License, users are free to share and change it.
Описание распаковки исходников и наложение патчей (этап rpmbuild -bp):
%prep
%setup -a0
Распаковывается первый исходник (Source — hello-2.10.targz) в каталог ~/RPM/BUILD/hello-2.10.
Этап построения пакета (этап rpm -bc --short-circuit), выполняются команды autoreconf, configure, make с параметрами по умолчанию для сборки пакетов rpm:
%build
%autoreconf
%configure
%make_build
Этап перемещения пакетов в каталог упаковки (rpm -bi --short-circuit), выполняются команды make install и поиск файлов перевода на различные языки:
%install
%makeinstall
%find_lang %name
Перечень файлов, которые должны войти в пакет (этап rpm -ba --short-circuit):
%files -f %name.lang
%doc AUTHORS ChangeLog ChangeLog.O NEWS README THANKS TODO
%doc %name-%version
%_bindir/*
%_infodir/*
%_mandir/man?/*
Перечень людей пересобиравших пакет и изменения в пакете:
%changelog
* Thu Dec 03 2015 Igor Vlasenko <viy@altlinux.ru> 2.10-alt1.1
- NMU: added BR: texinfo
......
* Thu Oct 23 2003 Andrey Rahmatullin <wrar@altlinux.ru> 2.1.1-alt1
- initial build
Расшифровку макросов входящих в spec файл, можно получить выдав команду[3]:
$rpm -bE hello.spec
Теперь попробуем собрать пакет hello в вашем текущем бранче, даём команду:
$ rpm -ba hello.spec
Скорей всего в вам выскочит сообщение, что для сборки пакета, нужно установить пакет texinfo:
# apt-get install texinfo
Это просто для одного недостающего пакета, сложнее для установки «кучи» необходимых для сборки пакетов.
Для этого можно применить интересный приём:
- Собираем пакет src.rpm (если его у вас нет, или вы добавили в spec свои патчи):
$ rpm -bs --nodeps hello.spec[4]
результат сборки вы увидите в ~/RPM/SRPMS/.
Далее настраиваем свой конфиг apt, что-бы он умел ставить пакеты, необходимые для сборки пакета указываем, где лежат пакеты src.rpm.
Например, у меня локальное зеркало Сизифа с источниками установки прописаны в файле /etc/apt/sources.list.d/10-local.list c следующим содержанием:
# local (ALT Linux)
rpm [p10] file:/mnt/Arhiv_ext/Branch-p10/ x86_64 classic gostcrypto
rpm [p10] file:/mnt/Arhiv_ext/Branch-p10/ noarch classic
rpm [p10] file:/mnt/Arhiv_ext/Branch-p10/ x86_64-i586 classic
rpm-src [p10] file:/mnt/Arhiv_ext/Branch-p10/ x86_64 classic
rpm-src [p10] file:/mnt/Arhiv_ext/Branch-p10/ noarch classic
Установка пакетов, необходимых для сборки
Тогда можно установить пакеты, необходимые для сборки пакета hello, одной из команд:
$ rpmgp -i hello.src.rpm
(требуется установить etersoft-build-utils)
# apt-get build-dep hello.src.rpm
(сейчас не работает) [5]
Сборка внутри хэшера
Описанный выше способ сборки пакета, как уже описано выше, имеет один существенный недостаток — в живую систему приходится устанавливать пакеты, не нужные в обычной жизни, например для сборки пакета hello, требуется пакет texinfo.
Для сборки внутри хэшера, надо установить и настроить пакет hasher, кратко смотри Hasher быстрый старт, Hasher Faq.
Классическое использование хэшера
Классическое использование хэшера, это запуск его командой:
$ hsh путь/имя.src.rpm
Возьмём для примера наш hello...src.rpm
Для начала настроим работу хэшера:
- установим hasher[6]:
# apt-get install hasher
- добавим аккаунты псевдопользователей для работы с хэшером:
# hasher-useradd имя_вашего_пользователя
С версии 2.0 пакета hasher-priv (бренча <= p10 не касается) нужно запустить сервис hasher-privd:
# systemctl enable --now hasher-privd.service
- создадим окружение для работы хэшера:
В домашнем каталоге пользователя создаём каталог, имя которого начинается с точки [7]:
$ cd$ mkdir .hasher
$ cd .hasher
$ > config
$ mcedit config
В файле ~.hasher/config прописываются значения опций пользователя по умолчанию. Эти опции можно изменить, указав их непосредственно в самой команде вызова хэшера, например:
def_repo=/home/$USER/hasher-repo
install -d /tmp/private/$HOME/hasher
ln -fs /tmp/private/$HOME/hasher /home/$HOME/hasher
known_mountpoints=/dev/pts
lock_nowait=1
apt-config=$HOME/apt/apt.conf.s64
if [ ! `uname -m` = x86_64 ]; then def_target=i586; fi
Создаём файл ~/apt/apt.conf.s64 такого содержания:
Dir::Etc::main "/dev/null";
Dir::Etc::parts "/var/empty";
Dir::Etc::SourceParts "/var/empty";
Dir::Etc::sourcelist "/home/$USER/apt/sources.list.s64";
RPM::Ignore { "vim-plugin-vimruby"; };
И файл apt/sources.list.s64, например, такого содержания:
rpm [p10] file:/mnt/Arhiv/Branch-p10/ x86_64 classic gostcrypto
rpm [p10] file:/mnt/Arhiv/Branch-p10/ x86_64-i586 classic
rpm [p10] file:/mnt/Arhiv/Branch-p10/ noarch classic
Здесь /mnt/Arhiv/Branch-p10/ — путь для локального репозитория p10.
Создаем символьную ссылку на расположение хэшера, например, так:
$ ln -fs /tmp/private/$USER/hasher /home/$USER/hasher
И теперь запускаем саму сборку в хэшере, заходим в каталог с файлом и даём команду:
$ hsh hello-2.10-alt1.1.src.rpm
В результате этой команды внутри хэшера соберётся пакет hello-2.10-alt1.1.x86_64.rpm, который мы увидим (при приведённом выше конфиге) в ~/hasher_repo.
В качестве примера приведу команду сбора 32 разрядного приложения в хэшере на 64-битной машине:
$ setarch i586 hsh -v --apt-config=$HOME/apt/apt.conf.s32 $HOME/hasher
где apt/apt.conf.s32 — описание 32 битного репозитория.
Использование хэшера как изолированной среды сборки
То есть для сборки пакета hello, со своими патчами, мы можем собрать свою версию src.rpm командой:
$ rpm -bs hello.spec
И дальше собираем свой вариант hello:
$ hsh hello-2.10-alt1.1.src.rpm
Но гораздо интереснее, использовать хэшер на этапе изучения пакета. Устанавливаем "чистый" хэшер:
$ hsh --initroot --pkg-build-list=+mc,rpm-utils
Кладём в hasher/in нужные исходники, заходим внутрь хэшера:
$ hsh-shell --mount=/dev/pts shell=mc
Теперь копируем эти файлы в /usr/src/RPM/BUILD хэшера, и начинаем экспериментировать со сборкой пакета.
Расположив спек в /src/RPM/SPECS, а исходники в /src/RPM/SOURCE, можно внутри хэшера собирать пакеты «классическим» способом.
Для установки пакета внутрь пакета, нужно выйти из хэшера:
$ exit
и дать команду:
$ hsh-install имя_пакета
Сборка с использованием инструментов работы с git репозиториями
Git репозиторий, это удобное место для хранения исходного кода пакетов. Для работы с ними и для сборки из них rpm существует пакет gear.
Для примера рассмотрим сборку пакета hello из git репозитория https://git.altlinux.org/gears/h/hello.git.
Для начала склонируем git репозиторий в то место, где вы будете хранить свои рабочие исходники, например:
$ mkdir My_Repo (необязательно)
$ cd My_Repo
$ git clone https://git.altlinux.org/gears/h/hello.git
Заходим в каталог hello и изучаем его.
$ cd hello
$ ls -al
итого 24
drwxr-xr-x 5 writer writer 4096 мая 15 19:58 .
drwxr-xr-x 32 writer writer 4096 мая 15 19:58 ..
drwxr-xr-x 2 writer writer 4096 мая 15 19:58 .gear
drwxr-xr-x 8 writer writer 4096 мая 15 19:58 .git
drwxr-xr-x 11 writer writer 4096 мая 15 19:58 hello
-rw-r--r-- 1 writer writer 1680 мая 15 19:58 hello.spec
$ cd .gear
$ cat rules
tar.gz: hello
Правило tar.gz: hello, указывает, что каталог hello упаковывается в hello.tar.gz.
Установим пакет gear:
# apt-get install gear
И дадим команду из каталога hello:
$ gear-hsh
И у нас в хэшере собирается пакет (для 64 битной архитектуры) hello-2.10-alt1.1.x86_64.rpm.
Примечания
- ↑ Для совсем начинающих две ссылкм
- ↑ в .rpmmacros прописаны стандартные для ALT пути: %_topdir %homedir/RPM %_tmppath %homedir/tmp
- ↑ нужно установить пакет rpm-utils
- ↑ Дальше для простоты, я не буду указывать путь до файла, подразумевая, что вы предварительно перешли в каталог с файлом
- ↑ смотри bugzilla.altlinux.org
- ↑ # - это не комментарий, а знак что для выполнения команды apt-get нужно получить права root
- ↑ $ — это знак, что команду cd надо выполнять вашим обычным пользователем
Ссылки
Полезные ссылки:
- RPM-HOWTO
- RPM-HOWTO перевод на русский
- Сборка_пакета_с_нуля
- О_стратегии_сборки_RPM_пакетов
- Руководство по написанию спек файла для rpm
- Краткая инструкция по сборке пакетов с помощью etersoft-build-utils
- Краткое_руководство_по_сборке_с_gear
- Макросы RPM
- git
- gear
- hasher
- Разрабатываемое новое "Руководство по сборке RPM-пакетов для дистрибутивов Альт"