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