第4章 S2I を使用した OpenShift での Quarkus アプリケーションのデプロイ

従来の Source-to-Image (S2I) 手法は、Red Hat OpenShift Container Platform でのアプリケーションのデプロイにおける推奨される方法として、広く使用されています。S2I では、Git リポジトリーを使用するか、ビルド時にソースをアップロードして、ソースコードをビルドコンテナーに提供する必要があります。この手法を使用して、実稼働環境に Quarkus アプリケーションをデプロイします。

前提条件

  • Git リポジトリーでホストされる Quarkus Maven プロジェクトがあること。

手順

  1. Quarkus Maven プロジェクトが含まれるディレクトリーに移動します。
  2. pom.xml ファイルと同じレベルで、.s2i という名前の隠しディレクトリーを作成します。
  3. .s2i ディレクトリーに environment という名前のファイルを作成し、以下の内容を追加します。

    ARTIFACT_COPY_ARGS=-p -r lib/ *-runner.jar
  4. 変更をリモート Git リポジトリーにコミットし、プッシュします。
  5. OpenShift CLI (oc) にログインします。

    oc login
  6. 新しい OpenShift プロジェクトを作成するには、以下のコマンドを実行します。このコマンドの PROJECT_NAME は、新規プロジェクトの名前に置き換えます。

    oc new-project PROJECT_NAME
  7. サポートされる OpenShift イメージをインポートするには、以下のコマンドを入力します。

    oc import-image --confirm openjdk/openjdk-11-rhel7 --from=registry.access.redhat.com/openjdk/openjdk-11-rhel7
    注記

    IBM Z インフラストラクチャーにデプロイする場合は、oc import-image --confirm openj9/openj9-11-rhel8 --from=registry.access.redhat.com/openj9/openj9-11-rhel8 を入力します。

    このイメージの詳細は、Red Hat OpenJDK 11 Java Applications ページを参照してください。

  8. OpenShift でプロジェクトをビルドするには、以下のコマンドを入力します。GIT_PATH は Quarkus プロジェクトをホストする Git リポジトリーへのパス、PROJECT_NAME は作成した OpenShift プロジェクトに置き換えます。

    oc new-app openjdk-11-rhel7 GIT_PATH --name=PROJECT_NAME
    注記

    IBM Z インフラストラクチャーにデプロイする場合は、oc new-app openj9/openj9-11-rhel8 GIT_PATH --name=PROJECT_NAME を入力します。

    このコマンドを実行すると、プロジェクトのビルド、アプリケーションの作成、そして OpenShift サービスのデプロイが行われます。

  9. OpenShift ルートを作成するには、以下のコマンドを入力します。

    oc expose service/PROJECT_NAME
  10. 新規ルートを表示するには、以下のコマンドを入力します。このコマンドの APPLICATION_NAME は、OpenShift プロジェクトにデプロイされたアプリケーションの名前に置き換えます。

    export URL="http://$(oc get route APPLICATION_NAME -o jsonpath='{.spec.host}}')"
    echo "Application URL: $URL"
  11. ルートの hello エンドポイントに HTTP 要求を作成するには、以下のコマンドを入力します。

    curl $URL/hello
  12. アプリケーションを使用するには、前のコマンドで返された URL を Web ブラウザーで入力します。
  13. プロジェクトの更新バージョンをデプロイするには、更新を Git リポジトリーにプッシュしてから、以下のコマンドを入力します。

    oc start-build PROJECT_NAME
  14. ビルドの完了後にブラウザーページを更新し、変更を確認します。

改訂日時: 2020-11-18 01:18:31 UTC