4.12. ansible-builder RPM のインストール

手順

1. RHEL システムで、ansible-builder RPM をインストールします。これは、いくつかの方法で実行できます。

   1. 非接続ネットワーク上の Satellite で RHEL ボックスをサブスクライブします。
   2. Ansible Automation Platform サブスクリプションを割り当て、Ansible Automation Platform リポジトリーを有効にします。

   3. ansible-builder RPM をインストールします。

      注記

      Satellite が存在する場合は、この方法を推奨します。基礎となるビルドホストが登録されていれば、実行環境イメージが Satellite からの RHEL コンテンツを使用できるためです。

2. Ansible Automation Platform セットアップバンドルを展開します。

3. 含まれているコンテンツから ansible-builder RPM とその依存関係をインストールします。

   $ tar -xzvf ansible-automation-platform-setup-bundle-2.3-1.2.tar.gz
   $ cd ansible-automation-platform-setup-bundle-2.3-1.2/bundle/el8/repos/
   $ sudo yum install ansible-builder-1.2.0-1.el9ap.noarch.rpm
   python38-requirements-parser-0.2.0-4.el9ap.noarch.rpm

   Copy to Clipboard Toggle word wrap

4. カスタム EE ビルドアーティファクト用のディレクトリーを作成します。

   $ mkdir custom-ee
   $ cd custom-ee/

   Copy to Clipboard Toggle word wrap

5. https://ansible-builder.readthedocs.io/en/stable/definition/ のドキュメントに従って、カスタム EE の要件を定義する execution-environment.yml ファイルを作成します。EE_BASE_IMAGE 変数および EE_BUILDER_IMAGE 変数をオーバーライドして、Private Automation Hub で使用可能な EE を指すようにします。

   $ cat execution-environment.yml
   ---
   version: 1
   build_arg_defaults:
     EE_BASE_IMAGE: '<hub_fqdn>/ee-supported-rhel8:latest'
     EE_BUILDER_IMAGE: '<hub_fqdn>/ansible-builder-rhel8:latest'
   
   dependencies:
     python: requirements.txt
     galaxy: requirements.yml

   Copy to Clipboard Toggle word wrap

6. Private Automation Hub を指し、アップロードを許可する認証情報 (管理者ユーザートークンなど) を含む ansible.cfg ファイルを作成します。

   $ cat ansible.cfg
   [galaxy]
   server_list = private_hub
   
   [galaxy_server.private_hub]
   url=https://<hub_fqdn>/api/galaxy/
   token=<admin_token>

   Copy to Clipboard Toggle word wrap

7. 非接続 UBI リポジトリーミラーを指す ubi.repo ファイルを作成します (UBI コンテンツがそこにホストされている場合、これは Satellite である可能性があります)。

   これは、UBI リポジトリーをミラーリングするために reposync が使用された出力例です。

   $ cat ubi.repo
   [ubi-8-baseos]
   name = Red Hat Universal Base Image 8 (RPMs) - BaseOS
   baseurl = http://<ubi_mirror_fqdn>/repos/ubi-8-baseos
   enabled = 1
   gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
   gpgcheck = 1
   
   [ubi-8-appstream]
   name = Red Hat Universal Base Image 8 (RPMs) - AppStream
   baseurl = http://<ubi_mirror_fqdn>/repos/ubi-8-appstream
   enabled = 1
   gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release
   gpgcheck = 1

   Copy to Clipboard Toggle word wrap

8. Private Automation Hub Web サーバー証明書の署名に使用される CA 証明書を追加します。

   1. 自己署名証明書 (インストーラーのデフォルト) の場合は、Private Automation Hub からファイル /etc/pulp/certs/root.crt のコピーを作成し、hub-root.crt という名前を付けます。
   2. Private Automation Hub Web サーバー証明書の要求と署名に内部認証局が使用された場合は、その CA 証明書のコピーを hub-root.crt という名前で作成します。
9. カスタム EE イメージに必要なコンテンツを含む python の requirements.txt と ansible コレクションの requirements.yml を作成します。必要なコレクションはすべて、Private Automation Hub にアップロードされている必要があることに注意してください。

10. ansible-builder を使用して、EE イメージのビルドに使用されるコンテキストディレクトリーを作成します。

    $ ansible-builder create
    Complete! The build context can be found at: /home/cloud-user/custom-ee/context
    $ ls -1F
    ansible.cfg
    context/
    execution-environment.yml
    hub-root.crt
    pip.conf
    requirements.txt
    requirements.yml
    ubi.repo

    Copy to Clipboard Toggle word wrap

11. インターネットに接続されたシステムのデフォルトをオーバーライドするために使用するファイルをコンテキストディレクトリーにコピーします。

    $ cp ansible.cfg hub-root.crt pip.conf ubi.repo context/

    Copy to Clipboard Toggle word wrap

12. ファイル context/Containerfile を編集し、次の変更を追加します。

    1. 最初の EE_BASE_IMAGE ビルドセクションで、ansible.cfg および hub-root.crt ファイルを追加し、update-ca-trust コマンドを実行します。
    2. EE_BUILDER_IMAGE ビルドセクションで、ubi.repo および pip.conf ファイルを追加します。

    3. 最後の EE_BASE_IMAGE ビルドセクションで、ubi.repo および pip.conf ファイルを追加します。

       $ cat context/Containerfile
       ARG EE_BASE_IMAGE=<hub_fqdn>/ee-supported-rhel8:latest
       ARG EE_BUILDER_IMAGE=<hub_fqdn>/ansible-builder-rhel8:latest
       
       FROM $EE_BASE_IMAGE as galaxy
       ARG ANSIBLE_GALAXY_CLI_COLLECTION_OPTS=
       USER root
       
       ADD _build /build
       WORKDIR /build
       
       # this section added
       ADD ansible.cfg /etc/ansible/ansible.cfg
       ADD hub-root.crt /etc/pki/ca-trust/source/anchors/hub-root.crt
       RUN update-ca-trust
       # end additions
       RUN ansible-galaxy role install -r requirements.yml \
           --roles-path /usr/share/ansible/roles
       RUN ansible-galaxy collection install \
           $ANSIBLE_GALAXY_CLI_COLLECTION_OPTS -r requirements.yml \
           --collections-path /usr/share/ansible/collections
       
       FROM $EE_BUILDER_IMAGE as builder
       
       COPY --from=galaxy /usr/share/ansible /usr/share/ansible
       
       ADD _build/requirements.txt requirements.txt
       RUN ansible-builder introspect --sanitize \
           --user-pip=requirements.txt \
           --write-bindep=/tmp/src/bindep.txt \
           --write-pip=/tmp/src/requirements.txt
       # this section added
       ADD ubi.repo /etc/yum.repos.d/ubi.repo
       ADD pip.conf /etc/pip.conf
       # end additions
       RUN assemble
       
       FROM $EE_BASE_IMAGE
       USER root
       
       COPY --from=galaxy /usr/share/ansible /usr/share/ansible
       # this section added
       ADD ubi.repo /etc/yum.repos.d/ubi.repo
       ADD pip.conf /etc/pip.conf
       # end additions
       
       COPY --from=builder /output/ /output/
       RUN /output/install-from-bindep && rm -rf /output/wheels

       Copy to Clipboard Toggle word wrap

13. podman コマンドを使用して、ローカル podman キャッシュに EE イメージを作成します。

    $ podman build -f context/Containerfile \
        -t <hub_fqdn>/custom-ee:latest

    Copy to Clipboard Toggle word wrap

14. カスタム EE イメージが正常にビルドされたら、それを Private Automation Hub にプッシュします。

    $ podman push <hub_fqdn>/custom-ee:latest

    Copy to Clipboard Toggle word wrap