Container Service for Kubernetes:Pod の異常に関するトラブルシューティング

フェーズ 1：初期評価

1. コンソールまたは kubectl を使用して Pod のステータスを確認します：

   kubectl get pods -n <namespace>

2. Pod のイベントを調べてエラーメッセージを確認します：

   kubectl describe pod <pod-name> -n <namespace>

3. コンテナーのログをレビューしてアプリケーションレベルのエラーを確認します：

   kubectl logs <pod-name> -n <namespace> --previous

Pod が Pending ステータスのままになる

Pod が Pending ステータスのままの場合、スケジューリングの制約とリソースの可用性を調査します。

リソース最適化戦略

効果的なリソース管理により、スケジューリングの問題を防止し、クラスターの利用効率を最適化できます。

# ノードのリソース使用率を表示
kubectl top nodes

# Pod のリソースリクエストを確認
kubectl describe pod <pod-name> -n <namespace> | grep -A 10 "Resources:"

# 推奨事項のためのリソースプロファイリングを有効化
# （自動リソース最適化を実現するコンソール機能）

一般的なイメージプルエラー

イメージプルのトラブルシューティング手順

1. イメージリポジトリの URL とタグの正確性を確認する

2. imagePullSecrets が存在し、正しく参照されていることを確認する

3. ワーカーノードからのレジストリ接続性をテストする:

   crictl pull <registry-address>/<image>:<tag>
   curl -v https://<registry-address>

4. レジストリ認証情報を検証する

5. レジストリへのアクセスを許可するネットワークポリシーを確認する

CrashLoopBackOff の分析

コンテナーが繰り返しクラッシュする場合、アプリケーションまたは構成に根本的な問題が存在します。

調査手順

1. クラッシュ原因を特定するため、以前のコンテナーログを確認します：

   kubectl logs <pod-name> --previous -n <namespace>

2. コンテナーの起動コマンドおよび引数を確認します

3. 環境変数および構成を検証します

4. 必要な依存関係およびサービスの可用性を確認します

5. アプリケーションのヘルスチェック構成を確認します

よくあるクラッシュ原因

• 起動コマンドの欠落または誤り

• 構成ファイルのエラー、またはファイルの欠落

• 依存サービスの利用不可

• 権限不足またはセキュリティ制約による実行失敗

• ポート競合またはバインド失敗

• 起動時のリソース制限違反

Pod は実行中だが準備未完了 (Ready: False)

Pod のステータスが Running と表示されているにもかかわらず readiness プローブに失敗する場合は、ヘルスチェックの構成を調査してください。

検証チェックリスト

• readiness プローブのエンドポイントが存在し、正しく応答することを確認します。

• プローブのタイムアウトと失敗のしきい値の設定を確認します。

• プローブのエンドポイントへのネットワーク接続をチェックします。

• プローブのポートがアプリケーションのリッスンポートと一致することを検証します。

• プローブのパスがアプリケーションのルートと一致することを確認します。

一時的な回避策

調査中にトラフィックを許可するために、一時的に readiness プローブを無効化します：

1. コンソールから Pod のターミナルにアクセスするか、`kubectl exec` を使用します。

2. `curl` または `wget` コマンドを使用して、ヘルスエンドポイントを手動でテストします。

3. readiness チェックなしでアプリケーションが正しく機能していることを確認します。

4. 根本原因を特定するために、メトリックとログを収集します。

5. 調査結果に基づいて readiness プローブの構成を調整します。

6. 問題が解決したら、readiness プローブを再度有効化します。

OOMKilled状態の分析

メモリ不足の状況はPodの終了を引き起こし、慎重なリソース管理が必要です。

調査手順

1. OOM killログを確認します。

   kubectl logs <pod-name> --previous -n <namespace> | grep -i oom

2. メモリ使用パターンとスパイクを分析します。

3. アプリケーションコード内のメモリリークを確認します。

4. JavaアプリケーションのJVMヒープ設定 (-Xmxパラメーター) を確認します。

5. メモリリソース制限を実際の使用量に対して検証します。

メモリ最適化

• アプリケーションが正当により多くのRAMを必要とする場合は、メモリ制限を増やします。

• メモリプロファイリングを実装して使用パターンを特定します。

• アプリケーションのメモリ割り当てとGCを最適化します。

• 動的メモリ調整のために垂直Pod自動スケーリングを検討します。

• サービス品質を確保するために適切なメモリリクエストを設定します。

実行中の Pod が正常に動作しない問題

アプリケーション構成の問題により、Pod が正常に動作しないまま実行されることがあります。

1. コンテナーの構成が想定通りであることを確認してください。

2. YAML 構成に構文エラーがないか確認してください。

3. 環境変数の値とシークレットを検証してください。

4. サービスディスカバリーと DNS 名前解決を確認してください。

5. 該当する場合、コンテナー間の通信をテストしてください。

Completed 状態について

ジョブや init コンテナーなどの特定のワークロードでは、プロセスが正常に終了すると Pod が Completed 状態に移行しますが、これは正常な動作です。