Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

1.9. 設定プロファイルの使用

お使いの環境に応じて、異なる設定プロファイルを使用できます。設定プロファイルを使用すると、同じファイルに複数の設定を含めることができ、プロファイル名を使用してそれらを選択できます。

Red Hat build of Quarkus には、次の 3 つのデフォルト設定プロファイルがあります。

  • dev: 開発モードでのアクティブ化
  • test: テストの実行時のアクティブ化
  • prod: 開発またはテストモードで実行されていない場合のデフォルトプロファイル
注記

さらに、独自のカスタムプロファイルを作成することもできます。

前提条件

Quarkus Maven プロジェクトがある。

手順

  1. Java リソースファイルを開き、以下のインポートステートメントを追加します。 

    import io.quarkus.runtime.configuration.ConfigUtils;
    Copy to Clipboard Toggle word wrap

  2. 現在のプロファイルのリストを取得するには、ConfigUtils.getProfiles() メソッドを呼び出してログを追加します。 

    LOGGER.infof("The application is starting with profiles `%s`", ConfigUtils.getProfiles());
    Copy to Clipboard Toggle word wrap

1.9.1. カスタム設定プロファイルの設定
リンクのコピー

設定プロファイルは、必要なだけ作成できます。同じファイル内に複数の設定を含めることができ、プロファイル名を使用して設定を選択できます。

手順

  1. カスタムプロファイルを設定するには、application.properties ファイルのプロファイル名で設定プロパティーを作成します。<property_name> はプロパティー名に、<value> はプロパティーの値に、そして <profile> はプロファイル名に置き換えます。

    設定プロパティーを作成します

     %<profile>.<property_name>=<value>
    Copy to Clipboard Toggle word wrap

    以下の設定例では、quarkus.http.port の値はデフォルトで 9090 で、dev プロファイルがアクティブ化されると 8181 になります。

    設定例

    quarkus.http.port=9090
%dev.quarkus.http.port=8181
    Copy to Clipboard Toggle word wrap

  2. プロファイルを有効にするには、以下のいずれかの方法を使用します。

    • quarkus.profile システムプロパティーを設定します。

      • quarkus.profile システムプロパティーを使用してプロファイルを有効にするには、以下のコマンドを入力します。

        quarkus.profile プロパティーを使用して、プロファイルを有効にします

        mvn -Dquarkus.profile=<value> quarkus:dev
        Copy to Clipboard Toggle word wrap

    • QUARKUS_PROFILE 環境変数を設定します。

      • 環境変数を使用してプロファイルを有効にするには、以下のコマンドを入力します。

        環境変数を使用してプロファイルを有効にします

        export QUARKUS_PROFILE=<profile>
        Copy to Clipboard Toggle word wrap

        注記

        システムプロパティーの値は環境変数の値よりも優先されます。

  3. アプリケーションを再パッケージしてプロファイルを変更するには、以下のコマンドを入力します。

    プロフィールを変更します

    ./mvnw package -Dquarkus.profile=<profile>
 java -jar target/quarkus-app/quarkus-run.jar
    Copy to Clipboard Toggle word wrap

    以下の例は、prod-aws プロファイルをアクティブ化するコマンドを示しています。

    プロファイルをアクティブにするコマンドの例

    ./mvnw package -Dquarkus.profile=prod-aws
 java -jar target/quarkus-app/quarkus-run.jar
    Copy to Clipboard Toggle word wrap

注記

Quarkus アプリケーションのデフォルトのランタイムプロファイルは、アプリケーションのビルドに使用されるプロファイルに設定されます。Red Hat build of Quarkus は、環境モードに応じてプロファイルを自動的に選択します。たとえば、JAR としてアプリケーションを実行中の場合、Quarkus は prod モードになります。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る