第4章 自動化実行環境の公開

手順

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

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

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

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

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

   1. たとえば、Galaxy の Kubernetes Core Collection をイメージに追加するには、Galaxy エントリーを使用します。

      collections:
        - kubernetes.core

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

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

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

   version: 3
   
   images:
     base_image: 'registry.redhat.io/ansible-automation-platform-25/ee-minimal-rhel9:latest'
   
   dependencies:
     galaxy:
       collections:
         - kubernetes.core

   注記

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

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

   $ ansible-builder build -t [username]/new-ee

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

   注記

   build で -t を使用しない場合は、ansible-execution-env というイメージが作成され、ローカルのコンテナーレジストリーに読み込まれます。

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

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

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

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

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

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

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

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

   注記

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

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

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

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

10. 新しいイメージを自動化コントローラーインスタンスにプルします。

    1. Automation Controller に移動します。
    2. ナビゲーションパネルから、Automation Execution Infrastructure Execution Environments を選択します。
    3. Add をクリックします。

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

       注記

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