The English version of quarkus.io is the official project site. Translated sites are community supported on a best-effort basis.
Back to Guides
このページを編集

Docker ビルドストラテジーを使用した OpenShift への Quarkus Java アプリケーションのデプロイ

As an application developer, you can deploy your applications to OpenShift by using the Docker build strategy as a deployment option.

This strategy builds the artifacts outside the OpenShift cluster, either locally or in a CI environment, and provides them to the OpenShift build system together with a Dockerfile. The artifacts include JAR files or a native executable. The OpenShift cluster builds the container image and provides it as an image stream.

This functionality is provided by the quarkus-openshift extension. If you want to use a custom Dockerfile, add the file to the src/main/docker directory or another location inside the module. Set the path to your Dockerfile with the quarkus.openshift.jvm-dockerfile property.

前提条件

  • OpenJDK 17, 21, or 25 がインストールされていること

  • 環境変数 JAVA_HOME をJava SDKの場所に設定していること

  • Apache Maven 3.9.15がインストールされていること

  • Quarkusプロジェクトには、 quarkus-openshift エクステンション含まれていること

  • OpenShift クラスタにアクセスでき、 oc CLIツールの最新互換バージョンがインストールされていること

  • 正しい OpenShift プロジェクトの名前空間で作業していること

手順

  1. Set the Docker build strategy in your application.properties file:

    quarkus.openshift.build-strategy=docker

  2. Optional: Complete one or more of the following configuration steps in the application.properties file:

    • 信頼されていない証明書を使用している場合は、 KubernetesClient の証明書の信頼を有効にします：

      quarkus.kubernetes-client.trust-certs=true

    • サービスを公開し、 OpenShift ルートを作成するには、以下のプロパティを設定します：

      quarkus.openshift.route.expose=true

    • To use a custom Dockerfile instead of the pre-generated Dockerfiles, set the path to your Dockerfile:

      quarkus.openshift.jvm-dockerfile=<path_to_your_dockerfile>

      For example, to specify a custom Dockerfile named Dockerfile.custom-jvm, set the following property:

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

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

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

検証

以下の検証ステップでは、 openshift-helloworld サンプル・アプリケーションを使用します。

  1. 現在の OpenShift プロジェクトに関連付けられたポッドのリストを表示します：

    oc get pods
    NAME                            READY   STATUS      RESTARTS   AGE
openshift-helloworld-1-build    0/1     Completed   0          11m
openshift-helloworld-1-deploy   0/1     Completed   0          10m
openshift-helloworld-1-gzzrx    1/1     Running     0          10m

  2. To get the log output from your application’s pod, run the oc logs -f command with the pod name. The following example uses the openshift-helloworld-1-gzzrx pod name, which corresponds to the latest pod prefixed with the application name:

    oc logs -f openshift-helloworld-1-gzzrx
    Starting the Java application using /opt/jboss/container/java/run/run-java.sh ...
INFO exec -a "java" java -Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager -XX:MaxRAMPercentage=50.0 -XX:+UseParallelGC -XX:MinHeapFreeRatio=10 -XX:MaxHeapFreeRatio=20 -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -XX:+ExitOnOutOfMemoryError -cp "." -jar /deployments/quarkus-run.jar
__  ____  __  _____   ___  __ ____  ______
--/ __ \/ / / / _ | / _ \/ //_/ / / / __/
-/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
2024-09-17 10:23:25,254 INFO  [io.quarkus] (main) getting-started 1.0.0-SNAPSHOT on JVM (powered by Quarkus {QuarkusCore}) started in 0.653s. Listening on: http://0.0.0.0:8080
2024-09-17 10:23:25,281 INFO  [io.quarkus] (main) Profile prod activated.
2024-09-17 10:23:25,281 INFO  [io.quarkus] (main) Installed features: [cdi, kubernetes, rest, smallrye-context-propagation, vertx]

  3. Display the list of services:

    oc get svc
    NAME                   TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                               AGE
openshift-helloworld   ClusterIP   172.30.64.57     <none>        80/TCP                                14m

  4. Get a URL to test your application. To do so, ensure that you exposed an OpenShift route by setting the quarkus.openshift.route.expose=true property in the application.properties file before building the application:

    oc get routes
    NAME                   HOST/PORT                                                                   PATH   SERVICES               PORT   TERMINATION   WILDCARD
openshift-helloworld   openshift-helloworld-username-dev.apps.sandbox-m2.ll9k.p1.openshiftapps.com          openshift-helloworld   http                 None

    Be aware that the route listens on port 80 and no longer listens on port 8080.

    You can test the application in this example with a web browser or from a terminal. Use the complete URL from oc get routes, for example http://openshift-helloworld-username-dev.apps.sandbox-m2.ll9k.p1.openshiftapps.com.

    例えば、以下のようになります:

    curl http://openshift-helloworld-username-dev.apps.sandbox-m2.ll9k.p1.openshiftapps.com

参照

関連コンテンツ

同じエクステンションについて

同じトピックについて

Quarkus はオープンです。このプロジェクトのすべての依存関係は、Apache Software License 2.0 または互換性のあるライセンスの下で利用可能です。 CC by 3.0

このウェブサイトは Jekyll で構築され、GitHub Pages でホストされており、完全にオープンソースです。改善したい場合は、ウェブサイトをフォークして、あなたのアイデアを見せてください。

ナビゲーション
フォローする
ヘルプ
言語
Quarkusはコミュニティプロジェクトで構成されています
Copyright © Quarkus. 全著作権所有。当社の商標の詳細については、商標ポリシーおよび商標リストをご覧ください。第三者の商標は、それぞれの所有者に帰属し、ここに記載されていることは、いかなる推奨や関連も示唆するものではありません。