第1章 プロパティーファイルを使用して Red Hat build of Quarkus アプリケーションを設定する
アプリケーション開発者は、Red Hat build of Quarkus を使用して、OpenShift 環境およびサーバーレス環境で実行される、Java で書かれたマイクロサービスベースのアプリケーションを作成できます。ネイティブ実行可能ファイルにコンパイルされたアプリケーションは、メモリーのフットプリントが小さく、起動時間は高速です。
次のいずれかの方法を使用して、Quarkus アプリケーションを設定できます。
-
application.propertiesファイルのプロパティーを設定する -
application.yamlファイルを更新することで、YAML フォーマットで構造化設定を適用する
次の手順を実行して、アプリケーションの設定を拡張およびカスタマイズすることもできます。
- プロパティー式を使用して、設定プロパティー値の置き換えまたは設定を行います。
- さまざまな外部ソースから設定値を読み取るカスタム設定ソースコンバーターを使用して、MicroProfile 準拠のクラスを実装します。
- 設定プロファイルを使用して、開発環境、テスト環境、実稼働環境用に個別の設定値のセットを維持します。
この手順には、Quarkus config-quickstart 演習を使用して作成された設定例が含まれています。
前提条件
OpenJDK 17 または 21 をインストールし、
JAVA_HOME環境変数を設定して Java SDK の場所を指定している。- Red Hat build of OpenJDK をダウンロードするには、Red Hat カスタマーポータルにログインし、ソフトウェアダウンロード に移動します。
Apache Maven 3.8.6 以降がインストールされている。
- Maven は Apache Maven Project の Web サイトからダウンロードできます。
Maven を、Quarkus Maven repository のアーティファクトを使用するように設定している。
- Maven の設定方法は、Quarkus スタートガイド を参照してください。
1.1. 設定オプション リンクのコピーリンクがクリップボードにコピーされました!
アプリケーションの設定を 1 つの設定ファイルで管理できます。さらに、設定プロファイルを定義して、開発、テスト、運用などのさまざまな環境の関連設定をグループ化することもできます。この方法では、メインの設定ファイルを変更せずに、プロファイルを簡単に切り替えて、環境固有のプロパティーを適用できます。
デフォルトでは、Quarkus は src/main/resources ディレクトリーにある application.properties ファイルからプロパティーを読み取ります。代わりに、application.yaml ファイルでアプリケーションプロパティーを設定および管理する場合は、プロジェクトの pom.xml ファイルに quarkus-config-yaml 依存関係を追加します。詳細は、YAML 設定サポートを追加する を参照してください。
Red Hat build of Quarkus は MicroProfile Config もサポートしており、これを使用してさまざまなソースからアプリケーションの設定を読み込むことができます。Eclipse MicroProfile プロジェクトの MicroProfile Config 仕様 を使用すると、設定プロパティーをアプリケーションに挿入し、コードで定義されたメソッドを使用してそれらにアクセスできます。
Quarkus は、次のようなさまざまなオリジンからのアプリケーションプロパティーを読み取ることができます。
- ファイルシステム
- データベース
-
Kubernetes または OpenShift Container Platform の
ConfigMapまたはSecretオブジェクト - Java アプリケーションがロードできるソース