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

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

設定プロファイルを使用すると、さまざまな環境に合わせてアプリケーションの動作をカスタマイズできます。プロファイルを使用すると、複数の設定値セットを定義し、実行時に特定のセットをアクティブ化できます。

Red Hat build of Quarkus には次のデフォルト設定プロファイルが含まれています。

  • dev: 開発モードで実行されているときにアクティブ化されます。
  • test: テストを実行するときにアクティブ化されます。
  • prod: 開発モードまたはテストモードで実行されていない場合に、デフォルトでアクティブ化されます。
注記

カスタム設定プロファイルを定義してアクティブ化することもできます。

プロファイル固有の設定を定義するには、以下を実行します。

  • パーセント記号とプロファイル名で始まるプロパティーキー (%custom.my.property など) を追加します。
  • プロファイル固有の設定ファイル (application-custom.properties など) を作成します。

カスタムプロファイルを有効にするには、実行時に quarkus.profile プロパティーを設定します。

詳細は、カスタム設定プロファイルの設定 を参照してください。

前提条件

  • Quarkus Maven プロジェクトを作成している。

手順

  1. プロジェクトの src/main/resources ディレクトリーにある application.properties ファイルを開きます。

  2. 次のいずれかの方法を使用して、プロファイル固有の設定を追加します。

    • プロパティーファイルにプロパティーを追加し、% と . の間に入れたプロファイル名 (dev.、%test.、%prod. など) を、そのプロパティーの接頭辞として付けます。以下に例を示します。 

      %dev.quarkus.datasource.username=devuser
%prod.quarkus.datasource.username=produser

    • または、プロファイル固有の値を格納する、プロファイル固有の設定ファイル (application-dev.properties、application-test.properties、application-prod.properties など) を作成します。

      例: application-dev.properties

      quarkus.datasource.username=devuser

  3. quarkus.profile 設定オプションをシステムプロパティーまたは環境変数として設定して、実行時にプロファイルをアクティブ化します。 

    $ ./mvnw package -Dquarkus.profile=<profile>

    <profile> は、dev、test、prod などの 1 つ以上のコンマ区切りのプロファイル名に置き換えます。

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

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

手順

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

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

     %<profile>.<property_name>=<value>

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

    設定例

    quarkus.http.port=9090
%dev.quarkus.http.port=8181

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

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

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

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

        mvn -Dquarkus.profile=<value> quarkus:dev

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

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

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

        export QUARKUS_PROFILE=<profile>

        注記

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

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

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

    ./mvnw package -Dquarkus.profile=<profile>
 java -jar target/quarkus-app/quarkus-run.jar

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

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

    ./mvnw package -Dquarkus.profile=prod-aws
 java -jar target/quarkus-app/quarkus-run.jar

注記

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

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

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

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

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

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

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

Legal Notice

Theme

© 2026 Red Hatトップに戻る