第12章 Helm チャートの使用例
Helm は、OpenShift 上で JBoss EAP XP 5.0 アプリケーションをビルド、デプロイ、保守できるようにするオープンソースのパッケージマネージャーです。
JBoss EAP XP 5.0 で Helm チャートを使用すると、以下が可能になります。
- OpenShift Source-to-Image (S2I) を使用して、Git リポジトリーでホストされている Maven プロジェクトからアプリケーションをビルドする。
- OpenShift クラスター (TLS 設定、アプリケーションを公開するためのパブリックルートなど) を使用して、緊密に統合された OpenShift にアプリケーションイメージをデプロイする。
- Helm チャートを使用してアプリケーションイメージをビルドし、JBoss EAP XP Operator を使用してイメージをデプロイする。
- その他の方法を使用して JBoss EAP XP のアプリケーションイメージをビルドし、Helm チャートを使用する。
- JBoss EAP XP 5.0 を使用して Java アプリケーションをビルドし、起動可能な Jar または Jakarta デプロイメントを作成できます (JBoss EAP 8.0 と同様)。
-
Java アプリケーションが起動可能な Jar である場合、JBoss EAP XP 5.0 の Helm チャートを (デフォルトの
build.modeをbootable-jarに設定して) 使用してアプリケーションイメージをビルドできます。 -
Java アプリケーションが Jakarta デプロイメントの場合、Helm チャートの
build.modeをs2iに設定することで、Source-to-Image (JBoss EAP 8.0 と同様) を使用してアプリケーションイメージをビルドできます。
12.1. Helm チャートを使用した JBoss EAP アプリケーションのビルドとデプロイ リンクのコピーリンクがクリップボードにコピーされました!
ビルドとデプロイの値を設定することで、Helm チャートを使用して JBoss EAP XP アプリケーションをビルドできます。ビルド設定には、アプリケーションコードをホストする Git リポジトリーへの URL を指定する必要があります。出力は、ビルドされたアプリケーションイメージを含む ImageStreamTag リソースです。アプリケーションをデプロイするには、ビルドされたアプリケーションイメージを含む ImageStreamTag リソースを指定する必要があります。出力は、デプロイされたアプリケーションと、OpenShift 内外からアプリケーションにアクセスするために使用できるその他の関連リソースです。
前提条件
- OpenShift 開発コンソールにアクセスできる。
- JBoss EAP XP アプリケーションのソースコードは Git リポジトリーにホストされている。
- アプリケーションは Maven プロジェクトである。
-
org.jboss.eap.plugins:eap-maven-pluginを使用して JBoss EAP XP 5.0 サーバーをプロビジョニングするようにアプリケーションを設定した。
- この手順では、OpenShift 開発コンソールの使用にのみ焦点を当てています。
- 一部のフォームセクションはデフォルトで折りたたまれています。コンテンツを展開して表示するには、> をクリックします。これらのセクションを更新しなくても続行できます。
手順
OpenShift 開発コンソールにログインします。
- ドロップダウンメニューで、Helm をクリックします。
- 右上隅で create をクリックし、Helm Release をクリックします。
- JBoss EAP XP 5 を選択します。
- create をクリックし、YAML ビュー で設定を選択します。
ソースリポジトリーからアプリケーションイメージをビルドします。
build: uri: <git repository URL of your application> mode: s2i
build: uri: <git repository URL of your application> mode: s2iCopy to Clipboard Copied! Toggle word wrap Toggle overflow オプション:
sourceSecretキーを使用してbuildセクションにシークレットを入力します。build: uri: <git repository URL of your application> mode: s2i sourceSecret: <name of secret login to your Git repository>
build: uri: <git repository URL of your application> mode: s2i sourceSecret: <name of secret login to your Git repository>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
- アプリケーションが正常にデプロイされると、OpenShift 開発コンソールの Helm リリースの横にデプロイ済みバッジが表示されます。
12.1.1. JBoss EAP XP で Source-to-Image と Helm チャートを使用する リンクのコピーリンクがクリップボードにコピーされました!
アプリケーションの pom.xml の eap-maven-plugin を使用して、JBoss EAP サーバーをプロビジョニングします。このプラグインが OpenShift プロファイル、デフォルトプロファイル、または他の任意のアクティブなプロファイルで設定され、OpenShift プロファイルが他のすべてよりも優先されることを確認します。
build.mode を S2I に設定する必要があります。これは、JBoss EAP XP Helm チャートのデフォルト値が bootable-jar であるためです。
build.s2i.featurePacks、build.s2i.galleonLayers、および build.s2i.channels フィールドは非推奨になりました。
12.1.2. JBoss EAP XP で起動可能な JAR と Helm チャートを使用する リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP XP 5.0 では、アプリケーションを起動可能な JAR としてビルドできます。その方法の詳細は、起動可能な JAR を参照してください。
さらに、JBoss EAP XP 5.0 では、JBoss EAP XP 5.0 用の Helms Chart を設定して、起動可能な JAR に基づきアプリケーションをビルドできます。
前提条件
- OpenShift 開発コンソールにログインしている。
- JBoss EAP XP アプリケーションのソースコードは Git リポジトリーにホストされている。
-
アプリケーションは Maven プロジェクトである。Maven プラグイン
org.wildfly.plugins:wildfly-jar-maven-pluginを使用して起動可能な JAR を作成するようにアプリケーションを設定した。詳細は、起動可能な JAR Maven プロジェクトの作成 を参照してください。
12.1.2.1. Bootable JAR を使用してアプリケーションイメージをビルドする リンクのコピーリンクがクリップボードにコピーされました!
OpenShift 開発コンソールのビルドセクションを設定することで、Helms チャートを使用して Bootable で JBoss EAP XP アプリケーションイメージをビルドできます。
-
Helm チャートを使用してアプリケーションをビルドする場合は、Git リポジトリーを参照する Git URL を
build.urlフィールドに指定する必要があります。 -
build.modeフィールドをbootable-jarに設定する必要があります。