第8章 ImageStream [image.openshift.io/v1]
- Description
ImageStream は、タグのイメージへのマッピング、イメージがストリームでタグ付けされたときに適用されるメタデータオーバーライド、およびレジストリー上のコンテナーイメージリポジトリーへのオプションの参照を格納します。ユーザーは通常、spec.tags フィールドを更新して、プルシークレットタイプの名前空間のクレデンシャルを使用してコンテナーレジストリーからインポートされた外部イメージ、またはタグ付けまたはプルのためにすぐにアクセスできる既存のイメージストリームタグおよびイメージをポイントします。タグに適用されたイメージの履歴は status.tags フィールドに表示され、イメージストリームを表示できるすべてのユーザーは、そのイメージを自分のイメージストリームにタグ付けできます。統合レジストリーからイメージをプルするためのアクセスは、特定のイメージストリームに対する getimagestreams/layers 権限を持つことによって付与されます。ユーザーは、imagestreamtag リソースを削除することでタグを削除できます。これにより、そのタグの仕様とステータスの両方が削除されます。イメージストリームの履歴は、管理者が削除操作を実行するまで保持されます。これにより、使用されなくなった参照が削除されます。履歴イメージを保持するには、ダイジェストによってそのイメージを指すタグが仕様に含まれていることを確認してください。
互換性レベル 1: メジャーリリース内で最低 12 か月または 3 つのマイナーリリース (どちらか長い方) の間安定しています。
- タイプ
-
object
8.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| metadata は標準オブジェクトのメタデータです。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| ImageStreamSpec は、ImageStreams のオプションを表します。 |
|
| ImageStreamStatus には、このイメージストリームの状態に関する情報が含まれています。 |
8.1.1. .spec
- Description
- ImageStreamSpec は、ImageStreams のオプションを表します。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| dockerImageRepository はオプションです。指定されている場合、このストリームはこのサーバー上のコンテナーリポジトリーによってサポートされます。非推奨: このフィールドは v3.7 で非推奨になり、将来のリリースで削除される予定です。代わりに、spec.tags.from 参照を介して、各タグにインポートされるタグのソースを指定してください。 |
|
| ImageLookupPolicy は、イメージストリームを使用して、名前空間内の Pod、ビルド、およびその他のリソースによって使用されるイメージ参照をオーバーライドする方法を説明します。 |
|
| タグは、任意の文字列値を特定のイメージロケーターにマップします |
|
| TagReference は、このタグを使用するイメージのオプションのアノテーションと、このタグが追跡する ImageStreamTag、ImageStreamImage、または DockerImage へのオプションの参照を指定します。 |
8.1.2. .spec.lookupPolicy
- Description
- ImageLookupPolicy は、イメージストリームを使用して、名前空間内の Pod、ビルド、およびその他のリソースによって使用されるイメージ参照をオーバーライドする方法を説明します。
- タイプ
-
object
- 必須
-
local
-
プロパティー | タイプ | Description |
---|---|---|
|
| 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
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| オプション。指定されている場合、ImageStreamTags を介して取得されたイメージに適用されるアノテーション。 |
| オプション。指定されている場合、このタグが指す必要がある別のイメージへの参照。有効な値は、ImageStreamTag、ImageStreamImage、および DockerImage です。ImageStreamTag 参照は、この同じ ImageStream 内のタグのみを参照できます。 | |
|
| 生成は、spec タグ (ユーザーの意図) への変更を追跡するカウンターです。タグ参照が変更されると、生成は現在のストリーム生成と一致するように設定されます (仕様が変更されるたびに増分されます)。イメージインポーターなどのシステムの他のプロセスは、スペックタグの生成がステータスに記録された生成よりも新しいことを確認し、それをトリガーとして使用して最新のリモートタグをインポートします。新しいインポートをトリガーするために、クライアントはこの値をゼロに設定すると、世代が最新のストリーム世代にリセットされます。レガシークライアントはこの値を nil として送信し、現在のタグ生成とマージされます。 |
|
| TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。 |
|
| タグの名前 |
|
| 参照には、タグがインポートされるかどうかが示されます。デフォルト値は false です。これは、タグがインポートされることを意味します。 |
|
| TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。 |
8.1.5. .spec.tags[].importPolicy
- Description
- TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| importMode は、イメージマニフェストをインポートする方法を説明します。 |
|
| イメージのインポート中にサーバーが証明書の検証を回避できる、または HTTP 経由で直接接続できる場合は、true を設定します。 |
|
| Scheduled は、このタグが最新であることを確認するために定期的にチェックし、インポートする必要があることをサーバーに示します |
8.1.6. .spec.tags[].referencePolicy
- Description
- TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。
- タイプ
-
object
- 必須
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
|
|
タイプは、イメージストリームタグがデプロイメント設定トリガーまたは新しいビルドで使用されるときに、イメージプル仕様をどのように変換するかを決定します。デフォルト値は |
8.1.7. .status
- Description
- ImageStreamStatus には、このイメージストリームの状態に関する情報が含まれています。
- タイプ
-
object
- 必須
-
dockerImageRepository
-
プロパティー | タイプ | Description |
---|---|---|
|
| DockerImageRepository は、このストリームにアクセスできる有効な場所を表します。サーバーがリポジトリーの場所を決定するまで空の場合があります |
|
| PublicDockerImageRepository は、イメージをクラスターの外部にプルできるパブリックロケーションを表します。管理者が統合レジストリーを外部に公開していない場合、このフィールドは空になる可能性があります。 |
|
| タグは、各タグに関連付けられたイメージの履歴レコードです。TagEvent 配列の最初のエントリーは、現在タグ付けされているイメージです。 |
|
| NamedTagEventList は、タグをそのイメージ履歴に関連付けます。 |
8.1.8. .status.tags
- Description
- タグは、各タグに関連付けられたイメージの履歴レコードです。TagEvent 配列の最初のエントリーは、現在タグ付けされているイメージです。
- タイプ
-
array
8.1.9. .status.tags[]
- Description
- NamedTagEventList は、タグをそのイメージ履歴に関連付けます。
- タイプ
-
object
- 必須
-
tag
-
items
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| 条件は、タグイベントリストに適用される条件の配列です。 |
|
| TagEventCondition には、タグイベントの条件情報が含まれています。 |
|
| 標準オブジェクトのメタデータ。 |
|
| TagEvent は、タグに関連付けられたイメージの履歴レコードを保持するために ImageStreamStatus によって使用されます。 |
|
| タグは、履歴が記録されるタグです。 |
8.1.10. .status.tags[].conditions
- Description
- 条件は、タグイベントリストに適用される条件の配列です。
- タイプ
-
array
8.1.11. .status.tags[].conditions[]
- Description
- TagEventCondition には、タグイベントの条件情報が含まれています。
- タイプ
-
object
- 必須
-
type
-
status
-
generation
-
プロパティー | タイプ | Description |
---|---|---|
|
| Generation は、このステータスが対応するスペックタグの生成です。 |
| time | lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。 |
|
| メッセージは、最後の遷移に関する詳細の人間が読める形式の説明であり、理由を補足します。 |
|
| Reason は、条件の最後の遷移に関する機械可読な簡単な説明です。 |
|
| 状態のステータス、True、False、Unknown のいずれか。 |
|
| タグイベント条件のタイプ、現在は ImportSuccess のみ |
8.1.12. .status.tags[].items
- Description
- 標準オブジェクトのメタデータ。
- タイプ
-
array
8.1.13. .status.tags[].items[]
- Description
- TagEvent は、タグに関連付けられたイメージの履歴レコードを保持するために ImageStreamStatus によって使用されます。
- タイプ
-
object
- 必須
-
created
-
dockerImageReference
-
image
-
generation
-
プロパティー | タイプ | Description |
---|---|---|
| time | Created は、TagEvent が作成された時刻を保持します |
|
| DockerImageReference は、このイメージをプルするために使用できる文字列です |
|
| Generation は、このタグが更新される結果となったスペックタグの生成です。 |
|
| イメージはイメージです |