手順

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

2. OpenShift エクステンションを既存プロジェクトに追加します。

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

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

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

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

   quarkus.kubernetes-client.trust-certs=true

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

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

5. OpenShift の内部レジストリーからコンテナーイメージをプルするように OpenShift Serverless を設定するには、以下の行を application.properties ファイルに追加します。

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

6. Knative Serving のデプロイメント記述子を作成できるようにするには、以下の行を application.properties ファイルに追加します。

   quarkus.kubernetes.deployment-target=knative

7. 変更を application.properties ファイルに保存します。

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

   oc login

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

   oc new-project <project_name>

   注記

   <project_name> は、ホストシステムの username と同じである必要があります。同じでない場合、Quarkus はイメージレジストリーからイメージをプルできません。別の <project_name> を設定する場合は、以下の行を application.properties ファイルに必ず追加します。

   quarkus.container-image.group=<project_name>

10. プロジェクトを OpenShift にデプロイするには、以下のコマンドを入力します。

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

11. アプリケーションが正常にデプロイされたことを確認するには、以下のコマンドを実行します。

    kn service list

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

     kn route describe <application_name> -o jsonpath='{.status.url}'

手順

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

2. 以下のいずれかの方法を使用して、Linux 実行可能ファイルをビルドします。

   1. Docker を使用する場合

      ./mvnw package -Pnative -Dquarkus.native.container-build=true -Dquarkus.native.builder-image=registry.access.redhat.com/quarkus/mandrel-20-rhel8:20.3

   2. Podman を使用する場合

      ./mvnw package -Pnative -Dquarkus.native.container-build=true -Dquarkus.native.container-runtime=podman -Dquarkus.native.builder-image=registry.access.redhat.com/quarkus/mandrel-20-rhel8:20.3

3. src/main/docker/Dockerfile.native ファイルを開き、<image_name> パラメーターおよび <version> パラメーターを設定します。

   1. Docker を使用する場合

      docker build -f src/main/docker/Dockerfile.native -t <image_name>:<version> .

   2. Podman を使用する場合

      podman build -f src/main/docker/Dockerfile.native -t <image_name>:<version>.

4. CI 環境および OpenShift 環境がアクセスできるリポジトリーにコンテナーをプッシュします。ここで、<registry> はレジストリーの URL になります。

   1. Docker を使用する場合

      docker tag <image_name>:<version> <registry>/<image_name>:<version>
      docker push <registry>/<image_name>:<version>

   2. Podman を使用する場合

      podman tag <image_name>:<version> <registry>/<image_name>:<version>
      podman push <registry>/<image_name>:<version>

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

   oc login

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

   oc new-project <project_name>

7. OpenShift Serverless CLI (kn) を使用して、サーバーレスアプリケーションとしてコンテナーをデプロイするには、以下のコマンドを入力します。<service_name> は、お使いのサービスの名前に置き換えます。

   kn service create <service_name> --image REPOSITORY/<image_name>:<version>

8. サービスの準備ができていることを確認するには、以下のコマンドを入力します。

   kn service list <service_name>

   サービスの準備ができている場合は、「READY」と呼ばれる列の出力に true と表示されます。

   注記

   イメージがプルダウンされて準備ができたときではなく、必要なコンポーネントが作成されるときに、kn service コマンドは true を返します。