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


Description

ImageStream は、タグのイメージへのマッピング、イメージがストリームでタグ付けされたときに適用されるメタデータオーバーライド、およびレジストリー上のコンテナーイメージリポジトリーへのオプションの参照を格納します。ユーザーは通常、spec.tags フィールドを更新して、プルシークレットタイプの名前空間のクレデンシャルを使用してコンテナーレジストリーからインポートされた外部イメージ、またはタグ付けまたはプルのためにすぐにアクセスできる既存のイメージストリームタグおよびイメージをポイントします。タグに適用されたイメージの履歴は status.tags フィールドに表示され、イメージストリームを表示できるすべてのユーザーは、そのイメージを自分のイメージストリームにタグ付けできます。統合レジストリーからイメージをプルするためのアクセスは、特定のイメージストリームに対する getimagestreams/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

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

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

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

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

local

ブール値

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

8.1.3. .spec.tags

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

8.1.4. .spec.tags[]

Description
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

ブール値

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

referencePolicy

object

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

8.1.5. .spec.tags[].importPolicy

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

importMode

string

importMode は、イメージマニフェストをインポートする方法を説明します。

insecure

ブール値

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

スケジュール済み

ブール値

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

8.1.6. .spec.tags[].referencePolicy

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

type

string

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

8.1.7. .status

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

dockerImageRepository

string

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

publicDockerImageRepository

string

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

tags

array

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

tags[]

object

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

8.1.8. .status.tags

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

8.1.9. .status.tags[]

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

conditions

array

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

conditions[]

object

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

items

array

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

items[]

object

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

tag

string

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

8.1.10. .status.tags[].conditions

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

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

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

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

Description
標準オブジェクトのメタデータ。
タイプ
array

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

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

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

© 2024 Red Hat, Inc.