6.3. Red Hat Quay オブジェクトストレージのトラブルシューティング
オブジェクトストレージは、データをオブジェクトと呼ばれる objects の単位として管理するデータストレージアーキテクチャーの一種です。データを階層ディレクトリーやファイルに編成する従来のファイルシステムとは異なり、オブジェクトストレージはデータを一意の識別子を持つ独立したエンティティーとして扱います。各オブジェクトには、データ自体と、オブジェクトを説明して効率的な検索を可能にするメタデータが含まれています。
Red Hat Quay は、コンテナーイメージを保存および管理するための基礎となるストレージメカニズムとしてオブジェクトストレージを使用します。コンテナーイメージを個別のオブジェクトとして保存します。各コンテナーイメージは、独自の一意の識別子と関連するメタデータを持つオブジェクトとして扱われます。
6.3.1. Red Hat Quay オブジェクトストレージの問題のトラブルシューティング
Red Hat Quay オブジェクトストレージの問題をトラブルシューティングするには、次のオプションを使用します。
手順
次のコマンドを入力して、どのオブジェクトストレージが使用されているかを確認します。
$ oc get quayregistry quay-registry-name -o yaml
- 使用しているオブジェクトストレージが、テスト済みの統合 ページをチェックして、Red Hat Quay によって正式にサポートされていることを確認してください。
- デバッグモードを有効化します詳細は、「デバッグモードでの Red Hat Quay の実行」を参照してください。
-
config.yamlファイル内のオブジェクトストレージ設定を確認してください。設定が正確であり、オブジェクトストレージプロバイダーが提供する設定と一致していることを確認してください。アクセス認証情報、エンドポイント URL、バケット名とコンテナー名、その他の関連する設定パラメーターなどの情報を確認できます。 - Red Hat Quay がオブジェクトストレージエンドポイントにネットワーク接続されていることを確認します。ネットワーク設定をチェックして、Red Hat Quay とオブジェクトストレージエンドポイント間の通信をブロックする制限がないことを確認します。
FEATURE_STORAGE_PROXYがconfig.yamlファイルで有効になっている場合は、そのダウンロード URL がアクセス可能かどうかを確認してください。これは、Red Hat Quay のデバッグログで確認できます。以下に例を示します。$ curl -vvv "https://QUAY_HOSTNAME/_storage_proxy/dhaWZKRjlyO......Kuhc=/https/quay.hostname.com/quay-test/datastorage/registry/sha256/0e/0e1d17a1687fa270ba4f52a85c0f0e7958e13d3ded5123c3851a8031a9e55681?AWSAccessKeyId=xxxx&Signature=xxxxxx4%3D&Expires=1676066703"
-
Red Hat Quay の外部にあるオブジェクトストレージサービスにアクセスして、問題がデプロイメントに固有のものなのか、基礎となるオブジェクトストレージに固有のものなのかを判断してください。オブジェクトストレージプロバイダーが提供する
aws、gsutil、s3cmd などのコマンドラインツールを使用して、バケット、コンテナーのリスト表示、オブジェクトのアップロードとダウンロードなどの基本的な操作を実行できます。これは問題を切り分けるのに役立つ場合があります。
