perl 模块打包加入外部依赖程序

perl 社区并不是所有的东西都发布在 cpan 上。甚至专门有一个 module::thirdparty 模块记录这些非 cpan 的 perl 项目列表。其中最有名的应该就属写博客的 movable type 和做监控的 smokeping 了。

但是如果个人图方便又想把 smokeping 打包方便部署使用的时候，就会发现一点小问题：打包成rpm，很多 perl 的依赖模块不一定在系统 repo 里存在；打包成 perl 的模块，smokeping 最常用的几个 probe 比如 fping、curl 什么的，又是非 perl 程序，cpanm 没法解决这个 requires_external_bin ，最多只能报错退出。

其实这里可以采取一些别的办法，虽然笨一些，但是解决问题。

首先还是让我们创建一个示例模块：

    cpanm module::starter module::build
    module-starter --module alien::fping --author="jeff rao" --email="[e-mail]" --mb

然后就会在本目录下创建一个 alien-fping 目录，自带好了 build.pl 等模块文件。这里使用了 alien:: 的名字空间，是一个潜规则，有些项目依赖 c 源码的库和头文件，就用 perl 包一层来安装，都放在这个空间下，比如 alien::v8, alien::gearmand, alien::ie7 等等。

现在让我们下载 fping 的源码放到模块里：

mkdir alien-fping/src
    wget http://www.fping.org/dist/fping-3.4.tar.gz -o alien-fping/src/fping-3.4.tar.gz

接下来应该就是编写 build.pl 了。不过为了尽量让 build.pl 看起来简洁而且一眼看出目的。我们最好把编译操作单独定义一个模块来使用：

 package alien::fping::build;
    use base qw(module::build);
    use file::spec;
    use archive::tar;
    my $rootdir = file::spec->rel2abs(".");
    my $srcdir = file::spec->catdir($rootdir, "src");
    my $fpingversion = '3.4';
    my $fpingname = "fping-${fpingversion}";
    my $fpingsrc = "${fpingname}.tar.gz";
    sub action_build {
        my $self = shift;
        chdir($srcdir);
        if (  !-x "/usr/sbin/fping" and !-d $fpingname ) {
            my $tar = archive::tar->new();
            $tar->read($fpingsrc);
            $tar->extract();
            chdir($fpingname);
            system('./configure', '--prefix=/usr/', '--enable-ipv6');
            system('make');
            system('make install');
        }
        $self->super::action_build();
    };
    1;

几乎就是调用 shell 而已，唯一需要讲一下的就是这个 action_build。这是 module::build 定义好的提供给 subclass 用的方法，事实上 ./build help 看得到的所有 action 都有类似的方法可以用。

然后稍微修改一下 build.pl 如下：

use 5.006;
    use strict;
    use warnings fatal => 'all';
    use lib 'inc';
    use alien::fping::build;
    my $builder = alien::fping::build->new(
        module_name         => 'alien::fping',
        license             => 'perl',
        dist_author         => q{jeff rao <[e-mail]>},
        dist_version_from   => 'lib/alien/fping.pm',
        release_status      => 'stable',
        configure_requires => {
            'module::build' => 0,
        },
        build_requires => {
            'test::more' => 0,
        },
        requires => {
            #'abc'              => 1.6,
            #'foo::bar::module' => 5.0401,
        },
        add_to_cleanup     => [ 'alien-fping-*' ],
        create_makefile_pl => 'traditional',
    );
    $builder->create_build_script();

把 module::build 替换成 alien::fping::build 而已，其他都不用动。

然后试一下吧：

cd alien-fping
    perl build.pl
    ./build

看到编译输出，并且成功安装有 /usr/sbin/fping 了吧。现在可以打包了。注意默认生成的 ignore.txt 里，是排除掉了 inc 目录的，需要去除掉，然后修改 manifest 文件加入 inc 和 src 里的文件，然后再打包出来的 perl 模块就可以直接用了。

sed -i '/inc/d' ignore.txt
    echo 'inc/alien/fping/build.pm' >> manifest
    echo 'src/fping-3.4.tar.gz' >> manifest
    ./build dist