Сборка пакетов start: различия между версиями
Строка 246: | Строка 246: | ||
=Виды сборки пакетов= | =Виды сборки пакетов= | ||
==Создание пакета с нуля== | ==Создание пакета с нуля== | ||
Для примера мы попробуем собрать утилиту [https:// | Для примера мы попробуем собрать утилиту [https://ftp.gnu.org/gnu/hello/ Hello]. | ||
=== Подготовка репозитория Git === | === Подготовка репозитория Git === | ||
Первым делом нужно создать Git-репозиторий для нужного пакета. Для этого мы создадим каталог и инициализируем в нем git-репозиторий. | Первым делом нужно создать Git-репозиторий для нужного пакета. Для этого мы создадим каталог и инициализируем в нем git-репозиторий. | ||
$ mkdir | $ mkdir hello | ||
$ cd | $ cd hello | ||
compresspdf$ git init . | compresspdf$ git init . | ||
Наш каталог: | Наш каталог: | ||
home | home | ||
└── | └── hello <- Мы сейчас здесь | ||
└── .git <- Служебный каталог Git | └── .git <- Служебный каталог Git | ||
=== Написание .gear/rules === | === Написание .gear/rules === | ||
В созданной папке | В созданной папке hello создаем каталог .gear и в нем файл rules: | ||
compresspdf$ mkdir .gear | compresspdf$ mkdir .gear | ||
compresspdf$ cd .gear | compresspdf$ cd .gear | ||
.gear$ mcedit rules | .gear$ mcedit rules | ||
Наполняем файл следующими строками и сохраняем файл: | Наполняем файл следующими строками и сохраняем файл: | ||
tar: | tar: hello name=@name@-@version@ base=@name@-@version@ | ||
spec: | spec: hello.spec | ||
*Первая срока указывает, что будет создан архив с нашим каталогом | *Первая срока указывает, что будет создан архив с нашим каталогом hello. | ||
*Вторая строка указывает, что для сборки пакета нужно использовать файл | *Вторая строка указывает, что для сборки пакета нужно использовать файл hello.spec. Если спек лежит в корневом каталоге, его указывать не нужно. | ||
Наш каталог: | Наш каталог: | ||
home | home | ||
└── | └── hello | ||
├── .gear <- Мы сейчас здесь | ├── .gear <- Мы сейчас здесь | ||
│ └── rules <- Мы создали этот файл | │ └── rules <- Мы создали этот файл | ||
Строка 277: | Строка 277: | ||
=== Импорт исходного кода === | === Импорт исходного кода === | ||
Исходный код | Исходный код Hello лежит на Github: [https://ftp.gnu.org/gnu/hello/ https://ftp.gnu.org/gnu/hello/]. | ||
Выходим из папки .gear в каталог выше и клонируем в него исходный код. | Выходим из папки .gear в каталог выше и клонируем в него исходный код. | ||
.gear$ cd .. | .gear$ cd .. | ||
hellof$ wget https://ftp.gnu.org/gnu/hello/hello-2.12.tar.gz | |||
hello$ tar xzvf hello-2.12.tar.gz | |||
hello$ rm hello-2.12.tar.gz | |||
Наш каталог: | Наш каталог: | ||
home | home | ||
└── | └── hello <- Мы сейчас здесь | ||
├── | ├── hello-2.12 <- Мы распаковали исходный код программы сюда | ||
├── .gear | ├── .gear | ||
└── .git | └── .git | ||
{{Note|Т.к. для Hasher-а нужно чтобы имя пакета в spec-е и имя репозитория совпадали (а пакет у нас будет называться | {{Note|Т.к. для Hasher-а нужно чтобы имя пакета в spec-е и имя репозитория совпадали (а пакет у нас будет называться hello, а не hello-2.12), мы переименуем каталог с исходным кодом в соответствии с именем пакета}} | ||
hello$ mv hello-2.12 hello | |||
=== Написание спека === | === Написание спека === | ||
Строка 296: | Строка 299: | ||
Создадим в каталоге, где мы собираемся собирать программу этот файл. | Создадим в каталоге, где мы собираемся собирать программу этот файл. | ||
compresspdf$ mcedit | compresspdf$ mcedit hello.spec | ||
Добавляем в файл следующие строки: | Добавляем в файл следующие строки: | ||
Строка 309: | Строка 310: | ||
<syntaxhighlight lang="spec"> | <syntaxhighlight lang="spec"> | ||
#Название пакета | #Название пакета | ||
Name: | Name: hello | ||
#Версия программы | #Версия программы | ||
Version: | Version: 2.12 | ||
#Номер сборки в текущем бранче | #Номер сборки в текущем бранче | ||
Release: alt1 | Release: alt1 | ||
#Описание на английском | #Описание на английском | ||
Summary: | Summary: GNU hello, THE greeting printing program | ||
#Лицензия | #Лицензия | ||
License: | License: GPLv3+ | ||
#Группа в меню ([[Ярлычки_программ#Категории|см. здесь]]) | #Группа в меню ([[Ярлычки_программ#Категории|см. здесь]]) | ||
Group: | Group: Development/C | ||
#Сайт программы | #Сайт программы | ||
Url: | Url: ftp://ftp.gnu.org/gnu/hello/ | ||
# | # | ||
Source: % | Source: %name-%version.tar.gz | ||
#Сборщик пакета (имя и email, указывается вручную) | #Сборщик пакета (имя и email, указывается вручную) | ||
Packager: Petr Akhlamov <ahlamovpm@altlinux.org> | Packager: Petr Akhlamov <ahlamovpm@altlinux.org> | ||
#Зависимость для сборки | |||
BuildRequires: texinfo | |||
BuildRequires | |||
#Описание на английском | #Описание на английском | ||
%description | %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. | |||
%prep | %prep | ||
%setup | %setup -a0 | ||
%build | %build | ||
% | %autoreconf | ||
%configure | |||
%make_build | |||
%install | %install | ||
% | %makeinstall | ||
%find_lang %name | |||
%files | %files -f %name.lang | ||
% | %doc AUTHORS ChangeLog ChangeLog.O NEWS README THANKS TODO | ||
%doc %name-%version | |||
%_bindir/* | |||
%_infodir/* | |||
%_mandir/man?/* | |||
#История изменений | #История изменений | ||
%changelog | %changelog | ||
* | * Thu Oct 10 2023 Petr Akhlamov ahlamovpm@altlinux.org 2.12-alt1 | ||
- | - Update version | ||
* Thu Dec 03 2015 Igor Vlasenko <viy@altlinux.ru> 2.10-alt1.1 | |||
- NMU: added BR: texinfo | |||
* Mon Nov 17 2014 Fr. Br. George <george@altlinux.ru> 2.10-alt1 | |||
- Autobuild version bump to 2.10 | |||
- Use autoreconf for educational purpose | |||
- Add full source tree in documentation | |||
* Thu Apr 17 2014 Fr. Br. George <george@altlinux.ru> 2.9-alt1 | |||
- Autobuild version bump to 2.9 | |||
* Mon Apr 15 2013 Dmitry V. Levin (QA) <qa_ldv@altlinux.org> 2.4-alt2.qa1 | |||
- NMU: rebuilt for debuginfo. | |||
* Thu May 21 2009 Andrey Rahmatullin <wrar@altlinux.ru> 2.4-alt2 | |||
- remove obsolete %%{,un}install_info calls | |||
* Sat Dec 13 2008 Andrey Rahmatullin <wrar@altlinux.ru> 2.4-alt1 | |||
- 2.4 | |||
* Wed Aug 15 2007 Andrey Rahmatullin <wrar@altlinux.ru> 2.3-alt1 | |||
- 2.3 | |||
* Thu Feb 15 2007 Andrey Rahmatullin <wrar@altlinux.ru> 2.2-alt1 | |||
- 2.2 | |||
* Thu Oct | * Thu Oct 23 2003 Andrey Rahmatullin <wrar@altlinux.ru> 2.1.1-alt1 | ||
- | - initial build | ||
</syntaxhighlight> | </syntaxhighlight> | ||
|} | |} | ||
Строка 410: | Строка 439: | ||
%changelog | %changelog | ||
* Thu Oct 05 2023 Petr Akhlamov ahlamovpm@altlinux.org 0.1-alt1 | * Thu Oct 05 2023 Petr Akhlamov ahlamovpm@altlinux.org 0.1-alt1 |
Версия от 17:12, 10 октября 2023
Возможно будет дорабатываться статья Сборка пакета с нуля
Подготовка
Генерация ключей
Для доступа к инфраструктуре ALT Linux нужны два открытых ключа: SSH и GPG. SSH ключ будет обеспечивать защищенное подключение к ресурсам ALT Linux Team, а GPG необходим для подписи пакетов.
SSH
Для работы с git-репозиториями ALT нужен будет SSH-ключ, который нужно сгенерировать. Его можно создать согласно инструкции с этой страницы.
$ ssh-keygen -t ED25519 -b 4096
развернутьГенерация ключа проходит следующим образом: |
---|
Публичная часть ключа — файл ~/.ssh/id_ed25519.pub.
GPG-ключ
Для подписи пакетов нужна открытая часть ключа. Следующими командами мы сгенерируем GPG-ключ и экспортируем в файл gpgkey.pub открытую часть.
$ gpg --gen-key $ gpg --armor --export petyaivanov@altlinux.org > gpgkey.pub
развернутьГенерация ключа проходит следующим образом: |
---|
Инструменты для сборки
В ALT Linux для сборки есть два инструмента.
- Hasher - для сборки в изолированном окружении.
В chroot ставится базовый комплект пакетов и пакеты, необходимые для сборки (поле BuildRequires в спеке).
Если какой-то пакет, необходимый для сборки, не указан в спеке, то появится ошибка. Так обеспечивается чистота сборки.
Обратной стороной является необходимость иметь доступ к репозиторию, так как пакеты ставятся при каждой новой сборке в Hasher.
- Gear - для сборки пакетов из репозитория Git.
В этом случае все файлы лежат в распакованном виде и в src.rpm упаковываются по правилам, определённым в .gear/rules.
Это позволяет работать сразу с содержимым, быстро делать патчи, вести историю изменений и обмениваться изменениями при коллективной разработке.
Установка инструментов для сборки
Для сборки пакетов нам понадобятся:
- Любой удобный текстовый редактор (Vim, Emacs, Mcedit);
- Система управления версиями Git
- Сборочная среда Hasher
- Инфраструктура Gear
- Утилиты RPM для сборки пакетов
- Инструменты для сборки программ: gcc, make, python, patch.
- Утилита для импорта проектов с Github
- Доступ к репозиторию пакетов
Установка:
# apt-get install mc git hasher hasher-priv gear gcc make python patch rpmdevtools rpm-utils rpm-build rpmlint rpm-build-licenses github2spec
Настройка Git
Чтобы у нашего Git-репозитория была идентификация, что именно мы занимаемся сборкой пакетов, его нужно настроить.
Следующими командами мы, для создаваемых вновь GIT репозиториев, настроим:
- имя
- адрес
- идентификатор ключа:
$git config --global user.name 'Petya Ivanov'
$git config --global user.email 'petyaivanov@altlinux.org'
$git config --global user.signingkey '835560D9'
Третья команда задаёт идентификатор вашего GPG-ключа для подписи.
Чтобы узнать этот идентификатор, выполните одну из следующих команд:
$ gpg --list-keys | grep -B 1 'Petya Ivanov'
pub 1024D/835560D9 2023-05-15
uid Petya Ivanov (ALT Linux Team) <petyaivanov@altlinux.ru>
или
[cas@cas ~]$ gpg --list-secret-keys
------------------------------
sec 1024D/835560D9 2023-05-15
uid Petya Ivanov (ALT Linux Team) <petyaivanov@altlinux.ru>
Работа с Git
Основы работы с Git-репозиторием описаны в указанной ниже статье.
- См. Git start
Настройка Hasher
Чтобы настроить сборочную среду Hasher нужно выполнить два действия - добавить пользователя в соответствующие группы и создать конфигурационный файл.
Добавление пользователя в группу
Из-под под root:
$ su - # hasher-useradd <существующий пользователь>
Например:
# hasher-useradd petr Добавление пользователя petr в группу petr_a Добавление пользователя petr в группу petr_b Добавление пользователя petr в группу hashman
Создание конфигурационного фала
Так же необходимо создать пользователю в домашнем каталоге файл .hasher/config:
$ mkdir ~/.hasher $ mcedit ~/.hasher/config
Вставляем в файл следующее содержимое:
packager="Petya Ivanov <petyaivanov@altlinux.org>" USER=petr #workdir="/tmp/.private/petr/" workdir="$HOME/hasher" target=i586 packager="`rpm --eval %packager`" #apt_config="$HOME/.hasher/apt.conf" mount=/dev/pts,/proc
Тут смотрите на строки с командами:
- echo packager ... - тут должны быть ваше имя и email
- echo 'USER=petr' - тут должно быть ваше имя пользователя, которое вы завели в hasher-useradd
- target - тут должна быть архитектура, под которую будут собираться пакеты, i586 или x86_64
- workdir - временная папка. /tmp - обозначает, что данные будут загружаться в оперативную память, если у вас ее не так много укажите локальный каталог, например $HOME/hasher
Инициализация окружения Hasher
$ hsh -v --initroot-only
Настройка Gear
Настройка окружения RPM
Для настройки сборки RPM-пакетов (чтобы указать в них кто собрал данный пакет и подпись разработчика) нужно создать в домашнем каталоге файл .rpmmacros.
Отредактируйте файл ~/.rpmmacros (конечно, заменив ключ и имя мейнтейнера на свои):
$ mcedit ~/.rpmmacros
"%packager Petya Ivanov <petyaivanov@altlinux.org>"
"%_gpg_name 1B40E49FD40245D0472E4C5FD9528003835560D9"
Визуально проверьте файл на соответствие ожидаемому:
$ cat ~/.rpmmacros
Что указывается в %_gpg_name?
В %_gpg_name указывается отпечаток ключа (а не краткий идентификатор, как для Git). Получить его можно командой:
$ LANG=C gpg --fingerprint 835560D9 | grep 'fingerprint =' | tr -d ' ' | cut -d= -f2
1B40E49FD40245D0472E4C5FD9528003835560D9
или
$ gpg --fingerprint 835560D9 | sed -n '/.*=/{s/.*=/%_gpg_name\t/;s/ //gp}'
%_gpg_name 1B40E49FD40245D0472E4C5FD9528003835560D9
Виды сборки пакетов
Создание пакета с нуля
Для примера мы попробуем собрать утилиту Hello.
Подготовка репозитория Git
Первым делом нужно создать Git-репозиторий для нужного пакета. Для этого мы создадим каталог и инициализируем в нем git-репозиторий.
$ mkdir hello $ cd hello compresspdf$ git init .
Наш каталог:
home └── hello <- Мы сейчас здесь └── .git <- Служебный каталог Git
Написание .gear/rules
В созданной папке hello создаем каталог .gear и в нем файл rules:
compresspdf$ mkdir .gear compresspdf$ cd .gear .gear$ mcedit rules
Наполняем файл следующими строками и сохраняем файл:
tar: hello name=@name@-@version@ base=@name@-@version@ spec: hello.spec
- Первая срока указывает, что будет создан архив с нашим каталогом hello.
- Вторая строка указывает, что для сборки пакета нужно использовать файл hello.spec. Если спек лежит в корневом каталоге, его указывать не нужно.
Наш каталог:
home └── hello ├── .gear <- Мы сейчас здесь │ └── rules <- Мы создали этот файл └── .git
Импорт исходного кода
Исходный код Hello лежит на Github: https://ftp.gnu.org/gnu/hello/.
Выходим из папки .gear в каталог выше и клонируем в него исходный код.
.gear$ cd .. hellof$ wget https://ftp.gnu.org/gnu/hello/hello-2.12.tar.gz hello$ tar xzvf hello-2.12.tar.gz hello$ rm hello-2.12.tar.gz
Наш каталог:
home └── hello <- Мы сейчас здесь ├── hello-2.12 <- Мы распаковали исходный код программы сюда ├── .gear └── .git
hello$ mv hello-2.12 hello
Написание спека
Теперь нам нужно создать файл спека (spec).
Создадим в каталоге, где мы собираемся собирать программу этот файл.
compresspdf$ mcedit hello.spec
Добавляем в файл следующие строки:
развернутьШаблон с комментариями на русском для изучения |
---|
развернутьШаблон без комментариев на русском для продакшена |
---|
Наш каталог:
home └── compresspdf <- Мы сейчас здесь ├── compresspdf <- В прошлом шаге мы переименовали каталог с исходным кодом для совпадения имени репы исходного кода и пакета ├── compresspdf.spec <- Файл спека, который мы создали ├── .gear └── .git
Внесение изменений в Git
После того, как мы внесли код, спек и настроили хэшер, внесенные изменения надо внести в Git.
Для этого переходим в каталог compresspdf, в котором мы находились в предыдущем шаге и вносим коммит:
$ git commit -am "Initial commit" $ git add .
Сборка в Hasher
Чтобы собрать пакет в Hasher перейдите в корневой каталог проекта и выполните команду:
$ gear --hasher -- hsh --no-sisyphus-check
Отправка в git.alt
Создание пакета на основе существующего
Создание нового пакета на основе существующего
"Воскрешение" "умершего" пакета
Сборка пакета из srcrpm
В ALT Linux кроме обычных пакетов есть пакеты с исходным кодом (имеют расширение *.src.rpm).
Такой пакет содержит:
- архив (один или несколько) с исходным кодом
- файл Spec (далее — просто спек)
- возможно, разнообразные патчи и дополнения.
Т.е. однажды разработчик все приготовил для того, чтобы собрать программу и упаковать ее в пакет, "заархивировал" все это в специальный файл и теперь вместо того чтобы все делать по новой (например, при обновлении программы), достаточно скачать данный пакет, подправить его содержимое и некоторые параметры и собрать новый пакет.
Пакет *.src.rpm можно использовать только для сборки двоичных пакетов, но не для установки.
Сборка осуществляется командой:
rpmbuild --rebuild package.src.rpm
В итоге получится готовый *.rpm-пакет который можно установить командой:
# rpm -Uvh package.rpm
Глоссарий
- Gear - инструмент, позволяющий оперируя данными из git репозитория проводить сборку исходного текста в rpm пакет,тарболл или просто экспортировать результаты выполненияправил (gear-rules) в определённый каталог.
- Git - консольная утилита, для отслеживания и ведения истории изменения файлов, в проекте. Она отслеживает и фиксирует изменения в файлах и сохраняет их в специальных "снимках" - коммитах.
- Hasher - инструмент безопасной и воспроизводимой сборки пакетов. Все пакеты Sisyphus собираются с его помощью.
- GPG - программа шифрования информации с публичным ключом. Используется для подписи пакетов чтобы подтвердить подлинность разработчика, который выпустил данный пакет.
- RPM - формат пакетов программного обеспечения и утилита для установки данных пакетов. Так же у RPM существуют утилиты для сборки пакетов из специально приготовленных пакетов с исходным кодом.
- SSH - это защищенный сетевой протокол для удаленного управления операционной системой с помощью командной строки и передачи данных в зашифрованном виде. Он используется для передачи данных между разработчиком и сервером с пакетами.
- Исходный код - часть программного обеспечения, с которой программисты работают, чтобы изменить работу приложения или добавить новые функции.
- Патч (Patch) - программное средство, используемое для устранения проблем в программном обеспечении или изменения его функциональности
- Спек (Spec) - файл содержащий инструкции для программы rpmbuild, необходимые для сборки пакета.