第5章 OpenShift Serverless サービスとしての Quarkus アプリケーションのデプロイ

手順

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