手順

1. ターミナルで次のコマンドを実行して、Ansible Automation Platform リポジトリーをアクティブ化します。

   #  dnf install --enablerepo=ansible-automation-platform-2.4-for-rhel-9-x86_64-rpms ansible-builder

1. ベースイメージを取得します。
2. ベースイメージの一時コピーでは、コレクションがダウンロードされ、宣言された Python およびシステム依存関係の一覧 (存在する場合) が後に収集されます。
3. エフェメラルビルダーイメージでは、定義ファイルに記載されているすべての Python 依存関係の Python ホイールがダウンロードされ、(必要に応じて) ビルドされます。これには、定義ファイルに記載されているコレクションによって宣言されたすべての Python 依存関係が含まれます。
4. 定義ファイルの additional_build_steps に対して prepend が実行します。
5. 最終的な自動化実行環境イメージでは、定義ファイルに記載されているシステム依存関係がインストールされ、定義ファイルに記載されているコレクションが宣言したすべてのシステム依存関係が含まれます。
6. 最終的な自動化実行環境イメージでは、ダウンロードしたコレクションがコピーされ、以前にフェッチされた Python 依存関係がインストールされます。
7. 定義ファイルの additional_build_steps に対して append が実行します。

手順

1. Podman を使用して registry.redhat.io にログインします。

   $ podman login -u="[username]" -p="[token/hash]" registry.redhat.io

2. 必要な自動化実行環境のベースイメージをプルできることを確認します。

   podman pull registry.redhat.io/ansible-automation-platform-22/ee-minimal-rhel8:latest

3. 必要なベースイメージと新しい実行環境イメージに追加する追加のコンテンツを指定するように Ansible Builder ファイルを設定します。

   1. たとえば、Kubernetes Core Collection を Galaxy から イメージに追加するには、以下のように requirements.yml ファイルを入力します。

      collections:
        - kubernetes.core

   2. 定義ファイルとそのコンテンツの詳細は、定義ファイルの内訳 セクションを参照してください。

4. 実行環境定義ファイルで、EE_BASE_IMAGE フィールドに元の ee-minimal コンテナーの URL とタグを指定します。その場合、最終的な execution-environment.yml ファイルは以下のようになります。

   例3.1 カスタマイズされた execution-environment.yml ファイル

   version: 1
   
   build_arg_defaults:
     EE_BASE_IMAGE: 'registry.redhat.io/ansible-automation-platform-22/ee-minimal-rhel8:latest'
   
   dependencies:
     galaxy: requirements.yml

   注記

   この例では、自動化ハブの認定コレクションではなく、コミュニティーバージョンの kubernetes.core を使用するため、ansible.cfg ファイルを作成したり、定義ファイルで参照したりする必要はありません。

5. 以下のコマンドを使用して、新しい実行環境イメージを構築します。

   $ ansible-builder build -t registry.redhat.io/[username]/new-ee

   ここで、[username] はユーザー名を指定し、new-ee は新しいコンテナーイメージの名前を指定します。

1. podman images コマンドを使用して、新しいコンテナーイメージが一覧に表示されていることを確認します。

   例3.2 new-ee イメージを使用した podman images コマンドの出力

   REPOSITORY          TAG     IMAGE ID      CREATED        SIZE
   localhost/new-ee    latest  f5509587efbb  3 minutes ago  769 MB

   1. コレクションがインストールされていることを確認します。

      $ podman run registry.redhat.io/[username]/new-ee ansible-doc -l kubernetes.core

   2. Automation Hub で使用するイメージにタグを付けます。

      $ podman tag registry.redhat.io/[username]/new-ee [automation-hub-IP-address]/[username]/new-ee

   3. Podman を使用して Automation Hub にログインします。

      注記

      コンテナーをプッシュするには、Automation Hub の admin または適切なコンテナーリポジトリーのアクセス許可が必要です。詳細は、Red Hat Ansible Automation Platform ドキュメント の プライベート Automation Hub でのコンテナーの管理 を参照してください。

      $ podman login -u="[username]" -p="[token/hash]" [automation-hub-IP-address]

   4. イメージを自動化ハブのコンテナーレジストリーにプッシュします。

      $ podman push [automation-hub-IP-address]/[username]/new-ee

   5. 新しいイメージを自動化コントローラーインスタンスにプルします。
2. Automation Controller に移動します。
3. ナビゲーションバーから、Administration → Execution Environments の順にクリックします。
4. Add をクリックします。

5. 適切な情報を入力して Save をクリックし、新規イメージにプルします。

   注記

   自動化ハブのインスタンスがパスワードまたはトークンで保護されている場合は、適切なコンテナーレジストリーの認証情報が設定されていることを確認してください。

手順

1. registry.redhat.io 認証情報を使用して Podman にログインします。

   $ podman login registry.redhat.io

2. プロンプトにユーザー名およびパスワードを入力します。

3. コンテナーイメージをプルします。

   $ podman pull registry.redhat.io/<container_image_name>:<tag>

検証

1. ローカルストレージ内のイメージを一覧表示します。

   $ podman images

2. 最近プルしたイメージが一覧に含まれていることを確認します。
3. タグが正しいことを確認します。

検証

1. ローカルストレージ内のイメージを一覧表示します。

   $ podman images

2. Automation Hub の情報で最近タグ付けされたイメージが一覧に含まれていることを確認します。

手順

1. Automation Hub の場所および認証情報を使用して Podman にログインします。

   $ podman login -u=<username> -p=<password> <automation_hub_url>

2. コンテナーイメージを Automation Hub のコンテナーレジストリーにプッシュします。

   $ podman push <automation_hub_url>/<container_image_name>

   注記

   registry.redhat.io からの署名付きイメージが Automation Hub コンテナーレジストリーにプッシュされる場合は、--remove-signatures フラグが必要です。push 操作は、アップロード中にイメージレイヤーを再圧縮します。これは、再現性が保証されておらず、クライアントの実装に依存します。これにより、イメージレイヤーダイジェストが変更され、プッシュ操作が失敗し、Error: Copying this image requires changing layer representation, which is not possible (image is signed or the destination specifies a digest) エラーが発生します。

検証

1. Automation Hub にログインします。
2. Container Registry に移動します。
3. コンテナーリポジトリー一覧でコンテナーを見つけます。

手順

1. Execution Environments に移動します。
2. コンテナーリポジトリーを選択します。
3. Detail タブで、Add をクリックします。
4. Raw Markdown テキストフィールドに、Markdown で README テキストを入力します。
5. 完了したら、Save をクリックします。

手順

1. Execution Environments に移動します。
2. コンテナーリポジトリーを選択します。
3. ウィンドウの右上にある Edit をクリックします。

4. Groups with access で、アクセス権を付与するグループ (単数または複数) を選択します。

   • (必要に応じて) グループ名でドロップダウンを使用して、特定のグループのパーミッションを追加または削除します。
5. Save をクリックします。

手順

1. Execution Environments に移動します。
2. コンテナーリポジトリーを選択します。
3. Images タブをクリックします。
4. More Actions アイコン ⋮ をクリックしてから、Manage tags をクリックします。

5. テキストフィールドに新しいタグを追加し、Add をクリックします。

   • (必要に応じて) そのイメージのいずれのタグの x をクリックして、current tags を削除します。
6. Save をクリックします。

手順

1. Automation Controller に移動します。
2. サイドメニューバーの Resources → Credentials をクリックします。
3. Add をクリックして、新規の認証情報を作成します。
4. 承認用の 名前、説明、および 組織 を入力します。
5. 認証情報のタイプ を選択します。
6. 認証用 URL を入力します。これはコンテナーレジストリーのアドレスです。
7. コンテナーレジストリーへのログインに必要な ユーザー名 と パスワードまたはトークン を入力します。
8. オプションで、Verify SSL を選択して、SSL の検証を有効にします。
9. Save をクリックします。

手順

1. Execution Environments に移動します。
2. コンテナーリポジトリーを選択します。
3. Pull this image エントリーで、Copy to clipboard をクリックします。
4. 端末でコマンドを貼り付けます。

1. Execution Environments → Remote Registries に移動します。
2. https://registry.redhat.io をレジストリーに追加します。
3. 認証に必要な認証情報を追加します。

1. Execution Environments → Execution Environments に移動します。
2. ページヘッダーの Add execution environment をクリックします。
3. プルするレジストリーを選択します。"name" フィールドには、ローカルレジストリー上に表示されるイメージの名前が表示されます。