第11章 Image API


11.1. Image API

11.1.1. Image [image.openshift.io/v1]

Description
イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。
タイプ
object

11.1.2. ImageSignature [image.openshift.io/v1]

Description
ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。
タイプ
object

11.1.3. ImageStreamImage [image.openshift.io/v1]

Description
ImageStreamImage は、ImageStream からイメージ名で取得されるイメージを表します。エンドユーザーはイメージリソースに直接アクセスできないため、ユーザーインターフェイスと通常のユーザーは、このリソースを使用して、イメージストリーム履歴内のタグ付きイメージのメタデータの詳細にアクセスして表示できます。そのようなイメージが ImageStream 内のタグによって参照されていない場合、notfound エラーが返されます。イメージは、外部レジストリー内のイメージを表すスペックタグがイメージストリームに設定されている場合、統合レジストリーにプッシュする場合、または既存のイメージをあるイメージストリームから別のイメージストリームにタグ付けする場合に作成されます。イメージストリームイメージの名前は <STREAM>@<DIGEST> の形式です。ここで、ダイジェストはイメージのコンテンツアドレス指定可能な識別子 (sha256:xxxxx…) です。ImageStreamImages をイメージストリームスペックタグの from.kind として使用して、イメージを正確に参照できます。imagestreamimage エンドポイントでサポートされている操作は、イメージの取得のみです。
タイプ
object

11.1.4. ImageStreamImport [image.openshift.io/v1]

Description

イメージストリームインポートリソースは、ユーザーが他のコンテナーイメージレジストリーからサーバーにコンテナーイメージを見つけてインポートするための簡単な方法を提供します。個々のイメージまたはイメージリポジトリー全体をインポートできます。ユーザーは、結果のイメージを指定されたイメージストリームにタグ付けする前に、インポートの結果を確認することを選択できます。

この API は、インポートする前にイメージのメタデータを確認する必要があるエンドユーザーツールを対象としています (たとえば、イメージからアプリケーションを生成するため)。目的のイメージを知っているクライアントは、引き続きイメージストリームに直接 spec.tags を作成できます。

タイプ
object

11.1.5. ImageStreamLayers [image.openshift.io/v1]

Description
ImageStreamLayers は、このイメージストリーム内のイメージによって参照されるレイヤーに関する情報を記述します。
タイプ
object

11.1.6. ImageStreamMapping [image.openshift.io/v1]

Description
ImageStreamMapping は、単一のイメージストリームタグからコンテナーイメージへのマッピングと、イメージの元となったコンテナーイメージストリームへの参照を表します。このリソースは、特権インテグレーターがイメージリソースを作成し、ステータスタグフィールドのイメージストリームに関連付けるために使用されます。ImageStreamMapping を作成すると、イメージストリームを表示できるすべてのユーザーがそのイメージにタグを付けたりプルしたりできるようになるため、ユーザーがイメージのコンテンツに直接アクセスできることが証明された場合にのみマッピングを作成できます。このリソースでサポートされている唯一の操作は作成であり、メタデータ名と名前空間は、更新する必要のあるタグを含むイメージストリームに設定する必要があります。
タイプ
object

11.1.7. ImageStream [image.openshift.io/v1]

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

11.1.8. ImageStreamTag [image.openshift.io/v1]

Description
ImageStreamTag は、ImageStream からタグ名で取得されるイメージを表します。このリソースを使用して、タグごとにイメージストリーム内のタグやイメージを操作したり、特定のタグのイメージの詳細を確認したりします。このリソースに関連付けられているイメージは、最後に正常にタグ付け、インポート、またはプッシュされたイメージです (このタグのイメージストリーム status.tags.items リストで説明されています)。インポートが進行中または失敗した場合は、前のイメージが表示されます。イメージストリームタグを削除すると、イメージストリームのステータスフィールドとスペックフィールドの両方がクリアされます。特定のタグのイメージを取得できない場合は、見つかりませんというエラーが返されます。
タイプ
object

11.1.9. ImageTag [image.openshift.io/v1]

Description
ImageTag は、イメージストリーム内の単一のタグを表し、指定されたタグの仕様、ステータス履歴、および現在参照されているイメージ (存在する場合) を含みます。このタイプは、タグの完全なビューを提供することにより、ImageStreamTag を置き換えます。ImageTag は、イメージストリームに存在するすべての仕様またはステータスタグに対して返されます。どちらの形式にもタグが存在しない場合、API によって notfound エラーが返されます。スペックタグがまだ定義されておらず、スペックフィールドが設定されている場合、作成操作は成功します。削除すると、イメージストリームから仕様要素とステータス要素の両方が削除されます。
タイプ
object

11.1.10. SecretList [image.openshift.io/v1]

Description
SecretList はシークレットの一覧です。
タイプ
object
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat