第7章 コンテナーイメージのカスタマイズ

手順

1. containers-prepare-parameter.yaml ファイルを編集し、ceph_images: false パラメーターを追加します。

   このファイルの例を以下に示します。上記のパラメーターを太字で示しています。

   parameter_defaults:
     ContainerImagePrepare:
     - tag_from_label: {version}-{release}
       set:
         name_prefix: rhosp17-openstack-
         name_suffix: ''
         tag: 17.1_20231214.1
         rhel_containers: false
         neutron_driver: ovn
         ceph_images: false
       push_destination: true

   Copy to Clipboard
2. containers-prepare-parameter.yaml ファイルを保存します。

3. オーバークラウドのデプロイに使用する新しいコンテナーイメージファイルを作成します。

   sudo openstack tripleo container image prepare -e containers-prepare-parameter.yaml --output-env-file <new_container_images_file>

   • <new_container_images_file> は、新しいパラメーターを含む出力ファイルに置き換えます。
4. 新しいコンテナーイメージファイルをオーバークラウドデプロイメント環境ファイルのリストに追加します。

手順

1. コンテナーイメージにインストールするための RPM パッケージをダウンロードします。

2. containers-prepare-parameter.yaml ファイルを編集して、コンテナーイメージ上のすべてのパッケージを更新します。

   ContainerImagePrepare:
   - push_destination: true
     ...
     modify_role: tripleo-modify-image
     modify_append_tag: "-updated"
     modify_vars:
       tasks_from: yum_update.yml
       compare_host_packages: true
       yum_repos_dir_path: /etc/yum.repos.d
     ...

   Copy to Clipboard
3. containers-prepare-parameter.yaml ファイルを保存します。
4. openstack overcloud deploy コマンドを実行する際に、containers-prepare-parameter.yaml ファイルを含めます。

手順

1. 以下の例では、nova-compute イメージでカスタム Dockerfile が実行されます。

   ContainerImagePrepare:
   - push_destination: true
     ...
     includes:
     - nova-compute
     modify_role: tripleo-modify-image
     modify_append_tag: "-hotfix"
     modify_vars:
       tasks_from: modify_image.yml
       modify_dir_path: /home/stack/nova-custom
     ...

   Copy to Clipboard

2. /home/stack/nova-custom/Dockerfile ファイルの例を以下に示します。USER root ディレクティブを実行した後は、元のイメージのデフォルトユーザーに戻す必要があります。

   FROM registry.redhat.io/rhosp-rhel9/openstack-nova-compute:latest
   
   USER "root"
   
   COPY customize.sh /tmp/
   RUN /tmp/customize.sh
   
   USER "nova"

   Copy to Clipboard

手順

1. すべてのコンテナーイメージのリストを作成します。

   $ sudo podman search --limit 1000 "registry.redhat.io/rhosp-rhel9" --format="{{ .Name }}" | sort > satellite_images
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep <ceph_dashboard_image_file>
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep <ceph_image_file>
   $ sudo podman search --limit 1000 "registry.redhat.io/openshift4" | grep ose-prometheus

   Copy to Clipboard

   • <ceph_dashboard_image_file> は、デプロイメントで使用する Red Hat Ceph Storage のバージョンのイメージファイルの名前に置き換えます。

     • Red Hat Ceph Storage 5: rhceph-5-dashboard-rhel8
     • Red Hat Ceph Storage 6: rhceph-6-dashboard-rhel9

   • <ceph_image_file> は、デプロイメントで使用する Red Hat Ceph Storage のバージョンのイメージファイルの名前に置き換えます。

     • Red Hat Ceph Storage 5: rhceph-5-rhel8

     • Red Hat Ceph Storage 6: rhceph-6-rhel9

       注記

       openstack-ovn-bgp-agent イメージは registry.redhat.io/rhosp-rhel9/openstack-ovn-bgp-agent-rhel9:17.1 にあります。

   • Ceph をインストールして Ceph Dashboard を有効にする場合は、次の ose-prometheus コンテナーが必要です。

     registry.redhat.io/openshift4/ose-prometheus-node-exporter:v4.12
     registry.redhat.io/openshift4/ose-prometheus:v4.12
     registry.redhat.io/openshift4/ose-prometheus-alertmanager:v4.12

     Copy to Clipboard
2. Satellite 6 の hammer ツールがインストールされているシステムに satellite_images ファイルをコピーします。あるいは、Hammer CLI ガイド に記載の手順に従って、アンダークラウドに hammer ツールをインストールします。

3. 以下の hammer コマンドを実行して、実際の Satellite 組織に新規製品 (OSP Containers) を作成します。

   $ hammer product create \
     --organization "ACME" \
     --name "OSP Containers"

   Copy to Clipboard

   このカスタム製品に、イメージを保管します。

4. satellite_images ファイルからオーバークラウドのコンテナーイメージを追加します。

   $ while read IMAGE; do \
     IMAGE_NAME=$(echo $IMAGE | cut -d"/" -f3 | sed "s/openstack-//g") ; \
     IMAGE_NOURL=$(echo $IMAGE | sed "s/registry.redhat.io\///g") ; \
     hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name $IMAGE_NOURL \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name $IMAGE_NAME ; done < satellite_images

   Copy to Clipboard

5. Ceph Storage コンテナーイメージを追加します。

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/<ceph_image_name> \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name <ceph_image_name>

   Copy to Clipboard

   • <ceph_image_file> は、デプロイメントで使用する Red Hat Ceph Storage のバージョンのイメージファイルの名前に置き換えます。

     • Red Hat Ceph Storage 5: rhceph-5-rhel8

     • Red Hat Ceph Storage 6: rhceph-6-rhel9

       注記

       Ceph ダッシュボードをインストールする場合は、hammer repository create コマンドに --name <ceph_dashboard_image_name> を含めます。

       $ hammer repository create \
         --organization "ACME" \
         --product "OSP Containers" \
         --content-type docker \
         --url https://registry.redhat.io \
         --docker-upstream-name rhceph/<ceph_dashboard_image_name> \
         --upstream-username USERNAME \
         --upstream-password PASSWORD \
         --name <ceph_dashboard_image_name>

       Copy to Clipboard

       • <ceph_dashboard_image_file> は、デプロイメントで使用する Red Hat Ceph Storage のバージョンのイメージファイルの名前に置き換えます。

         • Red Hat Ceph Storage 5: rhceph-5-dashboard-rhel8
         • Red Hat Ceph Storage 6: rhceph-6-dashboard-rhel9

6. コンテナーイメージを同期します。

   $ hammer product synchronize \
     --organization "ACME" \
     --name "OSP Containers"

   Copy to Clipboard

   Satellite Server が同期を完了するまで待ちます。

   注記

   設定によっては、hammer から Satellite Server のユーザー名およびパスワードが要求される場合があります。設定ファイルを使用して自動的にログインするように hammer を設定することができます。詳細は、Hammer CLI ガイド の 認証 セクションを参照してください。

7. お使いの Satellite 6 サーバーでコンテンツビューが使われている場合には、新たなバージョンのコンテンツビューを作成してイメージを反映し、アプリケーションライフサイクルの環境に従ってプロモートします。この作業は、アプリケーションライフサイクルをどのように設定するかに大きく依存します。たとえば、ライフサイクルに production という名称の環境があり、その環境でコンテナーイメージを利用可能にする場合には、コンテナーイメージを含むコンテンツビューを作成し、そのコンテンツビューを production 環境にプロモートします。詳細は、コンテンツビューの管理 を参照してください。

8. base イメージに使用可能なタグを確認します。

   $ hammer docker tag list --repository "base" \
     --organization "ACME" \
     --lifecycle-environment "production" \
     --product "OSP Containers"

   Copy to Clipboard

   このコマンドにより、特定環境のコンテンツビューでの OpenStack Platform コンテナーイメージのタグが表示されます。

9. アンダークラウドに戻り、Satellite サーバーをソースとして使用して、イメージを準備するデフォルトの環境ファイルを生成します。以下のサンプルコマンドを実行して環境ファイルを生成します。

   $ sudo openstack tripleo container image prepare default \
     --output-env-file containers-prepare-parameter.yaml

   Copy to Clipboard
   • --output-env-file: 環境ファイルの名前です。このファイルには、アンダークラウド用コンテナーイメージを準備するためのパラメーターが含まれます。ここでは、ファイル名は containers-prepare-parameter.yaml です。

10. containers-prepare-parameter.yaml ファイルを編集して以下のパラメーターを変更します。

    • push_destination: 選択したコンテナーイメージの管理手段に応じて、これを true または false に設定します。このパラメーターを false に設定すると、オーバークラウドノードはイメージを直接 Satellite からプルします。このパラメーターを true に設定すると、director はイメージを Satellite からアンダークラウドレジストリーにプルし、オーバークラウドはそのイメージをアンダークラウドレジストリーからプルします。
    • namespace: Satellite サーバー上のレジストリーの URL。

    • name_prefix: 接頭辞は Satellite 6 の命名規則に基づきます。これは、コンテンツビューを使用するかどうかによって異なります。

      • コンテンツビューを使用する場合、設定は [org]-[environment]-[content view]-[product]- です。例: acme-production-myosp17-osp_containers-.
      • コンテンツビューを使用しない場合、設定は [org]-[product]- です。例: acme-osp_containers-。
    • ceph_namespace、ceph_image、ceph_tag: Ceph Storage を使用する場合には、Ceph Storage コンテナーイメージの場所を定義するこれらの追加パラメーターを指定します。ceph_image に Satellite 固有の接頭辞が追加された点に注意してください。この接頭辞は、name_prefix オプションと同じ値です。

手順

1. オーバークラウド用に新たなコンテナーイメージファイルを作成します。

   $ sudo openstack tripleo container image prepare default \
       --local-push-destination \
       --output-env-file containers-prepare-parameter-dellemc.yaml

   Copy to Clipboard
2. containers-prepare-parameter-dellemc.yaml ファイルを編集します。

3. メインの Red Hat OpenStack Platform コンテナーイメージの設定に exclude パラメーターを追加します。このパラメーターを使用して、ベンダーコンテナーイメージで置き換えるコンテナーイメージを除外します。以下の例では、コンテナーイメージは cinder-volume イメージです。

   parameter_defaults:
     ContainerImagePrepare:
       - push_destination: true
         excludes:
     	   - cinder-volume
         set:
           namespace: registry.redhat.io/rhosp-rhel9
           name_prefix: openstack-
           name_suffix: ''
           tag: 17.1
           ...
         tag_from_label: "{version}-{release}"

   Copy to Clipboard

4. ContainerImagePrepare パラメーターに、ベンダープラグインの代替コンテナーイメージが含まれる新しい設定を追加します。

   parameter_defaults:
     ContainerImagePrepare:
       ...
       - push_destination: true
         includes:
           - cinder-volume
         set:
           namespace: registry.connect.redhat.com/dellemc
           name_prefix: openstack-
           name_suffix: -dellemc-rhosp16
           tag: 16.2-2
           ...

   Copy to Clipboard

5. ContainerImageRegistryCredentials パラメーターに registry.connect.redhat.com レジストリーの認証情報を追加します。

   parameter_defaults:
     ContainerImageRegistryCredentials:
       registry.redhat.io:
         [service account username]: [service account password]
       registry.connect.redhat.com:
         [service account username]: [service account password]

   Copy to Clipboard
6. containers-prepare-parameter-dellemc.yaml ファイルを保存します。

7. openstack overcloud deploy などのデプロイメントコマンドに containers-prepare-parameter-dellemc.yaml ファイルを追加します。

   $ openstack overcloud deploy --templates
       ...
       -e containers-prepare-parameter-dellemc.yaml
       ...

   Copy to Clipboard

   director がオーバークラウドをデプロイする際に、オーバークラウドは標準のコンテナーイメージの代わりにベンダーのコンテナーイメージを使用します。

   重要

   containers-prepare-parameter-dellemc.yaml ファイルは、オーバークラウドデプロイメント内の標準の containers-prepare-parameter.yaml ファイルを置き換えます。オーバークラウドのデプロイメントに、標準の containers-prepare-parameter.yaml ファイルを含めないでください。アンダークラウドのインストールおよび更新には、標準の containers-prepare-parameter.yaml ファイルを維持します。