Red Hat OpenShift Container Platform での Quarkus アプリケーションのデプロイ

手順

1. Quarkus Maven プロジェクトが含まれるディレクトリーに移動します。

2. OpenShift エクステンションを既存プロジェクトに追加するには、以下のコマンドを入力します。

   ./mvnw quarkus:add-extension -Dextensions="openshift"

   Copy to Clipboard Toggle word wrap
   注記

   新規プロジェクトの作成時に -Dextensions="openshift" 引数を含めて、Quarkus OpenShift エクステンションを追加することができます。

   OpenShift エクステンションを追加すると、スクリプトは以下の依存関係を pom.xml ファイルに追加します。

      <dependency>
        <groupId>io.quarkus</groupId>
        <artifactId>quarkus-openshift</artifactId>
      </dependency>

   Copy to Clipboard Toggle word wrap

3. 信頼されていない証明書を使用している場合は、src/main/resources/application.properties ファイルに以下の行を追加します。

   quarkus.kubernetes-client.trust-certs=true

   Copy to Clipboard Toggle word wrap

4. Open JDK 11 の Red Hat Enterprise Linux 7 イメージを使用するように OpenShift を設定するには、以下の行を application.properties ファイルに追加します。

   quarkus.s2i.base-jvm-image=registry.access.redhat.com/ubi8/openjdk-11

   Copy to Clipboard Toggle word wrap
   注記

   IBM Z インフラストラクチャーにデプロイする場合は、application.properties ファイルに quarkus.s2i.base-jvm-image=registry.access.redhat.com/openj9/openj9-11-rhel8 を追加します。

5. OpenShift ルートを作成するには、以下の行を application.properties ファイルに追加します。

   quarkus.openshift.expose=true

   Copy to Clipboard Toggle word wrap
6. 変更を application.properties ファイルに保存します。

7. OpenShift CLI (oc) にログインします。

   oc login

   Copy to Clipboard Toggle word wrap

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

   oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

9. プロジェクトを OpenShift にデプロイするには、Quarkus Maven プロジェクトディレクトリーに以下のコマンドを入力します。

   ./mvnw clean package -Dquarkus.kubernetes.deploy=true

   Copy to Clipboard Toggle word wrap

10. OpenShift プロジェクトでデプロイされたすべてのアプリケーションの名前およびルートを表示するには、以下のコマンドを入力します。

    oc get route

    Copy to Clipboard Toggle word wrap

11. アプリケーションの完全な URL を表示するには、以下のコマンドを入力します。ここで、<application_name> は OpenShift プロジェクトにデプロイされたアプリケーションの名前になります。

    export URL="http://$(oc get route <application_name> -o jsonpath='{.spec.host}')"
    echo "Application URL: $URL"
    curl $URL/hello

    Copy to Clipboard Toggle word wrap

12. ルートの hello エンドポイントに HTTP 要求を実行するには、以下のコマンドを入力します。

    curl $URL/hello

    Copy to Clipboard Toggle word wrap

手順

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

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

   ARTIFACT_COPY_ARGS=-p -r lib/ *-runner.jar

   Copy to Clipboard Toggle word wrap
4. 変更をリモート Git リポジトリーにコミットし、プッシュします。

5. OpenShift CLI (oc) にログインします。

   oc login

   Copy to Clipboard Toggle word wrap

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

   oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap
   注記

   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 ページを参照してください。

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

   oc new-app ubi8/openjdk-11 <git_path> --name=<project_name>

   Copy to Clipboard Toggle word wrap
   注記

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

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

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

   oc expose service/<project_name>

   Copy to Clipboard Toggle word wrap

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

    export URL="http://$(oc get route <application_name> -o jsonpath='{.spec.host}}')"
    echo "Application URL: $URL"

    Copy to Clipboard Toggle word wrap

11. ルートの hello エンドポイントに HTTP 要求を実行するには、以下のコマンドを入力します。

    curl $URL/hello

    Copy to Clipboard Toggle word wrap
12. アプリケーションを使用するには、前のコマンドで返された URL を Web ブラウザーで入力します。

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

    oc start-build <project_name>

    Copy to Clipboard Toggle word wrap
14. ビルドの完了後にブラウザーページを更新し、変更を確認します。