ランタイム問題のトラブルシューティング

オンライン編集

Cloud Pakの使用時に問題が発生する場合があります。

問題を診断するには、以下の情報を参照してください。

偶発的なエラーにより、イメージが Red Hat OpenShift 統合レジストリーにプッシュされる

以下のいずれかのメッセージを受け取る可能性があります。

  • received unexpected HTTP status: 504 Gateway Time-out
  • unable to retrieve auth token: invalid username/password

Red Hat OpenShift 統合イメージ・レジストリーに対して docker push を実行すると、さまざまな断続的なエラーが発生する可能性があります。 考えられるエラーの原因の 1 つは、統合レジストリーのバッキング・ストレージの 1 秒あたりの入出力操作 (IOPS) 設定です。

この問題を解決するには、以下のことを試みます。

  1. PV バッキングストレージデバイス 外部リンク・アイコン の IOPS 設定を増やすか、バッキングストレージのサイズを増やす。
  2. 以下のコマンドを使用して、イメージ・レジストリー・デプロイメントを 1 にスケール・ダウンします。
    oc -n openshift-image-registry scale deployment image-registry --replicas=1

Docker ハブ・コンテナー・レジストリーの代わりに、 Red Hat OpenShift で提供されているローカル・コンテナー・レジストリーを使用するにはどうすればよいですか?

Red Hat OpenShiftに付属のローカル・コンテナー・レジストリーを使用するには、以下のようにします。

  1. Red Hat OpenShift で指定されたローカル・コンテナ・レジストリ URL をクラスタ内で検索する。
    1. Red Hat OpenShift Web コンソールで、ワークスペースのデフォルトを選択します。
    2. docker-registry ポッドをクリックします。
    3. 「 Environment 」タブをクリックします。
    4. URL OPENSHIFT_DEFAULT_REGISTRY = docker-registry.default.svc:5000 を取得します。
  2. ローカル・コンテナー・レジストリーを見つけたら、 Docker Registry エントリーの値として Webhook を設定するときにそのレジストリーを使用するか、 docker-image パイプライン・リソースとして PipelineRun を手動で実行するときにそのレジストリーに言及します。
    • 例えば、パイプライン・ダッシュボードで、Webhook の設定を次のようにします。
      Docker Registry : image-registry.openshift-image-registry.svc:5000/kabanero
    • 例えば、手動で PipelineRun を実行する際に、パイプライン・リソースを次のようにします。
      docker-image : docker-registry.default.svc:5000/kabanero/my-image-name

Kubernetes サービスと内部 Docker レジストリーを使用してクラウド上で Red Hat OpenShift Container Platform を使用する場合、内部 Docker レジストリーへの Docker プッシュを実行すると、ゲートウェイ・タイムアウト・エラーが発生する可能性があります。

ゲートウェイ・タイムアウト・エラーは、レジストリーの永続ボリューム (PV) の補助ストレージに対する 1 秒当たりの入出力操作数 (IOPS) 設定が低すぎる場合に発生します。

この問題を解決するには、PV の補助ストレージ・デバイスの IOPS 設定を変更してください。

docker-image : image-registry.openshift-image-registry.svc:5000/kabanero/my-image-name