Kubernetes入門：PodからIngressまで（基礎と実践）

第10章：基本トラブルシューティング

本章では、Kubernetes での障害切り分けを「観測→仮説→検証→復旧」の型で整理し、kubectl の代表的な確認ポイントをまとめます。

学習目標

  • 症状/影響/変更点を整理し、切り分けの順序を組み立てられる
  • get/describe/events/logs/exec を使って状況を把握できる
  • よくある障害（CrashLoopBackOff、ImagePullBackOff、Pending、Service 到達不可）の入口を理解する

扱う範囲 / 扱わない範囲

扱う範囲

  • kubectl による観測（get/describe/events）
  • ログ確認（logs）
  • 侵入調査（exec）
  • 疎通確認（port-forward）
  • 典型障害のパターンと確認観点

扱わない範囲

  • 高度なデバッグ（プロファイリング、eBPF 等）
  • 監視基盤やアラート設計（運用編で扱う）

切り分けの型（最小）

1) 影響範囲（ユーザー影響、対象 namespace、対象コンポーネント）を整理する
2) 直近の変更（デプロイ、設定変更、クラスタ変更）を確認する
3) 事実の収集（events/logs/状態）
4) 仮説を立て、最短で検証できる順に試す

よく使う観測コマンド

kubectl -n demo get all
kubectl -n demo describe pod <pod-name>
kubectl -n demo get events --sort-by=.lastTimestamp
# 補足: lastTimestamp が期待どおりでない場合
kubectl -n demo get events --sort-by=.metadata.creationTimestamp
kubectl -n demo logs <pod-name>

典型障害（入口）

  • CrashLoopBackOff: アプリ起動失敗、設定/依存先未準備、Probe の誤設定など
  • ImagePullBackOff: イメージ名/タグ誤り、レジストリ認証、ネットワーク
  • Pending: リソース不足、ノード制約、PVC Pending
  • Service 到達不可: selector 不整合、targetPort 誤り、DNS

ハンズオン：Service の selector 不整合を切り分ける

Service の selector が間違うと Endpoints が空になり、到達できなくなります。

1) 現状を確認します。

kubectl -n demo get svc web
kubectl -n demo get endpointslice -l kubernetes.io/service-name=web

2) selector を誤らせて Endpoints を空にします（学習用途）。

kubectl -n demo patch svc web -p '{"spec":{"selector":{"app.kubernetes.io/name":"web-wrong"}}}'
kubectl -n demo get endpointslice -l kubernetes.io/service-name=web

3) Service の詳細で原因を確認し、selector を戻します。

kubectl -n demo describe svc web
kubectl -n demo patch svc web -p '{"spec":{"selector":{"app.kubernetes.io/name":"web","app.kubernetes.io/instance":"demo"}}}'
kubectl -n demo get endpointslice -l kubernetes.io/service-name=web

出力例（selector 不整合→Endpoints が空→原因確認→復旧。Endpoints/EndpointSlice の ADDRESSES が空で、kubectl describe svc web の Selector が Pod ラベルと不一致な点を確認）:

Service の selector 不整合の切り分け（例）

よくある落とし穴

  • events を見ずにログだけ追い、原因特定に時間がかかる
  • namespace を誤り、別環境を見てしまう
  • 暫定復旧（再起動）だけで終わり、恒久対応（原因の除去）が残る

まとめ / 次に読む

Edit this page on GitHub