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

第6章 oc-mirror プラグイン v1 から v2 への移行

oc-mirror v2 プラグインは、イメージのミラーリングワークフローに大きな変更をもたらします。このガイドでは、oc-mirror プラグイン v2 との互換性を確保しながら移行する手順を段階的に説明します。

重要

API バージョンを変更し、非推奨のフィールドを削除して、設定を手動で更新する必要があります。詳細は、「oc-mirror プラグイン v1 から v2 への変更点」を参照してください。

6.1. oc-mirror プラグイン v1 から v2 への変更点
リンクのコピー

oc-mirror プラグイン v1 から v2 に移行する前に、以下に示す oc-mirror プラグイン v1 と v2 の違いを確認してください。

  • 明示的なバージョン選択: oc-mirror を使用する場合、ユーザーは --v2 を明示的に指定する必要があります。バージョンが指定されていない場合は、デフォルトで v1 が実行されます。この動作は今後のリリースで変更される予定です。今後のリリースでは --v2 がデフォルトになります。

  • コマンドの更新: ミラーリングワークフローのコマンドが、oc-mirror プラグイン v2 の新しいワークフローに合わせて変更されました。

    • ミラーからディスクへのミラーリングの場合は、次のコマンドを実行します。 

      $ oc-mirror --config isc.yaml file://<directory_name> --v2
      Copy to Clipboard Toggle word wrap

    • ディスクからミラーへのミラーリングの場合は、次のコマンドを実行します。 

      $ oc-mirror --config isc.yaml --from file://<directory_name> docker://<remote_registry> --v2
      Copy to Clipboard Toggle word wrap

    • ミラーからミラーへのミラーリングの場合は、次のコマンドを実行します。 

      $ oc-mirror --config isc.yaml --workspace file://<directory_name> docker://<remote_registry> --v2
      Copy to Clipboard Toggle word wrap
      注記

      ミラー間の操作には --workspace が必須になりました。

  • API バージョンの更新: ImageSetConfiguration の API バージョンが v1alpha2 (v1) から v2alpha1 (v2) に変更されます。移行前に設定ファイルを手動で更新する必要があります。

  • 設定の変更:

    • oc-mirror プラグイン v2 では storageConfig を削除する必要があります。
    • 増分ミラーリングが、作業ディレクトリーまたはローカルキャッシュを通じて自動的に処理されるようになりました。

  • 結果ディレクトリーの変更: 非接続クラスターに適用されるすべてのカスタムリソースが、移行後に <workspace_path>/working-dir/cluster-resources ディレクトリーに生成されます。

    • oc-mirror プラグイン v2 の出力は、oc-mirror プラグイン v1 と同じ場所には保存されません。

    • 作業ディレクトリー配下の cluster-resources フォルダーで次のリソースを確認する必要があります。

      • ImageDigestMirrorSet (IDMS)
      • ImageTagMirrorSet (ITMS)
      • CatalogSource
      • ClusterCatalog
      • UpdateService

  • ワークスペースとディレクトリーの命名: バージョン間の移行時に潜在的なデータの不整合が発生しないように、oc-mirror v2 の新しい規則に従ってください。

    • oc-mirror プラグイン v1 の oc-mirror-workspace ディレクトリーは不要になりました。
    • 競合を避けるために、oc-mirror プラグイン v2 用の新しいディレクトリーを使用します。

  • ImageContentSourcePolicy (ICSP) リソースと IDMS/ITMS の置き換え:

    重要

    すべての ImageContentSourcePolicy (ICSP) リソースを削除すると、oc-mirror に関係のない設定が削除される可能性があります。

    意図しない削除を回避するために、oc-mirror によって生成された ICSP リソースを、削除する前に特定してください。不明な場合は、クラスター管理者に確認してください。詳細は、「oc-mirror プラグイン v2 を使用した非接続インストールのイメージのミラーリング」を参照してください。

    • oc-mirror プラグイン v2 では、ICSP リソースは ImageDigestMirrorSet (IDMS) および ImageTagMirrorSet (ITMS) リソースに置き換えられます。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat