第24章 検証およびトラブルシューティング

前提条件

• インストールホストにアクセスできる。

手順

• インストールホストのインストールディレクトリーにある .openshift_install.log ログファイルを確認します。

  $ cat <install_dir>/.openshift_install.log

  出力例

  以下の例で説明されているように、インストールに成功すると、クラスター認証情報はログの末尾に追加されます。

  ...
  time="2020-12-03T09:50:47Z" level=info msg="Install complete!"
  time="2020-12-03T09:50:47Z" level=info msg="To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'"
  time="2020-12-03T09:50:47Z" level=info msg="Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com"
  time="2020-12-03T09:50:47Z" level=info msg="Login to the console with user: \"kubeadmin\", and password: \"password\""
  time="2020-12-03T09:50:47Z" level=debug msg="Time elapsed per stage:"
  time="2020-12-03T09:50:47Z" level=debug msg="    Infrastructure: 6m45s"
  time="2020-12-03T09:50:47Z" level=debug msg="Bootstrap Complete: 11m30s"
  time="2020-12-03T09:50:47Z" level=debug msg=" Bootstrap Destroy: 1m5s"
  time="2020-12-03T09:50:47Z" level=debug msg=" Cluster Operators: 17m31s"
  time="2020-12-03T09:50:47Z" level=info msg="Time elapsed: 37m26s"

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

手順

• マスターまたはワーカーノードの CRI-O ログを確認します。

  $  oc adm node-logs <node_name> -u crio

  出力例

  Trying to access ログエントリーは、イメージがプルされる場所を示します。

  ...
  Mar 17 02:52:50 ip-10-0-138-140.ec2.internal crio[1366]: time="2021-08-05 10:33:21.594930907Z" level=info msg="Pulling image: quay.io/openshift-release-dev/ocp-release:4.10.0-ppc64le" id=abcd713b-d0e1-4844-ac1c-474c5b60c07c name=/runtime.v1alpha2.ImageService/PullImage
  Mar 17 02:52:50 ip-10-0-138-140.ec2.internal crio[1484]: time="2021-03-17 02:52:50.194341109Z" level=info msg="Trying to access \"li0317gcp1.mirror-registry.qe.gcp.devcluster.openshift.com:5000/ocp/release@sha256:1926eae7cacb9c00f142ec98b00628970e974284b6ddaf9a6a086cb9af7a6c31\""
  Mar 17 02:52:50 ip-10-0-138-140.ec2.internal crio[1484]: time="2021-03-17 02:52:50.226788351Z" level=info msg="Trying to access \"li0317gcp1.mirror-registry.qe.gcp.devcluster.openshift.com:5000/ocp/release@sha256:1926eae7cacb9c00f142ec98b00628970e974284b6ddaf9a6a086cb9af7a6c31\""
  ...

  ログは、前述の例のように、イメージのプルソースを 2 回表示する場合があります。

  ImageContentSourcePolicy オブジェクトに複数のミラーをリスト表示する場合には、OpenShift Container Platform はイメージを設定にリスト表示されている順序でプルしようとします。以下に例を示します。

  Trying to access \"li0317gcp1.mirror-registry.qe.gcp.devcluster.openshift.com:5000/ocp/release@sha256:1926eae7cacb9c00f142ec98b00628970e974284b6ddaf9a6a086cb9af7a6c31\"
  Trying to access \"li0317gcp2.mirror-registry.qe.gcp.devcluster.openshift.com:5000/ocp/release@sha256:1926eae7cacb9c00f142ec98b00628970e974284b6ddaf9a6a086cb9af7a6c31\"

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。
• OpenShift CLI (oc) がインストールされている。

前提条件

• Cloud Credential Operator ユーティリティー (ccoctl) を使用して OpenShift Container Platform クラスターをデプロイし、短期認証情報を実装しました。
• OpenShift CLI (oc) がインストールされている。
• cluster-admin 権限を持つユーザーとしてログインしている。

手順

• 次のコマンドを実行して、CCO が手動モードで動作するように設定されていることを確認します。

  $ oc get cloudcredentials cluster \
    -o=jsonpath={.spec.credentialsMode}

  次の出力は、CCO が手動モードで動作していることを示しています。

  出力例

  Manual

• 次のコマンドを実行して、クラスターに root 認証情報がないことを確認します。

  $ oc get secrets \
    -n kube-system <secret_name>

  <secret_name> は、クラウドプロバイダーのルートシークレットの名前です。

  プラットフォーム	シークレット名
  Amazon Web Services (AWS)	aws-creds
  Microsoft Azure	azure-credentials
  Google Cloud Platform (GCP)	gcp-credentials

  エラーは、ルートシークレットがクラスター上に存在しないことを確認します。

  AWS クラスターの出力例

  Error from server (NotFound): secrets "aws-creds" not found

• 次のコマンドを実行して、コンポーネントが個々のコンポーネントに対して短期セキュリティー認証情報を使用していることを確認します。

  $ oc get authentication cluster \
    -o jsonpath \
    --template='{ .spec.serviceAccountIssuer }'

  このコマンドは、クラスター Authentication オブジェクトの .spec.serviceAccountIssuer パラメーターの値を表示します。クラウドプロバイダーに関連付けられた URL の出力は、クラスターがクラスターの外部から作成および管理される短期認証情報を使用して手動モードを使用していることを示します。

• Azure クラスター: 次のコマンドを実行して、コンポーネントがシークレットマニフェストで指定された Azure クライアント ID を想定していることを確認します。

  $ oc get secrets \
    -n openshift-image-registry installer-cloud-credentials \
    -o jsonpath='{.data}'

  出力に azure_client_id フィールドと azure_federated_token_file フィールドが含まれていれば、コンポーネントが Azure クライアント ID を想定しています。

• Azure クラスター: 次のコマンドを実行して、pod identity webhook が実行されていることを確認します。

  $ oc get pods \
    -n openshift-cloud-credential-operator

  出力例

  NAME                                         READY   STATUS    RESTARTS   AGE
  cloud-credential-operator-59cf744f78-r8pbq   2/2     Running   2          71m
  pod-identity-webhook-548f977b4c-859lz        1/1     Running   1          70m

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。
• OpenShift CLI (oc) がインストールされている。

• クラスターの一般的なステータス
• コントロールプレーン、クラスター Operator、およびストレージのステータス
• CPU、メモリー、ファイルシステム、ネットワーク転送、および Pod の可用性
• クラスターの API アドレス、クラスター ID、およびプロバイダーの名前
• クラスターのバージョン情報
• 現在の更新チャネルの詳細や利用可能な更新を含むクラスター更新のステータス
• ノード、Pod、ストレージクラスの詳細を示すクラスターインベントリー、および永続ボリューム要求 (PVC) 情報
• 継続中のクラスターのアクティビティーおよび最近のイベントのリスト

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

手順

• Administrator パースペクティブで、Home Overview に移動します。

前提条件

• OpenShift Cluster Manager にログインしている。
• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

• etcd
• Kubernetes コンピュートリソース
• Kubernetes ネットワークリソース
• Prometheus
• クラスターおよびノードのパフォーマンスに関連するダッシュボード

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

• クラスターのインストール時に問題が発生した場合は、インストールのトラブルシューティング を参照してください。
• OpenShift Container Platform のインストール後に、クラスターをさらに拡張し、カスタマイズ できます。