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

手順

• 次のコマンドを実行して、ブートイメージアーティファクトのメタデータを出力します。

  $ openshift-install coreos print-stream-json | jq <bootimage> 

  1

  1

  情報を取得するブートイメージに対するクエリー。検証が目的の場合、ブートイメージアーティファクトに、生成された sha256sum が存在している必要があります。ブートイメージには、OVA、VHD、QCOW2 などがあります。たとえば、ベアメタルプラットフォーム用の x86_64 アーキテクチャーの ISO ファイルに関する情報を取得する場合、この値は .architectures.x86_64.artifacts.metal.formats.iso になります。

  出力例

  {
    "disk": {
      "location": "<url>/art/storage/prod/streams/<release>/builds/rhcos-<release>-live.<architecture>.<artifact>",
      "sha256": "abc2add9746eb7be82e6919ec13aad8e9eae8cf073d8da6126d7c95ea0dee962"
    }
  }

前提条件

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

手順

• インストールホストのインストールディレクトリーにある .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> は、クラウドプロバイダーのルートシークレットの名前です。

  Expand

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

  Show more

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

  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 ロールを持つユーザーとしてクラスターにアクセスできる。

手順

• Home → Overview に移動します。

前提条件

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

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

前提条件

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

前提条件

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

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

• OpenShift Container Platform クラスターのインストールを試みたが、インストールに失敗している。

前提条件

• OpenShift Container Platform のインストールがブートストラッププロセスの終了前に失敗している。ブートストラップノードは実行中で、SSH でアクセスできる。
• ssh-agent プロセスはコンピューター上でアクティブであり、ssh-agent プロセスとインストールプログラムの両方に同じ SSH キーを提供している。
• 独自にプロビジョニングしたインフラストラクチャーにクラスターのインストールを試行した場合は、ブートストラップおよびコントロールプレーンノードの完全修飾ドメイン名がある。

前提条件

• ホストへの SSH アクセスがある。

前提条件

• OpenShift Container Platform のインストールが完了している。
• API サービスが機能している。
• システム管理者権限がある。

• 非表示の .openshift_install.log ファイルで過去のインストールからのデバッグ情報を確認します。たとえば、以下を入力します。

  $ cat ~/<installation_directory>/.openshift_install.log 

  1

  1

  installation_directory には、./openshift-install create cluster を実行した際に指定したのと同じディレクトリーを指定します。

• インストールプログラムが含まれるディレクトリーに切り替え、--log-level=debug でこれを再実行します。

  $ ./openshift-install create cluster --dir <installation_directory> --log-level debug 

  1

  1

  installation_directory には、./openshift-install create cluster を実行した際に指定したのと同じディレクトリーを指定します。