7.7. Pod の問題の調査

手順

1. プロジェクトに切り替えます。

   $ oc project <project_name>

2. namespace 内で実行されている Pod、Pod のステータス、エラーの状態、再起動、および経過時間をリスト表示します。

   $ oc get pods

3. namespace がデプロイメント設定で管理されているかどうかを判別します。

   $ oc status

   namespace がデプロイメント設定で管理される場合、出力には、デプロイメント設定名とベースイメージの参照が含まれます。

4. 前述のコマンドの出力で参照されているベースイメージを検査します。

   $ skopeo inspect docker://<image_reference>

5. ベースイメージの参照が正しくない場合は、デプロイメント設定の参照を更新します。

   $ oc edit deployment/my-deployment

6. デプロイメント設定が終了時に変更されると、設定が自動的に再デプロイされます。デプロイメントの進行中に Pod ステータスを確認し、問題が解決されているかどうかを判別します。

   $ oc get pods -w

7. Pod の失敗に関連する診断情報については、namespace 内でイベントを確認します。

   $ oc get events

手順

1. 特定の Pod のログをクエリーします。

   $ oc logs <pod_name>

2. Pod 内の特定コンテナーのログをクエリーします。

   $ oc logs <pod_name> -c <container_name>

   前述の oc logs コマンドを使用して取得されるログは、Pod またはコンテナー内の標準出力 (stdout) に送信されるメッセージで設定されます。

3. Pod 内の /var/log/ に含まれるログを検査します。

   1. Pod 内の /var/log に含まれるファイルおよびサブディレクトリーをリスト表示します。

      $ oc exec <pod_name> ls -alh /var/log

   2. Pod 内の /var/log に含まれる特定のログファイルをクエリーします。

      $ oc exec <pod_name> cat /var/log/<path_to_log>

   3. 特定のコンテナー内の /var/log に含まれるログファイルおよびサブディレクトリーをリスト表示します。

      $ oc exec <pod_name> -c <container_name> ls /var/log

   4. 特定のコンテナー内の /var/log に含まれる特定のログファイルをクエリーします。

      $ oc exec <pod_name> -c <container_name> cat /var/log/<path_to_log>

手順

1. アクセスする Pod が含まれるプロジェクトに切り替えます。これは、oc rsh コマンドが -n namespace オプションを受け入れないために必要です。

   $ oc project <namespace>

2. リモートシェルを Pod で起動します。

   $ oc rsh <pod_name>  1

   1

   Pod に複数のコンテナーがある場合、oc rsh は -c <container_name> が指定されていない限り最初のコンテナーにデフォルト設定されます。

3. Pod 内の特定のコンテナーでリモートシェルを起動します。

   $ oc rsh -c <container_name> pod/<pod_name>

4. Pod のポートへのポート転送セッションを作成します。

   $ oc port-forward <pod_name> <host_port>:<pod_port>  1

   1

   ポート転送セッションをキャンセルするには、Ctrl+C を入力します。

手順

1. デプロイメントに基づいて、root アクセスでデバッグ Pod を起動します。

   1. プロジェクトのデプロイメント名を取得します。

      $ oc get deployment -n <project_name>

   2. デプロイメントに基づいて、root 権限でデバッグ Pod を起動します。

      $ oc debug deployment/my-deployment --as-root -n <project_name>

2. デプロイメント設定に基づいて、root アクセスでデバッグ Pod を起動します。

   1. プロジェクトのデプロイメント設定名を取得します。

      $ oc get deploymentconfigs -n <project_name>

   2. デプロイメント設定に基づいて、root 権限でデバッグ Pod を起動します。

      $ oc debug deploymentconfig/my-deployment-configuration --as-root -n <project_name>

手順

1. ファイルを Pod にコピーします。

   $ oc cp <local_path> <pod_name>:/<path> -c <container_name>  1

   1

   -c オプションが指定されていない場合、Pod の最初のコンテナーが選択されます。

2. Pod からファイルをコピーします。

   $ oc cp <pod_name>:/<path>  -c <container_name><local_path>  1

   1

   -c オプションが指定されていない場合、Pod の最初のコンテナーが選択されます。

   注記

   oc cp が機能するには、tar バイナリーがコンテナー内で利用可能である必要があります。