4.3. 既存の実行環境イメージのカスタマイズ

手順

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

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

   Copy to Clipboard Toggle word wrap

2. 使用するベースイメージをプルする権限があることを確認します。

   1. たとえば、ee-minimal イメージをプルするには、このリポジトリー にアクセスできることを確認してください。

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

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

      ---
      collections:
        - kubernetes.core

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

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

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

   ---
   version: 1
   
   build_arg_defaults:
     EE_BASE_IMAGE: 'example.registry.com/my-base-ee'
   
   dependencies:
     galaxy: requirements.yml

   Copy to Clipboard Toggle word wrap
   注記

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

      Copy to Clipboard Toggle word wrap
6. Ansible Navigator で新たに作成した実行環境イメージの確認

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

   $ podman push quay.io/[username]/new-ee

   Copy to Clipboard Toggle word wrap

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

   1. 自動化コントローラーに移動します。
   2. ナビゲーションバーから、Administration > Execution Environments の順にクリックします。
   3. Add をクリックします。

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

      注記

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