Deploying Quarkus applications compiled to native executables
You can deploy your native Quarkus applications to OpenShift compiled to native executables by using the Docker build strategy.
You must create a native executable for your application that targets a supported operating system and match the architecture. This means, if you are building on Windows, you create a native Linux executable by using a container runtime, for example, Docker or Podman.
Your Quarkus project includes pregenerated Dockerfiles with instructions.
If you want to use a custom Dockerfile, add the file to the src/main/docker directory or any location inside the module.
Additionally, if you want to have multiple Docker files and switch between them, set the path to your preferred Dockerfile by using the quarkus.openshift.native-dockerfile property.
|
This guide describes this strategy by using a Quarkus project with Maven as the example project. |
前提条件
-
A supported operating system or an Open Container Initiative (OCI) compatible container runtime, such as Podman or Docker.
-
You have a Quarkus Maven project that includes the
quarkus-openshiftextension. -
OpenShift クラスタにアクセスでき、
ocCLIツールの最新互換バージョンがインストールされていること -
正しい OpenShift プロジェクトの名前空間で作業していること
手順
-
application.properties設定ファイルで Docker ビルドストラテジーを設定します：quarkus.openshift.build-strategy=docker -
Enable container-based native builds:
quarkus.native.container-build=true -
Optional: Set the following properties in the
application.propertiesfile based on your environment:-
信頼されていない証明書を使用している場合は、
KubernetesClientの証明書の信頼を有効にします：quarkus.kubernetes-client.trust-certs=true -
サービスを公開し、 OpenShift ルートを作成するには、以下のプロパティを設定します：
quarkus.openshift.route.expose=true -
To use a custom Dockerfile instead of the pregenerated Dockerfiles, set the path to your custom Dockerfile:
quarkus.openshift.native-dockerfile=<path_to_your_dockerfile>For example, to specify a custom Dockerfile named
Dockerfile.custom-native:quarkus.openshift.native-dockerfile=src/main/docker/Dockerfile.custom-native -
Specify the container engine:
-
To build a native executable with Podman:
quarkus.native.container-runtime=podman -
To build a native executable with Docker:
quarkus.native.container-runtime=docker
-
-
-
Finally, build the native executable, package, and deploy your application to OpenShift:
./mvnw clean package -Pnative -Dquarkus.openshift.deploy=true
検証
-
Verify that an image stream and a service resource are created, and that the application is deployed. Use the OpenShift web console or the following OpenShift command-line interface (CLI) commands:
oc get is (1) oc get pods (2) oc get svc (3)1 作成されたイメージストリームを一覧表示します。 2 現在の OpenShift プロジェクトに関連するポッドを一覧表示します。 3 Kubernetesサービスをリストアップします。
-
To get the log output for your application’s pod, run the following command where
<pod_name>is the name of the latest pod prefixed with the name of your application:oc logs -f <pod_name>
