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

imageDigestMirrors

array

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

imageDigestMirrors[]

object

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

mirrorSourcePolicy

string

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

mirrors

array (string)

ミラーは、同じイメージが含まれる可能性のあるゼロ以上の場所です。指定されていない場合は、ミラーは設定されません。これらのミラーからイメージは、ダイジェストによって参照されている場合にのみ取得できます。ミラーリングされた場所は、mirrors エントリーによって一致するソースに一致する入力参照の一部（ソース、ミラー）、*.redhat.io、mirror.local/redhat は、mirror.local/redhat リポジトリーが使用されます。このリスト内のミラーの順序はユーザーの希望する優先度として扱われますが、ソースはデフォルトですべてのミラーよりも低い優先度と見なされます。ミラーが指定されていない場合や、ミラーリストからのすべてのイメージのプルが失敗した場合、イメージは、他の imageDigestMirrors オブジェクトを含む（ただしこれらに限定されない）他のクラスター設定によって明示的に禁止されていない限り、プル仕様のリポジトリーから引き続きプルされます。また、一部のミラーは、ミラーの正確な順序に影響を与える可能性があるか、一部のミラーが並行して接続される可能性があります。したがって、これは順序付けの保証ではなく優先事項とみなされます。ミラー化は、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 は、たとえばイメージプル仕様でユーザーが参照するリポジトリーです。ソースをレジストリーのホスト名（例：docker.io. quay.io または registry.redhat.io）に設定すると、関連するレジストリーのイメージプル仕様と一致します。ソースは、ホスト：host[:port] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…] host[:port]/namespace[/namespace…]/repo [*.]host の形式のいずれかを使用します。https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table