librarian-puppetの使い方

how-to-librarian-puppet.md

librarian-puppet

Puppet ForgeにあるPuppet modulesを管理するためのツール．

クイックスタート

準備（librarian-puppetのインストール，ひな形の生成）

gemからインストールし，initでPuppetfileのひな形を生成する

gem i librarian-puppet
librarian-puppet init

モジュールの追加・編集

Puppetfileを編集して，必要なモジュールの追加や修正を行う．

vim Puppetfile

生成されるひな形やドキュメントを読むと，書き方が分かる

モジュールのインストール

インストールパスの設定はconfigコマンドから実行可能． サードパーティ製モジュールは自前のモジュールと区別するために，今回はvendor/modulesという場所を選択．

librarian-puppet config path vendor/modules --local
librarian-puppet install

これだけでPuppetfile.lockにバージョン情報や依存関係が定義され，pathで設定したディレクトリにモジュールがインストールされる．

簡単！

更新

更新情報の取得

outdatedコマンドで行う．

アップデート

updateコマンドで行う．

雑感

出力にやや不満． installやoutdated実行後，何も更新がない場合は「Already up-to-date.」「Your puppet modules are up to date!」みたいな表示を出して欲しい． 現状だと，librarian-puppet installを実行しても，なんにも出力が出ないまま完了してしまう． --verboseはあるにはあるんだけど，こっちは出力多すぎるので，単純な結果だけ出すようなやつ．

例えばwebistranoやcapistranoで運用する場合，デプロイする度にlibrarian-puppet installして，ネットからデータ引っ張ってくるのは相当時間食いそうだなあ．
キャッシュ機能持ってるみたいだけど，capでデプロイするなら，sharedディレクトリにpuppet module用キャッシュディレクトリを置いて，更新がなければそこから引っ張ってくるような方式にすればいいのかな．

.tmpファイルには，以下のような感じでインストールしたバージョンのキャッシュが入ってるっぽい

$ tree -L 2 .tmp/librarian/cache/source/puppet/forge/forgeapi_puppetlabs_com/puppetlabs-stdlib/
.tmp/librarian/cache/source/puppet/forge/forgeapi_puppetlabs_com/puppetlabs-stdlib/
├── 4.3.0
│   ├── cache
│   └── stdlib
└── 4.3.2
    ├── cache
    └── stdlib

6 directories, 0 files

キャッシュ機能持ってるみたいだけど，capでデプロイするなら，sharedディレクトリにpuppet module用キャッシュディレクトリを置いて，更新がなければそこから引っ張ってくるような方式にすればいいのかな．

sharedの仕事なんだろうか

とりあえずwebiのタスクで，

librarian-puppet config path vendor/modules --local --verbose
librarian-puppet install --verbose

みたいなのを実行すればいいのかな．

setupタスクのあとに

librarian-puppet config path vendor/modules --global --verbose

を実行するでも良さそうだ．

librarian-puppet config path vendor/modules --local

しらんかった。vagrant-mhaの方も反映しようとおもった。

キャッシュ機能持ってるみたいだけど，capでデプロイするなら，sharedディレクトリにpuppet module用キャッシュディレクトリを置いて，更新がなければそこから引っ張ってくるような方式にすればいいのかな

vendor/ だけsahredにおいとけばいいんでないの？
とおもたけど、vagrant-mhaの方でためしたら.tmpって無いと毎回作ってソース取ってこられるんやね。めんどくさいな…

LIBRARIAN_PUPPET_TMPという環境変数を使えば，キャッシュディレクトリを移動できるらしい

あとcapで世代管理をするなら，bundler/capistranoみたくshared_pathにmodulesを入れて，current_release/vendor/modulesにsymlinkを貼ると良さそう