Chefの「真」のマルチプラットフォーム戦略：OSの差異を殺し、抽象化を極める
Chefにおいて「Linux専用」「Windows専用」とCookbookを分けるのは、二流の設計だ。真のSREは、同一のレシピの中に抽象化のレイヤーを挟み込み、プラットフォームの差異を「単なる設定ファイルの違い」へと昇華させる。
今日は、WindowsとLinuxが混在するカオスな環境で、どうやって「冪等性」を維持しつつ、保守性を極限まで高めるかを伝授する。
—
1. 汚い `if/else` 地獄からの脱却：属性抽象化パターン
多くの初学者は、レシピ内に `if platform?(‘windows’)` を乱立させる。これはアンチパターンだ。レシピは「あるべき状態の記述」に徹するべきであり、ロジックは分離せよ。
ベストプラクティス：`attributes/default.rb` での隠蔽
OSごとの差異（パス、パッケージ名、サービス名）は、すべて `attributes` 層で吸収する。
attributes/default.rb
プラットフォームごとに値をマッピングする
default[‘my_app’][‘package_name’] = case node[‘platform_family’]
when ‘windows’ then ‘MyApp.msi’
when ‘rhel’ then ‘my-app-rpm’
else ‘my-app-deb’
end
default[‘my_app’][‘install_dir’] = case node[‘platform_family’]
when ‘windows’ then ‘C:/Program Files/MyApp’
else ‘/opt/my_app’
end
これにより、レシピ（`recipes/default.rb`）はこうなる。
recipes/default.rb
OSの差異を意識せず、属性を使うだけで済む
package node[‘my_app’][‘package_name’]
directory node[‘my_app’][‘install_dir’] do
recursive true
end
—
2. WindowsとLinuxの「境界線」を越えるテクニック
パスの扱いと権限管理は、マルチプラットフォームにおける最大の罠だ。
- パスの正規化: Rubyの `File.join` を使うのは常識だが、さらに `Chef::Util::PathHelper` を活用せよ。Windowsのバックスラッシュ地獄から解放される。
- 権限の抽象化: `owner` や `group` はWindowsでは機能しないことが多い。`rights` プロパティ（Windows用）を動的に生成するヘルパー関数を `libraries/` に用意するのがプロの定石だ。
—
3. 実践：チーム開発を加速させる「神」設定とツール
Chef Workstationの生産性をブーストする
ただコマンドを打つだけでは遅い。以下のツールを導入せよ。
- `Test Kitchen` の並列実行: `.kitchen.yml` の `driver` 設定で `max_concurrency` を調整し、全プラットフォームのテストを一撃で完了させる。
- VS Codeプラグイン:
- `Chef` (by Progress): リソースの自動補完は必須。
- `Cookstyle`: これをCIに組み込むのは当たり前だが、エディタ上で常に警告が出るように設定せよ。コードレビューの指摘事項が8割減る。
チーム開発のルール：設定ファイルのベストプラクティス
JSONやYAMLで設定を持つ場合、`data_bags` に頼りすぎるな。暗号化が必要なもの以外は、Cookbook内に配置する `files/` または `templates/` に持たせ、検証可能な状態にせよ。
推奨するファイル構成:
my_app/
├── attributes/ # OSごとの定数を定義
├── libraries/ # プラットフォーム判定ヘルパーを自作
├── recipes/ # 宣言的な記述のみ
└── templates/
└── config.conf.erb # OSごとの変数を埋め込むテンプレート
—
4. 現場のテックリードからのアドバイス：冪等性を守るために
最後に、一つだけ覚えて帰ってほしい。「ガード句のないリソースは罪である」。
Windowsのレジストリ操作や、Linuxの複雑なコマンド実行を行う際、`not_if` や `only_if` を活用して、実行の必要性を常に自己判定させろ。
例：Windowsサービスが既に設定済みなら実行しない
execute ‘configure-service’ do
command ‘C:/scripts/setup.ps1’
not_if { powershell_out(‘Get-Service -Name MyService’).stdout.include?(‘Running’) }
end
まとめ：次にやるべきこと
1. 既存の `if` 文をすべて `attributes` に書き出せ。
2. `libraries/` に自前のヘルパー（例：`module PlatformHelper`）を作り、OS判定ロジックをカプセル化せよ。
3. CI環境で `Kitchen` を回し、WindowsとLinuxの差異が「属性値の切り替え」だけで済むことを証明せよ。
Chefはただの自動化ツールではない。インフラをコードとして美しく定義するための言語だ。OSという壁を抽象化の力で突破し、真の「Infrastructure as Code」を実現しよう。
健闘を祈る。