Глава 6. Сборка пакета

Для полной (пере)сборки пакета, необходимо убедиться в установке следующего:

Затем выполните следующую команду в каталоге с исходным кодом:

$ dpkg-buildpackage -us -uc

Она сделает всё, что необходимо для создания всех двоичных пакетов и пакета с исходным кодом. Она выполняет:

If the build result is satisfactory, sign the .dsc and .changes files with your private GPG key using the debsign command. You need to enter your secret pass phrase, twice. ^[62]

Для неродного пакета Debian, например, gentoo, после сборки пакетов вы увидите следующие файлы в родительском каталоге (~/gentoo):

The gentoo_0.9.12-1.dsc and gentoo_0.9.12-1_i386.changes files must be signed using the debsign command with your private GPG key in the ~/.gnupg/ directory, before uploading them to the Debian FTP archive. The GPG signature provides the proof that these files are really yours, using your public GPG key.

The debsign command can be made to sign with your specified secret GPG key ID (good for sponsoring packages) with the following in the ~/.devscripts file:

DEBSIGN_KEYID=ID_ключа_GPG

Длинные строки цифр в файлах .dsc и .changes — это контрольные суммы SHA1/SHA256 упомянутых файлов. Человек, загружающий ваши файлы, может проверить их с помощью sha1sum(1) или sha256sum(1) и, если числа не совпадают, он поймёт, что файл был повреждён или подделан.

Debian поддерживает много переносов с помощью сети autobuilder, в которой работает служба buildd на компьютерах различных архитектур. Хотя вам и не придётся этим заниматься, но всё же следует узнать, что будет происходить с вашими пакетами. Рассмотрим в общих чертах как ваш пакет пересобирается для различных архитектур ^[64].

Для пакетов с Architecture: any система autobuilder выполняет пересборку. Она убеждается, что установлен

Затем в каталоге с исходным кодом вызывается команда

$ dpkg-buildpackage -B

Она делает всё необходимое для сборки пакетов для данной архитектуры. А именно:

Так ваш пакет собирается для различных архитектур.

Хотя пакеты, перечисленные в поле Build-Depends-indep, должны быть установлены при ручном пакетировании (смотрите Раздел 6.1, «Полная (пере)сборка»), их не нужно устанавливать при использовании системы autobuilder, так как она занимается исключительно архитектурно-зависимыми двоичными пакетами ^[65]. Это различие между обычным пакетированием и использованием autobuilder определяет, где должны быть перечислены необходимые пакеты: в поле Build-Depends или Build-Depends-indep файла debian/control (смотрите Раздел 4.1, «Файл control»).

Для автоматизации действий по сборки с помощью dpkg-buildpackage можно использовать команду debuild. Смотрите debuild(1).

The debuild command executes the lintian command to make a static check after building the Debian package. The lintian command can be customized with the following in the ~/.devscripts file:

DEBUILD_DPKG_BUILDPACKAGE_OPTS="-us -uc -I -i"
DEBUILD_LINTIAN_OPTS="-i -I --show-overrides"

Для очистки каталога исходного кода и пересборки пакета выполните:

$ debuild

Для очистки древа исходного кода выполните:

$ debuild -- clean

В чистой среде сборки (chroot) для проверки пакетных зависимостей очень полезен пакет pbuilder ^[66]. Он поможет убедиться в чистоте сборки под управлением auto-builder из sid для различных архитектур и избежать опасной ошибки FTBFS (ошибка сборки из исходного кода), которая всегда относится к категории RC (критична для данного выпуска) ^[67].

Давайте настроим пакет pbuilder следующим образом:

Для начальной инициализации локальной системы chroot пакета pbuilder выполним:

$ sudo pbuilder create

Если у вас имеется готовый пакет исходного кода, то в каталоге, где расположены файлы foo.orig.tar.gz, foo.debian.tar.gz и foo.dsc, для обновления локальной системы chroot пакета pbuilder и сборки соответствующих двоичных пакетов выполните следующие команды:

$ sudo pbuilder --update
$ sudo pbuilder --build foo_версия.dsc

Только что собранные пакеты без подписи GPG будут помещены в каталог /var/cache/pbuilder/result/, их владельцем будет обычный пользователь (не суперпользователь).

Подписи GPG для файлов .dsc и .changes можно сгенерировать следующим образом:

$ cd /var/cache/pbuilder/result/
$ debsign foo_версия_архитектура.changes

Если у вас есть обновлённое древо исходного кода, но нет собранных пакетов с исходным кодом, выполните в каталоге, где размещён подкаталог debian, другие команды:

$ sudo pbuilder --update
$ pdebuild

Вы можете войти внутрь окружения chroot и настроить его командой pbuilder --login --save-after-login. Изменения будут сохранены, когда вы покинете оболочку, нажав ^D (Control-D).

Последняя версия команды lintian может быть вызвана в окружении chroot, используя сценарий /var/cache/pbuilder/hooks//B90lintian, настроенный следующим образом ^[68]:

#!/bin/sh
set -e
install_packages() {
        apt-get -y --allow-downgrades install "$@"
        }
install_packages lintian
echo "+++ lintian output +++"
su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
# use this version if you don't want lintian to fail the build
#su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
echo "+++ end of lintian output +++"

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

You may need to update your stable packages after their release for stable-proposed-updates, stable/updates, etc. ^[69] For such occasions, the fact that you may be running a sid system is not a good enough excuse for failing to update them promptly. The pbuilder package can help you to access environments of almost any Debian derivative distribution of the same architecture.

Смотрите http://www.netfort.gr.jp/~dancer/software/pbuilder.html, pdebuild(1), pbuilderrc(5) и pbuilder(8).

Если автор программы применяет систему управления кодом ^[70], то и вы можете использовать её возможности. Это упрощает слияние и выборку заплат для исходного кода. Для каждой VCS существуют специализированные инструменты, позволяющие производить сборку пакетов Debian:

Среди разработчиков Debian становится популярным использовать git-buildpackage для управления пакетами Debian на сервере Git alioth.debian.org. ^[71] В этот пакет включено много команд для автоматизации процесса упаковки:

Для ведения пакетирования в этих командах используются 3 ветви:

Для настройки git-buildpackage используйте файл ~/.gbp.conf. Смотрите gbp.conf(5). ^[73]

При работе над большим пакетом, возможно, вы не захотите каждый раз полностью пересобирать его из исходного кода при изменении настроек в файле debian/rules. Исключительно для тестовых целей вы можете создать deb-файл без пересборки кода следующим образом ^[74]:

$ fakeroot debian/rules binary

Или просто выполните для выяснения возможна ли сборка пакета:

$ fakeroot debian/rules build

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

Вот краткая сводка команд, которые объединяются в единую систему для сборки пакетов. Есть много способов сделать одно и тоже.

• debian/rules = сценарий сопровождающего для сборки пакета

• dpkg-buildpackage = ключевой инструмент сборки пакета

• debuild = dpkg-buildpackage + lintian (сборка при проверенных переменных окружение)

• pbuilder = ключевой инструмент chroot-окружения Debian

• pdebuild = pbuilder + dpkg-buildpackage (сборка в chroot)

• cowbuilder = ускорение выполнения pbuilder

• git-pbuilder = простой синтаксис командной строки для pdebuild (используется в gbp buildpackge)

• gbp = управление исходным кодом Debian в репозитории git

• gbp buildpackge = pbuilder + dpkg-buildpackage + gbp

Хотя высокоуровневые команды, такие как gbp buildpackge и pbuilder, предоставляют замечательную среду сборки пакета, необходимо понимать какие нижележащие команды, такие как debian/rules и dpkg-buildpackage, в них используются.