Dev Services for Elasticsearch
Elasticsearch関連のエクステンションがある場合（例： quarkus-elasticsearch-rest-client や quarkus-hibernate-search-orm-elasticsearch ）、Dev Services for Elasticsearchは開発モードやテスト実行時に自動的にElasticsearchサーバを起動します。そのため、手動でサーバを起動する必要はありません。アプリケーションは自動的に設定されます。
Dev Services for Elasticsearchの有効化／無効化
Dev Services for Elasticsearchは、以下の場合を除き、自動的に有効化されます。
-
quarkus.devservices.enabledがfalseに設定されている場合 -
quarkus.elasticsearch.devservices.enabledがfalseに設定されている場合 -
hostsプロパティが設定されている場合。使用するエクステンションにより、次のいずれか:
-
quarkus.elasticsearch.hosts -
quarkus.hibernate-search-orm.elasticsearch.hosts
Dev Services for Elasticsearchは、サーバーの起動にDockerを利用しています。Dockerに対応していない環境では、手動でサーバを起動するか、既に起動しているサーバに接続する必要があります。
共有Elasticsearch
アプリケーション間でサーバーを共有する必要がある場合があります。Dev Services for Elasticsearchは、 開発 モードで実行されている複数のQuarkusアプリケーションが1つのサーバーを共有できるように、 サービス検出 メカニズムを実装しています。
Dev Services for Elasticsearch は、コンテナの識別に使用される quarkus-dev-service-elasticsearch ラベルでコンテナを起動します。
|
複数の（共有）サーバーが必要な場合は、 quarkus.elasticsearch.devservices.service-name 属性を設定し、サーバー名を指定することができます。同じ値を持つコンテナを探すか、見つからない場合は新規に起動します。デフォルトのサービス名は elasticsearch です。
共有は、devモードではデフォルトで有効ですが、testモードでは無効です。共有は quarkus.elasticsearch.devservices.shared=false で無効にすることができます。
ポートの設定
デフォルトでは、Dev Services for Elasticsearchはランダムなポートを選び、アプリケーションを設定します。 quarkus.elasticsearch.devservices.port プロパティを設定することで、ポートを設定することができます。
Elasticsearchのhostsプロパティは、選択したポートで自動的に構成されることに注意してください。
イメージの設定
Dev Services for Elasticsearchは、ElasticsearchとOpenSearchの両方のイメージに基づいたディストリビューションをサポートしています。
Hibernate Search を使用する場合、 Dev Services は Hibernate Search の設定に基づき、使用するデフォルトを Elasticsearch または OpenSearch から選択します。
そうでない場合、Dev ServicesはデフォルトでElasticsearchを使用します。OpenSearchを使用するには、ディストリビューションを明示的に設定してください：
quarkus.elasticsearch.devservices.distribution=opensearchデフォルトとは異なるElasticsearchやOpenSearchのイメージを使用する必要がある場合は、以下の方法で設定することができます：
quarkus.elasticsearch.devservices.image-name=docker.io/elastic/elasticsearch:8.15.0エキゾチックなイメージ名の場合、Quarkusはディストリビューションを推測できないことがあります（ elastic または opensearch ）。
このような場合、Dev Servicesの起動に失敗し、ディストリビューションを明示的に設定する必要があります：
quarkus.elasticsearch.devservices.image-name=my-custom-image-with-no-clue-about-the-distribution:1.0
quarkus.elasticsearch.devservices.distribution=elasticsearchDev Servicesの再利用
一般的なケース
開発モードセッションまたはテストスイートの実行において、 Quarkus は設定 (ユーザー名、パスワード、環境、ポートバインディングなど) が変更されない限り、常にデータベースの Elasticsearch Dev Services を再利用します。
Elasticsearch Dev Services の設定が変更されると、 Quarkus は必ず対応するコンテナーを再起動します。
開発モードのセッションまたはテストスイートの実行が終了すると、 Quarkus は (デフォルトで) Elasticsearch Dev Services を停止します。
実行を跨いだDev Servicesコンテナの再利用
Dev Service コンテナを 開発モードセッションやテストスイート実行 後も実行したままにして、
次の開発モードセッションやテストスイート実行時に再利用することも
できます。
TestContainers の再利用 を有効にするには、
TestContainers の設定ファイル (通常は ~/.testcontainers.properties あるいは C:/Users/myuser/.testcontainers.properties) に次の行を記述します。
testcontainers.reuse.enable=true|
コンテナの再利用を有効になっていても、コンテナは起動コマンドが次を変更しない場合にのみ再利用されます。 同じ環境変数 (特にユーザー名/パスワード)、同じポートバインディング… |
|
コンテナの再利用は、Elasticsearch スキーマやインデックスの内容など、 コンテナの内部状態の再利用を意味します。 それを回避する必要がある場合、およびテストがインデックスに書き込む場合、おそらく適切ではありません。 アプリケーションの起動時にスキーマとデータを再初期化することを検討してください。 Hibernate Search を使用する場合、 Hibernate Search のスキーマ管理 が 役に立つ可能性があります。 |
|
コンテナの再利用を有効にすると、新しいQuarkus開発モードセッションやテストスイートの実行を開始した後でも、古いコンテナ（特に実行可能ファイルが古い）が無期限に実行されたままになる可能性があります。 その場合、これらのコンテナを手動で停止して削除する必要があります。 |
すべてではなく一部の Quarkus アプリケーションまたは Dev Service のみでコンテナーを再利用する必要がある場合は、特定の Dev Service で設定プロパティー quarkus.elasticsearch.devservices.reuse を false に変更することで、この機能を無効にできます。
現在の制限事項
現在、Dev Services for Elasticsearchは1つのElasticsearchコンテナしか起動できないため、Hibernate Search Elasticsearchのデフォルトバックエンドのみがサポートされています。
設定リファレンス
ビルド時に固定される設定プロパティ - その他の設定プロパティは実行時にオーバーライド可能です。
Configuration property |
タイプ |
デフォルト |
||
|---|---|---|---|---|
Whether this Dev Service should start with the application in dev mode or tests. Dev Services are enabled by default
unless connection configuration (e.g. Environment variable: Show more |
ブーリアン |
|||
Optional fixed port the dev service will listen to. If not defined, the port will be chosen randomly. Environment variable: Show more |
int |
|||
The Elasticsearch distribution to use. Defaults to a distribution inferred from the explicitly configured Environment variable: Show more |
|
|||
The Elasticsearch container image to use. Defaults depend on the configured
Environment variable: Show more |
string |
|||
The value for the ES_JAVA_OPTS env variable. Environment variable: Show more |
string |
|
||
Whether the Elasticsearch server managed by Quarkus Dev Services is shared. When shared, Quarkus looks for running containers using label-based service discovery. If a matching container is found, it is used, and so a second one is not started. Otherwise, Dev Services for Elasticsearch starts a new container. The discovery uses the Container sharing is only used in dev mode. Environment variable: Show more |
ブーリアン |
|
||
The value of the This property is used when This property is used when you need multiple shared Elasticsearch servers. Environment variable: Show more |
string |
|
||
Environment variables that are passed to the container. Environment variable: Show more |
Map<String,String> |
|||
Whether to keep Dev Service containers running after a dev mode session or test suite execution to reuse them in the next dev mode session or test suite execution. Within a dev mode session or test suite execution, Quarkus will always reuse Dev Services as long as their configuration (username, password, environment, port bindings, …) did not change. This feature is specifically about keeping containers running when Quarkus is not running to reuse them across runs.
This configuration property is set to Environment variable: Show more |
ブーリアン |
|
