よくある問題の診断

Kubernetesでアプリケーションを実行すると大きな力を得られますが、常に計画どおりに進むとは限りません。Podが起動しなかったり、Serviceが接続できなかったり、Deploymentが失敗したりすることがあります。

こうした問題をすばやく診断するスキルは、Kubernetesを利用するすべての人にとって重要です。アプリケーションを正常かつ利用可能な状態に保つのに役立ちます。

Kubernetesクラスターを操作するための主要なコマンドラインツールはkubectlです。クラスターの状態を確認し、問題を診断するための入り口となるツールです。

kubectlを使ってクラスターのさまざまな部分を調査し、問題を特定する方法を学びます。

トラブルシューティングでは、まずPodのステータスを確認します。kubectl get podコマンドを使うと、概要をすばやく確認できます。

Pending、Error、CrashLoopBackOffなどの状態にあるPodや、再起動回数が予想外に多いPodを探してください。

kubectl get podで問題が見つかったら、kubectl describe podで詳しく調査します。このコマンドでは、特定のPodについて次のような豊富な情報を確認できます。

• ステータス: 現在の状態と条件です。
• イベント: Podで起きたことの時系列です。失敗の原因を理解するうえで重要です。
• コンテナ: Pod内の各コンテナの詳細です。
• ボリューム: 接続されているストレージの情報です。

Podが実行中なのにアプリケーションが動作しない場合は、次にログを確認します。アプリケーションログには、問題の原因を示すエラーメッセージや警告が含まれていることがよくあります。

kubectl logsを使うと、Pod内のコンテナからログを取得できます。コンテナが再起動した場合は、以前のログも確認できます。

DeploymentはPodのグループを管理します。アプリケーションのスケーリングや更新が正しく行われない場合は、Deploymentのステータスを確認してください。

kubectl get deploymentで現在の状態を確認し、kubectl describe deploymentでReplicaSetの情報を含む詳細なイベントや条件を確認します。

ServiceはPodに到達できるようにします。クライアントからアプリケーションにアクセスできない場合は、Serviceの設定が誤っているか、正常なPodを参照していない可能性があります。

Serviceのステータスと関連付けられたエンドポイントを確認します。

• Selector: Podのラベルと一致していますか。
• Endpoints: 正常なPodのIPアドレスが一覧にありますか。

Kubernetesは、クラスター内でほぼすべての操作に対してイベントを生成します。イベントは、問題の経過を理解するうえで非常に役立ちます。特に、スケジューリングの問題やリソース不足の調査に有効です。

kubectl get eventsを使うと、名前空間内またはクラスター全体で発生したイベントを時系列のログとして確認できます。

よくある問題と確認すべき点を紹介します。

• ImagePullBackOff: イメージ名またはタグが誤っている、プライベートレジストリの認証に問題がある。
• CrashLoopBackOff: アプリケーションエラー（ログを確認してください）、liveness probeの設定ミス、リソース不足。
• Pending状態のPod: リソース（CPUやメモリ）の不足、ノードのtaintとtolerationの不一致、ノードセレクターの不一致。
• Serviceに接続できない: ServiceのセレクターがPodのラベルと一致していない、target portが誤っている。
• Readiness Probeの失敗: アプリケーションがトラフィックを処理できる状態になっていない。

web-server-789abcという名前のPodがPending状態から進みません。スケジューリングされない理由を理解するために、最初にどのkubectlコマンドを使いますか。

このレッスンでは、Kubernetesでよくある問題を診断するための重要なコマンドと手法を学びました。

• 概要をすばやく確認するにはkubectl getを使います。
• 詳細なステータスとイベントを確認するにはkubectl describeで深く調査します。
• アプリケーション固有のエラーを確認するにはkubectl logsを使います。
• クラスター全体のアクティビティを監視するにはkubectl get eventsを使います。

これらのツールを使えば、問題をすばやく特定して解決し、アプリケーションを安定して動作させられます。