PodとServiceのデバッグ

Kubernetes上のアプリケーションが正しく動作しないとき、デバッグは問題解決の大きな力になります。何が起きたのかを理解し、修正方法を見つけるのに役立ちます。

問題が起きている一般的な兆候は次のとおりです。

• Podが「Pending」または「CrashLoopBackOff」状態から進まない。
• Serviceに到達できない。
• アプリケーションが期待どおりに応答しない。

これらの問題を診断するための基本的なツールを学びます。

Kubernetesには、クラスターの調査とトラブルシューティングに役立つ強力なコマンドラインツールが用意されています。中心となるのがkubectlです。

ここでは、次の主要なコマンドを取り上げます。

• kubectl describe: リソースの詳細情報を取得します。
• kubectl logs: コンテナの出力を確認します。
• kubectl exec: コンテナ内でコマンドを実行します。
• kubectl port-forward: サービスにローカルからアクセスします。

これらを使いこなせば、Kubernetesのデバッグをプロレベルで行えるようになります。

kubectl describeコマンドは、Kubernetesリソース、特にPodについて詳細な情報を確認する最初の手段です。

イベント、ステータス、IPアドレス、ボリューム、コンテナの詳細など、豊富なデータを提供します。手がかりを探すには、末尾にある「Events」を確認してください。

イベントは、Podやその他のリソースで何が起きたのかを理解するうえで重要です。作成、スケジューリング、エラーなどの経過を知ることができます。

describeを使って特定のリソースのイベントを確認したり、kubectl get eventsでクラスター全体のイベントを表示したりできます。

アプリケーションは通常、重要なメッセージ、エラー、デバッグ情報を標準出力または標準エラー出力に表示します。kubectl logsを使うと、これらの情報にアクセスできます。

Podがクラッシュしている場合は、ログを確認してなぜ失敗しているのかを理解することが重要です。ログをリアルタイムで追跡することもできます。

ログを見るだけでは不十分な場合があります。サーバーにSSH接続するように、問題を診断するために実行中のコンテナ内でコマンドを実行する必要があるかもしれません。

kubectl execを使うと、コンテナ内でコマンドを実行したり、bashやshなどのシェルを直接起動したりできます。

Serviceに到達できないと考えられる場合や、外部に公開せずローカルでテストしたい場合は、kubectl port-forwardが役立ちます。

ローカルマシンからクラスター内のPodまたはServiceへの安全なトンネルを作成し、localhost経由でアクセスできるようにします。

Service経由でアプリケーションに到達できない場合は、次の2点を確認します。

• Service Selector: Podのラベルと正しく一致していますか。
• Endpoints: Serviceにアクティブなエンドポイント（実行中のPod）はありますか。

kubectl get svcとkubectl get epを使って確認します。

Podでよく起きる2つの問題を見てみましょう。

• CrashLoopBackOff: コンテナが起動とクラッシュを繰り返しています。エラーを確認するにはkubectl logsを使います。
• ImagePullBackOff: Kubernetesがコンテナイメージを取得できません。イメージ名、タグ、レジストリへのアクセスを確認します。

kubectl describe podを使うと、多くの場合、「Events」セクションで最初の原因を確認できます。

data-processor-xyzという名前のPodがCrashLoopBackOff状態になっていることに気付きました。クラッシュの原因を調査する必要があります。

直近の原因を診断するために、最初に実行すべき最も重要な2つのコマンドは次のうちどれですか。

お疲れさまでした。主要なkubectlコマンドを使ってPodとServiceをデバッグする方法を学びました。

• 詳細なリソース情報とイベントにはkubectl describeを使います。
• コンテナ内で何が起きているかを確認するにはkubectl logsを使います。
• 対話的なトラブルシューティングにはkubectl execを使います。
• Serviceにローカルからアクセスするにはkubectl port-forwardを使います。

これらのツールは、Kubernetesアプリケーションを安定して動作させるために不可欠です。練習を続けてください。