第8章 ImageStream [image.openshift.io/v1]


説明

ImageStream は、タグのイメージへのマッピング、イメージがストリームでタグ付けされたときに適用されるメタデータオーバーライド、およびレジストリー上のコンテナーイメージリポジトリーへのオプションの参照を格納します。ユーザーは通常、spec.tags フィールドを更新して、プルシークレットタイプの名前空間のクレデンシャルを使用してコンテナーレジストリーからインポートされた外部イメージ、またはタグ付けまたはプルのためにすぐにアクセスできる既存のイメージストリームタグおよびイメージをポイントします。タグに適用されたイメージの履歴は status.tags フィールドに表示され、イメージストリームを表示できるすべてのユーザーは、そのイメージを自分のイメージストリームにタグ付けできます。統合レジストリーからイメージをプルするためのアクセスは、特定のイメージストリームに対する "get imagestreams/layers" 権限を持つことによって付与されます。ユーザーは、imagestreamtag リソースを削除することでタグを削除できます。これにより、そのタグの仕様とステータスの両方が削除されます。イメージストリームの履歴は、管理者が削除操作を実行するまで保持されます。これにより、使用されなくなった参照が削除されます。履歴イメージを保持するには、ダイジェストによってそのイメージを指すタグが仕様に含まれていることを確認してください。

互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。

object

8.1. 仕様

プロパティー説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta_v2

metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

ImageStreamSpec は、ImageStreams のオプションを表します。

status

object

ImageStreamStatus には、このイメージストリームの状態に関する情報が含まれています。

8.1.1. .spec

説明
ImageStreamSpec は、ImageStreams のオプションを表します。
object
プロパティー説明

dockerImageRepository

string

dockerImageRepository はオプションです。指定されている場合、このストリームはこのサーバー上のコンテナーリポジトリーによってサポートされます。非推奨: このフィールドは v3.7 で非推奨になり、将来のリリースで削除される予定です。代わりに、spec.tags.from 参照を介して、各タグにインポートされるタグのソースを指定してください。

lookupPolicy

object

ImageLookupPolicy は、イメージストリームを使用して、名前空間内の Pod、ビルド、およびその他のリソースによって使用されるイメージ参照をオーバーライドする方法を説明します。

tags

array

タグは、任意の文字列値を特定のイメージロケーターにマップします

tags[]

object

TagReference は、このタグを使用するイメージのオプションのアノテーションと、このタグが追跡する ImageStreamTag、ImageStreamImage、または DockerImage へのオプションの参照を指定します。

8.1.2. .spec.lookupPolicy

説明
ImageLookupPolicy は、イメージストリームを使用して、名前空間内の Pod、ビルド、およびその他のリソースによって使用されるイメージ参照をオーバーライドする方法を説明します。
object
必須
  • local
プロパティー説明

local

boolean

local は、リモートレジストリーにアクセスする代わりに、この名前空間内のオブジェクトの Docker ショートイメージ参照 ("mysql" や "php:latest" など) を、このイメージストリームと一致するたびにイメージ ID に変更します。名前が見つかった場合、その名前はイメージ ID に完全に修飾されます。タグの referencePolicy は、置き換えられた値で考慮されます。現在の名前空間内でのみ機能します。

8.1.3. .spec.tags

説明
タグは、任意の文字列値を特定のイメージロケーターにマップします
array

8.1.4. .spec.tags[]

説明
TagReference は、このタグを使用するイメージのオプションのアノテーションと、このタグが追跡する ImageStreamTag、ImageStreamImage、または DockerImage へのオプションの参照を指定します。
object
必須
  • name
プロパティー説明

annotations

object (string)

オプション。指定されている場合、ImageStreamTags を介して取得されたイメージに適用されるアノテーション。

from

ObjectReference

オプション。指定されている場合、このタグが指す必要がある別のイメージへの参照。有効な値は、ImageStreamTag、ImageStreamImage、および DockerImage です。ImageStreamTag 参照は、この同じ ImageStream 内のタグのみを参照できます。

generation

integer

生成は、spec タグ (ユーザーの意図) への変更を追跡するカウンターです。タグ参照が変更されると、生成は現在のストリーム生成と一致するように設定されます (仕様が変更されるたびに増分されます)。イメージインポーターなどのシステムの他のプロセスは、スペックタグの生成がステータスに記録された生成よりも新しいことを確認し、それをトリガーとして使用して最新のリモートタグをインポートします。新しいインポートをトリガーするために、クライアントはこの値をゼロに設定すると、世代が最新のストリーム世代にリセットされます。レガシークライアントはこの値を nil として送信し、現在のタグ生成とマージされます。

importPolicy

object

TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。

name

string

タグの名前

reference

boolean

参照には、タグがインポートされるかどうかが示されます。デフォルト値は false です。これは、タグがインポートされることを意味します。

referencePolicy

object

TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。

8.1.5. .spec.tags[].importPolicy

説明
TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。
object
プロパティー説明

importMode

string

importMode は、イメージマニフェストのインポート方法を記述します。

insecure

boolean

イメージのインポート中にサーバーが証明書の検証を回避できる、または HTTP 経由で直接接続できる場合は、true を設定します。

scheduled

boolean

scheduled は、このタグが最新であることを確認するために定期的にチェックし、インポートする必要があることをサーバーに示します

8.1.6. .spec.tags[].referencePolicy

説明
TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。
object
必須
  • type
プロパティー説明

type

string

タイプは、イメージストリームタグがデプロイメント設定トリガーまたは新しいビルドで使用されるときに、イメージプル仕様をどのように変換するかを決定します。デフォルト値は Source で、イメージの元の場所を使用する必要があることを示します (インポートされている場合)。ユーザーは Local を指定することもできます。これは、プル仕様が統合コンテナーイメージレジストリーを指し、プルをアップストリームレジストリーにプロキシーするレジストリーの機能を活用する必要があることを示します。ローカル では、このイメージのプルに使用されるクレデンシャルをイメージストリームの名前空間から管理できるため、プラットフォーム上の他のユーザーはリモートイメージにアクセスできますが、リモートシークレットにはアクセスできません。また、イメージレイヤーをローカルレジストリーにミラーリングして、アップストリームレジストリーが使用できない場合でもイメージをプルできるようにします。

8.1.7. .status

説明
ImageStreamStatus には、このイメージストリームの状態に関する情報が含まれています。
object
必須
  • dockerImageRepository
プロパティー説明

dockerImageRepository

string

DockerImageRepository は、このストリームにアクセスできる有効な場所を表します。サーバーがリポジトリーの場所を決定するまで空の場合があります

publicDockerImageRepository

string

PublicDockerImageRepository は、イメージをクラスターの外部にプルできるパブリックロケーションを表します。管理者が統合レジストリーを外部に公開していない場合、このフィールドは空になる可能性があります。

tags

array

タグは、各タグに関連付けられたイメージの履歴レコードです。TagEvent 配列の最初のエントリーは、現在タグ付けされているイメージです。

tags[]

object

NamedTagEventList は、タグをそのイメージ履歴に関連付けます。

8.1.8. .status.tags

説明
タグは、各タグに関連付けられたイメージの履歴レコードです。TagEvent 配列の最初のエントリーは、現在タグ付けされているイメージです。
array

8.1.9. .status.tags[]

説明
NamedTagEventList は、タグをそのイメージ履歴に関連付けます。
object
必須
  • tag
  • items
プロパティー説明

conditions

array

条件は、タグイベントリストに適用される条件の配列です。

conditions[]

object

TagEventCondition には、タグイベントの条件情報が含まれています。

items

array

標準オブジェクトのメタデータ。

items[]

object

TagEvent は、タグに関連付けられたイメージの履歴レコードを保持するために ImageStreamStatus によって使用されます。

tag

string

タグは、履歴が記録されるタグです。

8.1.10. .status.tags[].conditions

説明
条件は、タグイベントリストに適用される条件の配列です。
array

8.1.11. .status.tags[].conditions[]

説明
TagEventCondition には、タグイベントの条件情報が含まれています。
object
必須
  • type
  • status
  • generation
プロパティー説明

generation

integer

Generation は、このステータスが対応するスペックタグの生成です。

lastTransitionTime

Time

lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。

message

string

メッセージは、最後の遷移に関する詳細の人間が読める形式の説明であり、理由を補足します。

reason

string

Reason は、条件の最後の遷移に関する機械可読な簡単な説明です。

status

string

状態のステータス (True、False、Unknown のいずれか)。

type

string

タグイベント条件のタイプ、現在は ImportSuccess のみ

8.1.12. .status.tags[].items

説明
標準オブジェクトのメタデータ。
array

8.1.13. .status.tags[].items[]

説明
TagEvent は、タグに関連付けられたイメージの履歴レコードを保持するために ImageStreamStatus によって使用されます。
object
必須
  • created
  • dockerImageReference
  • image
  • generation
プロパティー説明

created

Time

Created は、TagEvent が作成された時刻を保持します

dockerImageReference

string

DockerImageReference は、このイメージをプルするために使用できる文字列です

generation

integer

Generation は、このタグが更新される結果となったスペックタグの生成です。

image

string

イメージはイメージです

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat, Inc.