1.6. S2I を使用して Red Hat build of Quarkus アプリケーションを OpenShift Container Platform にデプロイする

手順

1. pom.xml ファイルを開き、次のように Java 設定をバージョン 17 に変更します。

   <maven.compiler.source>17</maven.compiler.source>
   <maven.compiler.target>17</maven.compiler.target>

2. Java 17 アプリケーションをパッケージ化するには、次のコマンドを入力します。

   ./mvnw clean package

3. pom.xml ファイルと同じレベルに、.s2i というディレクトリーを作成します。

4. .s2i ディレクトリーに environment という名前のファイルを作成し、以下の内容を追加します。

   MAVEN_S2I_ARTIFACT_DIRS=target/quarkus-app
   S2I_SOURCE_DEPLOYMENTS_FILTER=app lib quarkus quarkus-run.jar
   JAVA_OPTIONS=-Dquarkus.http.host=0.0.0.0
   AB_JOLOKIA_OFF=true
   JAVA_APP_JAR=/deployments/quarkus-run.jar

5. 変更をリモート Git リポジトリーにコミットし、プッシュします。

6. 次のコマンドを入力して、サポートされている OpenShift Container Platform イメージをインポートします。

   oc import-image ubi8/openjdk-17 --from=registry.access.redhat.com/ubi8/openjdk-17 --confirm

   注記
   • OpenShift イメージレジストリーを使用し、同じプロジェクト内のイメージストリームからプルしている場合、Pod サービスアカウントにはすでに正しい権限が付与されているはずです。
   • 他の OpenShift Container Platform プロジェクトまたは保護されたレジストリーからイメージをプルする場合は、追加の設定手順が必要になることもあります。

   詳細は、Red Hat OpenShift Container Platform のドキュメントで イメージプルシークレットの使用 を参照してください。

7. 次のコマンドを入力して、プロジェクトのビルド、アプリケーションの作成、OpenShift Container Platform サービスのデプロイを実行します。

   oc new-app registry.access.redhat.com/ubi8/openjdk-17~<git_path> --name=<project_name>

   ここでは、以下のようになります。

   • <git_path> は、Quarkus プロジェクトをホストする Git リポジトリーへのパスです。たとえば、oc new-app registry.access.redhat.com/ubi8/openjdk-17~https://github.com/johndoe/code-with-quarkus.git --name= code-with-quarkus です。

     Git リポジトリー用に SSH キーを設定していない場合は、Git パスを指定する際に、SSH URL の代わりに HTTPS URL を使用します。

   • <project_name> はアプリケーションの名前です。

8. プロジェクトの更新バージョンをデプロイするには、更新を Git リポジトリーにプッシュしてから、以下のコマンドを入力します。

   oc start-build <project_name>

9. 次のコマンドを入力して、ルートを Quarkus アプリケーションに公開します。

   oc expose svc <project_name>

検証

1. 次のコマンドを入力して、現在の OpenShift プロジェクトに関連付けられている Pod のリストを表示します。

   oc get pods

2. アプリケーションの Pod のログ出力を取得するには、以下のコマンドを入力します。<pod_name> は、お使いのアプリケーションの名前の接頭辞が付いた最新の Pod の名前になります。

   oc logs -f <pod_name>

手順

1. pom.xml ファイルを開き、次のように Java 設定をバージョン 21 に変更します。

   <maven.compiler.source>21</maven.compiler.source>
   <maven.compiler.target>21</maven.compiler.target>

2. 次のコマンドを入力して、Java 21 アプリケーションをパッケージ化します。

   ./mvnw clean package

3. pom.xml ファイルと同じレベルに、.s2i というディレクトリーを作成します。

4. .s2i ディレクトリーに environment という名前のファイルを作成し、以下の内容を追加します。

   MAVEN_S2I_ARTIFACT_DIRS=target/quarkus-app
   S2I_SOURCE_DEPLOYMENTS_FILTER=app lib quarkus quarkus-run.jar
   JAVA_OPTIONS=-Dquarkus.http.host=0.0.0.0
   AB_JOLOKIA_OFF=true
   JAVA_APP_JAR=/deployments/quarkus-run.jar

5. 変更をリモート Git リポジトリーにコミットし、プッシュします。

6. 次のコマンドを入力して、サポートされている OpenShift Container Platform イメージをインポートします。

   oc import-image ubi8/openjdk-21 --from=registry.access.redhat.com/ubi8/openjdk-21 --confirm

   注記
   • OpenShift イメージレジストリーを使用し、同じプロジェクト内のイメージストリームからプルしている場合、Pod サービスアカウントにはすでに正しい権限が付与されているはずです。

   • 他の OpenShift Container Platform プロジェクトまたは保護されたレジストリーからイメージをプルする場合は、追加の設定手順が必要になることもあります。

     詳細は、Red Hat OpenShift Container Platform のドキュメントで イメージプルシークレットの使用 を参照してください。

   • IBM Z インフラストラクチャーにデプロイする場合は、代わりに oc import-image ubi8/openjdk-21 --from=registry.redhat.io/ubi8/openjdk-21 --confirm を入力します。このイメージの詳細は、Red Hat build of OpenJDK 21 ページを参照してください。

7. 次のコマンドを入力して、プロジェクトのビルド、アプリケーションの作成、OpenShift Container Platform サービスのデプロイを実行します。

   oc new-app registry.access.redhat.com/ubi8/openjdk-21~<git_path> --name=<project_name>

   ここでは、以下のようになります。

   • <git_path> は、Quarkus プロジェクトをホストする Git リポジトリーへのパスです。たとえば、oc new-app registry.access.redhat.com/ubi8/openjdk-21~https://github.com/johndoe/code-with-quarkus.git --name=code-with-quarkus です。

     Git リポジトリー用に SSH キーを設定していない場合は、Git パスを指定する際に、SSH URL の代わりに HTTPS URL を使用します。

   • <project_name> はアプリケーションの名前です。

     注記

     IBM Z インフラストラクチャー上にデプロイする場合は、代わりに oc new-app ubi8/openjdk-21~<git_path> --name=<project_name> と入力します。

8. プロジェクトの更新バージョンをデプロイするには、更新を Git リポジトリーにプッシュしてから、以下のコマンドを入力します。

   oc start-build <project_name>

9. 次のコマンドを入力して、ルートを Quarkus アプリケーションに公開します。

   oc expose svc <project_name>

検証

1. 次の子アンドを入力して、Pod のリストを表示します。

   oc get pods

2. 次のコマンドを入力して、アプリケーションの Pod のログ出力を取得します。

   oc logs -f <pod_name>