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

      出力例

      total 124K
      drwxr-xr-x. 1 root root   33 Aug 11 11:23 .
      drwxr-xr-x. 1 root root   28 Sep  6  2022 ..
      -rw-rw----. 1 root utmp    0 Jul 10 10:31 btmp
      -rw-r--r--. 1 root root  33K Jul 17 10:07 dnf.librepo.log
      -rw-r--r--. 1 root root  69K Jul 17 10:07 dnf.log
      -rw-r--r--. 1 root root 8.8K Jul 17 10:07 dnf.rpm.log
      -rw-r--r--. 1 root root  480 Jul 17 10:07 hawkey.log
      -rw-rw-r--. 1 root utmp    0 Jul 10 10:31 lastlog
      drwx------. 2 root root   23 Aug 11 11:14 openshift-apiserver
      drwx------. 2 root root    6 Jul 10 10:31 private
      drwxr-xr-x. 1 root root   22 Mar  9 08:05 rhsm
      -rw-rw-r--. 1 root utmp    0 Jul 10 10:31 wtmp

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

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

      出力例

      2023-07-10T10:29:38+0000 INFO --- logging initialized ---
      2023-07-10T10:29:38+0000 DDEBUG timer: config: 13 ms
      2023-07-10T10:29:38+0000 DEBUG Loaded plugins: builddep, changelog, config-manager, copr, debug, debuginfo-install, download, generate_completion_cache, groups-manager, needs-restarting, playground, product-id, repoclosure, repodiff, repograph, repomanage, reposync, subscription-manager, uploadprofile
      2023-07-10T10:29:38+0000 INFO Updating Subscription Management repositories.
      2023-07-10T10:29:38+0000 INFO Unable to read consumer identity
      2023-07-10T10:29:38+0000 INFO Subscription Manager is operating in container mode.
      2023-07-10T10:29:38+0000 INFO

   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 バイナリーがコンテナー内で利用可能である必要があります。