第6章 設定プロパティーの設定
デフォルトでは、Quarkus は src/main/resources ディレクトリーにある application.properties ファイルからプロパティーを読み取ります。ビルドプロパティーを変更する場合は、アプリケーションを必ず再パッケージしてください。
Quarkus はビルド時にほとんどのプロパティーを設定します。エクステンションはプロパティーを実行時に上書き可能であると定義できます (例: データベース URL、ユーザー名、ターゲット環境に固有のパスワード)。
前提条件
- Quarkus Maven プロジェクトがある。
手順
Quarkus プロジェクトをパッケージ化するには、以下のコマンドを入力します。
./mvnw clean package
./mvnw clean packageCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のメソッドのいずれかを使用して、設定プロパティーを設定します。
システムプロパティーの設定
以下のコマンドを入力します。
<key>は追加する設定プロパティーの名前に、<value>はプロパティーの値に置き換えます。java -D<key>=<value> -jar target/myapp-runner.jar
java -D<key>=<value> -jar target/myapp-runner.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow たとえば、
quarkus.datasource.passwordプロパティーの値を設定するには、以下のコマンドを入力します。java -Dquarkus.datasource.password=youshallnotpass -jar target/myapp-runner.jar
java -Dquarkus.datasource.password=youshallnotpass -jar target/myapp-runner.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow 環境変数の設定
以下のコマンドを入力します。
<key>は設定する設定プロパティーの名前に、<value>はプロパティーの値に置き換えます。export <key>=<value> ; java -jar target/myapp-runner.jar
export <key>=<value> ; java -jar target/myapp-runner.jarCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記環境変数名は、Eclipse MicroProfile の変換ルールに従います。名前を大文字に変換し、英数字以外の文字をすべてアンダースコア (
_) に置き換えます。環境ファイルの使用
現在の作業ディレクトリーに
.envファイルを作成し、設定プロパティーを追加します。<PROPERTY_KEY>はプロパティー名に、<value>はプロパティーの値に置き換えます。<PROPERTY_KEY>=<value>
<PROPERTY_KEY>=<value>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記開発モードでは、このファイルはプロジェクトの root ディレクトリーに置かれますが、バージョン管理でファイルを追跡しないことが推奨されます。プロジェクトのルートディレクトリーに
.envファイルを作成する場合は、プログラムがプロパティーとして読み取るキーおよび値を定義できます。application.propertiesファイルを使用します。アプリケーションが実行される
$PWD/config/application.propertiesディレクトリーに設定ファイルを配置し、そのファイルに定義されたランタイムプロパティーがデフォルト設定を上書きできるようにします。注記開発モードで
config/application.properties機能を使用することもできます。config/application.propertiesをtargetディレクトリーに配置します。ビルドツールからのクリーニング操作 (例:mvn clean) は、configディレクトリーも削除します。