第12章 ImageDigestMirrorSet [config.openshift.io/v1]

imageDigestMirrors

array

imageDigestMirrors を使用すると、Pod 内のイメージダイジェストによって参照されるイメージを、ミラーリングされた代替のリポジトリーの場所から取得できます。Pod に提供されたイメージプル仕様は、imageDigestMirrors に記述されているソースの場所と比較され、指定されたリポジトリーではなくリスト内の任意のミラーからイメージがプルダウンされる可能性があるため、管理者はより高速なミラーを選択できます。タグ仕様を使用してミラーでイメージをプルするには、ユーザーは "ImageTagMirrorSet" CRD を使用してミラーのリストを設定する必要があります。イメージプル仕様が複数の imagedigestmirrorset オブジェクト内の "source" のリポジトリーと一致する場合、最も具体的な namespace の一致を定義するオブジェクトのみが使用されます。たとえば、quay.io/libpod と quay.io/libpod/busybox を "source" として使用するオブジェクトがある場合、quay.io/libpod/busybox を使用するオブジェクトのみがプル仕様 quay.io/libpod/busybox に適用されます。各 "source" リポジトリーは独立して扱われます。異なる "ソース" リポジトリーの設定は相互作用しません。"ミラー" が指定されていない場合、イメージはプル仕様で指定されたリポジトリーから引き続きプルされます。同じ "ソース" リポジトリーに対して複数のポリシーが定義されている場合、定義されたミラーのセットは一緒にマージされ、可能であればミラーの相対的な順序が維持されます。たとえば、ポリシー A にミラー a、b、c があり、ポリシー B にミラー c、d、e がある場合、ミラーは a、b、c、d、e の順序で使用されます。ミラーエントリーの順序が競合する場合 (たとえば a, bb, a) 設定は拒否されませんが、結果の順序は指定されていません。特定のミラー順序を使用する必要があるユーザーは、ミラーを予想される順序で 1 つのリストに設定する必要があります。

imageDigestMirrors[]

object

ImageDigestMirrors は、レジストリー設定におけるミラー処理方法に関するクラスター全体の情報を保持します。

mirrorSourcePolicy

string

mirrorSourcePolicy は、ミラーからイメージをプルできない場合のフォールバックポリシーを定義します。設定されていない場合、イメージはプル仕様のリポジトリーから引き続きプルされます。sourcePolicy は、ミラーリストに 1 つ以上のミラーがある場合にのみ有効な設定です。

mirrors

array (string)

mirrors は、同じイメージが含まれる可能性がある 0 個以上の場所です。これが指定されていない場合、ミラーは設定されません。これらのミラーからイメージを取得できるのは、ダイジェストによって参照されている場合のみです。ミラーリングされた場所は、入力参照のソースと一致する部分をミラーエントリーで置き換えることにより取得されます。たとえば、registry.redhat.io/product/repo 参照の場合、(ソース、ミラーの) ペアである *.redhat.io、mirror.local/redhat により、mirror.local/redhat/product/repo リポジトリーが使用されます。このリスト内のミラーの順序はユーザーの希望する優先度として扱われますが、ソースはデフォルトですべてのミラーよりも低い優先度と見なされます。ミラーが指定されていない場合、またはミラーリストからのすべてのイメージプルが失敗した場合、"mirrorSourcePolicy" によって明示的に禁止されていない限り、イメージはプル仕様のリポジトリーから引き続きプルされます。他の imageDigestMirrors オブジェクトを含む (ただしこれらに限定されない) その他のクラスター設定は、接続されるミラーの正確な順序に影響を与える可能性があり、また一部のミラーは並行して接続される可能性があるため、これは順序を保証するものではなく、優先順位として考慮する必要があります。"mirrors" は、host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo のいずれかの形式を使用します。形式の詳細は、location フィールドに関するドキュメント (https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table) を参照してください。

source

string

source は、たとえばイメージプル仕様などでユーザーが参照するリポジトリーです。source をレジストリーホスト名 (例: docker.io、quay.io、registry.redhat.io) に設定すると、対応するレジストリーのイメージプル仕様と一致します。"source" は、host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo [*.]host のいずれかの形式を使用します。形式の詳細は、location フィールドに関するドキュメント (https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table) を参照してください。