3.7. 一般的なクライアント RPM のワークフロー

手順

1. 次の例では、x86_64 アーキテクチャー上のベース Red Hat Enterprise Linux 8 のクライアント設定 RPM 用に、カスタムリポジトリーを作成します。

   # rhui-manager repo create_custom --protected --repo_id client-config-rhel-8-x86_64 --display_name "RHUI Client Configuration for RHEL 8 on x86_64" --gpg_public_keys /root/RPM-GPG-KEY-my-cloud

   必要に応じて別のリポジトリー ID と表示名を使用することもできます。また、実際の GPG 鍵ファイルを指定してください。

2. 関連する Red Hat リポジトリーを追加します。次の YAML ファイルには、バージョン管理されていないリポジトリーを使用した、x86_64 アーキテクチャー上のベース Red Hat Enterprise Linux 8 用の一般的なリポジトリーセットが含まれています。

   # cat rhel-8-x86_64.yaml
   name: Red Hat Enterprise Linux 8 on x86_64
   repo_ids:
     - codeready-builder-for-rhel-8-x86_64-rhui-debug-rpms-8
     - codeready-builder-for-rhel-8-x86_64-rhui-rpms-8
     - codeready-builder-for-rhel-8-x86_64-rhui-source-rpms-8
     - rhel-8-for-x86_64-appstream-rhui-debug-rpms-8
     - rhel-8-for-x86_64-appstream-rhui-rpms-8
     - rhel-8-for-x86_64-appstream-rhui-source-rpms-8
     - rhel-8-for-x86_64-baseos-rhui-debug-rpms-8
     - rhel-8-for-x86_64-baseos-rhui-rpms-8
     - rhel-8-for-x86_64-baseos-rhui-source-rpms-8
     - rhel-8-for-x86_64-supplementary-rhui-debug-rpms-8
     - rhel-8-for-x86_64-supplementary-rhui-rpms-8
     - rhel-8-for-x86_64-supplementary-rhui-source-rpms-8

   上記の YAML ファイルを使用してこれらすべてのリポジトリーを追加および同期するには、次のコマンドを実行します。

   # rhui-manager repo add_by_file --file rhel-8-x86_64.yaml --sync_now

3. エンタイトルメント証明書を作成します。証明書で許可されるリポジトリーラベルのリストが必要です。多くの場合、リポジトリーラベルはリポジトリー ID と同じです。ただし、リポジトリー ID に特定の Red Hat Enterprise Linux マイナーバージョンが含まれている場合は、ラベルにマイナーバージョンは含まれず、メジャーバージョンのみが含まれます。ベース Red Hat Enterprise Linux リポジトリーの場合、ID は同一であるため、次の Python コードを使用して上記の YAML ファイルから ID を抽出できます。

   import yaml
   with open("rhel-8-x86_64.yaml") as repoyaml:
       repodata = yaml.safe_load(repoyaml)
       print(",".join(repodata["repo_ids"]))

   出力をクリップボードにコピーし、環境変数 ($labels など) として保存します。

   # labels=<paste the contents of the clipboard here>

   エンタイトルメント証明書を作成するときは、Red Hat Enterprise Linux リポジトリーラベルに加えて、カスタムリポジトリーをラベルのコンマ区切りリストに追加する必要もあります。次のコマンドを実行して、Red Hat Enterprise Linux リポジトリーとカスタムリポジトリーの両方へのアクセスを許可するエンタイトルメント証明書を作成します。

   # rhui-manager client cert --name rhel-8-x86_64 --dir /root --days 3650 --repo_label $labels,client-config-rhel-8-x86_64

   会社のポリシーで証明書の有効期間が 1 年、2 年などに制限されている場合は、それに応じて --days 引数の値を変更します。

   このコマンドは、ファイル /root/rhel-8-x86_64.crt と /root/rhel-8-x86_64.key を作成します。これらのファイルは次のステップで必要になります。

4. クライアント設定 RPM を作成します。

   # rhui-manager client rpm --dir /tmp --rpm_name rhui-client-rhel-8-x86_64 --rpm_version 1.0 --entitlement_cert /root/rhel-8-x86_64.crt --private_key /root/rhel-8-x86_64.key

   任意の RPM 名またはバージョンを使用してください。上記の値を指定すると、コマンドによって RPM が作成され、その場所が出力されます。場所は次のとおりです。

   /tmp/rhui-client-rhel-8-x86_64-1.0/build/RPMS/noarch/rhui-client-rhel-8-x86_64-1.0-1.noarch.rpm

5. この RPM を RHUA からシステムに転送し、適切な GPG 鍵 (カスタムリポジトリーの作成時に --gpg_public_keys パラメーターとして使用した公開鍵に対応する秘密鍵) を使用して RPM に署名します。その後、たとえば、クラウド環境内の Red Hat Enterprise Linux 8 x86_64 イメージに、署名済み RPM をプリインストールすることができます。また、署名済み RPM を RHUA に転送し、x86_64 上の Red Hat Enterprise Linux 8 のカスタムリポジトリーにアップロードする必要があります。

   # rhui-manager packages upload --repo_id client-config-rhel-8-x86_64 --packages /root/signed/rhui-client-rhel-8-x86_64-1.0-1.noarch.rpm

検証

1. カスタムリポジトリーの内容を確認します。

   # rhui-manager packages list --repo_id client-config-rhel-8-x86_64

   このコマンドは、アップロードした RPM ファイルを出力するためのものです。

2. CDS ノードと HAProxy ノードを設定 (このガイドで後ほど説明) してから、テスト仮想マシンにクライアント設定 RPM をインストールし、テスト仮想マシンで次のコマンドを実行して、関連するすべてのリポジトリーへのアクセスを確認することもできます。

   # yum -v repolist

   このコマンドは、設定された Red Hat Enterprise Linux 8 リポジトリーとクライアント設定 RPM 用のカスタムリポジトリーを出力するためのものです。

1. 前回の呼び出しで 1.0 を使用した場合は、2.0 などを使用します。他のパラメーターはそのままにします。

   # rhui-manager client rpm --dir /tmp --rpm_name rhui-client-rhel-8-x86_64 --rpm_version 2.0 ...

2. 再度、新しい RPM に署名し、RHUA に転送して、カスタムリポジトリーにアップロードします。

   # rhui-manager packages upload --repo_id client-config-rhel-8-x86_64 --packages /root/signed/rhui-client-rhel-8-x86_64-2.0-1.noarch.rpm

3. これで、以前のバージョンの RPM がインストールされているクライアント仮想マシンを新しいバージョンに更新できます。新しい RPM をアップロードしたときに、更新されたリポジトリーデータを dnf で再ロードするには、クライアント仮想マシン上の dnf キャッシュを消去する必要がある場合があります。