第3章 JBoss EAP の自動デプロイメントの有効化

手順

1. Ansible コントロールノードで、vars.yml ファイルを開きます。

2. インストールする JBoss EAP のバージョンを指定するには、eap_version 変数を適切なベースリリースに設定します。

   以下に例を示します。

   [...]
   eap_version: 7.4.0

   注記

   jws_version 変数に指定する値が、インストールする製品アーカイブファイルのバージョンと一致していることを確認してください。たとえば、JBoss EAP 7.4 のアーカイブファイルをインストールするには、7.4 .0 の値を指定します。

   ステップ 4 の説明に従って自動ファイルダウンロードの認証情報を指定しない場合は、指定した製品バージョンのアーカイブファイルが Ansible コントロールノードにコピーされていることを確認してください。

3. JBoss EAP アーカイブファイルのコピーが Ansible コントロールノードに存在しない場合は、コレクションはデフォルトで Red Hat カスタマーポータルに連絡してアーカイブファイルを自動的にダウンロードします。Red Hat カスタマーポータルとの接続を確実に成功させるには、rhn_username 変数と rhn_password 変数を設定して、Red Hat サービスアカウントの認証情報を指定します。

   以下に例を示します。

   [...]
   rhn_username: <client_ID>
   rhn_password: <client_secret>

   上記の例では、<client_ID> と <client_secret> を、Red Hat サービスアカウントに関連付けられているクライアント ID とシークレットに置き換えます。

   注記

   適切なアーカイブファイルのコピーが Ansible コントロールノードにすでに存在する場合、コレクションはこのアーカイブファイルを再度ダウンロードしません。

   アーカイブファイルを手動でダウンロードする場合や、これらのファイルを別の方法ですでに取得している場合は、完全なオフラインインストールを強制できます。オフラインインストールの強制の詳細は、JBoss EAP パッチ更新の自動インストールの有効化 を参照してください。

4. Ansible コントロールノードでダウンロードしたアーカイブファイルの名前を変更した場合は、eap_archive_filename 変数を設定して、インストールするファイルを指定します。

   以下に例を示します。

   [...]
   eap_archive_filename: <application_server_file>

   前の例で、< application_server_file > を適切なアーカイブファイル名に置き換えます。

   注記

   ファイル名を変更しない場合は、eap_archive_filename 変数を設定する必要はありません。JBoss EAP コレクションは、eap_version 変数の値を使用して、デフォルトのファイル名を自動的に決定します。

5. 変更を vars.yml ファイルに保存します。

手順

1. Ansible コントロールノードで、vars.yml ファイルを開きます。

2. eap_apply_cp 変数を True に設定します。

   以下に例を示します。

   [...]
   eap_version: 7.4.0
   [...]
   eap_apply_cp: True

   注記

   jws_version 変数が適切な製品バージョンのベースリリース (例: 6.0.0) に設定されていることを確認します。

   JBoss EAP コレクションは、デフォルトで最新のパッチ更新をインストールするように設定されています。コレクションは Red Hat カスタマーポータルに接続して、インストールする正しいパッチを決定します。

3. 最新のパッチ更新ではなく、指定したパッチリリースをコレクションにインストールする場合は、jws_patch_version 変数を、インストールするパッチリリースに設定します。

   以下に例を示します。

   [...]
   eap_apply_cp: True
   eap_patch_version: 7.4.2

   上記の例に基づくと、新しいパッチが利用可能な場合でも、コレクションは 6.0.2 累積パッチのみをインストールします。

4. eap_apply_cp 変数が True に設定されている場合、JBoss EAP コレクションは Red Hat カスタマーポータルに接続して、新しいパッチ更新が利用可能かどうかを確認します。このコレクションは、必要に応じてパッチ更新もダウンロードします。Red Hat カスタマーポータルとの接続を確実に成功させるには、rhn_username 変数と rhn_password 変数を設定して、Red Hat サービスアカウントの認証情報を指定します。

   以下に例を示します。

   [...]
   rhn_username: <client_ID>
   rhn_password: <client_secret>

   上記の例では、<client_ID> と <client_secret> を、Red Hat サービスアカウントに関連付けられているクライアント ID とシークレットに置き換えます。

   注記

   適切なアーカイブファイルのコピーが Ansible コントロールノードにすでに存在する場合、コレクションはこのアーカイブファイルを再度ダウンロードしません。

   jws_patch_version 変数が特定のパッチリリースに設定されている場合、新しいパッチが利用可能な場合でも、コレクションは指定したパッチリリースのみをダウンロードします。

   アーカイブファイルを手動でダウンロードする場合や、これらのファイルを別の方法ですでに取得している場合は、ステップ 5 の説明に従って完全なオフラインインストールを強制できます。

5. 完全なオフラインインストールを強制し、コレクションが Red Hat カスタマーポータルに接続しないようにするには、jws_offline_install 変数を True に設定します。

   以下に例を示します。

   [...]
   eap_offline_install: True

   注記

   jws_offline_install 変数は、Ansible コントロールノードがインターネットにアクセスできない場合や、コレクションがファイルのダウンロードのために Red Hat カスタマーポータルに接続することを回避したい場合に役立ちます。この場合は、jws_patch_version 変数を、インストールするパッチリリースに設定する必要があります。

   適切なパッチ更新のアーカイブファイルが Ansible コントロールノードにコピーされていることを確認してください。この状況では、Ansible コントロールノードのカスタム Playbook と同じディレクトリーにアーカイブファイルをコピーする必要があります。

   jws_offline_install 変数を True に設定した場合、ファイルの自動ダウンロードを許可するように rhn_username 変数と rhn_password 変数を設定していても、コレクションは Red Hat カスタマーポータルに接続しようとしません。

6. 変更を vars.yml ファイルに保存します。