deb编译构建指南

deb

仓库同步

工具 apt-mirror

基本配置：

/etc/apt/mirror.list

############# config ##################
#
# set base_path    /var/spool/apt-mirror
#
# set mirror_path  $base_path/mirror
# set skel_path    $base_path/skel
# set var_path     $base_path/var
# set cleanscript $var_path/clean.sh
# set defaultarch  <running host architecture>
# set postmirror_script $var_path/postmirror.sh
# set run_postmirror 0
set base_path    /data/upstream/
set mirror_path  $base_path/mirror
set skel_path    $base_path/skel
set var_path     $base_path/var
set nthreads     20
set run_postmirror 0

############# end config ##############

deb http://security./ubuntu precise-security main restricted universe multiverse
deb-src http://security./ubuntu precise-security main restricted universe multiverse

结合crond 每天自动同步

/etc/cron.d/apt-mirror
0 1 * * * root /usr/bin/apt-mirror &> /data/log/cron.log &

软件包编译

apt-get install build-essential dpkg-dev dh-make debhelper dpkg-sign 

gcc        GNU C语言编译器
g++        GNU C++语言编译器
make       GNU自动化构建工具 
autotools  autoconf automake 工具集  
dpkg-dev   这个软件包包括了在解开、制作、上传Debian源文件包时需要用到的工具
diff/patch 源码补丁制作与补丁管理工具
fakeroot   模拟变成root用户，这在创建软件包的过程的一些部分是必要的
dh-make    提供了我们需要用到的 dh_make 命令,用于根据上游tarball生成我们deb包模板
debhelper  包含dh开头的命令集合,主要用于简化rules文件的编写，把一些通用，重复的操作用perl命令来代替。  
gnupg      加密签名相关
dpkg-sign  deb包签名工具

修改来自上游仓库的软件包简要示例

apt-get source zip
cd zip-3.0
apt-get build-dep zip -y
…
dpkg-buildpackage -a

从软件源码包开始制作deb包

wget http://ftp.gnu.org/gnu/tar/tar-1.26.tar.bz2
tar -xvpf tar-1.26.tar.bz2
cd tar-1.26
dh_make -e [e-mail] -f ../tar-1.26.tar.bz2
… 
debian/rules
debian/changlog
dpkg-buildpackage -a
...

debian目录的重要文件

debian/control      定义二进制deb包的名称，编译依赖，安装依赖等信息
debian/changelog        记录软件包修订版记录，以及定义版本号码
debian/compat           定义对 debhelper 最低版本要求 
debian/source/format    定义 deb 源代码包格式   
Idebian/copyright       定义版权信息

更多细节参考

＊ [ https://www./doc/manuals/maint-guide/index.en.html ]
＊ [ https://www./doc/debian-policy/ ］

debian/rules 解析

rules文件本质上是一个Makefile文件，这个Makefile文件定义了创建deb格式软件包的规则。打包工具按照rules文件指定的规则，完成编译，将软件安装到临时安装目录 debiani/tmpdir，清理编译目录等操作，并依据安装到临时目录的文件来生成deb格式的软件包。

rules文件一般会包含，”binary-arch”, ”binary-indep”, ”binary”，”build”, ”clean”, ”install”, 等targets。

从源码安装开始

基于 autotools 制作的源码包编译安装,通常为如下步骤

./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man --localstatedir=/var 
make -j16
make install
make clean

创建一个简单的 debian/rules

#!/usr/bin/make -f

binary:build install 
    dh_gencontrol
    dh_md5sums 
    dh_builddeb 
binary-indep: binary
binary-arch: binary
build:
    ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man --localstatedir=/var
    make -j16
install:
        make install DSEDIR=./debian/tmpdir/    
clean:
    make clean
    rm -rf debian/tmpdir/

全部操作 使用 debhelper 命令集来简化 debian/rules 的编写

#!/usr/bin/make -f

binary:build install 
    dh_gencontrol
    dh_md5sums 
    dh_builddeb 
binary-indep: binary
binary-arch: binary
build:
    dh_auto_configure
    dh_auto_build
install:
        dh_auto_install
clean:
        dh_auto_clean

使用默认的rules

在新版本中，dh_make 会使用默认的dh $@ 指令 来进一步简化 rules 文件的编写

%:
    dh $@

使用 dh $@时，dh_make会执行一系列的默认的dh_命令，具体请参考 [ http://www./doc/manuals/maint-guide/dreq.zh-cn.html#defaultrules ]

这一系列的默认的dh命令，不能满足所有软件包的编译安装，我们可以通过 override_来重新定义 dh命令，示例如下:

%:
        dh $@ --with python2

override_dh_install:
        python setup.py install --root=$(CURDIR)/debian/timelib --prefix=/usr --install-layout=deb

override_dh_auto_clean:
        dh_auto_clean
        rm -rf $(CURDIR)/debian/timelib

dh命令简要解析

dh是debhelper包中的命令序列，dh开头的命令主要用于简化rules文件的编写，把一些通用的重复的操作用perl命令来代替。

下面是一些dh命令和实际对应执行的操作的简要介绍

dh_auto_clean           make distclean
dh_auto_configure       ./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var ...
dh_auto_build           make
dh_auto_test            make test
dh_auto_install         make install DESTDIR=/path/to/package_version-revision/debian/package 
以上的targets 如果需要 fakeroot 操作，则需要加上dh_testroot

deb包的执行脚本

许多软件安装前或安装后都需要进行一些设置工作，deb格式的软件安装过程执行的操作是由如下脚本来控制的

debian/preinst    安装前执行脚本
debian/postinst   安装后执行脚本
debian/prerm      卸载前执行脚本
debian/postrm     卸载后执行脚本

deb源代码包新格式

• Format：1.0 一个 .dsc 文件，一个 .orig.tar.gz 文件，一个 .diff.gz 文件 　　
• Format：2.0 这个格式不建议广泛使用，是个过渡格式
• Format：3.0 (native) 包含了 debian 化的所有更改全部在一个压缩包中　　
• Format：3.0 (quilt) 一个 .dsc 文件, 一个 .debian.tar.{gz,bz2,lzma} 包含了 debian 化的所有更改, 零个或者多个 .orig-.tar.{gz,bz2,lzma}， 　　
• Format：3.0 (git) 实验性质的，源代码包和版本控制系统 (git) 的结合
• Format：3.0 (bzr) 实验性质的，源代码包和版本控制系统 (bzr) 的结合

deb 签名

生成签名所需的密钥

# gpg --gen-key
# gpg --list-keys
# gpg --export -a 6A9E1B52 > key.pub
# apt-key add key.pub

用户需要将这个公钥key.pub下载添加到系统的keyring中，就可以使用对应签过名的软件包

给deb软件包签名

给软件包签名指令如下,需要输入之前生成公钥时的密码，：

dpkg-sig -k keyid --sign builder /your_packages_<version>_<architecture>.deb

Keyid          为之前生成的公钥ID， 
--sign builder 后面为deb全路径和deb包

参考文档 [ http://blog.csdn.net/michaelwubo/article/details/keyid ]

其他进阶工具

• debootstrap 构建临时环境
• devscripts 辅助脚本集合
• pbuilder 用于创建和维护chroot环境的程序。在此chroot环境中构建Debian可以检查构建软件包的依赖关系的正确性
• ccache 用于缓存编译临时文件，加快编译

介绍下pbuilder 的基本用法

pbuilder create
pbuilder build  *.dsc

• https://wiki./PbuilderHowto

参考文档：

http:///build/
http://www./
https://wiki./buildd

仓库管理

工具 reprepro 一个快速搭建deb软件仓库的工具。

安装 apt-get install reprepro -y

使用

创建配置文件，比如仓库目录在/var/www/repo 为例

cd /var/www/repo/
cat > conf/distributions << "EOF"
Origin: regulus
Label:  wheezy
Codename: wheezy
Architectures: i386 amd64 source 
Components: main
Version: 2015.4.17
Description: regulus.intra.repo 2015.4.17
EOF

更新仓库

reprepro includedeb wheezy pkgdir/*.deb
reprepro includedsc wheezy pkgdir/*.dsc

/var/www/repo/
conf/  
db/..  
dists/..  
pool/..

创建ISO

build-simple-cdd --conf ./custom.conf

• https://wiki./Debootstrap/
• https://wiki./Simple-CDD/Howto
• https://wiki./DebianCustomCD
• http:///browse/stable/sect.automated-installation.html#sect.simple-cdd