11.5. ImageStreamImport [image.openshift.io/v1]
- Description
イメージストリームインポートリソースは、ユーザーが他のコンテナーイメージレジストリーからサーバーにコンテナーイメージを見つけてインポートするための簡単な方法を提供します。個々のイメージまたはイメージリポジトリー全体をインポートできます。ユーザーは、結果のイメージを指定されたイメージストリームにタグ付けする前に、インポートの結果を確認することを選択できます。
この API は、インポートする前にイメージのメタデータを確認する必要があるエンドユーザーツールを対象としています (たとえば、イメージからアプリケーションを生成するため)。目的のイメージを知っているクライアントは、引き続きイメージストリームに直接 spec.tags を作成できます。
- タイプ
-
object
- 必須
-
spec
-
status
-
11.5.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 を参照してください。 |
| ||
|
| ImageStreamImportSpec は、インポートするイメージを定義します。 |
|
| ImageStreamImportStatus には、イメージストリームのインポートのステータスに関する情報が含まれています。 |
11.5.1.1. .spec リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageStreamImportSpec は、インポートするイメージを定義します。
- タイプ
-
object
- 必須
-
import
-
プロパティー | タイプ | Description |
---|---|---|
|
| イメージは、インポートする個々のイメージのリストです。 |
|
| ImageImportSpec は、特定のイメージをインポートするリクエストを記述します。 |
|
| インポートは、インポートを実行するかどうかを示します。実行する場合、指定されたタグは、タイプ meta によって定義されたイメージストリームの仕様とステータスに設定されます。 |
|
| RepositoryImportSpec は、コンテナーイメージリポジトリーからイメージをインポートするリクエストを記述します。 |
11.5.1.2. .spec.images リンクのコピーリンクがクリップボードにコピーされました!
- Description
- イメージは、インポートする個々のイメージのリストです。
- タイプ
-
array
11.5.1.3. .spec.images[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageImportSpec は、特定のイメージをインポートするリクエストを記述します。
- タイプ
-
object
- 必須
-
from
-
プロパティー | タイプ | Description |
---|---|---|
| From は、インポートするイメージのソースです。種類の DockerImage のみが許可されます | |
|
| TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。 |
|
| IncludeManifest は、各イメージのマニフェストが応答で返されるかどうかを決定します |
|
| TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。 |
| To は、インポートされたイメージを割り当てる現在のイメージストリーム内のタグです。名前が指定されていない場合、from.name のデフォルトタグが使用されます。 |
11.5.1.4. .spec.images[].importPolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| イメージのインポート中にサーバーが証明書の検証を回避できる、または HTTP 経由で直接接続できる場合は、true を設定します。 |
|
| Scheduled は、このタグが最新であることを確認するために定期的にチェックし、インポートする必要があることをサーバーに示します |
11.5.1.5. .spec.images[].referencePolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。
- タイプ
-
object
- 必須
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
|
|
タイプは、イメージストリームタグが展開設定トリガーまたは新しいビルドで使用されるときに、イメージプル仕様をどのように変換するかを決定します。デフォルト値は |
11.5.1.6. .spec.repository リンクのコピーリンクがクリップボードにコピーされました!
- Description
- RepositoryImportSpec は、コンテナーイメージリポジトリーからイメージをインポートするリクエストを記述します。
- タイプ
-
object
- 必須
-
from
-
プロパティー | タイプ | Description |
---|---|---|
| From は、インポートするイメージリポジトリーのソースです。種類の DockerImage とコンテナーイメージリポジトリーの名前のみが許可されます | |
|
| TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。 |
|
| IncludeManifest は、各イメージのマニフェストが応答で返されるかどうかを決定します |
|
| TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。 |
11.5.1.7. .spec.repository.importPolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| イメージのインポート中にサーバーが証明書の検証を回避できる、または HTTP 経由で直接接続できる場合は、true を設定します。 |
|
| Scheduled は、このタグが最新であることを確認するために定期的にチェックし、インポートする必要があることをサーバーに示します |
11.5.1.8. .spec.repository.referencePolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。
- タイプ
-
object
- 必須
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
|
|
タイプは、イメージストリームタグが展開設定トリガーまたは新しいビルドで使用されるときに、イメージプル仕様をどのように変換するかを決定します。デフォルト値は |
11.5.1.9. .status リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageStreamImportStatus には、イメージストリームのインポートのステータスに関する情報が含まれています。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| イメージは spec.images をインポートした結果で設定されます |
|
| ImageImportStatus は、イメージのインポートの結果を示します。 |
|
| ImageStream は、タグのイメージへのマッピング、イメージがストリームでタグ付けされたときに適用されるメタデータオーバーライド、およびレジストリー上のコンテナーイメージリポジトリーへのオプションの参照を格納します。ユーザーは通常、spec.tags フィールドを更新して、プルシークレットタイプの名前空間のクレデンシャルを使用してコンテナーレジストリーからインポートされた外部イメージ、またはタグ付けまたはプルのためにすぐにアクセスできる既存のイメージストリームタグおよびイメージをポイントします。タグに適用されたイメージの履歴は status.tags フィールドに表示され、イメージストリームを表示できるすべてのユーザーは、そのイメージを自分のイメージストリームにタグ付けできます。統合レジストリーからイメージをプルするためのアクセスは、特定のイメージストリームに対する getimagestreams/layers 権限を持つことによって付与されます。ユーザーは、imagestreamtag リソースを削除することでタグを削除できます。これにより、そのタグの仕様とステータスの両方が削除されます。イメージストリームの履歴は、管理者が削除操作を実行するまで保持されます。これにより、使用されなくなった参照が削除されます。履歴イメージを保持するには、ダイジェストによってそのイメージを指すタグが仕様に含まれていることを確認してください。 |
|
| RepositoryImportStatus は、イメージリポジトリーのインポートの結果を示します |
11.5.1.10. .status.images リンクのコピーリンクがクリップボードにコピーされました!
- Description
- イメージは spec.images をインポートした結果で設定されます
- タイプ
-
array
11.5.1.11. .status.images[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageImportStatus は、イメージのインポートの結果を示します。
- タイプ
-
object
- 必須
-
status
-
プロパティー | タイプ | Description |
---|---|---|
|
| イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。 |
| ステータスは、イメージの取得中に発生したエラーを含む、イメージのインポートのステータスです。 | |
|
| タグは、このイメージが配置されていたタグです (存在する場合) |
11.5.1.12. .status.images[].image リンクのコピーリンクがクリップボードにコピーされました!
- Description
- イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。
- タイプ
-
object
- 必須
-
dockerImageLayers
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| DockerImageConfig は、ランタイムがコンテナーをセットアップするために使用する JSONBLOB です。これはマニフェストスキーマ v2 の一部です。 |
|
| DockerImageLayers は、イメージ内のレイヤーを表します。イメージがそのデータを定義していない場合は設定されない可能性があります。 |
|
| ImageLayer は、イメージの単一のレイヤーを表します。一部のイメージには複数のレイヤーが含まれる場合があります。ないものもあります。 |
|
| DockerImageManifest は、マニフェストの生の JSON です |
|
| DockerImageManifestMediaType は、マニフェストの mediaType を指定します。これはマニフェストスキーマ v2 の一部です。 |
| DockerImageMetadata には、このイメージに関するメタデータが含まれています | |
|
| DockerImageMetadataVersion は、オブジェクトのバージョンを伝達します。空の場合、デフォルトは 1.0 です。 |
|
| DockerImageReference は、このイメージをプルするために使用できる文字列です。 |
|
| DockerImageSignatures は、署名を不透明なブロブとして提供します。これはマニフェストスキーマ v1 の一部です。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| ||
|
| 署名は、イメージのすべての署名を保持します。 |
|
| ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。 |
11.5.1.13. .status.images[].image.dockerImageLayers リンクのコピーリンクがクリップボードにコピーされました!
- Description
- DockerImageLayers は、イメージ内のレイヤーを表します。イメージがそのデータを定義していない場合は設定されない可能性があります。
- タイプ
-
array
11.5.1.14. .status.images[].image.dockerImageLayers[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageLayer は、イメージの単一のレイヤーを表します。一部のイメージには複数のレイヤーが含まれる場合があります。ないものもあります。
- タイプ
-
object
- 必須
-
name
-
size
-
mediaType
-
プロパティー | タイプ | Description |
---|---|---|
|
| 参照されるオブジェクトの MediaType。 |
|
| 基になるストアによって定義されたレイヤーの名前。 |
|
| 基になるストアによって定義されたレイヤーのサイズ (バイト単位)。 |
11.5.1.15. .status.images[].image.signatures リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 署名は、イメージのすべての署名を保持します。
- タイプ
-
array
11.5.1.16. .status.images[].image.signatures[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。
- タイプ
-
object
- 必須
-
type
-
content
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。 |
|
| SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。 |
|
| 必須: イメージの署名である不透明なバイナリー文字列。 |
| 指定した場合、それは署名の作成時です。 | |
|
| イメージのアイデンティティを表す人間が読める文字列。製品名とバージョン、またはイメージプルスペック (例:registry.access.redhat.com/rhel7/rhel:7.2) の場合があります。 |
|
| SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。 |
|
| SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| ||
|
| 署名からのクレームが含まれています。 |
|
| 必須: 保存されている BLOB のタイプを記述します。 |
11.5.1.17. .status.images[].image.signatures[].conditions リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。
- タイプ
-
array
11.5.1.18. .status.images[].image.signatures[].conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。
- タイプ
-
object
- 必須
-
type
-
status
-
11.5.1.19. .status.images[].image.signatures[].issuedBy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
11.5.1.20. .status.images[].image.signatures[].issuedTo リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。
- タイプ
-
object
- 必須
-
publicKeyID
-
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
|
| 存在する場合、それはイメージの署名を検証するために使用されるサブジェクトに属する公開鍵の人間が読める形式の鍵 ID です。公開鍵のフィンガープリントの下位 64 ビット以上が含まれている必要があります (例:0x685ebe62bf278440)。 |
11.5.1.21. .status.import リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageStream は、タグのイメージへのマッピング、イメージがストリームでタグ付けされたときに適用されるメタデータオーバーライド、およびレジストリー上のコンテナーイメージリポジトリーへのオプションの参照を格納します。ユーザーは通常、spec.tags フィールドを更新して、プルシークレットタイプの名前空間のクレデンシャルを使用してコンテナーレジストリーからインポートされた外部イメージ、またはタグ付けまたはプルのためにすぐにアクセスできる既存のイメージストリームタグおよびイメージをポイントします。タグに適用されたイメージの履歴は status.tags フィールドに表示され、イメージストリームを表示できるすべてのユーザーは、そのイメージを自分のイメージストリームにタグ付けできます。統合レジストリーからイメージをプルするためのアクセスは、特定のイメージストリームに対する getimagestreams/layers 権限を持つことによって付与されます。ユーザーは、imagestreamtag リソースを削除することでタグを削除できます。これにより、そのタグの仕様とステータスの両方が削除されます。イメージストリームの履歴は、管理者が削除操作を実行するまで保持されます。これにより、使用されなくなった参照が削除されます。履歴イメージを保持するには、ダイジェストによってそのイメージを指すタグが仕様に含まれていることを確認してください。
- タイプ
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| 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 を参照してください。 |
| ||
|
| ImageStreamSpec は、ImageStreams のオプションを表します。 |
|
| ImageStreamStatus には、このイメージストリームの状態に関する情報が含まれています。 |
11.5.1.22. .status.import.spec リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageStreamSpec は、ImageStreams のオプションを表します。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| dockerImageRepository はオプションです。指定されている場合、このストリームはこのサーバー上のコンテナーリポジトリーによってサポートされます。非推奨: このフィールドは v3.7 で非推奨になり、将来のリリースで削除される予定です。代わりに、spec.tags.from 参照を介して、各タグにインポートされるタグのソースを指定してください。 |
|
| ImageLookupPolicy は、イメージストリームを使用して、名前空間内の Pod、ビルド、およびその他のリソースによって使用されるイメージ参照をオーバーライドする方法を説明します。 |
|
| タグは、任意の文字列値を特定のイメージロケーターにマップします |
|
| TagReference は、このタグを使用するイメージのオプションの注釈と、このタグが追跡する ImageStreamTag、ImageStreamImage、または DockerImage へのオプションの参照を指定します。 |
11.5.1.23. .status.import.spec.lookupPolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageLookupPolicy は、イメージストリームを使用して、名前空間内の Pod、ビルド、およびその他のリソースによって使用されるイメージ参照をオーバーライドする方法を説明します。
- タイプ
-
object
- 必須
-
local
-
プロパティー | タイプ | Description |
---|---|---|
|
| local は、リモートレジストリーにアクセスする代わりに、この名前空間内のオブジェクトの Docker ショートイメージ参照 (mysql や php:latest など) を、このイメージストリームと一致するたびにイメージ ID に変更します。名前が見つかった場合、その名前はイメージ ID に完全に修飾されます。タグの referencePolicy は、置き換えられた値で考慮されます。現在の名前空間内でのみ機能します。 |
11.5.1.24. .status.import.spec.tags リンクのコピーリンクがクリップボードにコピーされました!
- Description
- タグは、任意の文字列値を特定のイメージロケーターにマップします
- タイプ
-
array
11.5.1.25. .status.import.spec.tags[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagReference は、このタグを使用するイメージのオプションの注釈と、このタグが追跡する ImageStreamTag、ImageStreamImage、または DockerImage へのオプションの参照を指定します。
- タイプ
-
object
- 必須
-
name
-
プロパティー | タイプ | Description |
---|---|---|
|
| オプション。指定されている場合、ImageStreamTags を介して取得されたイメージに適用される注釈。 |
| オプション。指定されている場合、このタグが指す必要がある別のイメージへの参照。有効な値は、ImageStreamTag、ImageStreamImage、および DockerImage です。ImageStreamTag 参照は、この同じ ImageStream 内のタグのみを参照できます。 | |
|
| 生成は、spec タグ (ユーザーの意図) への変更を追跡するカウンターです。タグ参照が変更されると、生成は現在のストリーム生成と一致するように設定されます (仕様が変更されるたびに増分されます)。イメージインポーターなどのシステムの他のプロセスは、スペックタグの生成がステータスに記録された生成よりも新しいことを確認し、それをトリガーとして使用して最新のリモートタグをインポートします。新しいインポートをトリガーするために、クライアントはこの値をゼロに設定すると、世代が最新のストリーム世代にリセットされます。レガシークライアントはこの値を nil として送信し、現在のタグ生成とマージされます。 |
|
| TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。 |
|
| タグの名前 |
|
| 参照には、タグがインポートされるかどうかが示されます。デフォルト値は false です。これは、タグがインポートされることを意味します。 |
|
| TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。 |
11.5.1.26. .status.import.spec.tags[].importPolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagImportPolicy は、このタグに関連するイメージのインポート方法を制御します。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| イメージのインポート中にサーバーが証明書の検証を回避できる、または HTTP 経由で直接接続できる場合は、true を設定します。 |
|
| Scheduled は、このタグが最新であることを確認するために定期的にチェックし、インポートする必要があることをサーバーに示します |
11.5.1.27. .status.import.spec.tags[].referencePolicy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagReferencePolicy は、デプロイメント設定またはビルドのイメージ変更トリガーが解決されたときに、このイメージストリームタグ内のイメージのプルスペックがどのように生成されるかを記述します。これにより、イメージストリームの作成者はイメージへのアクセス方法を制御できます。
- タイプ
-
object
- 必須
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
|
|
タイプは、イメージストリームタグが展開設定トリガーまたは新しいビルドで使用されるときに、イメージプル仕様をどのように変換するかを決定します。デフォルト値は |
11.5.1.28. .status.import.status リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageStreamStatus には、このイメージストリームの状態に関する情報が含まれています。
- タイプ
-
object
- 必須
-
dockerImageRepository
-
プロパティー | タイプ | Description |
---|---|---|
|
| DockerImageRepository は、このストリームにアクセスできる有効な場所を表します。サーバーがリポジトリーの場所を決定するまで空の場合があります |
|
| PublicDockerImageRepository は、イメージをクラスターの外部にプルできるパブリックロケーションを表します。管理者が統合レジストリーを外部に公開していない場合、このフィールドは空になる可能性があります。 |
|
| タグは、各タグに関連付けられたイメージの履歴レコードです。TagEvent 配列の最初のエントリーは、現在タグ付けされているイメージです。 |
|
| NamedTagEventList は、タグをそのイメージ履歴に関連付けます。 |
11.5.1.29. .status.import.status.tags リンクのコピーリンクがクリップボードにコピーされました!
- Description
- タグは、各タグに関連付けられたイメージの履歴レコードです。TagEvent 配列の最初のエントリーは、現在タグ付けされているイメージです。
- タイプ
-
array
11.5.1.30. .status.import.status.tags[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- NamedTagEventList は、タグをそのイメージ履歴に関連付けます。
- タイプ
-
object
- 必須
-
tag
-
items
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| 条件は、タグイベントリストに適用される条件の配列です。 |
|
| TagEventCondition には、タグイベントの条件情報が含まれています。 |
|
| 標準オブジェクトのメタデータ。 |
|
| TagEvent は、タグに関連付けられたイメージの履歴レコードを保持するために ImageStreamStatus によって使用されます。 |
|
| タグは、履歴が記録されるタグです。 |
11.5.1.31. .status.import.status.tags[].conditions リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 条件は、タグイベントリストに適用される条件の配列です。
- タイプ
-
array
11.5.1.32. .status.import.status.tags[].conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagEventCondition には、タグイベントの条件情報が含まれています。
- タイプ
-
object
- 必須
-
type
-
status
-
generation
-
プロパティー | タイプ | Description |
---|---|---|
|
| Generation は、このステータスが対応するスペックタグの生成です。 |
| lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。 | |
|
| メッセージは、最後の遷移に関する詳細の人間が読める形式の説明であり、理由を補足します。 |
|
| Reason は、条件の最後の遷移に関する機械可読な簡単な説明です。 |
|
| 状態のステータス、True、False、Unknown のいずれか。 |
|
| タグイベント条件のタイプ、現在は ImportSuccess のみ |
11.5.1.33. .status.import.status.tags[].items リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 標準オブジェクトのメタデータ。
- タイプ
-
array
11.5.1.34. .status.import.status.tags[].items[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- TagEvent は、タグに関連付けられたイメージの履歴レコードを保持するために ImageStreamStatus によって使用されます。
- タイプ
-
object
- 必須
-
created
-
dockerImageReference
-
image
-
generation
-
プロパティー | タイプ | Description |
---|---|---|
| Created は、TagEvent が作成された時刻を保持します | |
|
| DockerImageReference は、このイメージをプルするために使用できる文字列です |
|
| Generation は、このタグが更新される結果となったスペックタグの生成です。 |
|
| イメージはイメージです |
11.5.1.35. .status.repository リンクのコピーリンクがクリップボードにコピーされました!
- Description
- RepositoryImportStatus は、イメージリポジトリーのインポートの結果を示します
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| AdditionalTags は、リポジトリーに存在するが、自動インポートの上限が適用されたためにインポートされなかったタグです。 |
|
| イメージは、リポジトリーのインポートによって正常に取得されたイメージのリストです。 |
|
| ImageImportStatus は、イメージのインポートの結果を示します。 |
| ステータスは、インポート中に障害が発生したかどうかを反映します |
11.5.1.36. .status.repository.images リンクのコピーリンクがクリップボードにコピーされました!
- Description
- イメージは、リポジトリーのインポートによって正常に取得されたイメージのリストです。
- タイプ
-
array
11.5.1.37. .status.repository.images[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageImportStatus は、イメージのインポートの結果を示します。
- タイプ
-
object
- 必須
-
status
-
プロパティー | タイプ | Description |
---|---|---|
|
| イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。 |
| ステータスは、イメージの取得中に発生したエラーを含む、イメージのインポートのステータスです。 | |
|
| タグは、このイメージが配置されていたタグです (存在する場合) |
11.5.1.38. .status.repository.images[].image リンクのコピーリンクがクリップボードにコピーされました!
- Description
- イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。
- タイプ
-
object
- 必須
-
dockerImageLayers
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| DockerImageConfig は、ランタイムがコンテナーをセットアップするために使用する JSONBLOB です。これはマニフェストスキーマ v2 の一部です。 |
|
| DockerImageLayers は、イメージ内のレイヤーを表します。イメージがそのデータを定義していない場合は設定されない可能性があります。 |
|
| ImageLayer は、イメージの単一のレイヤーを表します。一部のイメージには複数のレイヤーが含まれる場合があります。ないものもあります。 |
|
| DockerImageManifest は、マニフェストの生の JSON です |
|
| DockerImageManifestMediaType は、マニフェストの mediaType を指定します。これはマニフェストスキーマ v2 の一部です。 |
| DockerImageMetadata には、このイメージに関するメタデータが含まれています | |
|
| DockerImageMetadataVersion は、オブジェクトのバージョンを伝達します。空の場合、デフォルトは 1.0 です。 |
|
| DockerImageReference は、このイメージをプルするために使用できる文字列です。 |
|
| DockerImageSignatures は、署名を不透明なブロブとして提供します。これはマニフェストスキーマ v1 の一部です。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| ||
|
| 署名は、イメージのすべての署名を保持します。 |
|
| ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。 |
11.5.1.39. .status.repository.images[].image.dockerImageLayers リンクのコピーリンクがクリップボードにコピーされました!
- Description
- DockerImageLayers は、イメージ内のレイヤーを表します。イメージがそのデータを定義していない場合は設定されない可能性があります。
- タイプ
-
array
11.5.1.40. .status.repository.images[].image.dockerImageLayers[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageLayer は、イメージの単一のレイヤーを表します。一部のイメージには複数のレイヤーが含まれる場合があります。ないものもあります。
- タイプ
-
object
- 必須
-
name
-
size
-
mediaType
-
プロパティー | タイプ | Description |
---|---|---|
|
| 参照されるオブジェクトの MediaType。 |
|
| 基になるストアによって定義されたレイヤーの名前。 |
|
| 基になるストアによって定義されたレイヤーのサイズ (バイト単位)。 |
11.5.1.41. .status.repository.images[].image.signatures リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 署名は、イメージのすべての署名を保持します。
- タイプ
-
array
11.5.1.42. .status.repository.images[].image.signatures[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。
- タイプ
-
object
- 必須
-
type
-
content
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。 |
|
| SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。 |
|
| 必須: イメージの署名である不透明なバイナリー文字列。 |
| 指定した場合、それは署名の作成時です。 | |
|
| イメージのアイデンティティを表す人間が読める文字列。製品名とバージョン、またはイメージプルスペック (例:registry.access.redhat.com/rhel7/rhel:7.2) の場合があります。 |
|
| SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。 |
|
| SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| ||
|
| 署名からのクレームが含まれています。 |
|
| 必須: 保存されている BLOB のタイプを記述します。 |
11.5.1.43. .status.repository.images[].image.signatures[].conditions リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。
- タイプ
-
array
11.5.1.44. .status.repository.images[].image.signatures[].conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。
- タイプ
-
object
- 必須
-
type
-
status
-
11.5.1.45. .status.repository.images[].image.signatures[].issuedBy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
11.5.1.46. .status.repository.images[].image.signatures[].issuedTo リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。
- タイプ
-
object
- 必須
-
publicKeyID
-
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
|
| 存在する場合、それはイメージの署名を検証するために使用されるサブジェクトに属する公開鍵の人間が読める形式の鍵 ID です。公開鍵のフィンガープリントの下位 64 ビット以上が含まれている必要があります (例:0x685ebe62bf278440)。 |
11.5.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreamimports
-
POST
:ImageStreamImport を作成します
-
11.5.2.1. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreamimports リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | タイプ | 説明 |
---|---|---|
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | タイプ | 説明 |
---|---|---|
|
| これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。 |
|
| fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。 |
|
| 'true' の場合、出力はきれいに印刷されます。 |
- HTTP メソッド
-
POST
- Description
- ImageStreamImport を作成します
パラメーター | タイプ | 説明 |
---|---|---|
|
|
HTTP コード | レスポンス本文 |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | 空白 |