プロパティの構成

以下に構成プロパティのリストを示します。

名前 デフォルト 説明

spring.cloud.compatibility-verifier.compatible-boot-versions

3.4.x

Spring Boot 依存関係のデフォルトで受け入れられるバージョン。具体的な値を指定したくない場合は、パッチバージョンに {@code x} を設定できます。例: {@ コード 3.4.x}

spring.cloud.compatibility-verifier.enabled

false

Spring Cloud 互換性検証の作成を有効にします。

spring.cloud.config.allow-override

true

{@link #isOverrideSystemProperties()systemPropertiesOverride} を使用できることを示すフラグ。ユーザーが誤ってデフォルトを変更しないようにするには、false に設定します。デフォルトは true です。

spring.cloud.config.initialize-on-context-refresh

false

コンテキストリフレッシュイベントでブートストラップ構成を初期化するフラグ。デフォルトは false。

spring.cloud.config.override-none

false

{@link #setAllowOverride(boolean) allowedOverride} が true の場合、外部プロパティの優先順位が最も低くなり、既存のプロパティソース (ローカル構成ファイルを含む) をオーバーライドしてはならないことを示すフラグ。デフォルトは false。これは、config first bootstrap を使用する場合にのみ効果があります。

spring.cloud.config.override-system-properties

true

外部プロパティがシステムプロパティをオーバーライドする必要があることを示すフラグ。デフォルトは true です。

spring.cloud.decrypt-environment-post-processor.enabled

true

DecryptEnvironmentPostProcessor を有効にします。

spring.cloud.discovery.client.composite-indicator.enabled

true

ディスカバリクライアントの複合ヘルスインジケータを有効にします。

spring.cloud.discovery.client.health-indicator.enabled

true

spring.cloud.discovery.client.health-indicator.include-description

false

spring.cloud.discovery.client.health-indicator.use-services-query

true

インジケーターがそのヘルスをチェックするために {@ linkDiscoveryClient#getServices} を使用する必要があるかどうか。{@code false} に設定すると、インジケーターは代わりにライターの {@link DiscoveryClient#probe()} を使用します。これは、返されるサービスの数によって操作が不必要に重くなる大規模なデプロイで役立ちます。

spring.cloud.discovery.client.simple.instances

spring.cloud.discovery.client.simple.local.host

spring.cloud.discovery.client.simple.local.instance-id

spring.cloud.discovery.client.simple.local.metadata

spring.cloud.discovery.client.simple.local.port

0

spring.cloud.discovery.client.simple.local.secure

false

spring.cloud.discovery.client.simple.local.service-id

spring.cloud.discovery.client.simple.local.uri

spring.cloud.discovery.client.simple.order

spring.cloud.discovery.enabled

true

ディスカバリクライアントのヘルスインジケータを有効にします。

spring.cloud.features.enabled

true

関数エンドポイントを有効にします。

spring.cloud.httpclientfactories.apache.enabled

true

Apache Http クライアントファクトリ Bean の作成を有効にします。

spring.cloud.httpclientfactories.ok.enabled

true

OKHttp クライアントファクトリ Bean の作成を有効にします。

spring.cloud.hypermedia.refresh.fixed-delay

5000

spring.cloud.hypermedia.refresh.initial-delay

10000

spring.cloud.inetutils.default-hostname

localhost

デフォルトのホスト名。エラーの場合に使用されます。

spring.cloud.inetutils.default-ip-address

127.0.0.1

デフォルトの IP アドレス。エラーの場合に使用されます。

spring.cloud.inetutils.ignored-interfaces

無視されるネットワークインターフェースの Java 正規表現のリスト。

spring.cloud.inetutils.preferred-networks

優先されるネットワークアドレスの Java 正規表現のリスト。

spring.cloud.inetutils.timeout-seconds

1

ホスト名を計算するためのタイムアウト(秒単位)。

spring.cloud.inetutils.use-only-site-local-interfaces

false

サイトのローカルアドレスを持つインターフェースのみを使用するかどうか。詳細については、{@ link InetAddress#isSiteLocalAddress()} を参照してください。

spring.cloud.loadbalancer.cache.caffeine.spec

キャッシュの作成に使用する仕様。スペック形式の詳細については、CaffeineSpec を参照してください。

spring.cloud.loadbalancer.cache.capacity

256

int として表される初期キャッシュ容量。

spring.cloud.loadbalancer.cache.enabled

true

Spring Cloud LoadBalancer キャッシュメカニズムを有効にします。

spring.cloud.loadbalancer.cache.ttl

35s

Time To Live - レコードの書き込みからカウントされた時間。この時間が経過するとキャッシュエントリは期限切れになります。{@link Duration} として表されます。プロパティ {@link String} は、Spring Boot <code>StringToDurationConverter</code> で指定されている適切な構文に準拠している必要があります。@see <a href= "https://github.com/spring-projects/spring-boot/blob/master/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/convert/StringToDurationConverter.java">StringToDurationConverter.java</a>

spring.cloud.loadbalancer.call-get-with-request-on-delegates

true

このフラグが {@code true} に設定されている場合、{@code ServiceInstanceListSupplier#get(Request request)} メソッドは、{@code DelegatingServiceInstanceListSupplier} から割り当て可能なクラスで {@code delegate.get(request)} を呼び出すように実装されます。{@code CachingServiceInstanceListSupplier} と {@code HealthCheckServiceInstanceListSupplier} を除いて、そのメソッドはまだ実装されていません。これらは、サプライヤーがネットワーク経由でインスタンスの取得を実行した直後、リクエストベースのフィルタリングが行われる前に、インスタンスサプライヤー階層に直接配置される必要があります。完了しました。デフォルトでは {@code true}。

spring.cloud.loadbalancer.clients

spring.cloud.loadbalancer.configurations

default

事前定義された LoadBalancer 構成を有効にします。

spring.cloud.loadbalancer.eager-load.clients

クライアントの名前。

spring.cloud.loadbalancer.enabled

true

Spring Cloud LoadBalancer を有効にします。

spring.cloud.loadbalancer.health-check.initial-delay

0

HealthCheck スケジューラーの初期遅延値。

spring.cloud.loadbalancer.health-check.interval

25s

HealthCheck スケジューラーを再実行するための間隔。

spring.cloud.loadbalancer.health-check.interval

25s

HealthCheck スケジューラーを再実行するための間隔。

spring.cloud.loadbalancer.health-check.path

ヘルスチェックリクエストを行うパス。serviceId ごとに設定可能。default 値も設定できます。何も設定されていない場合は、/actuator/health が使用されます。

spring.cloud.loadbalancer.health-check.port

ヘルスチェックリクエストを行う必要があるパス。何も設定されていない場合、リクエストされたサービスがサービスインスタンスで利用できるポート。

spring.cloud.loadbalancer.health-check.refetch-instances

false

インスタンスを HealthCheckServiceInstanceListSupplier で再フェッチするかどうかを示します。インスタンスを更新でき、基になるデリゲートが進行中の flux を提供しない場合に使用できます。

spring.cloud.loadbalancer.health-check.refetch-instances-interval

25s

使用可能なサービスインスタンスを再フェッチする間隔。

spring.cloud.loadbalancer.health-check.repeat-health-check

true

ヘルスチェックを繰り返し続ける必要があるかどうかを示します。インスタンスを定期的に再フェッチする場合は、再フェッチのたびにヘルスチェックもトリガーされるため、これを false に設定すると便利な場合があります。

spring.cloud.loadbalancer.health-check.update-results-list

true

取得された有効な {@link ServiceInstance} ごとに {@code healthCheckFlux} を発行するかどうかを示します。{@code false} に設定すると、アライブインスタンスシーケンス全体が最初にリストに収集されてから出力されます。

spring.cloud.loadbalancer.hint

LoadBalancer リクエストに渡され、その後 {@link ReactiveLoadBalancer} 実装で使用できる <code>hint</code> の値を設定できます。

spring.cloud.loadbalancer.hint-header-name

X-SC-LB-Hint

ヒントベースのサービスインスタンスフィルタリングのヒントを渡すために使用されるヘッダーの名前を設定できます。

spring.cloud.loadbalancer.retry.avoid-previous-instance

true

Spring-Retry がクラスパスにある場合、ServiceInstanceListSupplier Bean を RetryAwareServiceInstanceListSupplier でラップできるようにします。

spring.cloud.loadbalancer.retry.backoff.enabled

false

Reactor 再試行バックオフを適用する必要があるかどうかを示します。

spring.cloud.loadbalancer.retry.backoff.jitter

0.5

RetryBackoffSpec.jitter の設定に使用します。

spring.cloud.loadbalancer.retry.backoff.max-backoff

Long.MAX ms

RetryBackoffSpec.maxBackoff の設定に使用します。

spring.cloud.loadbalancer.retry.backoff.min-backoff

5 ms

RetryBackoffSpec#minBackoff の設定に使用します。

spring.cloud.loadbalancer.retry.enabled

true

LoadBalancer の再試行を有効にします。

spring.cloud.loadbalancer.retry.max-retries-on-next-service-instance

1

次の ServiceInstance で実行される再試行の数。ServiceInstance は、各再試行呼び出しの前に選択されます。

spring.cloud.loadbalancer.retry.max-retries-on-same-service-instance

0

同じ ServiceInstance 上で実行される再試行の数。

spring.cloud.loadbalancer.retry.retry-on-all-exceptions

false

retryableExceptions で指定された例外だけでなく、すべての例外に対して再試行する必要があることを示します。

spring.cloud.loadbalancer.retry.retry-on-all-operations

false

HttpMethod.GET 以外の操作で再試行する必要があることを示します。

spring.cloud.loadbalancer.retry.retryable-exceptions

{}

再試行をトリガーする必要がある Throwable クラスの Set

spring.cloud.loadbalancer.retry.retryable-status-codes

{}

再試行をトリガーするステータスコードの Set

spring.cloud.loadbalancer.service-discovery.timeout

サービスディスカバリへの呼び出しのタイムアウトの期間の文字列表現。

spring.cloud.loadbalancer.stats.include-path

true

メトリクスの {@code uri} タグに {@code path} を追加するかどうかを示します。{@link RestTemplate} を使用して、カーディナリティの高いパスを持つ負荷分散されたリクエストを実行する場合は、これを {@code false} に設定することをお勧めします。

spring.cloud.loadbalancer.stats.micrometer.enabled

false

Spring Cloud LoadBalancer Micrometer 統計を有効にします。

spring.cloud.loadbalancer.sticky-session.add-service-instance-cookie

false

新しく選択されたインスタンスを含む Cookie を LoadBalancer で追加する必要があるかどうかを示します。

spring.cloud.loadbalancer.sticky-session.instance-id-cookie-name

sc-lb-instance-id

優先インスタンス ID を保持する Cookie の名前。

spring.cloud.loadbalancer.subset.instance-id

決定的サブセット化のインスタンス ID。設定されていない場合は、{@link IdUtils#getDefaultInstanceId(PropertyResolver)} が使用されます。

spring.cloud.loadbalancer.subset.size

100

決定的サブセット化の最大サブセットサイズ。

spring.cloud.loadbalancer.x-forwarded.enabled

false

X-Forwarded ヘッダーを有効にします。

spring.cloud.loadbalancer.zone

Spring Cloud LoadBalancer ゾーン。

spring.cloud.refresh.additional-property-sources-to-retain

リフレッシュ中に保持する追加のプロパティソース。通常、システムプロパティソースのみが保持されます。このプロパティを使用すると、EnvironmentPostProcessors によって作成されたプロパティソースなどのプロパティソースも保持できます。

spring.cloud.refresh.enabled

true

リフレッシュスコープと関連機能の自動構成を有効にします。

spring.cloud.refresh.extra-refreshable

true

後処理をリフレッシュスコープに入れる Bean の追加のクラス名。

spring.cloud.refresh.never-refreshable

true

Bean のクラス名のコンマ区切りリストは、リフレッシュまたはリバウンドされません。

spring.cloud.refresh.on-restart.enabled

true

開始時にコンテキストをリフレッシュできるようにします。

spring.cloud.service-registry.auto-registration.enabled

true

サービスの自動登録が有効になっているかどうか。デフォルトは true です。

spring.cloud.service-registry.auto-registration.fail-fast

false

AutoServiceRegistration がない場合に起動に失敗するかどうか。デフォルトは false です。

spring.cloud.service-registry.auto-registration.register-management

true

管理をサービスとして登録するかどうか。デフォルトは true です。

spring.cloud.util.enabled

true

Spring Cloud ユーティリティ Bean の作成を有効にします。