Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

5.5. oc-mirror プラグイン v2 によって生成されるカスタムリソースについて

oc-mirror プラグイン v2 は、次のカスタムリソースを自動的に生成します。

ImageDigestMirrorSet (IDMS)
イメージダイジェストプル仕様を使用する場合に、レジストリーミラールールを処理します。イメージセットの少なくとも 1 つのイメージがダイジェストによってミラーリングされている場合に生成されます。
ImageTagMirrorSet (ITMS)
イメージタグプル仕様を使用する場合に、レジストリーミラールールを処理します。イメージセットの少なくとも 1 つのイメージがタグによってミラーリングされている場合に生成されます。
CatalogSource
ミラーレジストリー内の利用可能な Operator に関する情報を取得します。Operator Lifecycle Manager (OLM) Classic によって使用されます。
ClusterCatalog
ミラーレジストリー内の利用可能なクラスター拡張機能 (Operator を含む) に関する情報を取得します。OLM v1 で使用されます。
UpdateService
非接続環境に更新グラフデータを提供します。OpenShift Update Service によって使用されます。

5.5.1. oc-mirror プラグインによって生成されるリソースの変更制限
リンクのコピー

oc-mirror プラグイン v2 によって生成されたリソースを使用してクラスターを設定する場合、変更してはならないフィールドがあります。これらのフィールドを変更するとエラーが発生する可能性があり、変更はサポートされていません。

次の表は、変更してはならないリソースとそのフィールドを示しています。

Expand
表5.1 oc-mirror によって生成されたリソース内で変更してはならないフィールド
リソース変更禁止フィールド

CatalogSource

apiVersion、kind、spec.image

ClusterCatalog

apiVersion、kind、spec.source.image.ref

ImageDigestMirrorSet

apiVersion、kind、spec.imageDigestMirrors

ImageTagMirrorSet

apiVersion、kind、spec.imageTagMirrors

署名の ConfigMap

apiVersion、kind、metadata.namespace、binaryData

UpdateService

apiVersion、kind、spec.graphDataImage、spec.releases

これらのリソースの詳細は、OpenShift API ドキュメントの CatalogSource、ImageDigestMirrorSet、および ImageTagMirrorSet を参照してください。

5.5.2. oc-mirror プラグイン v2 が生成したリソースを使用するためのクラスター設定
リンクのコピー

イメージセットをミラーレジストリーにミラーリングした後、生成された ImageDigestMirrorSet (IDMS)、ImageTagMirrorSet (ITMS)、CatalogSource、および UpdateService リソースをクラスターに適用する必要があります。

重要

oc-mirror プラグイン v2 では、oc-mirror プラグイン v1 の ImageContentSourcePolicy (ICSP) ファイルとは異なり、IDMS ファイルと ITMS ファイルがイメージセット全体をカバーします。したがって、増分ミラーリング中に新しいイメージのみを追加した場合でも、IDMS ファイルと ITMS ファイルにはセットのすべてのイメージが含まれます。

前提条件

  • cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。

手順

  1. cluster-admin ロールを持つユーザーとして OpenShift CLI にログインします。

  2. 以下のコマンドを実行して、results ディレクトリーからクラスターに YAML ファイルを適用します。 

    $ oc apply -f <path_to_oc_mirror_workspace>/working-dir/cluster-resources
    Copy to Clipboard Toggle word wrap

  3. リリースイメージをミラーリングした場合は、次のコマンドを実行して、リリースイメージの署名をクラスターに適用します。 

    $ oc apply -f working-dir/cluster-resources/signature-configmap.json
    Copy to Clipboard Toggle word wrap
    重要

    クラスターではなく Operator をミラーリングする場合は、上記のコマンドを実行しないでください。適用するリリースイメージ署名がないため、コマンドを実行するとエラーが発生します。

    また、同じディレクトリー working-dir/cluster-resources/ で YAML ファイルを使用することもできます。JSON または YAML 形式のいずれかを使用できます。

検証

  1. 次のコマンドを実行して、ImageDigestMirrorSet リソースが正常にインストールされたことを確認します。 

    $ oc get imagedigestmirrorset
    Copy to Clipboard Toggle word wrap

    次のコマンドを実行して、oc-mirror で作成されたリソースのみを表示します。 

    $ oc get imagedigestmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

  2. 次のコマンドを実行して、ImageTagMirrorSet リソースが正常にインストールされたことを確認します。 

    $ oc get imagetagmirrorset
    Copy to Clipboard Toggle word wrap

    次のコマンドを実行して、oc-mirror で作成されたリソースのみを表示します。 

    $ oc get imagetagmirrorset -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

  3. 以下のコマンドを実行して、CatalogSource リソースが正常にインストールされたことを確認します。 

    $ oc get catalogsource -n openshift-marketplace
    Copy to Clipboard Toggle word wrap

    次のコマンドを実行して、oc-mirror で作成されたリソースのみを表示します。 

    $ oc get catalogsource -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

  4. 次のコマンドを実行して、ClusterCatalog リソースが正常にインストールされたことを確認します。 

    $ oc get clustercatalog
    Copy to Clipboard Toggle word wrap

    次のコマンドを実行して、oc-mirror で作成されたリソースのみを表示します。 

    $ oc get clustercatalog -o jsonpath='{.items[?(@.metadata.annotations.createdBy=="oc-mirror v2")].metadata.name}'
    Copy to Clipboard Toggle word wrap

oc-mirror プラグイン v2 によって生成されたリソースを使用するようにクラスターを設定したら、ミラーリングされたイメージを使用して実行できるタスクの詳細について、次のステップ を参照してください。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat