Chef Cookbookの真髄：冪等性を極め、インフラを「コード」として支配せよ
世の中には「Chefは古い」という言説が溢れている。だが、現場で泥臭く数千台のサーバーを管理し、CI/CDパイプラインの中で完全自動化を達成しているエンジニアは知っている。Chefが提供する「Rubyによる記述力」と「Resourceの完全な冪等性」こそが、複雑なシステム構成を再現可能な状態に保つための最強の武器であることを。
本稿では、単なるマニュアルの焼き直しではなく、実戦で生き残るための「Chef Cookbook設計術」を伝授する。
—
1. CookbookとRecipeの「正解」：ディレクトリ構造の哲学
Chefにおけるディレクトリ構造は、単なるファイルの置き場所ではない。「依存関係の依存」をいかに疎結合にするかの設計図だ。
my_nginx/
├── attributes/ # 外部化可能な定数のみを配置
├── recipes/ # 冪等性を担保した処理手順
├── templates/ # ERBテンプレートによる動的生成
├── files/ # 変更不要な静的ファイル
└── metadata.rb # 依存関係とバージョンの定義
【プロの知見】
- `recipes/default.rb` に全てを書くな。機能単位（`install.rb`, `config.rb`, `service.rb`）で分割し、`default.rb` はそれらを `include_recipe` するだけのコントローラーに徹せよ。これが保守性の第一歩だ。
—
2. Attributesの深淵：優先順位を制する者がChefを制す
Attributes（属性）は便利だが、乱用すると「結局どの値が適用されているのか？」というデバッグ地獄に陥る。
優先順位の鉄則（重要度順）：
1. Role attribute
2. Environment attribute
3. Default attribute
【現場のベストプラクティス】
- Defaultは「デフォルト」に留める: `attributes/default.rb` には、環境が変わっても変わらない「デフォルト値」のみを書く。
- 環境依存はData BagかEnvironment: 開発環境、本番環境で切り替えるべき値は `attributes` でハードコードしてはならない。環境ごとのRoleを作成し、そこで上書きせよ。
—
3. ハンズオン：Nginxインストールレシピの「正解」
ただインストールするだけなら誰でもできる。重要なのは、設定ファイルが変更されたときだけサービスを再起動する「通知（Notification）」の設計だ。
recipes/nginx.rb
1. パッケージの定義（冪等性が自動で担保される）
package ‘nginx’ do
action :install
end
2. 設定ファイルの管理（テンプレートを使用）
template ‘/etc/nginx/nginx.conf’ do
source ‘nginx.conf.erb’
owner ‘root’
group ‘root’
mode ‘0644’
# 設定が変わった時だけ再起動をトリガーする（即時実行は :immediately）
notifies :reload, ‘service[nginx]’, :delayed
end
3. サービスの制御
service ‘nginx’ do
action [:enable, :start]
end
—
4. Metadata.rb：依存関係の「契約書」
`metadata.rb` は単なるメタデータではない。Chef ServerやBerkshelfが「このCookbookを適用する前に何が必要か」を判断するための契約書だ。
name ‘my_nginx’
maintainer ‘SRE Team’
license ‘Apache-2.0’
version ‘1.2.3’ # セマンティックバージョニングを徹底せよ
依存するCookbookのバージョンを固定せよ
depends ‘yum’, ‘~> 5.0’
supports ‘centos’, ‘>= 7.0’
—
チーム開発を加速させる「極限のエンジニアリング」
① 神プラグイン・IDE設定
- VS Code拡張: `Chef Extension` は必須。さらに `Ruby` 言語サーバーを入れ、静的解析を有効にせよ。
- RuboCop: `rubocop-chef` を導入し、CIで自動リントをかける。「俺の書き方」を排除し、チームの言語を統一する。
② チーム開発のルール：設定ファイルの共有化
設定ファイルは「XMLやJSONを直書き」してはいけない。以下のように管理せよ。
- YAML/JSON: `attributes/` や `data_bags/` に格納。機密情報は必ず `chef-vault` で暗号化し、決してGitに生データをコミットしないこと。
- テンプレート戦略: `templates/` 内のERBファイルには、必ず変数展開のデフォルト値を持たせ、「空の変数が渡されてもエラーにならない」堅牢性を確保せよ。
③ 生産性を劇的に高める「Chef Workflow」
- Test Kitchen: 実際にサーバーを立てるな。`kitchen test` でローカルのDockerコンテナ上に構築し、冪等性を検証せよ。これがChefで最も重要な開発ループだ。
- Berkshelf: 依存関係は手動管理せず、`Berksfile` に記述して `berks vendor` でvendoringする。これにより、ネットワークが切れてもビルドが通る環境を構築できる。
—
最後に：SREとしての心構え
コードは書いた瞬間からレガシーになる。しかし、Chefのレシピは「構成管理という名のドキュメント」だ。「次にこのコードを触るエンジニアが、30秒で意図を理解できるか？」を自問し続けろ。
Chefを使いこなすことは、インフラを「ただの設定」から「再現可能なソフトウェア」へと昇華させることと同義だ。さあ、今すぐターミナルを開き、あなたのインフラをコードの海へ解き放て。