Puppetの「動かない」を「即座に治す」。伝説のSREが教えるトラブルシューティング極意10選
Puppetは「宣言的構成管理の完成形」である一方、その深い抽象度ゆえにハマりどころも多い。しかし、現場で起きるエラーの9割は「仕組みの理解不足」と「ログの読み方」に集約される。
今日は、Puppetを使い倒し、CI/CDパイプラインを止めることなく爆速で回すための「実戦的トラブルシューティング」を伝授する。
—
1. SSL証明書エラー：信頼の崩壊を食い止める
Puppetの通信において、SSLは心臓部だ。エラーの多くは時刻のズレか、古い証明書が残っていることに起因する。
- 原因: AgentのクロックがServerとずれている、または再インストールで証明書が不整合。
- 即解決策:
1. Agent側で `rm -rf /etc/puppetlabs/puppet/ssl/` を実行。
2. `puppet agent -t` で再生成。
3. Server側で `puppetserver ca sign –all`。
- プロの教訓: NTPの同期はインフラの絶対正義。ここが狂っていると、全ての自動化は砂上の楼閣だ。
2. 構文エラー（Syntax Error）：静的解析をサボるな
コンパイルエラーは、実行前に叩き潰すのが鉄則だ。
- 解決策: `puppet parser validate` を使え。
- 神プラグイン: VS Codeの `Puppet` 拡張機能 は必須。これなしでコードを書くのは、地図なしでジャングルに入るようなものだ。
- 自動化の極意: Gitの `pre-commit` フックに `puppet-lint` を組み込め。コミットするたびに構文チェックが走る環境を作れば、CIで落ちることはなくなる。
3. 循環依存エラー：グラフ理論の罠
`Dependency cycle` エラーは、リソース間の依存関係がループしている時に起きる。
- 解決策: `puppet graph –tree` を使え。依存関係を視覚化すれば、どこで矛盾が起きているか一目瞭然だ。
- 設計思想: 依存関係は可能な限りフラットに保て。`require` と `before` の乱用は、スパゲッティコードの元凶だ。
—
4. 現場で役立つ「デバッグのコツ」と「ログの場所」
Puppetは隠れた場所で多くを語っている。
- ログの定位置:
- Server: `/var/log/puppetlabs/puppetserver/puppetserver.log`
- Agent: `/var/log/puppetlabs/puppet/puppetagent.log`
- 必殺コマンド: `puppet agent -t –debug –trace`。これを見れば、どのリソースがどの順番で処理され、どこで失敗したかが「血塗られた詳細さ」で出力される。
—
5. チーム開発を加速させる「神設定」と「構成ルール」
チームの生産性を劇的に高めるために、以下のルールを導入せよ。
YAML/Hieraのベストプラクティス
Hieraの階層化（Hierarchy）はシンプルに保つのが正義だ。
/etc/puppetlabs/code/environments/production/data/common.yaml
—
複雑なロジックはコードに書かず、データに分離する
ntp::servers:
- ‘ntp1.example.com’
- ‘ntp2.example.com’
階層の例（優先度が高い順）
hierarchy:
- name: “Per-node data”
path: “nodes/%{trusted.certname}.yaml”
- name: “Common data”
path: “common.yaml”
チーム開発の生産性を底上げする「隠れたテクニック」
1. `puppet module list` の常用: 依存モジュールのバージョン不整合を即座に特定せよ。
2. `noop` モード: 本番適用前に `puppet agent -t –noop` を叩く。これが「伝説的SRE」と「ただのオペレーター」の分かれ道だ。
3. キーボードショートカット: VS Codeで `Ctrl + Shift + P` からの「Puppet: Generate Type Reference」を使え。ドキュメントをブラウザで探す時間は、現代のエンジニアには不要だ。
—
最後に：なぜPuppetを使い続けるのか
Puppetは「インフラのコード化」を誰よりも深く追求できるツールだ。冪等性を守り、宣言的にシステムを記述する。この設計思想が身につけば、TerraformだろうがAnsibleだろうが、どんなIaCツールでも瞬時に使いこなせるようになる。
トラブルは「敵」ではなく、そのシステムの「構造」を知るための招待状だ。エラーログと対話し、一つずつ因果関係を紐解いていく。その先にしか、真のオートメーションの世界は広がっていない。
さあ、ターミナルを開け。君のコードで、サーバーを踊らせろ。