deb与rpm打包

阅读量

0x00 引言

   Debian下的安装包后缀名.deb，Unix服务器的安装包后缀名一般为.rpm 。本文主要研究如何打这两种包。

0x01 rpm打包

  rpm打包默认是以源码打包的形式，当然也可以利用这种机制实现非源码打包。

1
2
3
4
5
6
7
8
1 环境搭建
2 基础知识构建
  2.1 rpm打包文件结构
  2.2 rpm目录路径宏
  2.3 rpm常用路径宏
  2.4 SPEC文件执行流程
3 源码打包示例
4 非源码打包示例

1、环境搭建
   这里以centos7为rpm打包平台，具体的环境配置已经在仓库里面，可以自行查阅资料[1]。

2、基础知识构建
2.1、rpm打包文件结构
   rpmdev-setuptree命令由工具rpmdevtools提供，可以直接在/root/rpmbuild/目录下生成rpm打包所需的目录结构。下面具体描述各个文件夹的作用: 

1
2
3
4
5
6
7
$ tree /root/rpmbuild
rpmbuild
├── SOURCES    # 源码路径
├── BUILD      # 源码编译路径
├── SPECS      # rpm生成规则存放路径
├── RPMS       # rpm包生成路径
└── SRPMS      # rpm源码包生成路径
  • SOURCES - 如果是用源码打包，则只需要将源码的tar.gz文件存放于此即可;
  • BUILD - rpmbuild工具会自行将SOURCES目录中的源码在此处解压，该文件无需手动修改，具体编译方法需要在SPECS下的.spec文件中描述;
  • SPECS - 需要人工操作的只有该文件夹，里面可以存放各种rpm打包规则的.spec文件，后面详细介绍;
  • RPMS - 当打包完成，会在此处生成release与debug版的.rpm包;
  • SRPMS - 当打包完成，会在此处生成源码.rpm包;
  • *BUILDROOT - 该目录是在SPECS打包过程中自动生成的，其重要性是最后打完的包需要安装的文件及其路径都以该目录为模板。

2.2、rpm目录路径宏
   各路径宏参考文献[2]

目录 宏代码 用途
/root/rpmbuild/SOURCES %_sourcedir 保存源码包（如 .tar 包）和所有 patch 补丁
/root/rpmbuild/BUILD %_builddir 源码包被解压至此，并在该目录的子目录完成编译
/root/rpmbuild/BUILDROOT %_buildrootdir 保存 %install 阶段安装的文件
/root/rpmbuild/SPECS %_specdir 保存 RPM 包配置（.spec）文件
/root/rpmbuild/RPMS %_rpmdir 生成/保存二进制 RPM 包
/root/rpmbuild/SRPMS %_srcrpmdir 生成/保存源码 RPM 包(SRPM)

2.3、rpm常用路径宏
   各路径宏参考文献[2]

路径 宏
/etc %{_sysconfdir}
/usr %{_prefix}
%{_prefix} %{_exec_prefix}
%{_exec_prefix}/bin %{_bindir}
%{_exec_prefix}/%{_lib} %{_libdir}
%{_exec_prefix}/libexec %{_libexecdir}
%{_exec_prefix}/sbin %{_sbindir}
/var/lib %{_sharedstatedir}
%{_prefix}/share %{_datarootdir}
%{_datarootdir} %{_datadir}
%{_prefix}/include %{_includedir}
/usr/share/info %{_infodir}
/usr/share/man %{_mandir}
/var %{_localstatedir}
%{_sysconfdir}/rc.d/init.d %{_initddir}
/var %{_var}
%{_var}/tmp %{_tmppath}
/usr %{_usr}
%{_usr}/src %{_usrsrc}
lib (lib64 on 64bit multilib systems) %{_lib}
%{_datadir}/doc %{_docdir}
%{_buildrootdir}/%{name}-%{version}-%{release}.%{_arch} %{buildroot}
%{buildroot} $RPM_BUILD_ROOT

2.4、SPEC文件执行流程 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 升级时完整执行流程：
1、执行新包spec文件中 %pre 段.
2、安装新包的相关依赖包.
3、执行新包spec文件中的 %post 段.
4、执行旧包spec文件中的 %preun 段.
5、删除新包中不需要的旧文件。
6、执行旧包spec文件中的 %postun 段.

# 完整参数传递：
%pre和%post段
当传递的第一个参数为1时，表示新安装一个rpm包。
当传递的第一个参数为2时，表示升级一个已经存在的包。
%preun和%postun段
当传递的第一个参数为0时，表示删除一个包。
当传递的第一个参数为1时，表示更新一个包。

3、源码打包示例
   SPECS撰写方法参考文献[3]，这里以最后实现的一个rpm项目打包为例。首先要在/root/rpmbuild/SPECS/目录下新建一个.spec文件，并且内部需要实现一些字段，下面解释各个部分的作用:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# 项目名
name: CTest
# 项目版本
Version: 1.0
# 发布序列号
Release: 1%{?dist}
# 概要
Summary: The "CTest" program from GNU
Summary(zh_CN):  GNU "Hello World" 程序
# 开源协议
License: GPLv3+
# 源代码路径，即放在SOURCES目录下的tar包名
Source0: %{name}.tar.gz

# 简介
%description
The "CTest" program

# 简介中文
%description -l zh_CN
"CTest" 程序

# rpm进行实际打包准备工作的阶段
%prep

# rpm安装前执行的脚本
%prep
# 作用: 将解压后的源码重命名为/root/rpmbuild/BUILD/CTest/
%setup -n CTest

# rpm安装后执行的脚本
%post

# rpm卸载前执行的脚本
%preun

# rpm卸载后执行的脚本
%postun

# build默认 cd /root/rpmbuild/BUILD/CTest/ 目录下
%build
mkdir build
cd build
cmake ..
make %{?_smp_mflags}

# install默认 cd /root/rpmbuild/BUILD/CTest/ 目录下
# 开始把软件安装到虚拟的根目录中，正规写法应该是在MakeFile里面些install
# 虚拟根目录即 /root/rpmbuild/BUILDROOT/’包名‘
# 可以用宏 $RPM_BUILD_ROOT 或 %{buildroot} 代替
%install
mkdir -p %{buildroot}%{_bindir}
cd build
cp CTest %{buildroot}%{_bindir}

# files能指定最终打包到安装包的文件
# !!files默认 cd /root/rpmbuild/BUILDROOT/'包名'/ 目录下
# %defattr(文件权限,用户名,组名,目录权限),其中'-'表示默认权限
%files
%defattr(-,root,root,-)
%{_bindir}/*

# 变更日志
%changelog
* Sun MAY 4 2021 Your Name <youremail@xxx.xxx> - 1.0
- Update to 1.0

  最后只需要执行生成rpm包的指令:

1
rpmbuild -ba '.spec文件路径'

4、非源码打包示例
   如果无源码，只有一些已经编译完成的链接库与可执行文件，则可以借用打包机制，跳过编译步骤，直接将需要打入rpm包的文件拷贝到/root/rpmbuild/BUILDROOT/目录下:

1
2
3
4
5
6
7
8
9
# rpm进行实际打包准备工作的阶段
%prep
mkdir -p %{buildroot}/'文件安装的路径'
cp -r '要存放的文件夹' %{buildroot}/'文件安装的路径'

# files能指定最终打包到安装包的文件
%files
%defattr(-,root,root,-)
%'需要打包的路径'

  最后只需要执行生成rpm包的指令:

1
rpmbuild -ba '.spec文件路径'

0x02 deb打包

  虽然deb打包的网上资料较少，但是实际上也是能实现源码与非源码打包的，并且天然支持CMake。可以参考下debian维护手册[4]。
  打包方法总共有三种:

  • debuild - 这种方法较复杂但是做的事情最多。该方法会创建上传Debian软件包所需的所有文件。它首先运行 dpkg-buildpackage，然后在创建的 .changes 文件上运行 lintian（假设安装了 lintian，这是一个 Debian 上面的包质量的检测工具），最后根据需要对 .changes 和/或 .dsc 文件进行签名。
  • dpkg-buildpackage - debuild方法的第一步，如果不做签名等复杂操作，这个方法足矣
  • dpkg-deb - 这种方法是为了快速打包，并且只能非源码打包，但并不是常用的方法，相比之下，还是使用dpkg-buildpackage更好
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    1 环境搭建
    2 基础知识
      2.1 deb打包文件结构
      2.2 debian/control文件详解
      2.3 debian/rules文件详解
      2.4 debian/install文件详解
      2.5 deb打包钩子脚本执行流程
      2.6 deb打包时环境变量
    3 源码打包示例
    4 非源码打包示例

1、环境搭建 

1
2
3
4
5
6
7
8
# debuild环境
sudo apt install dh-make devscripts cmake gcc

# dpkg-buildpackage环境
sudo apt install dh-make cmake gcc

# dpkg-deb环境
sudo apt install fakeroot cmake gcc

2、基础知识
2.1、deb打包文件结构
   debian / DEBIAN 目录可以使用dh_make工具自动生成。下面具体描述debian文件夹各文件的作用: 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# 首先新建一个 <包名>-<版本号> 的目录
# 使用dh_make自动生成debian包，选择'single' 'Y'
$ dh_make --native

# debian目录初始生成结构如下
# debian: dpkg-buildpackage指令使用小写目录名
# DEBIAN: dpkg-deb指令使用大写目录名
`
debian/
├── changelog          # 包的更新历史，后面可以使用dch -i指令修改
├── compat             # 包的兼容性，与debian policy版本有关
├── control            # 包的描述信息
├── copyright          # 包的版权信息
├── ctest.cron.d.ex
├── ctest.default.ex
├── ctest.doc-base.EX
├── ctest-docs.docs
├── init.d.ex
├── manpage.1.ex
├── manpage.sgml.ex
├── manpage.xml.ex
├── menu.ex
├── postinst.ex        # 安装后执行脚本，使用前去掉.ex后缀
├── postrm.ex          # 卸载后执行脚本，使用前去掉.ex后缀
├── preinst.ex         # 安装前执行脚本，使用前去掉.ex后缀
├── prerm.ex           # 卸载前执行脚本，使用前去掉.ex后缀
├── README.Debian
├── README.source
├── rules              # 包的编译方法
├── source
│   └── format         # 包的版本
└── watch.ex           # 包的升级链接，使用前去掉.ex后缀
`

  将debian目录尽量简化，打包示例中的debian目录结构如下:

1
2
3
4
5
debian
├── changelog
├── compat
├── control
└── rules

2.2、debian/control文件详解
  control文件是最重要的，这边给出打包示例中control文件的详细内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Source: ctest  # 这就是根据tar.gz包名自动生成的项目名
Section: unknown  # 该源码包要进入发行版中的分类
Priority: optional  # 描述用户安装该包的重要程度
Maintainer: xyh <yhxu94@126.com>  # 源码维护者的名字和邮箱
Build-Depends: debhelper (>=9)  # 编译依赖
 cmake,
 qtbase5-dev
Standards-Version: 3.9.6  # 此软件包所依据的“Debian Policy Manual”标准版本号
Homepage: https://jailbreakfox.github.io/

Package: ctest  # 二进制软件包的名称。通常情况下与源代码包相同，但不是必须的
Architecture: any  # 目标机架构，可以是其他架构，比如amd64
# Debian软件包系统最强大的特性之一。每个软件包都可以和其他软件包有各种不同的关系
Depends: ${shlibs:Depends}, ${misc:Depends}  # 运行时依赖
Recommends: XXXX(>=5.1.0.0)   # 建议依赖，不影响使用
Description:  # 软件的简短描述

2.3、debian/rules文件详解
  还有一个很重要的文件就是rules，在不知道如何使用的情况下，使用初始化的rules文件即可。
  rules文件本质上是一个Makefile文件，这个Makefile文件定义了创建deb格式软件包的规则。打包工具按照rules文件指定的规则，完成编译，将软件安装到临时安装目录，清理编译目录等操作，并依据安装到临时目录的文件来生成deb格式的软件包。

1
2
3
4
5
6
7
8
#!/usr/bin/make -f
# -*- makefile -*-
# Uncomment this to turn on verbose mode.
#export DH_VERBOSE=1  打开后编译输出更详细
#export DH_BUILD_OPTIONS=nocheck  可以跳过编译后的测试，对于某些编译不过的包有效

%:
  dh $@

  实际上rules文件的dh语言是由debhelper工具来解析的，不要看上面只有短短一行语句，但实际上它的进化简化过程很漫长:

2.4、debian/install文件详解
  还有一个文件对于非源码打包作用很大，即debian/install。如果你的软件包需要那些标准的make install没有安装的文件，你可以把文件名和目标路径写入 debian/install文件，它们将被 dh_install安装:

1
2
3
4
5
6
# 假设有个空文件的tar.gz包，文件结构如下
$ tree test-1.0
test-1.0/
├── debian
│   └── install
└── 1.md

  install的初始位置就是在打包根目录下，install文件可以这样写(注意install文件的属性、所属者必须与其他文件一致):

1
2
#!/bin/bash
cp 1.md /home

2.5、deb打包钩子脚本执行流程 

1
2
3
4
5
6
7
8
9
10
11
# 首次安装某deb包时，执行dpkg -i test_v1.deb安装，DEBIAN下面控制脚本按如下顺序执行：
preinst->postinst

# 若卸载deb，但保留配置档，执行dpkg -r test，DEBIAN下面控制脚本按如下顺序执行：
prerm->postrm

# 若卸载不保留配置档，执行dpkg -P test，DEBIAN下面控制脚本按如下顺序执行：
prerm->postrm(remove)->postrm(purge)

# 若升级安装,例如执行dpkg -i test_v2.deb，DEBIAN下面的控制脚本执行顺序如下：
prerm->preinst->postrm->postinst

2.6、deb打包时环境变量

1
2
3
4
# 包名
DPKG_MAINTSCRIPT_NAME
# 架构名
DPKG_MAINTSCRIPT_ARCH

3、源码打包示例
  deb源码打包只能使用debuild / dpkg-buildpackage的方法，其特点就是能够直接识别CMakeLists.txt文件，并自动编译。现以一个实例程序展示源码打包的流程: 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 使用dh_make自动生成debian包，选择'single' 'Y'
$ tree .
ctest-1.0
├── CMakeLists.txt
├── CTest.cpp
└── debian

# 使用 debuild / dpkg-buildpackage / dpkg-deb 去生成deb包
# $ debuild -us -uc -b
$ dpkg-buildpackage -us -uc -b
# $ fakeroot dpkg-deb -b ctest-1.0 ctest-1.0.deb

# 使用dh clean清理生成的多余文件
$ dh clean

4、非源码打包示例
  非源码打包可以使用debian/install文件安装或者打包目录下的文件结构，前者可在钩子脚本指定安装位置，后者可在用户安装deb包的时候自动放入对应的文件系统中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 在打包根目录下新建1.md 2.md
# 注意，dpkg-deb需要将debian改成DEBIAN
$ tree .
ftest-1.0
├── 1.md
└── debian
    ├── install # 文件安装控制
    └── postinst # 安装后钩子脚本

# 添加debian/install文件，内容如下
`
#!/bin/bash
cp 1.md /home
`

# 添加debian/postinst文件，内容如下
`
#!/bin/bash
echo "postinst modify test" >> /home/1.md
`

# 使用 debuild / dpkg-buildpackage / dpkg-deb 去生成deb包
# $ debuild -us -uc -b
$ dpkg-buildpackage -us -uc -b
# $ fakeroot dpkg-deb -b ctest-1.0 ctest-1.0.deb

# 使用dh clean清理生成的多余文件
$ dh clean

0x03 dpkg基础 知识

1
2
1 常用命令
2 路径释义

1、常用命令 

1
2
3
4
5
6
7
8
9
10
11
12
# 安装
dpkg -i '包路径'

# 卸载(不卸载配置文件)
dpkg -r '包路径'

# 卸载(卸载配置文件)
dpkg -P '包路径'

# 查看安装状态
# 第一列 ii 代表成功安装
dpkg -l

2、路径释义

  • /var/lib/dpkg/status: 查看包当前状态
  • /var/lib/dpkg/info/: 包含安装包的配置文件(钩子脚本都能在此修改)

0x04 引用文献

[1]https://github.com/JailbreakFox/Linux-sh-package/blob/master/Centos/Centos%20Mini.md
[2]https://blog.csdn.net/get_set/article/details/53453320
[3]https://www.cnblogs.com/SQL888/p/5776442.html
[4]https://www.debian.org/doc/manuals/maint-guide/index.zh-cn.html

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

致力于创造风靡全球的机器人<br><br>迈向CyberPunk的新世界<br>Never STOP!