プルスルー・キャッシュ・リポジトリの使用

プルスルー・キャッシュ・リポジトリがアップストリーム・レジストリからイメージを取得およびキャッシュする方法を確認します。

プルスルー・キャッシュ・リポジトリは、プライベートの読取り専用リポジトリです。クライアントはそこからイメージをプルできますが、イメージにプッシュすることはできません。コンテナ・レジストリは、リポジトリ用に構成されたアップストリーム・レジストリからリクエストされたイメージを取得し、プルスルー・キャッシュ・リポジトリを含むリージョンにキャッシュします。

サポートされるアップストリーム・レジストリは、プルスルー・キャッシュ・リポジトリと同じOCIレルム内の異なるOCIリージョン内のコンテナ・レジストリ・エンドポイントです。

クライアントはコンテナ・レジストリを認証し、他のプライベート・リポジトリと同じ方法でプルスルー・キャッシュ・リポジトリからイメージをプルします。

プルスルー・キャッシュ・リポジトリを作成するには、「リポジトリの作成」の手順に従って、リポジトリ・タイプとして「プルスルー・キャッシュ・リポジトリ」を選択し、「アップストリームURL」、「アップストリーム・ユーザー名」および「アップストリーム・シークレットID」の値を指定します。

アップストリーム・レジストリ認証

コンテナ・レジストリは、プルスルー・キャッシュ・リポジトリ用に構成されたアップストリーム・ユーザー名を使用して、アップストリーム・レジストリを認証します。対応する認証資格証明は、アップストリーム・シークレットIDで識別されるOCI Vaultのシークレットに格納されます。

コンテナ・レジストリ・アップストリームの場合、この資格証明はアップストリーム・ユーザーのOCI認証トークンです。

アップストリーム認証資格証明は、OCI Vaultに送信されるときにBase64でエンコードされている必要があります。PATに有効期限がある場合は、期限切れになる前に、PATを置き換えてOCI Vaultに格納されている資格証明を更新します。

コンテナ・レジストリからパブリック・イメージをプルする場合でも、アップストリーム資格証明が必要です。匿名アップストリーム・アクセスはサポートされていません。

アップストリーム・ユーザーには、リクエストされたイメージをプルする権限が必要です。テナンシのIAMポリシーでは、コンテナ・レジストリのプルスルー・リソース・プリンシパルがシークレットを読み取ることも許可する必要があります:

allow resource ocir ocirpullthrough to read secret-bundles in compartment <secret-compartment-name> where target.secret.name = '<secret-name>'

<secret-compartment-name>をシークレットを含むコンパートメントに、<secret-name>をシークレットの名前に置き換えます。

例:

allow resource ocir ocirpullthrough to read secret-bundles in compartment registry-secrets where target.secret.name = 'upstream-ocir-auth-token'

イメージのキャッシュ方法

クライアントがイメージをプルすると、次で説明するタグ・リフレッシュ動作に従って、コンテナ・レジストリがローカル・キャッシュからイメージを処理します。イメージまたは必要なレイヤーがキャッシュされていない場合、コンテナ・レジストリは、構成済のアップストリーム・レジストリからそれらを取得し、クライアントにストリームし、後続のプル用にローカルにキャッシュします。

イメージはオンデマンドでキャッシュされます。プルスルー・キャッシュ・リポジトリを作成すると、アップストリーム・レジストリからイメージが自動的にコピーされることはありません。

キャッシュされたイメージは、プルスルー・キャッシュ・リポジトリを含むリージョンに格納され、コンテナ・レジストリ内の他のイメージと同じストレージ使用および保存ポリシーの対象となります。

タグとダイジェストの動作

タグによるプル

タグでイメージをプルする場合、リフレッシュ・チェックが行われるまで、コンテナ・レジストリはキャッシュされたバージョンを使用します。デフォルトのリフレッシュ間隔は、タグごとに1時間であり、最後に記録されたアップストリーム・チェックから測定されます。

その間隔の後の最初のリクエストにより、アップストリーム・レジストリのチェックがトリガーされます。タグが別のイメージを指している場合、コンテナ・レジストリはキャッシュされたタグを更新し、まだキャッシュされていない必要なイメージまたはレイヤーを取得します。タグが変更されていない場合、コンテナ・レジストリはキャッシュされたバージョンを返します。

タグは、要求された場合にのみリフレッシュされます。コンテナ・レジストリは、バックグラウンドでタグを自動的にリフレッシュしません。

アップストリーム・チェックが失敗した場合の動作

キャッシュされたタグが存在しなくなったことがアップストリーム・レジストリから報告された場合、コンテナ・レジストリはキャッシュされたイメージを引き続き返すことができます。アップストリーム・レジストリからイメージまたはタグを削除しても、プルスルー・キャッシュ・リポジトリからイメージまたはタグは自動的に削除されません。

タイムアウトやアップストリーム・サービスの停止などの一時的な問題のためにリフレッシュが失敗した場合、コンテナ・レジストリはキャッシュされたイメージがローカルで使用可能であれば返すことができます。後のプルでリフレッシュを再試行できます。

コンテナ・レジストリがアップストリーム・レジストリに接続する必要がある場合、アップストリーム資格証明が無効であるか、アップストリーム構成が正しくないか、またはアップストリーム権限が不十分な場合、古いバージョンのイメージがキャッシュされていてもプルは失敗します。

ダイジェストによるプル

イメージをダイジェストでプルする場合、コンテナ・レジストリは、アップストリーム・レジストリの更新をチェックせずに、キャッシュされたイメージを処理します。イメージまたは必要なレイヤーがキャッシュされていない場合、コンテナ・レジストリはそれらをアップストリーム・レジストリから取得し、ローカルにキャッシュします。

サポートされているイメージマニフェスト形式

プルスルー・キャッシュ・リポジトリでは、Docker Image Manifest V2、Schema 2、Dockerマニフェスト・リスト、OCIイメージ・マニフェストおよびOCIイメージ索引がサポートされています。Dockerスキーマ・バージョン1のイメージ・マニフェストはサポートされていません。

プルスルー・キャッシュ・リポジトリの管理

プルスルー・キャッシュ・リポジトリを作成した後、アップストリーム・ユーザー名およびアップストリーム・シークレットIDを更新できます。アップストリームURLまたはリポジトリ・タイプは変更できません。詳細は、リポジトリの編集を参照してください。

キャッシュされたイメージの削除および保存ポリシーの使用の詳細は、「イメージの削除」および「保存ポリシーを使用したイメージの保存および削除」を参照してください。キャッシュされたイメージの署名およびスキャンの詳細は、セキュリティのためのイメージの署名および脆弱性のためのイメージのスキャンに関する項を参照してください。