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

S2Iを使用したQuarkusアプリケーションのOpenShiftへのデプロイ

Quarkus のアプリケーションを OpenShift にデプロイするには、Source-to-Image (S2I) メソッドを使用します。S2Iでは、Gitリポジトリを通して、あるいはビルド時にソースコードをアップロードして、ビルドコンテナにソースコードを提供する必要があります。

Quarkus アプリケーションを Java 17, 21, or 25 で OpenShift にデプロイできます。

前提条件

  • Java 17, 21, or 25 で構築された Quarkus アプリケーションがあります。

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

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

  • プロジェクトがGitリポジトリにホストされていること

手順

  1. Open the pom.xml file, and set the Java version, where ${java.version} is 17, 21, or 25.

    <maven.compiler.release>${java.version}</maven.compiler.release>

  2. 以下のコマンドを入力して、アプリケーションをパッケージ化します。

    ./mvnw clean package

  3. pom.xml ファイルと同じ階層に .s2i というディレクトリを作成します。

  4. .s2i ディレクトリに environment というファイルを作成し、以下の内容を追加します：

    MAVEN_S2I_ARTIFACT_DIRS=target/quarkus-app
S2I_SOURCE_DEPLOYMENTS_FILTER=app lib quarkus quarkus-run.jar
JAVA_OPTIONS=-Dquarkus.http.host=0.0.0.0
AB_JOLOKIA_OFF=true
JAVA_APP_JAR=/deployments/quarkus-run.jar

  5. 変更をコミットして、リモートの Git リポジトリにプッシュします。

  6. サポートされている OpenShift イメージをインポートします。

    • Java 17:

      oc import-image ubi9/openjdk-17 --from=registry.access.redhat.com/ubi9/openjdk-17 --confirm

    • Java 21:

      oc import-image ubi9/openjdk-21 --from=registry.access.redhat.com/ubi9/openjdk-21 --confirm

    • Java 25:

      oc import-image ubi9/openjdk-25 --from=registry.access.redhat.com/ubi9/openjdk-25 --confirm

      • OpenShiftのイメージレジストリを使用し、同じプロジェクト内のイメージストリームからプルしている場合、ポッドのサービスアカウントはすでに正しいパーミッションを持っている必要があります。

      • 他の OpenShift プロジェクトや保護されたレジストリからイメージを引っ張ってくる場合は、追加の設定手順が必要になるかもしれません。

        詳細は、 Red Hat Openshift Container Platform のドキュメントを参照してください。

      • IBM Z インフラストラクチャにデプロイする場合は、代わりに oc import-image ubi9/openjdk-21 --from=registry.redhat.io/ubi9/openjdk-21 --confirm を入力します。このイメージに関する情報は、 UBI9 上の OpenJDK 21 ランタイムイメージ を参照してください。

  7. プロジェクトをビルドし、アプリケーションを作成し、OpenShift サービスをデプロイします。

    • Java 17:

      oc new-app registry.access.redhat.com/ubi9/openjdk-17~<git_path> --name=<project_name>

    • Java 21:

      oc new-app registry.access.redhat.com/ubi9/openjdk-21~<git_path> --name=<project_name>

    • Java 25:

      oc new-app registry.access.redhat.com/ubi9/openjdk-25~<git_path> --name=<project_name>

      1. Replace <git_path> with the path of the Git repository that hosts your Quarkus project.

        For example, for Java 21:

        oc new-app registry.access.redhat.com/ubi9/openjdk-21~https://github.com/johndoe/code-with-quarkus.git --name=code-with-quarkus

         

        Git リポジトリに SSH 鍵を設定していない場合は、Git のパスを指定する際に SSH URL ではなく HTTPS URL を使ってください。

      2. <project_name> をアプリケーション名に置き換えてください。

        IBM Zインフラストラクチャにデプロイする場合は、代わりに oc new-app ubi9/openjdk-21~<git_path> --name=<project_name> を入力してください。

  8. プロジェクトの更新版をデプロイするには、変更をGitリポジトリにプッシュしてから実行します：

    oc start-build <project_name>

  9. アプリケーションへのルートを公開するには、以下のコマンドを実行します:

    oc expose svc <project_name>

検証

  1. 現在の OpenShift プロジェクトに関連するポッドを一覧表示します：

    oc get pods

  2. アプリケーションのポッドのログ出力を取得するには、次のコマンドを実行します。 <pod_name> を最新のポッドの名前に置き換え、その前にアプリケーション名を付けます：

    oc logs -f <pod_name>

参照

関連コンテンツ

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

同じトピックについて

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

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

ナビゲーション
フォローする
ヘルプ
言語
Quarkusはコミュニティプロジェクトで構成されています
Copyright © Quarkus. All rights reserved. For details on our trademarks, please visit our Trademark Policy and Trademark List. Trademarks of third parties are owned by their respective holders and their mention here does not suggest any endorsement or association.