OrePANとcpanmでCPANの部分ミラーを作ってCPANモジュールを管理する

OrePANとcpanmでCPANの部分ミラーを作ってCPANモジュールを管理する

これまでサービスで使うCPANモジュールの管理と言えばrpm/debパッケージが主流だと思いますが、最近ではperlbrewで使いたいバージョンのperlをインストールすることもあり、rpm/debでは対応できなくなってきています。\n\nperlbrewのperlに対してプロジェクトが依存しているCPANモジュールを入れる際、\n\n \$ perlbrew switch perl-5.12.3\n \$ cd /path/to/MyProj\n \$ perl Makefile.PL\n \$ cpanm --installdeps .\n\nなどと cpanm --installdeps が使えます。\n\nしかし、これではサーバを新規セットアップするたびに、最新のモジュールが入ることになりサーバ間でモジュールのバージョンの差異が生まれる可能性があります。\n\nそこで対応策として考えられるのが開発サーバで--installdepsを実行し、perlbrewのディレクトリごと本番サーバにrsyncする方法です。しかしこの方法はOSのアーキテクチャ変更やメジャーバージョンの変更、ディストリビューションの変更に弱いという問題があります。もしアーキテクチャが変更された場合は本番サーバ、開発サーバの両方用意してperlbrewとCPANモジュールを入れ直す必要がありますが、その際に元の開発サーバと同じバージョンのモジュールが入る保証はありません。\n\nそこで、プロジェクトが依存しているCPANモジュール（とそのCPANモジュールが依存しているモジュール)を全てローカルにダウンロードし、プロジェクトのディレクトリ内で外部依存が無いCPANの部分ミラーを作成し、cpanmでそのミラーだけからモジュールをインストールするという手段を考えました。\n\nまず、DarkPAN(CPAN for intranet) の管理ツールである[OrePAN](http://d.hatena.ne.jp/tokuhirom/20101117/1289952012)をインストールします。変更がまだあるので自分のforkから\n\n \$ cpanm https://github.com/kazeburo/OrePAN/tarball/master\n\nこれで、orepan.pl と orepan_index.pl というのが入ります。このコマンドでローカルのCPANミラーのindexを生成できます。\n\n次に、依存モジュールのdownloadだけを行うオプションを追加したcpanmを持ってきます。適当patchなので、これも自分のforkから\n\n \$ curl -LO https://github.com/kazeburo/cpanminus/raw/master/cpanm > cpanm\n \$ chmod +x ./cpanm\n\nこのcpanmを使って依存モジュールのダウンロードを行います\n\n \$ cwd\n /path/to/MyProj\n \$ perl Makefile.PL\n \$./cpanm --dpan=./cpan --installdeps .\n --> Working on .\n Configuring /path/to/MyProj ... OK\n ==> Found dependencies: Router::Simple::Sinatraish, Tiffany, Module::Find\n --> Working on Router::Simple::Sinatraish\n Fetching http://search.cpan.org/CPAN/authors/id/T/TO/TOKUHIROM/Router-Simple-Sinatraish-0.02.tar.gz ... OK\n Configuring Router-Simple-Sinatraish-0.02 ... OK\n Copy to /path/to/MyProj/cpan/authors/id/T/TO/TOKUHIROM/Router-Simple-Sinatraish-0.02.tar.gz\n --> Working on Tiffany\n Fetching http://search.cpan.org/CPAN/authors/id/T/TO/TOKUHIROM/Tiffany-0.03.tar.gz ... OK\n Configuring Tiffany-0.03 ... OK\n Copy to /path/to/MyProj/cpan/authors/id/T/TO/TOKUHIROM/Tiffany-0.03.tar.gz\n ..\n\nextlibにモジュールを導入する際は、-l や -L オプションも一緒に使います\n\n \$./cpanm -l extlib --dpan=./cpan --installdeps .\n\n./cpanディレクトリにCPANと同じディレクトリ構造で依存モジュールのダウンロードしていきます。インストールはされません\n\n \$ find ./cpan -name \"*.tar.gz\" \n ./cpan/authors/id/C/CR/CRENZ/Module-Find-0.10.tar.gz\n ./cpan/authors/id/T/TO/TOKUHIROM/Router-Simple-Sinatraish-0.02.tar.gz\n ./cpan/authors/id/T/TO/TOKUHIROM/Tiffany-0.03.tar.gz\n\n全てのダウンロードが終わったら、今度はindexを作成します。先ほどインストールしたOrePANを使います\n\n \$ orepan_index.pl --repository ./cpan\n ...\n 2011-02-03T17:24:45 [INFO] Save cpan/modules/02packages.details.txt.gz at /...\n\nこれでcpan/modules以下にindexファイルができ、CPANミラーの準備ができました。このミラーのディレクトリはVCSでプロジェクトと同様に管理してしまうのがよさげです。\n\nこのミラーからモジュールを導入する場合は\n\n \$ cpanm --mirror file:///path/to/MyProj/cpan --mirror-only --installdeps .\n\nこのようにmirrorとmirror-onlyのオプションを使います。これで外部にモジュールを取りにいくことはなく、ローカルのみから依存モジュールを一括で導入可能です。\n\n\nもし、依存モジュールが増えたり、依存モジュールのバージョンが新しくなった場合は Makefile.PL を更新しもう一度 cpanmを動かします\n\n \$ vim Makefile.PL\n \$ perl Makefile.PL\n \$ ./cpanm --dpan=./cpan --installdeps .\n\n今度は、cpanmがcpan/modulesディレクトリ中の02packages.details.txt.gzを読み込んで必要なモジュールだけダウンロードします。依存モジュールのどこかで明示的に書かれていない限り勝手にバージョンがあがってしまう事はありません。\n\nそしてindexを再生成します\n\n \$ rm -f ./cpan/modules/02packages.details.txt.gz\n \$ orepan_index.pl --repository ./cpan\n\nモジュールを減らす場合はcpan/authorディレクトリから削除して、同じ様にindexを作り直せば完了です\n\nこの方法の良い点として、おまけ的ですが、search.cpan.orgが止まっていたり、グローバルにアクセスできない場所でも問題なく依存モジュールがインストール可能であること、ダウンロードの手間が無いのでインストールがちょっと高速になることも挙げられます。\n\nいかがでしょうかNe。\n\n