エンジニアの皆さん、こんにちは。インフラの自動化を突き詰めると、必ず「自動化が失敗したとき、どうやって元の安全な状態に戻すか」という絶望的な問いに直面します。
Chefを単なる「設定ファイル配布ツール」だと思っていませんか？ それは大きな誤解です。Chefは「システムをあるべき姿（Desired State）へ強制的に収束させるエンジン」です。
今回は、Chefの実行中に例外が発生した際、環境を崩壊させないための「セーフティネット」と「自動リカバリ」の極意を伝授します。これをマスターすれば、深夜の障害対応で冷や汗をかくことはもうありません。
—
1. Chefの役割：なぜ「収束（Convergence）」が重要なのか
Chefの真髄は、何度実行しても同じ結果になる「冪等性（べきとうせい）」にあります。しかし、ネットワークの切断や外部APIのタイムアウトなど、制御不能なエラーは必ず起きます。
ここで重要なのは、「失敗したときに何もしない」のではなく、「失敗したことを検知し、安全な状態へフォールバックする」設計です。
2. 環境構築：Chefの最小単位を理解する
まずは、Chefの動作確認のための基礎的なセットアップを行いましょう。
インストール（Chef Workstation）
公式の[Chef Workstation](https://www.chef.io/downloads/tools/workstation)をインストールするだけで、必要なツールはすべて揃います。
バージョン確認で準備完了
chef –version
HelloWorld: 動作確認
`hello.rb` というレシピを作成し、Chefの実行プロセスを確認します。
hello.rb
file ‘/tmp/hello.txt’ do
content ‘Chef is running perfectly!’
action :create
end
実行コマンド:
chef-client –local-mode hello.rb
これで `/tmp/hello.txt` が生成されれば、あなたのエンジンは正常に回っています。
—
3. 致命的エラーを制御する：Chef::Handlerの魔力
Chefの実行中に例外が発生したとき、標準では「ログを吐いて終了」するだけです。しかし、`Chef::Handler` を使えば、失敗した瞬間にSlackへ通知したり、特定のクリーンアップスクリプトを走らせたりできます。
失敗時のリカバリハンドラの例
以下のコードを `libraries/handler.rb` に配置してください。
失敗を検知して自動処理を行うハンドラ
class FailureHandler < Chef::Handler
def report
if failed?
# ここにリカバリロジックを記述
Chef::Log.error("致命的なエラーを検知: #{run_status.exception.message}")
# 例：特定のログファイルを退避させるコマンドを実行
system("cp /var/log/chef/client.log /var/log/chef/error_backup.log")
# ここで通知（Slack API等を叩くのが現場の定石）
# send_slack_notification("Chef failed!")
end
end
end
これを `client.rb`（設定ファイル）で読み込ませることで、Chefは「自らを守る能力」を獲得します。
client.rb に追加
handler_config = FailureHandler.new
exception_handlers << handler_config
---
4. 現場で使える「セーフティネット」構築の極意
本番環境で障害を起こさないために、以下の3つの鉄則を守ってください。
1. Guard Clause（ガード句）を徹底する:
`only_if` や `not_if` を使い、リソースの適用前に安全確認をしてください。
execute ‘dangerous_command’ do
command ‘…’
not_if ‘test -f /var/run/skip_execution’ # このファイルがあれば実行しない
end
2. 例外を握りつぶさない:
初心者がやりがちな `begin-rescue` でエラーを隠蔽するのは厳禁です。失敗は明示的に失敗させ、ハンドラで後処理を行うのが「プロの作法」です。
3. dry-run（検証）の自動化:
本番に適用する前に、必ず `chef-client –noop` でドライランを行い、変更差分が想定通りかを確認するパイプラインを構築してください。
—
最後に：自動化は「失敗」を前提に設計する
自動化エンジニアとしての腕の見せ所は、上手く動いている時ではなく、システムが崩壊しそうな時に、いかに静かに、かつ確実にリカバリできるかにあります。
Chefのハンドラ機能を使いこなし、エラーを「無視」するのではなく「制御」できるようになれば、あなたのインフラは鋼鉄の堅牢さを手に入れます。
迷ったときは、いつでもこの基本に立ち返ってください。自動化の恐怖を克服した先に、本当の自由が待っていますよ。さあ、次はあなたの番です。コードを書いて、インフラを芸術の域まで高めていきましょう！