Quarkus アプリケーションの OpenShift へのデプロイ

手順

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

2. 以下の方法のいずれかを使用して、プロジェクトに quarkus-openshift エクステンションを追加します。

   1. quarkus-openshift エクステンションを pom.xml ファイルに追加します。

      pom.xml

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

      Copy to Clipboard Toggle word wrap

   2. コマンドラインを使用して quarkus-openshift エクステンションを追加します。

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

      Copy to Clipboard Toggle word wrap

手順

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

2. application.properties ファイルで以下のプロパティーを設定します。

   1. Docker ビルドストラテジーを設定します。

      quarkus.openshift.build-strategy=docker

      Copy to Clipboard Toggle word wrap

   2. (オプション) 信頼されていない証明書を使用している場合は、KubernetesClient を設定します。

      quarkus.kubernetes-client.trust-certs=true

      Copy to Clipboard Toggle word wrap

   3. (オプション) サービスを公開して OpenShift ルートを作成します。

      quarkus.openshift.expose=true

      Copy to Clipboard Toggle word wrap

   4. (オプション) カスタム Dockerfile へのパスを設定します。

      quarkus.openshift.jvm-dockerfile=<path_to_your_dockerfile>

      Copy to Clipboard Toggle word wrap

      以下の例は、Dockerfile.custom-jvm へのパスを示しています。

      quarkus.openshift.jvm-dockerfile=src/main/resources/Dockerfile.custom-jvm

      Copy to Clipboard Toggle word wrap

3. Quarkus アプリケーションをパッケージ化し、現在の OpenShift プロジェクトにデプロイします。

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

   Copy to Clipboard Toggle word wrap

検証

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

   oc get pods

   Copy to Clipboard Toggle word wrap

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

   oc logs -f <pod_name>

   Copy to Clipboard Toggle word wrap

手順

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

2. application.properties ファイルで以下のプロパティーを設定します。

   1. Docker ビルドストラテジーを設定します。

      quarkus.openshift.build-strategy=docker

      Copy to Clipboard Toggle word wrap

   2. コンテナーランタイムを設定します。

      quarkus.native.container-build=true

      Copy to Clipboard Toggle word wrap

   3. (オプション) 信頼されていない証明書を使用している場合は、KubernetesClient を設定します。

      quarkus.kubernetes-client.trust-certs=true

      Copy to Clipboard Toggle word wrap

   4. (オプション) サービスを公開して OpenShift ルートを作成します。

      quarkus.openshift.expose=true

      Copy to Clipboard Toggle word wrap

   5. (オプション) カスタム Dockerfile へのパスを設定します。

      quarkus.openshift.native-dockerfile=<path_to_your_dockerfile>

      Copy to Clipboard Toggle word wrap

      以下の例は、Dockerfile.custom-native へのパスを示しています。

      quarkus.openshift.jvm-dockerfile=src/main/docker/Dockerfile.custom-native

      Copy to Clipboard Toggle word wrap

   6. (オプション) コンテナーエンジンを指定し、以下を実行します。

      • Podman を使用してネイティブ実行可能ファイルをビルドします。

        quarkus.native.container-runtime=podman

        Copy to Clipboard Toggle word wrap

      • Docker を使用してネイティブ実行可能ファイルをビルドします。

        quarkus.native.container-runtime=docker

        Copy to Clipboard Toggle word wrap

3. ネイティブ実行可能ファイルをビルドし、アプリケーションをパッケージ化して OpenShift にデプロイします。

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

   Copy to Clipboard Toggle word wrap

検証

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

   oc get pods

   Copy to Clipboard Toggle word wrap

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

   oc logs -f <pod_name>

   Copy to Clipboard Toggle word wrap

手順

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

2. application.properties ファイルで以下のプロパティーを設定します。

   1. Knative をデプロイメントターゲットとして設定します。

      quarkus.kubernetes.deployment-target=knative

      Copy to Clipboard Toggle word wrap

   2. Docker ビルドストラテジーを設定します。

      quarkus.openshift.build-strategy=docker

      Copy to Clipboard Toggle word wrap

   3. OpenShift 内部レジストリーからコンテナーイメージをプルするように OpenShift Serverless に指示します。

      quarkus.container-image.registry=image-registry.openshift-image-registry.svc:5000

      Copy to Clipboard Toggle word wrap
      注記

      OpenShift <project_name> がホストシステムの username と異なる場合は、コンテナーイメージのグループを設定します。設定しない場合は、Quarkus はイメージレジストリーからイメージをプルできません。

      quarkus.container-image.group=<project_name>

      Copy to Clipboard Toggle word wrap

   4. (オプション) 信頼されていない証明書を使用している場合は、KubernetesClient を設定します。

      quarkus.kubernetes-client.trust-certs=true

      Copy to Clipboard Toggle word wrap

   5. (オプション) サービスを公開して OpenShift ルートを作成します。

      quarkus.openshift.expose=true

      Copy to Clipboard Toggle word wrap

   6. (オプション) カスタム Dockerfile へのパスを設定します。

      quarkus.openshift.jvm-dockerfile=<path_to_your_dockerfile>

      Copy to Clipboard Toggle word wrap

      以下の例は、Dockerfile.custom-jvm へのパスを示しています。

      quarkus.openshift.jvm-dockerfile=src/main/resources/Dockerfile.custom-jvm

      Copy to Clipboard Toggle word wrap

3. (オプション) ネイティブ実行可能ファイルにコンパイルされた Serverless アプリケーションをデプロイするには、以下のプロパティーを設定する必要があります。

   1. コンテナーランタイムを設定します。

      quarkus.native.container-build=true

      Copy to Clipboard Toggle word wrap

   2. コンテナーエンジンを指定します。

      • Podman を使用してネイティブ実行可能ファイルをビルドします。

        quarkus.native.container-runtime=podman

        Copy to Clipboard Toggle word wrap

      • Docker を使用してネイティブ実行可能ファイルをビルドします。

        quarkus.native.container-runtime=docker

        Copy to Clipboard Toggle word wrap

   3. (オプション) カスタム Dockerfile へのパスを設定します。

      quarkus.openshift.native-dockerfile=<path_to_your_dockerfile>

      Copy to Clipboard Toggle word wrap

4. 以下のオプションのいずれかを使用して、Serverless アプリケーションをパッケージ化して OpenShift にデプロイします。

   1. Quarkus Java アプリケーションをデプロイします。

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

      Copy to Clipboard Toggle word wrap

   2. Quarkus ネイティブアプリケーションをデプロイします。

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

      Copy to Clipboard Toggle word wrap

検証

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

   oc get pods

   Copy to Clipboard Toggle word wrap

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

   oc logs -f <pod_name>

   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 イメージをインポートするには、以下のコマンドを入力します。

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

6. 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 サービスのデプロイが行われます。

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

   oc start-build <project_name>

   Copy to Clipboard Toggle word wrap

検証

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

   oc get pods

   Copy to Clipboard Toggle word wrap

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

   oc logs -f <pod_name>

   Copy to Clipboard Toggle word wrap

手順

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

   oc login

   Copy to Clipboard Toggle word wrap

2. 現在のプロジェクトスペースを表示します。

   oc project -q

   Copy to Clipboard Toggle word wrap

3. (オプション) 新しい OpenShift プロジェクトを作成します。

   oc new-project <project_name>

   Copy to Clipboard Toggle word wrap