第4章 S2I を使用した OpenShift での Quarkus アプリケーションのデプロイ
従来の Source-to-Image (S2I) 手法は、Red Hat OpenShift Container Platform でのアプリケーションのデプロイにおける推奨される方法として、広く使用されています。S2I では、Git リポジトリーを使用するか、ビルド時にソースをアップロードして、ソースコードをビルドコンテナーに提供する必要があります。この手法を使用して、実稼働環境に Quarkus アプリケーションをデプロイします。
前提条件
- Git リポジトリーでホストされる Quarkus Maven プロジェクトがあること。
手順
- Quarkus Maven プロジェクトが含まれるディレクトリーに移動します。
-
pom.xmlファイルと同じレベルで、.s2iという名前の隠しディレクトリーを作成します。 .s2iディレクトリーにenvironmentという名前のファイルを作成し、以下の内容を追加します。ARTIFACT_COPY_ARGS=-p -r lib/ *-runner.jar
- 変更をリモート Git リポジトリーにコミットし、プッシュします。
OpenShift CLI (oc) にログインします。
oc login
新しい OpenShift プロジェクトを作成するには、以下のコマンドを実行します。このコマンドの
<project_name>は、新規プロジェクトの名前に置き換えます。oc new-project <project_name>
サポートされる OpenShift イメージをインポートするには、以下のコマンドを入力します。
oc import-image --confirm ubi8/openjdk-11 --from=registry.access.redhat.com/ubi8/openjdk-11
注記IBM Z インフラストラクチャーにデプロイする場合は、
oc import-image --confirm openj9/openj9-11-rhel8 --from=registry.redhat.io/openj9/openj9-11-rhel8を入力します。このイメージの詳細は、Red Hat OpenJ9 11 Java Applications on RHEL8 ページを参照してください。
OpenShift でプロジェクトをビルドするには、以下のコマンドを入力します。
<git_path>は Quarkus プロジェクトをホストする Git リポジトリーへのパス、<project_name>は作成した OpenShift プロジェクトに置き換えます。oc new-app ubi8/openjdk-11 <git_path> --name=<project_name>
注記IBM Z インフラストラクチャーにデプロイする場合は、
oc new-app openj9/openj9-11-rhel8 <git_path> --name=<project_name>を入力します。このコマンドを実行すると、プロジェクトのビルド、アプリケーションの作成、そして OpenShift サービスのデプロイが行われます。
OpenShift ルートを作成するには、以下のコマンドを入力します。
oc expose service/<project_name>
新規ルートを表示するには、以下のコマンドを入力します。このコマンドの <application_name> は、OpenShift プロジェクトにデプロイされたアプリケーションの名前に置き換えます。
export URL="http://$(oc get route <application_name> -o jsonpath='{.spec.host}}')" echo "Application URL: $URL"ルートの
helloエンドポイントに HTTP 要求を実行するには、以下のコマンドを入力します。curl $URL/hello
- アプリケーションを使用するには、前のコマンドで返された URL を Web ブラウザーで入力します。
プロジェクトの更新バージョンをデプロイするには、更新を Git リポジトリーにプッシュしてから、以下のコマンドを入力します。
oc start-build <project_name>
- ビルドの完了後にブラウザーページを更新し、変更を確認します。