3.3. Private Automation Hub コンテナーレジストリーへの入力
デフォルトでは、Private Automation Hub にはコンテナーイメージが含まれていません。コンテナーレジストリーを設定するには、コンテナーイメージレジストリーにコンテナーイメージをプッシュする必要があります。
Private Automation Hub コンテナーレジストリーを設定するには、特定のワークフローに従う必要があります。
- Red Hat Ecosystem Catalog (registry.redhat.io) からイメージをプルします。
- イメージにタグを付けます。
- Private Automation Hub コンテナーレジストリーにプッシュします。
2025 年 4 月 1 日 の時点で、quay.io は 3 つのエンドポイントを別に追加しています。そのため、お客様はファイアウォールシステムリスト内の許可/ブロックリストを調整して、次のエンドポイントを含める必要があります。
-
cdn04.quay.io -
cdn05.quay.io -
cdn06.quay.io
コンテナーイメージのプルに関する問題を回避するには、次のホスト名への送信 TCP 接続 (ポート 80 および 443) を許可する必要があります。
-
cdn.quay.io -
cdn01.quay.io -
cdn02.quay.io -
cdn03.quay.io -
cdn04.quay.io -
cdn05.quay.io -
cdn06.quay.io
registry.redhat.io または registry.access.redhat.com への送信接続を特に有効にするすべてのファイアウォール設定にこの変更を加えます。
ファイアウォールルールを設定するときは、IP アドレスの代わりにホスト名を使用します。
この変更を加えた後も、引き続き registry.redhat.io または registry.access.redhat.com からイメージをプルできます。Red Hat コンテナーイメージのプルを続行するために、quay.io にログインする必要も、quay.io レジストリーと直接やりとりする必要もありません。
詳細は、Firewall changes for container image pulls 2024/2025 を参照してください。
Table 6.4 に記載されている ネットワークポートとプロトコル を確認します。実行環境 (EE)) を確認してください。コンテナーイメージをプルする際の問題を回避するのに役立ちます。
3.3.1. Automation Hub で使用するイメージのプル リンクのコピーリンクがクリップボードにコピーされました!
コンテナーイメージを Private Automation Hub にプッシュする前に、まず既存のレジストリーからプルし、使用できるようにタグを付ける必要があります。次の例では、Red Hat Ecosystem Catalog (registry.redhat.io) からイメージをプルする方法を説明します。
前提条件
- registry.redhat.io からイメージをプルする権限がある。
手順
registry.redhat.io の認証情報を使用して Podman にログインします。
podman login registry.redhat.io
$ podman login registry.redhat.ioCopy to Clipboard Copied! Toggle word wrap Toggle overflow - ユーザー名およびパスワードを入力します。
コンテナーイメージをプルします。
podman pull registry.redhat.io/<container_image_name>:<tag>
$ podman pull registry.redhat.io/<container_image_name>:<tag>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
最近プルしたイメージがリストに含まれていることを確認するには、次の手順を実行します。
ローカルストレージ内のイメージをリスト表示します。
podman images
$ podman imagesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - イメージ名を確認し、タグが正しいことを確認します。
3.3.2. Automation Hub で使用するイメージのタグ付け リンクのコピーリンクがクリップボードにコピーされました!
レジストリーからイメージをプルしたら、Private Automation Hub コンテナーレジストリーで使用するようにタグを付けます。
前提条件
- 外部レジストリーからコンテナーイメージをプルしている。
- Automation Hub インスタンスの FQDN または IP アドレスがある。
手順
Automation Hub コンテナーリポジトリーを使用してローカルイメージにタグを付けます。
podman tag registry.redhat.io/<container_image_name>:<tag> <automation_hub_hostname>/<container_image_name>
$ podman tag registry.redhat.io/<container_image_name>:<tag> <automation_hub_hostname>/<container_image_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
ローカルストレージ内のイメージをリスト表示します。
podman images
$ podman imagesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Automation Hub の情報で最近タグ付けされたイメージが一覧に含まれていることを確認します。
3.3.3. Private Automation Hub へのコンテナーイメージのプッシュ リンクのコピーリンクがクリップボードにコピーされました!
タグ付けされたコンテナーイメージを Private Automation Hub にプッシュして、新しいコンテナーを作成し、コンテナーレジストリーに追加できます。
前提条件
- 新規コンテナーを作成する権限がある。
- Automation Hub インスタンスの FQDN または IP アドレスがある。
手順
Automation Hub の場所および認証情報を使用して Podman にログインします。
podman login -u=<username> -p=<password> <automation_hub_url>
$ podman login -u=<username> -p=<password> <automation_hub_url>Copy to Clipboard Copied! Toggle word wrap Toggle overflow コンテナーイメージを Automation Hub のコンテナーレジストリーにプッシュします。
podman push <automation_hub_url>/<container_image_name>
$ podman push <automation_hub_url>/<container_image_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
トラブルシューティング
push 操作は、アップロード中にイメージレイヤーを再圧縮します。この操作は、再現性が保証されておらず、クライアントの実装に依存します。これにより、イメージレイヤーダイジェストが変更され、プッシュ操作が失敗し、Error: Copying this image requires changing layer representation, which is not possible (image is signed or the destination specifies a digest) エラーが発生します。
検証
- Automation Hub にログインします。
- に移動します。
- コンテナーリポジトリーリストでコンテナーを見つけます。