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

第7章 設定プロファイルの使用

お使いの環境に応じて、異なる設定プロファイルを使用できます。設定プロファイルを使用すると、同じファイルに複数の設定を含めることができ、プロファイル名を使用してそれらを選択できます。Red Hat ビルドの Quarkus には 3 つの設定プロファイルがあります。さらに、独自のカスタムプロファイルを作成することもできます。

Quarkus のデフォルトプロファイル

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

前提条件

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

手順

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

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

  2. 現在の設定プロファイルを表示するには、ProfileManager.getActiveProfile() メソッドを呼び出すログを追加します。 

    LOGGER.infof("The application is starting with profile `%s`", ProfileManager.getActiveProfile());
    Copy to Clipboard Toggle word wrap
    注記

    @ConfigProperty("quarkus.profile") メソッドを使用して、現在のプロファイルにアクセスすることはできません。

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

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

手順

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

     %<profile>.<key>=<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 システムプロパティーを使用してプロファイルを有効にするには、以下のコマンドを入力します。 

        mvn -D<key>=<value> quarkus:<profile>
        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/myapp-runner.jar
    Copy to Clipboard Toggle word wrap

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

    ./mvnw package -Dquarkus.profile=prod-aws
 java -jar target/myapp-runner.jar
    Copy to Clipboard Toggle word wrap
注記

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

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hat