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

9.4. Red Hat OpenShift Service on AWS のイメージレジストリーミラーリング

ImageDigestMirrorSet (IDMS) オブジェクトを使用して、ミラーリングされたレジストリーからイメージをプルするように既存の Red Hat OpenShift Service on AWS クラスターを設定できます。

重要

イメージミラー設定機能は、ダイジェストによるイメージ参照でのみ動作します。つまり、イメージミラーリングが有効になるのは、一意かつイミュータブルな ID を使用してイメージがプルされた場合だけです。ミュータブルなタグを使用したイメージ参照は、現在この機能ではサポートされていません。

IDMS は、イメージのダウンロードを高速化し、信頼性とセキュリティーを向上させるための、レジストリーミラーリングに関するクラスター全体のポリシーを定義します。これは、一意のコンテンツアドレス指定ダイジェストによってイメージを識別するイメージプルリクエストをインターセプトすることによって機能します。IDMS はこれらのポリシーに基づいて、指定のソースレジストリーから 1 つ以上の指定されたミラーレジストリーにプル操作を透過的にリダイレクトします。開発者にとっては、元のソースを参照したままのリクエストが、より高速でより近いミラーによって自動的に対応されるため、ワークフローを変更することなく、デプロイメント速度が大幅に向上します。

前提条件

ImageDigestMirrorSet (IDMS) オブジェクトを使用して、ミラーリングされたレジストリーからイメージをプルするように Red Hat OpenShift Service on AWS クラスターを設定するには、次の前提条件を満たす必要があります。

  • インストールホストに最新の ROSA コマンドラインインターフェイス (CLI) (rosa) をインストールして設定した。
  • Red Hat OpenShift Service on AWS クラスターをインストールした。
  • イメージミラーを作成、編集、リスト表示、または削除するために、Red Hat OpenShift Service on AWS クラスターが Ready 状態になっている。
  • 設定するミラーレジストリーにアクセスできる。
  • クラスター設定の管理に必要な IAM 権限がある。詳細は、関連情報 セクションの 「IAM リソースについて」を参照してください。

IDMS を使用してミラー化されたレジストリーからイメージをプルするように Red Hat OpenShift Service on AWS クラスターを設定する利点は次のとおりです。

  • 強化されたセキュリティー: プライベートのミラーリングされたレジストリーからイメージを強制的にプルして、イメージがクラスターに入る前に、すべてのイメージの脆弱性をスキャンして承認できます。
  • クラスターの信頼性の向上: ローカルミラーにより、パブリックインターネットパスウェイへの依存が排除され、安定した予測可能なクラスターパフォーマンスが確保されます。
  • イメージの一貫性の保証: IDMS はイメージダイジェストを使用してイメージを参照します。これにより、クラスター内のすべてのノードが同じバージョンのイメージをプルし、デプロイメントの失敗につながる可能性のある不整合が防止されます。

9.4.1. イメージミラー設定の作成
リンクのコピー

手順

Red Hat OpenShift Service on AWS クラスターのイメージミラー設定を作成するには、次のコマンドを実行します。

重要

ソースレジストリーは作成後に変更することはできません。ソースを変更するには、イメージミラーを削除して再作成する必要があります。

構文

$ rosa create image-mirror [arguments]
Copy to Clipboard Toggle word wrap

Expand
表9.1 引数
オプション定義

--cluster

必須: ミラー設定を適用するクラスターの名前または ID。

--source

必須: ミラーリングされるソースレジストリー。

--mirrors

必須: ミラーレジストリーのリスト。ミラーレジストリーはコンマで区切る必要があります。

--type=digest

任意: イメージミラーのタイプ。digest タイプがデフォルトで設定されます。これは唯一使用可能な type オプションです。

--profile

任意: 認証情報ファイルから AWS プロファイル (文字列) を指定します。

--region

任意: AWS リージョンを指定し、AWS_REGION 環境変数をオーバーライドします。

例

mycluster という名前のクラスターのイメージミラー設定を作成します。 

$ rosa create image-mirror --cluster=mycluster \
  --source=registry.example.com/team \
  --mirrors=mirror.corp.com/team,backup.corp.com/team
Copy to Clipboard Toggle word wrap

出力例

I: Image mirror with ID 'abc123def456' has been created on cluster 'mycluster'
I: Source: registry.example.com/team
I: Mirrors: [mirror.corp.com/team backup.corp.com/team]
Copy to Clipboard Toggle word wrap

注記

イメージミラー設定の作成中に、ID が自動的に生成され、イメージミラーに割り当てられます。

特定のタイプのイメージミラー設定を作成します。

注記

digest タイプがデフォルトで設定されます。これは唯一使用可能な type オプションです。 

$ rosa create image-mirror --cluster=mycluster \
  --type=digest --source=docker.io/library \
  --mirrors=internal-registry.company.com/dockerhub
Copy to Clipboard Toggle word wrap

クラスターのミラーが複数含まれるイメージミラー設定を 1 つ作成します。 

$ rosa create image-mirror --cluster=mycluster \
  --source=quay.io/openshift \
  --mirrors=mirror1.company.com/openshift,mirror2.company.com/openshift,mirror3.company.com/openshift
Copy to Clipboard Toggle word wrap

9.4.2. イメージミラーリング設定の編集
リンクのコピー

手順

Red Hat OpenShift Service on AWS クラスターのイメージミラー設定を編集するには、次のコマンドを実行します。

注記

イメージミラー設定を編集すると、新しいミラーリストが既存のミラーリストに完全に置き換えられます。

構文

$ rosa edit image-mirror [arguments]
Copy to Clipboard Toggle word wrap

Expand
表9.2 引数
オプション定義

--cluster

必須: イメージミラー設定が適用されるクラスターの名前または ID (文字列)。

--mirrors

必須: 現在のミラーレジストリーを置き換える新しいミラーレジストリーのリスト。ミラーレジストリーはコンマで区切る必要があります。

--id

必須: 編集するイメージミラー設定の ID。

--profile

任意: 認証情報ファイルから特定の AWS プロファイルを使用します。

--region

任意: AWS リージョンを使用し、AWS_REGION 環境変数をオーバーライドします。

例

イメージミラー設定のミラーを 1 つ置き換えます。 

$ rosa edit image-mirror --cluster=mycluster --id=abc123def456 \
  --mirrors=single-mirror.company.com/team
Copy to Clipboard Toggle word wrap

出力例

I: Image mirror 'abc123def456' has been updated on cluster 'mycluster'
I: Source: registry.example.com/team
I: Updated mirrors: [mirror.corp.com/team backup.corp.com/team new-mirror.corp.com/team]
Copy to Clipboard Toggle word wrap

イメージミラー設定のすべてのミラーを置き換えます。 

$ rosa edit image-mirror --cluster=mycluster --id=abc123def456 \
  --mirrors=new-primary.company.com/team,new-secondary.company.com/team
Copy to Clipboard Toggle word wrap

9.4.3. すべてのイメージミラー設定のリスト表示
リンクのコピー

手順

Red Hat OpenShift Service on AWS クラスターのすべてのイメージミラー設定をリスト表示するには、次のコマンドを実行します。

構文

$ rosa list image-mirrors [arguments]
Copy to Clipboard Toggle word wrap

Expand
表9.3 引数
オプション定義

--cluster

必須: クラスターの名前または ID。

--output

任意: 出力形式。使用できる形式は json、yaml です

--profile

任意: 認証情報ファイルから特定の AWS プロファイルを使用します。

--region

任意: AWS リージョンを使用し、AWS_REGION 環境変数をオーバーライドします。

例

クラスターのすべてのイメージミラー設定を表示します。 

$ rosa list image-mirrors --cluster=mycluster
Copy to Clipboard Toggle word wrap

出力例

ID              TYPE    SOURCE                    MIRRORS
abc123def456    digest  registry.example.com/team mirror.corp.com/team, backup.corp.com/
Copy to Clipboard Toggle word wrap

9.4.4. イメージミラー設定の削除
リンクのコピー

注記

--yes または --y の引数が使用されない限り、削除操作を確定する必要があります。

手順

Red Hat OpenShift Service on AWS クラスターからイメージミラー設定を削除するには、次のコマンドを実行します。

構文

$ rosa delete image-mirror [arguments]
Copy to Clipboard Toggle word wrap

Expand
表9.4 引数
オプション定義

--cluster

必須: イメージミラー設定が削除されるクラスターの名前または ID (文字列)。

--id

必須: 削除するイメージミラー設定の ID。

--yes、-y

オプション: 自動的に "yes" と回答して削除を確定します。

--profile

任意: 認証情報ファイルから特定の AWS プロファイルを使用します。

--region

任意: AWS リージョンを使用し、AWS_REGION 環境変数をオーバーライドします。

例

確認プロンプトなしでイメージミラー設定を削除します。 

$ rosa delete image-mirror --cluster=mycluster abc123def456 --yes
Copy to Clipboard Toggle word wrap

出力例

I: Image mirror 'abc123def456' has been deleted from cluster 'mycluster'
Copy to Clipboard Toggle word wrap

確認プロンプトとともにイメージミラー設定を削除します。 

$ rosa delete image-mirror --cluster=mycluster --id=abc123def456
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat