当前位置: > Linux集群 > Ceph >

ceph存储 Centos下建立RPM包中spec文件编写说明书

时间:2015-10-17 01:10来源:linux.it.net.cn 作者:IT

Centos RPM Build Shell SPEC FILE INSTRUCTIONS

一、概述

Rpm包制作最重要的就是编写.spec脚本。rpm建包的原理其实并不复杂,可以理解为按照标准的格式整理一些信息,包括:软件基础信息,以及安装、卸载前后执行的脚本,对源码包解压、打补丁、编译,安装路径和文件等。

   实际过程中,最关键的地方,是要清楚虚拟路径的位置,以及宏的定义

我自己的编写示例,可以单击下载:http://download.csdn.net/detail/skdkjxy/8237031

二、关键字

spec脚本包括很多关键字,主要有:

Name:

 软件包的名称,后面可使用%{name}的方式引用

Summary:

软件包的内容概要

Version:

软件的实际版本号,例如:1.0.1等,后面可使用%{version}引用

Release:

 发布序列号,例如:1 linuxing等,标明第几次打包,后面可使用%{release}引用

Group:

 软件分组,建议使用标准分组

License:

 软件授权方式,通常就是GPL或者MIT

Source:

 源代码包,可以带多个用Source1Source2等源,后面也可以用%{source1}%{source2}引用

BuildRoot:

这个是安装或编译时使用的虚拟目录,考虑到多用户的环境,一般定义为:

%{_tmppath}/%{name}-%{version}-%{release}-root

%{_tmppath}/%{name}-%{version}-%{release}-buildroot-%(%{__id_u}-n}

该参数非常重要,因为在生成rpm的过程中,执行make install时就会把软件安装到上述的路径中,在打包的时候,同样依赖虚拟目录根目录进行操作。后面可使用$RPM_BUILD_ROOT方式引用。

URL:

软件的主页

Vendor:

发行商或打包组织的信息,例如RedFlag Co,Ltd

Disstribution:

发行版标识

Patch:

补丁源码,可使用Patch1Patch2等标识多个补丁,使用%patch0%{patch0}引用

Prefix:

%{_prefix}这个主要是为了解决今后安装rpm包时,并不一定把软件安装到rpm中打包的目录的情况。这样,必须在这里定义该标识,并在编写%install脚本的时候引用,才能实现rpm安装时重新指定位置的功能

Prefix:

%{_sysconfdir}这个原因和上面的一样,但由于%{_prefix}/usr,而对于其他的文件,例如/etc下的配置文件,则需要用%{_sysconfdir}标识

Build Arch:

指编译的目标处理器架构,noarch标识不指定,但通常都是以/usr/share/doc/rpm-4.8.0/marcros中的内容为默认值

Requires:

rpm包所依赖的软件包名称,可以用>=<=表示大于或小于某一特定版本,例如:libpng-devel>= 1.0.20 zlib

注:“>=”号两边需用空格隔开,而不同软件名称也用空格分开还有例如PreReqRequires(pre)Requires(post)Requires(preun)Requires(postun)BuildRequires等都是针对不同阶段的依赖指定

Provides:

指明本软件一些特定的功能,以便其他rpm识别

Packager:

打包者的信息

%description

 软件的详细说明

三、spec脚本主体

spec脚本的主体中也包括了很多关键字和描述,下面会一一列举。我会把一些特别需要留意的地方标注出来。

%prep预处理脚本:

%setup -n%{name}-%{version}把源码包解压并放好通常是从/root/SOURCES里的包解压到/root/BUILD/%{name}-%{version}中。一般用%setup-c就可以了,但有两种情况:一就是同时编译多个源码包,二就是源码的tar包的名称与解压出来的目录不一致,此时,就需要使用-n参数指定一下了。

%patch打补丁

通常补丁都会一起在源码tar.gz包中,或放到SOURCES目录下。一般参数为:%patch -p1 使用前面定义的Patch补丁进行,-p1是忽略patch的第一层目录%Patch2 -p1 -bxxx.patch 打上指定的补丁,-b是指生成备份文件。

针对%setup%patch做如下补充:

%setup不加任何选项,仅将软件包打开。
%setup -n newdir 将软件包解压在newdir目录。
%setup -c 解压缩之前先产生目录。
%setup -q 安静模式进行解压
%setup -b num 将第numsource文件解压缩。
%setup -T 不使用default的解压缩操作。
%setup -T -b 0 将第0个源代码文件解压缩。
%setup -c -n newdir 指定目录名称newdir,并在此目录产生rpm套件。
%patch 最简单的补丁方式,自动指定patch level
%patch 0 使用第0个补丁文件,相当于%patch ?p 0
%patch -s 不显示打补丁时的信息。
%patch -T 将所有打补丁时产生的输出文件删除。

%configure

这个不是关键字,而是rpm定义的标准宏命令。意思是执行源代码的configure配置在/root/BUILD/%{name}-%{version}目录中进行,使用标准写法,会引用/usr/share/doc/rpm-4.8.0/marcros中定义的参数。另一种不标准的写法是,可参考源码中的参数自定义,例如:

CFLAGS="$RPM_OPT_FLAGS" CXXFLAGS="$RPM_OPT_FLAGS"./configure --prefix=%{_prefix}

%build开始构建包

/root/BUILD/%{name}-%{version}目录中进行make的工作,常见写法:

make %{?_smp_mflags}OPTIMIZE="%{optflags}"都是一些优化参数,定义在/usr/share/doc/rpm-4.8.0/marcros

%install开始把软件安装到虚拟的根目录中

/root/BUILD/%{name}-%{version}目录中进行make install的操作。这个很重要,因为如果这里的路径不对的话,则下面%file中寻找文件的时候就会失败。常见内容有:

%makeinstall这不是关键字,而是rpm定义的标准宏命令。也可以使用非标准写法:

make DESTDIR=$RPM_BUILD_ROOTinstallmakeprefix=$RPM_BUILD_ROOT install

说明:这里的%install主要就是为了后面的%file服务的。所以,还可以使用常规的系统命令:

install -d $RPM_BUILD_ROOT/

cp -a * $RPM_BUILD_ROOT/

%clean清理临时文件

通常内容为:

[ "$RPM_BUILD_ROOT"!= "/" ] && rm -rf "$RPM_BUILD_ROOT"

rm -rf$RPM_BUILD_DIR/%{name}-%{version}

说明:注意区分$RPM_BUILD_ROOT$RPM_BUILD_DIR

$RPM_BUILD_ROOT是指开头定义的BuildRoot,而$RPM_BUILD_DIR通常就是指/root/BUILD,其中,前面的才是%file需要的。

%pre rpm安装前执行的脚本

%post rpm安装后执行的脚本

%preun rpm卸载前执行的脚本

%postun rpm卸载后执行的脚本

说明:%preun %postun的区别是什么呢?前者在升级的时候会执行,后者在升级rpm包的时候不会执行。

%files定义哪些文件或目录会放入rpm

这里会在虚拟根目录下进行,千万不要写绝对路径,而应用宏或变量表示相对路径。如果描述为目录,表示目录中除%exclude外的所有文件。

%defattr(-,root,root)指定包装文件的属性,分别是(mode,owner,group)-表示默认值,对文本文件是0644,可执行文件是0755%exclude列出不想打包到rpm中的文件

注:如果%exclude指定的文件不存在,也会出错的。

%changelog变更日志

   

四、范例

 #这个区域定义的NameVersion这些字段对应的值可以在后面

#通过%{name},%{version}这样的方式来引用,类似于C语言中的宏

# Name制定了软件的名称

Name:      nginx

#软件版本

Version:   1.5.2

#释出号,也就是第几次制作rpm

Release:   1%{?dist}

#软件的介绍,必须设置,最好不要超过50个字符

Summary:   Nginx from WangYing

#软件的分组,可以通过/usr/share/doc/rpm-4.8.0/GROUPS文件中选择,也可以

#在相应的分类下,自己创建一个新的类型,例如这里的Server

Group:     Application/Server

#许可证类型

License:   GPL

#软件的源站

URL:       http://nginx.org

#制作rpm包的人员信息

Packager:  WangYing <justlinux2010@gmail.com>

#源码包的名称,在%_topdir/SOURCE下,如果有多个源码包的话,可以通过

# Source1Source2这样的字段来指定其他的源码包

Source0:   %{name}-%{version}.tar.gz

# BuildRoot指定了make install的测试安装目录,通过这个目录我们可以观察

#生成了哪些文件,方便些files区域。如果在files区域中写的一些文件报

#不存在的错误,可以查看%_topdir/BUILDROOT目录来检查有哪些文件。

BuildRoot: %_topdir/BUILDROOT

#指定安装的路径

Prefix:    /usr/local/nginx-1.5.2

#制作过程需要的工具或软件包

BuildRequires: gcc,make

#安装时依赖的软件包

Requires:pcre,pcre-devel,openssl

#软件的描述,这个可以尽情地写

%description

Nginxis a http server

# %prep指定了在编译软件包之前的准备工作,这里的

# setup宏的作用是静默模式解压并切换到源码目录中,

#当然你也可以使用tar命令来解压

%prep

%setup-q

#编译阶段,和直接编译源代码类似,具体的操作或指定的一些参数由configure文件决定。

%build

CFLAGS="-pipe-O2 -g -W -Wall -Wpointer-arith -Wno-unused-parameter -Werror" ./configure--prefix=%{prefix}

# make后面的意思是:如果是多处理器,则并行编译

make%{?_smp_mflags}

#安装阶段

%install

#先删除原来的测试安装的,只有在制作失败了%{buildroot}目录才会有内容,

#如果成功的话,目录下会被清除。

# %{buildroot}指向的目录不是BuildRoot%_topdir/BUILDROOT)指定的目录,

#而是该目录下名称与生成的rpm包名称相同的子目录。例如我的是

# /usr/src/redhat/BUILDROOT/nginx-1.5.2-1.el6.x86_64

rm-rf %{buildroot}

#指定安装目录,注意不是真实的安装目录,是在制作rpm包的时候指定的

#安装目录,如果不指定的话,默认就会安装到configure命令中指定的prefix路径,

#所以这里一定要指定DESTDIR

makeinstall DESTDIR=%{buildroot}

#安装前执行的脚本,语法和shell脚本的语法相同

%pre

#安装后执行的脚本

%post

#卸载前执行的脚本,我这里的做的事情是在卸载前将nginx服务器停掉

%preun

   MSG=`ps aux | grep nginx | grep -v"grep"`

   if [ -z "$MSG" ];then

       killall nginx 1>/dev/null2>/dev/null

   fi

#卸载完成后执行的脚本

%postun

   rm -rf %{prefix}

#清理阶段,在制作完成后删除安装的内容

%clean

rm-rf %{buildroot}

#指定要包含的文件

%files

#设置默认权限,如果没有指定,则继承默认的权限

%defattr (-,root,root,0755)

%{prefix}

如果在制作的过程中报类似下面的错误,检查你的files区域,看要包含的文件是否存在。

error: File not found: /usr/src/redhat/BUILDROOT/

五、其他

1、扩展

a)就是%build%install的过程中,都必须把编译和安装的文件定义到虚拟根目录中。

%build

make -f admin/Makefile.commoncvs
./configure --prefix=%{_prefix} --enable-final --disable-debug \
--with-extra-includes=%{_includedir}/freetype2 --includedir=%{_includedir}
make

%install

rm -fr $RPM_BUILD_ROOT
make DESTDIR=$RPM_BUILD_ROOT install
cp -r $RPM_BUILD_ROOT%{_datadir}/apps/kolourpaint/icons/hicolor/*$RPM_BUILD_ROOT%{_datadir}/icons/crystalsvg/

b)就是%file中必须明白,用的是相对目录

%files

%defattr(-,root,root)
%{_bindir}
%{_libdir}
%{_datadir}
%exclude %{_libdir}/debug

%files

%defattr(-,root,root)
%{_bindir}

%files

%defattr(-,root,root)
/usr/bin

则打包的会是根目录下的/usr/bin中所有的文件。

2、一些rpm相关信息

rpm软件包系统的标准分组/usr/share/doc/rpm-4.8.0/GROUPS
各种宏定义:
/usr/share/doc/rpm-4.8.0/macros
已经安装的rpm包数据库:
/var/lib/rpm
如果要避免生成debuginfo包:这个是默认会生成的rpm包。则可以使用下面的命令:

echo'%debug_package %{nil}' >> ~/.rpmmacros

如果rpm包已经做好,但在安装的时候想修改默认路径,则可以:

rpm -ivh--prefix=/opt/usr xxx.rpm

又或者同时修改多个路径

rpm xxx.rpm--relocate=/usr=/opt/usr --relocate=/etc=/usr/etc

3、如何编写%file

由于必须在%file中包括所有套件中的文件,所以,我们需要清楚编译完的套件到底包括那些文件?

常见的做法是,人工模拟一次编译的过程:

./configrue--prefix=/usr/local/xxx
make
make DESTDIR=/usr/local/xxx install

make prefix=/usr/local/xxx install

这样,整个套件的内容就会被放到/usr/local/xxx中,可根据情况编写%file%exclude

当然,这个只能对源码按GNU方式编写,并使用GNU autotool创建的包有效,若自定义Makefile则不能一概而论。

4、关于rpm中的执行脚本

如果正在制作的rpm包是准备作为放到系统安装光盘中的话,则需要考虑rpm中定义的脚本是否有问题。由于系统在安装的时候只是依赖于一个小环境进行,而该环境与实际安装完的环境有很大的区别,所以,大部分的脚本在该安装环境中都是无法生效,甚至会带来麻烦的。

所以,对于这样的,需要放到安装光盘中的套件,不加入执行脚本是较佳的方法。

另外,为提供操作中可参考的信息,rpm还提供了一种信号机制:不同的操作会返回不同的信息,并放到默认变量$1中。0代表卸载、1代表安装、2代表升级

可这样使用:

%postun
if [ "$1" = "0" ]; then
/sbin/ldconfig
fi

六、参考文献:

1.http://www-900.ibm.com/developerWorks/cn/linux/management/package/rpm/part1/index.shtml[/url]

2.http://www-900.ibm.com/developerWorks/cn/linux/management/package/rpm/part2/index.shtml

3.http://www-900.ibm.com/developerWorks/cn/linux/management/package/rpm/part3/index.shtml

4./usr/share/doc/rpm-4.3.2/(具体路径还要看系统版本和rpmbuild版本)

5.http://www.rpm.org/RPM-HOWTO/build.html#SCRIPTS

6.http://www.linuxfans.org/nuke/modules.php?name=Forums&file=printview&t=86980&start=0

七、附录:宏对应路径一览表

可以通过命令rpm --showrc查看实现代码。另外直接通过 rpm --eval"%{macro}"来查看具体对应路径。

Macros mimicking autoconf variables

%{_sysconfdir}          /etc

%{_prefix}               /usr

%{_exec_prefix}         %{_prefix}

%{_bindir}               %{_exec_prefix}/bin

%{_lib}                  lib(lib64 on 64bit systems)

%{_libdir}               %{_exec_prefix}/%{_lib}

%{_libexecdir}          %{_exec_prefix}/libexec

%{_sbindir}             %{_exec_prefix}/sbin

%{_sharedstatedir}      /var/lib

%{_datadir}             %{_prefix}/share

%{_includedir}          %{_prefix}/include

%{_oldincludedir}       /usr/include

%{_infodir}              /usr/share/info

%{_mandir}               /usr/share/man

%{_localstatedir}       /var

%{_initddir}            %{_sysconfdir}/rc.d/init.d

Note: On releases older thanFedora 10 (and EPEL), %{_initddir} does not exist. Instead, youshould use the deprecated%{_initrddir} macro.

RPM directory macros

%{_topdir}               %{getenv:HOME}/rpmbuild

%{_builddir}            %{_topdir}/BUILD

%{_rpmdir}               %{_topdir}/RPMS

%{_sourcedir}           %{_topdir}/SOURCES

%{_specdir}             %{_topdir}/SPECS

%{_srcrpmdir}           %{_topdir}/SRPMS

%{_buildrootdir}        %{_topdir}/BUILDROOT

Note:On releases older than Fedora 10 (and EPEL), %{_buildrootdir} doesnot exist.

Build flags macros

%{_global_cflags}       -O2-g -pipe

%{_optflags}            %{__global_cflags}-m32 -march=i386 -mtune=pentium4 # if redhat-rpm-config is installed

Other macros

%{_var}                  /var

%{_tmppath}             %{_var}/tmp

%{_usr}                  /usr

%{_usrsrc}               %{_usr}/src

%{_docdir}               %{_datadir}/doc



(责任编辑:IT)
------分隔线----------------------------