Разоблачаем магию deb-пакетов
Привет! Вторая статья на habr и третья за жизнь. Сегодня мы в формате мини-урока поговорить про такую вещь, как дебинизация проекта - процесс формирования .deb -пакета.
Весь приведённый материал в статье представлен здесь: https://github.com/X0re4ik/dpkg-study-cpp . Так как данная статья позиционирует себя как туториал, то мы добавим ей немножко интерактивности. Переходите по ссылке: https://x0re4ik.ru/study/tutorials/001-cpp-study — заботливый GLM сформировал интерактивный учебник по статье (буду очень благодарен за обратную связь: насколько идея живая).
По ходу статьи пройдём путь от ручной сборки до автоматизации:
- Соберём минимально жизнеспособный пакет руками , без специализированных утилит ( dpkg --build ).
- Добавим бинарник, конфиг и systemd-юнит с postinst/prerm-скриптами.
- Поймём, почему пакет не обновляется при повторном apt-get install и как работает версионирование.
- Разберёмся с зависимостями : как выяснить, от чего зависит бинарник, и что писать в Depends: .
- Заглянем внутрь .deb и увидим, что никакой магии там нет.
- Автоматизируем всё то же самое через dpkg-buildpackage и debhelper - и поймём, что утилиты просто делают за нас то, что мы уже умеем делать руками.
Проект pg-server - небольшой HTTP-сервер на C++, который:
- собирается обычным make в один бинарник;
- читает из YAML-конфига порт, на котором ему нужно подняться;
- на любой HTTP-запрос отвечает версией установленного драйвера PostgreSQL ( libpq ).
Структура нашего приложения на данный момент следующая:
{"data":{"code":".\n├── Makefile\n├── Dockerfile\n├── example.config.yaml # конфигурационный файл\n├── pg-server.service # юнит systemd\n└── src\n └── main.cpp"},"id":"26anmf2mc5","type":"code"}
example.config.yaml :
{"data":{"code":"port: 3031"},"id":"jl1wt39nzf","type":"code"}
pg-server.service :
{"data":{"code":"[Unit]\nDescription=PostgreSQL version HTTP server\n\n[Service]\nType=simple\nExecStart=/usr/bin/pg-server --config /etc/pg-server/config.yaml\n\nDynamicUser=yes\nNoNewPrivileges=yes\nRestart=on-failure\nRestartSec=3\n\n[Install]\nWantedBy=multi-user.target"},"id":"dx79c56udx","type":"code"}
Мы хотим, чтобы наше приложение ставилось одной командой:
{"data":{"code":"apt-get install ./pg-server.deb"},"id":"wl3h8ma4aq","type":"code"}
А удаляться наше приложение должно так же легко, как и ставиться:
{"data":{"code":"apt-get remove pg-server"},"id":"wnwkrwebs2","type":"code"}
Начнём с ручного формирования deb-пакета. Первым делом обсудим структуру проекта, она будет следующей:
{"data":{"code":"├── Makefile\n├── packages\n│ ├── pg-server-amd64-dpkg\n│ │ ├── DEBIAN\n│ │ │ ├── control # описание пакета: имя, версия, архитектура\n│ │ │ ├── postinst # скрипт, выполняемый после установки\n│ │ │ └── prerm # скрипт, выполняемый перед удалением\n│ │ ├── etc\n│ │ │ └── pg-server\n│ │ │ └── config.yaml # конфигурационный файл проекта\n│ │ ├── lib\n│ │ │ └── systemd\n│ │ │ └── system\n│ │ │ └── pg-server.service # юнит systemd\n│ │ └── usr\n│ │ └── bin\n│ │ └── pg-server # наш бинарник\n│ └── pg-server-amd64-dpkg.deb\n└── src\n └── main.cpp"},"id":"052dvifx9h","type":"code"}
При первом взгляде на целевую картинку пакета можно заметить, что она повторяет то, как файлы будут располагаться на целевой машине: pg-server после установки попадёт в /usr/bin/pg-server , config.yaml - в /etc/pg-server/config.yaml , а юнит - в /lib/systemd/system/pg-server.service . Один из фокусов deb-пакетов раскрыт: куда встанет тот или иной файл, определяется при создании самого пакета.
Для начала соберём каркас пакета - папку с манифестом и пока пустыми скриптами:
{"data":{"code":"# Создаём каркас пакета\nmkdir -p packages/pg-server-amd64-dpkg/\nmkdir -p packages/pg-server-amd64-dpkg/DEBIAN/\n\n# Скрипты пока оставим пустыми - их содержимым займёмся ниже\ntouch packages/pg-server-amd64-dpkg/DEBIAN/control\ntouch packages/pg-server-amd64-dpkg/DEBIAN/postinst\ntouch packages/pg-server-amd64-dpkg/DEBIAN/prerm"},"id":"zp8vne3wsf","type":"code"}
packages/pg-server-amd64-dpkg/DEBIAN/control - здесь хранится манифест нашего проекта:
{"data":{"code":"Package: pg-server\nSection: utils\nPriority: optional\nVersion: 0.0.1\nMaintainer: Mochalov Anton <xoore4ik@gmail.com>\nStandards-Version: 3.9.4\nArchitecture: amd64\nDescription: Учимся собирать свой простой deb-пакет"},"id":"0zjdocmzvv","type":"code"}
Мы задаём название проекта, владельца пакета, архитектуру и описание. Разбор postinst , prerm и юнита systemd оставим на потом. Как только файл control готов, мы уже можем собрать наш deb-пакет - хоть изначально он и будет бесполезен:
{"data":{"code":"dpkg --build ./packages/pg-server-amd64-dpkg\nsudo apt-get install ./packages/pg-server-amd64-dpkg.deb"},"id":"hk18kx8ep3","type":"code"}
После установки пакета Linux хранит связь между пакетом и связанными с ним файлами, посмотреть её можно по пути /var/lib/dpkg/info/pg-server.list .
В нашем простом случае этот файл будет иметь следующий вид:
{"data":{"code":"cat /var/lib/dpkg/info/pg-server.list\n\n/."},"id":"yyj46r7kfk","type":"code"}
Единственная запись /. - это корень пакета: файлов в нём пока нет, только манифест.
Наполняем пакет
Теперь положим в пакет бинарник и конфигурацию. Сначала соберём сам сервер:
{"data":{"code":"# Собираем бинарник\nmake\n\n# Кладём исполняемый файл в пакет\nmkdir -p packages/pg-server-amd64-dpkg/usr/bin/\ncp pg-server packages/pg-server-amd64-dpkg/usr/bin/pg-server\n\n# Кладём конфигурационный файл\nmkdir -p packages/pg-server-amd64-dpkg/etc/pg-server/\ncp example.config.yaml packages/pg-server-amd64-dpkg/etc/pg-server/config.yaml"},"id":"kpydie5mgh","type":"code"}
Пересобираем и переустанавливаем. Нюанс: apt не станет ставить пакет, если его версия не изменилась - почему так происходит, разберём в главе про версионирование. Пока просто удалим и поставим заново:
{"data":{"code":"sudo apt-get remove pg-server\n\ndpkg --build ./packages/pg-server-amd64-dpkg\nsudo apt-get install ./packages/pg-server-amd64-dpkg.deb"},"id":"4ylhxlv1sf","type":"code"}
Проверяем, что файлы реально встали на свои места:
{"data":{"code":"cat /etc/pg-server/config.yaml\nport: 3031\n\nls /usr/bin/pg-server\n/usr/bin/pg-server"},"id":"14z0krwv4k","type":"code"}
Подключаем systemd
Сервер ставится и работает, но у нас же сервер - хочется, чтобы он управлялся через systemctl . Юнит pg-server.service у нас уже есть - мы показали его в «Дано». Кладём его туда, где systemd ищет юниты, - по пути из дерева выше:
{"data":{"code":"# Кладём юнит в пакет\nmkdir -p packages/pg-server-amd64-dpkg/lib/systemd/system/\ncp pg-server.service packages/pg-server-amd64-dpkg/lib/systemd/system/pg-server.service"},"id":"n0l72p48dw","type":"code"}
Пересобирать пакет уже сейчас не будем - сделаем это вместе со скриптами в следующем разделе.
Автозапуск: maintainer-скрипты
Ранее мы упоминали, что наш сервер должен автоматически запускаться сразу же после установки и корректно останавливаться после удаления пакета - не зря же мы положили в пакет systemd-юнит.
Здесь нам помогут maintainer-скрипты: preinst (pre-install), postinst (post-install), prerm (pre-remove) и postrm (post-remove). Названия говорят сами за себя - они выполняются до и после установки/удаления соответственно. В нашем пакете мы будем использовать postinst и prerm ; preinst и postrm упомянули для полноты картины.
Использовать эти файлы нужно аккуратно: установка пакета происходит от root, а значит и скрипты выполняются от root - в этот момент у нас в руках вся система.
В нашем случае мы сразу после установки запустим наш сервер ( postinst ), а при удалении выполним мягкий стоп ( prerm ):
{"data":{"code":"vi ./packages/pg-server-amd64-dpkg/DEBIAN/postinst\n\n#!/bin/sh\nsystemctl --system daemon-reload\nsystemctl enable pg-server\nsystemctl start pg-server"},"id":"dfyn6n5vn6","type":"code"}
{"data":{"code":"vi ./packages/pg-server-amd64-dpkg/DEBIAN/prerm\n\n#!/bin/sh\nsystemctl stop pg-server\nsystemctl --system daemon-reload"},"id":"gxg7b8gmp2","type":"code"}
dpkg не исправляет права сам - скрипты должны быть исполняемыми, иначе установка упадёт:
{"data":{"code":"chmod 755 ./packages/pg-server-amd64-dpkg/DEBIAN/postinst ./packages/pg-server-amd64-dpkg/DEBIAN/prerm"},"id":"jlreifeikt","type":"code"}
Мы изменили содержимое пакета, но разбором обновления пакетов займёмся позже, поэтому, как и раньше, просто удалим пакет, пересоберём его и поставим заново:
{"data":{"code":"sudo apt-get remove pg-server\ndpkg --build ./packages/pg-server-amd64-dpkg\nsudo apt-get install ./packages/pg-server-amd64-dpkg.deb"},"id":"90v8jlvr98","type":"code"}
Теперь проверим наш сервер и убедимся, что он автоматически запустился сразу же после установки:
{"data":{"code":"sudo systemctl status pg-server\n\n● pg-server.service - PostgreSQL version HTTP server\n Loaded: loaded (/lib/systemd/system/pg-server.service; enabled; vendor preset: enabled)\n Active: active (running) since Sun 2026-11-15 09:37:47 MSK; 40s ago\n Main PID: 1660198 (pg-server)\n Tasks: 1 (limit: 18676)\n Memory: 1.7M\n CPU: 17ms\n CGroup: /system.slice/pg-server.service\n └─1660198 /usr/bin/pg-server --config /etc/pg-server/config.yaml\n\nноя 15 09:37:47 ... systemd[1]: Started PostgreSQL version HTTP server.\nноя 15 09:37:47 ... pg-server[1660198]: Listening on http://127.0.0.1:3031"},"id":"7g4sj4oynf","type":"code"}
Проверим теперь, что при удалении пакета сервер автоматически остановится. Вывод systemctl status здесь не поможет - юнит исчезнет вместе с пакетом, поэтому подсмотрим в журнал systemd:
{"data":{"code":"sudo apt-get remove pg-server\njournalctl -u pg-server --no-pager | tail -n 3\n\nноя 15 09:41:02 ... systemd[1]: Stopping PostgreSQL version HTTP server...\nноя 15 09:41:02 ... systemd[1]: pg-server.service: Deactivated successfully.\nноя 15 09:41:02 ... systemd[1]: Stopped PostgreSQL version HTTP server."},"id":"g4zfkz8jxk","type":"code"}
prerm отработал: в момент удаления сервер был корректно остановлен. А сам юнит исчез вместе с пакетом:
{"data":{"code":"sudo systemctl status pg-server\n\nUnit pg-server.service could not be found."},"id":"gx9or3gd28","type":"code"}
На этом ручная сборка закончена. Заодно проявилось главное свойство пакета: он - снапшот того, каким мы хотим видеть состояние файловой системы на целевой машине.
Ранее мы отмечали: если внести изменения в пакет и отдать клиенту обновлённый .deb, у него ничего не произойдёт. Клиенту пришлось бы либо явно переустановить пакет ( apt-get install --reinstall ... ), либо сначала удалить старый ( apt-get remove pg-server ) и только потом поставить новый - это крайне неудобно.
В Linux обновление пакетов работает через версии: если версия пакета не изменилась, переустановка не произойдёт, даже если содержимое пакета изменилось.
Начнём с апгрейда. Изменим версию пакета в файле control , например, с 0.0.1 на 0.0.2 ( Version: 0.0.2 ), и попробуем поставить его поверх уже установленного:
{"data":{"code":"sudo apt-get install ./packages/pg-server-amd64-dpkg.deb\n\n\nReading package lists... Done\nBuilding dependency tree... Done\nReading state information... Done\nNote, selecting 'pg-server' instead of './packages/pg-server-amd64-dpkg.deb'\nThe following packages were automatically installed and are no longer required:\n libc++1-14 libc++abi1-14 libunwind-14\nUse 'sudo apt autoremove' to remove them.\nThe following packages will be upgraded:\n pg-server\n1 upgraded, 0 newly installed, 0 to remove and 112 not upgraded.\nNeed to get 0 B/20,2 kB of archives.\nAfter this operation, 0 B of additional disk space will be used.\nGet:1 /home/xoore4ik/X0re4ik/projects/deb-cpp-study/packages/pg-server-amd64-dpkg.deb pg-server amd64 0.0.2 [20,2 kB]\n(Reading database ... 418612 files and directories currently installed.)\nPreparing to unpack .../pg-server-amd64-dpkg.deb ...\nUnpacking pg-server (0.0.2) over (0.0.1) ... # <-- Смотреть сюда\nSetting up pg-server (0.0.2) ..."},"id":"s42si8m556","type":"code"}
apt сравнил версии, понял, что новая выше, и выполнил полноценный апгрейд.
А теперь попробуем поставить тот же самый пакет - с той же версией 0.0.2 - ещё раз:
{"data":{"code":"sudo apt-get install ./packages/pg-server-amd64-dpkg.deb\n\n\nReading package lists... Done\nBuilding dependency tree... Done\nReading state information... Done\nNote, selecting 'pg-server' instead of './packages/pg-server-amd64-dpkg.deb'\n\npg-server is already the newest version (0.0.2). # <-- Смотреть сюда\n\nThe following packages were automatically installed and are no longer required:\n libc++1-14 libc++abi1-14 libunwind-14\nUse 'sudo apt autoremove' to remove them.\n0 upgraded, 0 newly installed, 0 to remove and 112 not upgraded."},"id":"p3i3eebw1d","type":"code"}
Версия не изменилась - и dpkg даже не стал распаковывать содержимое, хотя внутри пакета мы могли что-то поменять. Именно поэтому после изменения пакета нужно поднимать его версию в control .
Все это время мы не замечали слона в комнате: ещё на первом шаге мы намеренно не указали Depends: - список библиотек, от которых зависит наше приложение. На моей машине, как и на вашей, все необходимые библиотеки уже установлены, поэтому всё работало. Но если перенести пакет на чистую систему, получим неприятный сюрприз. Проверим в изолированной ubuntu через docker:
{"data":{"code":"docker run --rm -it \\\n -v \"$PWD/packages:/packages:ro\" \\\n ubuntu:22.04 bash"},"id":"ve8gb9q9t6","type":"code"}
И внутри контейнера поставим наш пакет:
{"data":{"code":"apt-get update && apt-get install /packages/pg-server-amd64-dpkg.deb"},"id":"t9j87hnbb3","type":"code"}
Установка прошла успешно. Пробуем запустить сервер:
{"data":{"code":"/usr/bin/pg-server --config /etc/pg-server/config.yaml\n/usr/bin/pg-server: error while loading shared libraries: libpq.so.5: cannot open shared object file: No such file or directory"},"id":"gbw4gpypuy","type":"code"}
Пакет встал, но приложение не запускается. Всё потому, что наш сервер зависит от двух внешних библиотек - libpq и yaml-cpp - которые на чистой машине просто отсутствуют. Нам повезло, что на нашей машине они были.
Узнаем, от чего именно зависит наш бинарник:
{"data":{"code":"objdump -p ./pg-server | grep \"NEEDED\"\n NEEDED libpq.so.5\n NEEDED libyaml-cpp.so.0.7\n NEEDED libstdc++.so.6\n NEEDED libgcc_s.so.1\n NEEDED libc.so.6"},"id":"nzxc3npd3o","type":"code"}
Список NEEDED - это и есть содержимое Depends: в терминах deb-пакета. Причём libstdc++ , libgcc_s и libc есть в любой системе - их можно не указывать. А вот libpq.so.5 и libyaml-cpp.so.0.7 нужно обеспечить.
Где физически лежит библиотека, подскажет ldconfig - он хранит кэш того, что видит линковщик:
{"data":{"code":"sudo ldconfig -p | grep libpq.so.5\n libpq.so.5 (libc6,x86-64) => /lib/x86_64-linux-gnu/libpq.so.5"},"id":"m1blnknz0g","type":"code"}
Осталось понять, какому пакету принадлежит файл - это умеет dpkg , он хранит список файлов каждого установленного пакета:
{"data":{"code":"dpkg -S /usr/lib/x86_64-linux-gnu/libpq.so.5\nlibpq5\n\ndpkg -S /usr/lib/x86_64-linux-gnu/libyaml-cpp.so.0.7\nlibyaml-cpp0.7"},"id":"78v80yvq88","type":"code"}
Имена пакетов найдены - вписываем их в наш control :
{"data":{"code":"Package: pg-server\nSection: utils\nPriority: optional\nVersion: 0.0.2\nMaintainer: Mochalov Anton <xoore4ik@gmail.com>\nArchitecture: amd64\nDepends: libpq5, libyaml-cpp0.7\nDescription: Учимся собирать свой простой deb-пакет"},"id":"8vkzdg8emj","type":"code"}
Пересобираем и ставим на чистой машине ещё раз:
{"data":{"code":"apt-get install /packages/pg-server-amd64-dpkg.deb\n\nReading package lists... Done\nBuilding dependency tree... Done\nNote, selecting 'pg-server' instead of '/packages/pg-server-amd64-dpkg.deb'\nThe following additional packages will be installed:\n libldap-2.5-0 libldap-common libpq5 libsasl2-2 libsasl2-modules libsasl2-modules-db libyaml-cpp0.7\nThe following NEW packages will be installed:\n libldap-2.5-0 libldap-common libpq5 libsasl2-2 libsasl2-modules libsasl2-modules-db libyaml-cpp0.7 pg-server\n0 upgraded, 8 newly installed, 0 to remove and 2 not upgraded."},"id":"ynbtx6vm86","type":"code"}
Бинго! apt прочитал Depends: из control и сам дотянул недостающее - среди новых пакетов наши libpq5 и libyaml-cpp0.7 , а libldap и libsasl - это уже зависимости самой libpq . Сервер теперь запускается и на чистой системе.
Но вписывать зависимости руками - скучно и ненадёжно: забыл одну библиотеку - и пакет сломается на чужой машине. Логичный вопрос: можно ли автоматизировать и это? Можно - об этом следующая глава.
Конечно, всё то, что мы делали ранее руками, так уже никто не делает - мы прошли этот путь, чтобы понять, что никакой магии в работе пакетов нет. Современные инструменты заточены под автоматизацию сборки пакетов. Одним из самых популярных инструментов является dh_make . О нём есть несколько статей на habr, например тут и тут .
Я не хотел бы рассказывать о его работе и тонкостях настройки, так как статьи выше сделали это за меня. Я лишь покажу, что всё то, что мы создавали руками, умеет автоматизировать dh_make .
Для начала поставим инструменты: dh_make генерирует заготовку пакета, debhelper - набор помощников, которые эту заготовку собирают, а debuild - обёртка над dpkg-buildpackage , которая управляет всей сборкой:
{"data":{"code":"sudo apt-get install -y dh-make debhelper devscripts"},"id":"fwprak63ay","type":"code"}
Создаём наш debian-пакет:
{"data":{"code":"dh_make -p pg-server_0.0.1 --createorig"},"id":"1wm9lgxe5w","type":"code"}
По итогу получим следующую структуру, именно здесь мы и будем описывать наши systemd-юниты, пост/пре команды и документацию:
{"data":{"code":".\n└── debian\n ├── changelog\n ├── control\n ├── copyright\n ├── manpage.1.ex\n ├── manpage.md.ex\n ├── manpage.sgml.ex\n ├── manpage.xml.ex\n ├── pg-server.cron.d.ex\n ├── pg-server.doc-base.ex\n ├── pg-server-docs.docs\n ├── postinst.ex\n ├── postrm.ex\n ├── preinst.ex\n ├── prerm.ex\n ├── README.Debian\n ├── README.source\n ├── rules\n ├── salsa-ci.yml.ex\n ├── source\n │ └── format\n └── watch.ex"},"id":"yz9mp0ucaz","type":"code"}
Файлы с расширением .ex - это заготовки-примеры (manpage, cron, ci-конфиг и прочее). Они не используются, пока вы сами не переименуете их без суффикса, поэтому спокойно удаляем всё лишнее и оставляем только то, что нам действительно нужно.
Посмотрим на debian/control . Он устроен чуть иначе, чем наш ручной манифест, - разделён на две секции:
- Source - исходный проект и требования для его сборки;
- Package - описание устанавливаемого бинарного пакета.
{"data":{"code":"Source: pg-server\nSection: net\nPriority: optional\nMaintainer: Student Developer <student@example.com>\nBuild-Depends:\n debhelper-compat (= 13),\n g++,\n make,\n pkg-config,\n libpq-dev,\n libyaml-cpp-dev\nStandards-Version: 4.6.0\nRules-Requires-Root: no\n\nPackage: pg-server\nArchitecture: any\nDepends:\n ${shlibs:Depends},\n ${misc:Depends}\nDescription: Small HTTP server reporting the libpq version\n A small educational HTTP server written in C++.\n It reads the listening port from a YAML configuration file\n and reports the PostgreSQL client library version."},"id":"x68ovfxucz","type":"code"}
Здесь Build-Depends перечисляет то, что нужно для сборки пакета (компилятор, заголовочные файлы библиотек), а вот Depends мы указываем не руками, а заготовками-переменными:
{"data":{"code":"Depends:\n ${shlibs:Depends},\n ${misc:Depends}"},"id":"2sxzjj9413","type":"code"}
В момент сборки dpkg-shlibdeps просканирует наш бинарник, выяснит, с какими библиотеками он слинкован, найдёт пакеты-владельцы этих библиотек и запишет список в файл ./debian/pg-server.substvars . А debhelper в конце подставит этот список на место ${shlibs:Depends} в итоговом control .
Важный нюанс: если бы в debian/control не было ${shlibs:Depends} , ничего бы само не вписалось - переменная должна быть объявлена заранее. Это не магия, а простая подстановка.
Но откуда dpkg-shlibdeps знает, где лежит наш бинарник? Из debian/pg-server.install - файла, который описывает, какой файл в какой каталог устанавливать, по шаблону:
{"data":{"code":"исходный_файл каталог_назначения_в_пакете"},"id":"wi7djigbyi","type":"code"}
В нашем случае:
{"data":{"code":"vi ./debian/pg-server.install\n\npg-server /usr/bin"},"id":"h1hu0hj62h","type":"code"}
Обратите внимание: бинарник кладётся в /usr/bin - это та самая конвенция Debian, о которой мы говорили в «Дано»: содержимое пакетов ставится в /usr , а /usr/local остаётся территорией ручной установки администратором. Заодно эта же строка отвечает и на вопрос, как dpkg-shlibdeps найдёт бинарник для сканирования.
За файл lib/systemd/system/pg-server.service отвечает отдельный специализированный файл - debian/pg-server.service : debhelper увидит его и сам положит юнит в пакет. Юнит нам уже знаком - он лежал у нас в проекте с самого начала, поэтому просто копируем:
{"data":{"code":"cp pg-server.service ./debian/pg-server.service"},"id":"gz7y1vuatu","type":"code"}
Содержимое debian/rules - правила сборки. Именно здесь определяется, что и в какой последовательности выполняется:
{"data":{"code":"vi ./debian/rules\n\n#!/usr/bin/make -f\n\nexport DEB_BUILD_MAINT_OPTIONS = hardening=+all\ninclude /usr/share/dpkg/buildflags.mk\n\n%:\n\tdh $@ --buildsystem=makefile\n\noverride_dh_auto_install:"},"id":"p4m62jgxt4","type":"code"}
Пустой override_dh_auto_install - не случайность: он отключает дефолтный make install , и тогда debhelper раскладывает файлы по описанию из pg-server.install , а не по тому, что прописано в нашем Makefile.
Остался ещё один файл - debian/changelog . И он важнее, чем кажется: в этой схеме версию пакета задаёт именно он, а не Version: в control . Проверить, какую версию увидит сборщик, можно так:
{"data":{"code":"dpkg-parsechangelog -S Version"},"id":"ihdrx5ymck","type":"code"}
Заметьте: сборщик здесь очень капризный и ругается на любое отличие от эталонного формата changelog.
Нам остаётся выполнить debuild -us -uc -b и наблюдать магию:
{"data":{"code":"debuild -us -uc -b"},"id":"4r46949duo","type":"code"}
Итоговая структура проекта будет следующая:
{"data":{"code":"./debian/pg-server/\n├── DEBIAN\n│ ├── control\n│ ├── md5sums\n│ ├── postinst\n│ ├── postrm\n│ └── prerm\n├── lib\n│ └── systemd\n│ └── system\n│ └── pg-server.service\n└── usr\n ├── bin\n │ └── pg-server\n └── share\n └── doc\n └── pg-server\n ├── changelog.Debian.gz\n ├── copyright\n └── README.Debian"},"id":"zh3wcdopgr","type":"code"}
И здесь мы видим, что debuild сделал всё то, что ранее делали мы сами - он аккуратно разложил файлы в нужные каталоги, самостоятельно вписал Depends в control-файл - пакет создан и готов к запуску.
На протяжении этого небольшого урока мы собирали пакет на машине и на ней же его устанавливали. Но нам, конечно же, хочется разместить наш пакетик в репозитории артефактов и раздавать оттуда. Для этого в проекте есть docker-compose.yml с запуском nexus : Часть разворачивания nexus и его настройки опустим, ведь есть прекрасная статья на эту тему здесь .
Условимся, что на данном этапе вы запустили nexus локально на порту :8081, создали репозиторий артефактов apt и пользователя для скачивания дистрибутивов.
{"data":{"code":"docker compose up -d"},"id":"wj6vzw5enw","type":"code"}
Теперь наш пакет должен появиться в репозитории. Проще всего залить его через UI: в Nexus откроем Upload → выберем наш apt-репозиторий ( my-debian ) → добавим pg-server-amd64-dpkg.deb → Upload.
Чтобы пакет стал доступен apt-get , сообщим системе адрес нашего репозитория. Список репозиториев apt берёт из /etc/apt/sources.list.d/ - положим туда файл nexus.list :
{"data":{"code":"echo 'deb [trusted=yes] http://localhost:8081/repository/my-debian/ jammy main' | sudo tee /etc/apt/sources.list.d/nexus.list"},"id":"f8pab0cdjn","type":"code"}
Конечно же, для наших приватных пакетов нужны логин и пароль. Для этого в Linux есть специальная папка: /etc/apt/auth.conf.d/ . При попытке скачать какой-либо дистрибутив Linux найдёт подходящий хост среди файлов папки /etc/apt/auth.conf.d/ :
{"data":{"code":"sudo vi /etc/apt/auth.conf.d/nexus.conf\n\nmachine localhost:8081\nlogin <NEXUS-USER>\npassword <NEXUS-PASSWORD>"},"id":"l3qtqarnus","type":"code"}
Теперь можем смело выполнять sudo apt-get update - Linux заглянет в наш репозиторий и сохранит список доступных пакетов, после чего нам станет доступен apt-get install pg-server . Проверим заветную команду на чистой машине:
{"data":{"code":"sudo apt-get update\nsudo apt-get install pg-server"},"id":"gwx9qco657","type":"code"}
Пакет, который мы час назад собирали руками, ставится из нашего репозитория одной командой - без пути к .deb , без remove перед установкой и на любой машине, у которой есть доступ к Nexus.
Вот и всё! Спасибо большое, что дошли до этой главы, - значит, что-то интересное всё-таки было :) Теперь мы с Вами знаем чуть больше про магию deb-пакетов в Linux.
Спасибо большое за прочтение этой скромной статьи, буду рад комментариям под постом 🙌
Охуеть вкуснятина
заорал как чмошник
почему "как"???