From 9c695648be6a88c232ed7792759fc9adfad82c2d Mon Sep 17 00:00:00 2001 From: Ryan Baxter Date: Mon, 19 Apr 2021 14:56:48 -0400 Subject: [PATCH] Update documentation around discovery first lookup (#1865) * Added warning to documentation --- docs/src/main/asciidoc/spring-cloud-config.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/src/main/asciidoc/spring-cloud-config.adoc b/docs/src/main/asciidoc/spring-cloud-config.adoc index 496f559e..a460b6ec 100644 --- a/docs/src/main/asciidoc/spring-cloud-config.adoc +++ b/docs/src/main/asciidoc/spring-cloud-config.adoc @@ -1512,14 +1512,14 @@ When a config client starts, it binds to the Config Server (through the `spring. The net result of this behavior is that all client applications that want to consume the Config Server need a `bootstrap.yml` (or an environment variable) with the server address set in `spring.cloud.config.uri` (it defaults to "http://localhost:8888"). [[discovery-first-bootstrap]] -==== Discovery First Bootstrap +==== Discovery First Lookup + +WARNING: Unless you are using <>, you will need to have a `spring.config.import` property in your configuration properties. +For example, `spring.config.import=optional:configserver:`. If you use a `DiscoveryClient` implementation, such as Spring Cloud Netflix and Eureka Service Discovery or Spring Cloud Consul, you can have the Config Server register with the Discovery Service. -Using the `DiscoveryClient` to locate the config server requires that the config client *must use* <> and *cannot use* <>. - If you prefer to use `DiscoveryClient` to locate the Config Server, you can do so by setting `spring.cloud.config.discovery.enabled=true` (the default is `false`). -The net result of doing so is that client applications all need a `bootstrap.yml` (or an environment variable) with the appropriate discovery configuration. For example, with Spring Cloud Netflix, you need to define the Eureka server address (for example, in `eureka.client.serviceUrl.defaultZone`). The price for using this option is an extra network round trip on startup, to locate the service registration. The benefit is that, as long as the Discovery Service is a fixed point, the Config Server can change its coordinates.