From 4796f064b454fba4f4e8af180614b950f3952313 Mon Sep 17 00:00:00 2001
From: Dave Syer <dsyer@pivotal.io>
Date: Tue, 23 Jun 2015 10:17:40 +0000
Subject: [PATCH] Sync docs from master to gh-pages

---
 spring-cloud.html | 1537 ++++++++++++++-------------------------------
 1 file changed, 467 insertions(+), 1070 deletions(-)

diff --git a/spring-cloud.html b/spring-cloud.html
index 46d4697..d88e70c 100644
--- a/spring-cloud.html
+++ b/spring-cloud.html
@@ -416,29 +416,6 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="toctitle">Table of Contents</div>
 <ul class="sectlevel1">
 <li><a href="#_features">Features</a></li>
-<li><a href="#_cloud_native_applications">Cloud Native Applications</a>
-<ul class="sectlevel1">
-<li><a href="#_spring_cloud_context_application_context_services">Spring Cloud Context: Application Context Services</a>
-<ul class="sectlevel2">
-<li><a href="#_the_bootstrap_application_context">The Bootstrap Application Context</a></li>
-<li><a href="#_application_context_hierarchies">Application Context Hierarchies</a></li>
-<li><a href="#customizing-bootstrap-properties">Changing the Location of Bootstrap Properties</a></li>
-<li><a href="#_customizing_the_bootstrap_configuration">Customizing the Bootstrap Configuration</a></li>
-<li><a href="#customizing-bootstrap-property-sources">Customizing the Bootstrap Property Sources</a></li>
-<li><a href="#_environment_changes">Environment Changes</a></li>
-<li><a href="#_refresh_scope">Refresh Scope</a></li>
-<li><a href="#_encryption_and_decryption">Encryption and Decryption</a></li>
-<li><a href="#_endpoints">Endpoints</a></li>
-</ul>
-</li>
-<li><a href="#_spring_cloud_commons_common_abstractions">Spring Cloud Commons: Common Abstractions</a>
-<ul class="sectlevel2">
-<li><a href="#_spring_resttemplate_as_a_load_balancer_client">Spring RestTemplate as a Load Balancer Client</a></li>
-<li><a href="#_multiple_resttemplate_objects">Multiple RestTemplate objects</a></li>
-</ul>
-</li>
-</ul>
-</li>
 <li><a href="#_spring_cloud_config">Spring Cloud Config</a>
 <ul class="sectlevel1">
 <li><a href="#_quick_start">Quick Start</a>
@@ -449,12 +426,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_spring_cloud_config_server">Spring Cloud Config Server</a>
 <ul class="sectlevel2">
 <li><a href="#_environment_repository">Environment Repository</a></li>
-<li><a href="#_health_indicator">Health Indicator</a></li>
 <li><a href="#_security">Security</a></li>
-<li><a href="#_encryption_and_decryption_2">Encryption and Decryption</a></li>
+<li><a href="#_encryption_and_decryption">Encryption and Decryption</a></li>
 <li><a href="#_key_management">Key Management</a></li>
 <li><a href="#_creating_a_key_store_for_testing">Creating a Key Store for Testing</a></li>
-<li><a href="#_using_multiple_keys_and_key_rotation">Using Multiple Keys and Key Rotation</a></li>
 <li><a href="#_embedding_the_config_server">Embedding the Config Server</a></li>
 </ul>
 </li>
@@ -463,7 +438,16 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#config-first-bootstrap">Config First Bootstrap</a></li>
 <li><a href="#eureka-first-bootstrap">Eureka First Bootstrap</a></li>
 <li><a href="#config-client-fail-fast">Config Client Fail Fast</a></li>
+<li><a href="#_environment_changes">Environment Changes</a></li>
+<li><a href="#_refresh_scope">Refresh Scope</a></li>
+<li><a href="#_encryption_and_decryption_2">Encryption and Decryption</a></li>
+<li><a href="#_endpoints">Endpoints</a></li>
 <li><a href="#_locating_remote_configuration_resources">Locating Remote Configuration Resources</a></li>
+<li><a href="#_the_bootstrap_application_context">The Bootstrap Application Context</a></li>
+<li><a href="#_application_context_hierarchies">Application Context Hierarchies</a></li>
+<li><a href="#customizing-bootstrap-properties">Changing the Location of Bootstrap Properties</a></li>
+<li><a href="#_customizing_the_bootstrap_configuration">Customizing the Bootstrap Configuration</a></li>
+<li><a href="#customizing-bootstrap-property-sources">Customizing the Bootstrap Property Sources</a></li>
 <li><a href="#_security_2">Security</a></li>
 </ul>
 </li>
@@ -477,7 +461,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_status_page_and_health_indicator">Status Page and Health Indicator</a></li>
 <li><a href="#_eureka_metadata_for_instances_and_clients">Eureka Metadata for Instances and Clients</a></li>
 <li><a href="#_using_the_discoveryclient">Using the DiscoveryClient</a></li>
-<li><a href="#_alternatives_to_the_native_netflix_discoveryclient">Alternatives to the native Netflix DiscoveryClient</a></li>
+<li><a href="#_alternatives_to_the_discoveryclient">Alternatives to the DiscoveryClient</a></li>
 <li><a href="#_why_is_it_so_slow_to_register_a_service">Why is it so Slow to Register a Service?</a></li>
 </ul>
 </li>
@@ -491,8 +475,6 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </li>
 <li><a href="#_circuit_breaker_hystrix_clients">Circuit Breaker: Hystrix Clients</a>
 <ul class="sectlevel2">
-<li><a href="#_propagating_the_security_context_or_using_spring_scopes">Propagating the Security Context or using Spring Scopes</a></li>
-<li><a href="#_health_indicator_2">Health Indicator</a></li>
 <li><a href="#_hystrix_metrics_stream">Hystrix Metrics Stream</a></li>
 </ul>
 </li>
@@ -508,8 +490,8 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_customizing_the_ribbon_client">Customizing the Ribbon Client</a></li>
 <li><a href="#_using_ribbon_with_eureka">Using Ribbon with Eureka</a></li>
 <li><a href="#spring-cloud-ribbon-without-eureka">Example: How to Use Ribbon Without Eureka</a></li>
-<li><a href="#_example_disable_eureka_use_in_ribbon">Example: Disable Eureka use in Ribbon</a></li>
 <li><a href="#_using_the_ribbon_api_directly">Using the Ribbon API Directly</a></li>
+<li><a href="#_spring_resttemplate_as_a_ribbon_client">Spring RestTemplate as a Ribbon Client</a></li>
 </ul>
 </li>
 <li><a href="#spring-cloud-feign">Declarative REST Client: Feign</a></li>
@@ -517,9 +499,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_router_and_filter_zuul">Router and Filter: Zuul</a>
 <ul class="sectlevel2">
 <li><a href="#netflix-zuul-reverse-proxy">Embedded Zuul Reverse Proxy</a></li>
-<li><a href="#_uploading_files_through_zuul">Uploading Files through Zuul</a></li>
 <li><a href="#_plain_embedded_zuul">Plain Embedded Zuul</a></li>
-<li><a href="#_disable_zuul_filters">Disable Zuul Filters</a></li>
 <li><a href="#_polyglot_support_with_sidecar">Polyglot support with Sidecar</a></li>
 </ul>
 </li>
@@ -528,19 +508,18 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_spring_cloud_bus">Spring Cloud Bus</a>
 <ul class="sectlevel1">
 <li><a href="#_quick_start_2">Quick Start</a></li>
-<li><a href="#_addressing_an_instance">Addressing an Instance</a></li>
-<li><a href="#_addressing_all_instances_of_a_service">Addressing all instances of a service</a></li>
-<li><a href="#_application_context_id_must_be_unique">Application Context ID must be unique</a></li>
 <li><a href="#_customizing_the_amqp_connectionfactory_2">Customizing the AMQP ConnectionFactory</a></li>
 </ul>
 </li>
 <li><a href="#_spring_boot_cloud_cli">Spring Boot Cloud CLI</a>
 <ul class="sectlevel1">
-<li><a href="#_installation">Installation</a></li>
-<li><a href="#_writing_groovy_scripts_and_running_applications">Writing Groovy Scripts and Running Applications</a></li>
+<li><a href="#_installation">Installation</a>
+<ul class="sectlevel2">
 <li><a href="#_encryption_and_decryption_3">Encryption and Decryption</a></li>
 </ul>
 </li>
+</ul>
+</li>
 <li><a href="#_spring_cloud_security">Spring Cloud Security</a>
 <ul class="sectlevel1">
 <li><a href="#_quickstart">Quickstart</a>
@@ -552,7 +531,6 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <li><a href="#_more_detail">More Detail</a>
 <ul class="sectlevel2">
 <li><a href="#_single_sign_on">Single Sign On</a></li>
-<li><a href="#_token_type_in_user_info">Token Type in User Info</a></li>
 <li><a href="#_customizing_the_resttemplate">Customizing the RestTemplate</a></li>
 <li><a href="#_resource_server">Resource Server</a></li>
 <li><a href="#_token_relay">Token Relay</a></li>
@@ -621,467 +599,10 @@ and extensibility mechanism to cover others.</p>
 </div>
 </div>
 </div>
-<h1 id="_cloud_native_applications" class="sect0">Cloud Native Applications</h1>
-<div class="openblock partintro">
-<div class="content">
-<div class="paragraph">
-<p><a href="http://pivotal.io/platform-as-a-service/migrating-to-cloud-native-application-architectures-ebook">Cloud Native</a> is a style of application development that encourages easy adoption of best practices in the areas of continuous delivery and value-driven development. A related discipline is that of building <a href="http://12factor.net/">12-factor Apps</a> in which development practices are aligned with delivery and operations goals, for instance by using declarative programming and management and monitoring. Spring Cloud facilitates these styles of development in a number of specific ways and the starting point is a set of features that all components in a distributed system either need or need easy access to when required.</p>
-</div>
-<div class="paragraph">
-<p>Many of those features are covered by <a href="http://projects.spring.io/spring-boot">Spring Boot</a>, which we build on in Spring Cloud. Some more are delivered by Spring Cloud as two libraries: Spring Cloud Context and Spring Cloud Commons. Spring Cloud Context provides utilities and special services for the <code>ApplicationContext</code> of a Spring Cloud application (bootstrap context, encryption, refresh scope and environment endpoints). Spring Cloud Commons is a set of abstractions and common classes used in different Spring Cloud implementations (eg. Spring Cloud Netflix vs. Spring Cloud Consul).</p>
-</div>
-<div class="paragraph">
-<p>If you are getting an exception due to "Illegal key size" and you are using Sun&#8217;s JDK, you need to install the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files. See the following links for more information:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Java 6 JCE Link <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html" class="bare">http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html</a></p>
-</li>
-<li>
-<p>Java 7 JCE Link <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html" class="bare">http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html</a></p>
-</li>
-<li>
-<p>Java 8 JCE Link <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html" class="bare">http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html</a></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Extract files into JDK/jre/lib/security folder (whichever version of JRE/JDK x64/x86 you are using).</p>
-</div>
-<div class="paragraph">
-<p><a href="https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc" class="bare">https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc</a></p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_context_application_context_services">Spring Cloud Context: Application Context Services</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Spring Boot has an opinionated view of how to build an application
-with Spring: for instance it has conventional locations for common
-configuration file, and endpoints for common management and monitoring
-tasks. Spring Cloud builds on top of that and adds a few features that
-probably all components in a system would use or occasionally need.</p>
-</div>
-<div class="sect2">
-<h3 id="_the_bootstrap_application_context">The Bootstrap Application Context</h3>
-<div class="paragraph">
-<p>A Spring Cloud application operates by creating a "bootstrap"
-context, which is a parent context for the main application. Out of
-the box it is responsible for loading configuration properties from
-the external sources, and also decrypting properties in the local
-external configuration files. The two contexts share an <code>Environment</code>
-which is the source of external properties for any Spring
-application. Bootstrap properties are added with high precedence, so
-they cannot be overridden by local configuration.</p>
-</div>
-<div class="paragraph">
-<p>The bootstrap context uses a different convention for locating
-external configuration than the main application context, so instead
-of <code>application.yml</code> (or <code>.properties</code>) you use <code>bootstrap.yml</code>,
-keeping the external configuration for bootstrap and main context
-nicely separate. Example:</p>
-</div>
-<div class="listingblock">
-<div class="title">bootstrap.yml</div>
-<div class="content">
-<pre>spring:
-  application:
-    name: foo
-  cloud:
-    config:
-      uri: ${SPRING_CONFIG_URI:http://localhost:8888}</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>It is a good idea to set the <code>spring.application.name</code> (in
-<code>bootstrap.yml</code> or <code>application.yml</code>) if your application needs any
-application-specific configuration from the server.</p>
-</div>
-<div class="paragraph">
-<p>You can disable the bootstrap process completely by setting
-<code>spring.cloud.bootstrap.enabled=false</code> (e.g. in System properties).</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_application_context_hierarchies">Application Context Hierarchies</h3>
-<div class="paragraph">
-<p>If you build an application context from <code>SpringApplication</code> or
-<code>SpringApplicationBuilder</code>, then the Bootstrap context is added as a
-parent to that context. It is a feature of Spring that child contexts
-inherit property sources and profiles from their parent, so the "main"
-application context will contain additional property sources, compared
-to building the same context without Spring Cloud Config. The
-additional property sources are:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>"bootstrap": an optional <code>CompositePropertySource</code> appears with high
-priority if any <code>PropertySourceLocators</code> are found in the Bootstrap
-context, and they have non-empty properties. An example would be
-properties from the Spring Cloud Config Server. See
-<a href="#customizing-bootstrap-property-sources">below</a> for instructions
-on how to customize the contents of this property source.</p>
-</li>
-<li>
-<p>"applicationConfig: [classpath:bootstrap.yml]" (and friends if
-Spring profiles are active). If you have a <code>bootstrap.yml</code> (or
-properties) then those properties are used to configure the Bootstrap
-context, and then they get added to the child context when its parent
-is set. They have lower precedence than the <code>application.yml</code> (or
-properties) and any other property sources that are added to the child
-as a normal part of the process of creating a Spring Boot
-application. See <a href="#customizing-bootstrap-properties">below</a> for
-instructions on how to customize the contents of these property
-sources.</p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Because of the ordering rules of property sources the "bootstrap"
-entries take precedence, but note that these do not contain any data
-from <code>bootstrap.yml</code>, which has very low precedence, but can be used
-to set defaults.</p>
-</div>
-<div class="paragraph">
-<p>You can extend the context hierarchy by simply setting the parent
-context of any <code>ApplicationContext</code> you create, e.g. using its own
-interface, or with the <code>SpringApplicationBuilder</code> convenience methods
-(<code>parent()</code>, <code>child()</code> and <code>sibling()</code>). The bootstrap context will be
-the parent of the most senior ancestor that you create yourself.
-Every context in the hierarchy will have its own "bootstrap" property
-source (possibly empty) to avoid promoting values inadvertently from
-parents down to their descendants.  Every context in the hierarchy can
-also (in principle) have a different <code>spring.application.name</code> and
-hence a different remote property source if there is a Config
-Server. Normal Spring application context behaviour rules apply to
-property resolution: properties from a child context override those in
-the parent, by name and also by property source name (if the child has
-a property source with the same name as the parent, the one from the
-parent is not included in the child).</p>
-</div>
-<div class="paragraph">
-<p>Note that the <code>SpringApplicationBuilder</code> allows you to share an
-<code>Environment</code> amongst the whole hierarchy, but that is not the
-default. Thus, sibling contexts in particular do not need to have the
-same profiles or property sources, even though they will share common
-things with their parent.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="customizing-bootstrap-properties">Changing the Location of Bootstrap Properties</h3>
-<div class="paragraph">
-<p>The <code>bootstrap.yml</code> (or <code>.properties) location can be specified using
-`spring.cloud.bootstrap.name</code> (default "bootstrap") or
-<code>spring.cloud.bootstrap.location</code> (default empty), e.g. in System
-properties. Those properties behave like the <code>spring.config.*</code>
-variants with the same name, in fact they are used to set up the
-bootstrap <code>ApplicationContext</code> by setting those properties in its
-<code>Environment</code>. If there is an active profile (from
-<code>spring.profiles.active</code> or through the <code>Environment</code> API in the
-context you are building) then properties in that profile will be
-loaded as well, just like in a regular Spring Boot app, e.g. from
-<code>bootstrap-development.properties</code> for a "development" profile.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_customizing_the_bootstrap_configuration">Customizing the Bootstrap Configuration</h3>
-<div class="paragraph">
-<p>The bootstrap context can be trained to do anything you like by adding
-entries to <code>/META-INF/spring.factories</code> under the key
-<code>org.springframework.cloud.bootstrap.BootstrapConfiguration</code>. This is
-a comma-separated list of Spring <code>@Configuration</code> classes which will
-be used to create the context. Any beans that you want to be available
-to the main application context for autowiring can be created here,
-and also there is a special contract for <code>@Beans</code> of type
-<code>ApplicationContextInitializer</code>. Classes can be marked with an <code>@Order</code>
-if you want to control the startup sequence (the default order is
-"last").</p>
-</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Warning</div>
-</td>
-<td class="content">
-Be careful when adding custom <code>BootstrapConfiguration</code> that the
-classes you add are not <code>@ComponentScanned</code> by mistake into your
-"main" application context, where they might not be needed.
-Use a separate package name for boot configuration classes that is
-not already covered by your <code>@ComponentScan</code> or <code>@SpringBootApplication</code>
-annotated configuration classes.
-</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p>The bootstrap process ends by injecting initializers into the main
-<code>SpringApplication</code> instance (i.e. the normal Spring Boot startup
-sequence, whether it is running as a standalone app or deployed in an
-application server). First a bootstrap context is created from the
-classes found in <code>spring.factories</code> and then all <code>@Beans</code> of type
-<code>ApplicationContextInitializer</code> are added to the main
-<code>SpringApplication</code> before it is started.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="customizing-bootstrap-property-sources">Customizing the Bootstrap Property Sources</h3>
-<div class="paragraph">
-<p>The default property source for external configuration added by the
-bootstrap process is the Config Server, but you can add additional
-sources by adding beans of type <code>PropertySourceLocator</code> to the
-bootstrap context (via <code>spring.factories</code>). You could use this to
-insert additional properties from a different server, or from a
-database, for instance.</p>
-</div>
-<div class="paragraph">
-<p>As an example, consider the following trivial custom locator:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-java" data-lang="java">@Configuration
-public class CustomPropertySourceLocator implements PropertySourceLocator {
-
-    @Override
-    public PropertySource&lt;?&gt; locate(Environment environment) {
-        return new MapPropertySource("customProperty",
-                Collections.&lt;String, Object&gt;singletonMap("property.from.sample.custom.source", "worked as intended"));
-    }
-
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The <code>Environment</code> that is passed in is the one for the
-<code>ApplicationContext</code> about to be created, i.e. the one that we are
-supplying additional property sources for. It will already have its
-normal Spring Boot-provided property sources, so you can use those to
-locate a property source specific to this <code>Environment</code> (e.g. by
-keying it on the <code>spring.application.name</code>, as is done in the default
-Config Server property source locator).</p>
-</div>
-<div class="paragraph">
-<p>If you create a jar with this class in it and then add a
-<code>META-INF/spring.factories</code> containing:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>org.springframework.cloud.bootstrap.BootstrapConfiguration=sample.custom.CustomPropertySourceLocator</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>then the "customProperty" <code>PropertySource</code> will show up in any
-application that includes that jar on its classpath.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_environment_changes">Environment Changes</h3>
-<div class="paragraph">
-<p>The application will listen for an <code>EnvironmentChangedEvent</code> and react
-to the change in a couple of standard ways (additional
-<code>ApplicationListeners</code> can be added as <code>@Beans</code> by the user in the
-normal way). When an <code>EnvironmentChangedEvent</code> is observed it will
-have a list of key values that have changed, and the application will
-use those to:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>Re-bind any <code>@ConfigurationProperties</code> beans in the context</p>
-</li>
-<li>
-<p>Set the logger levels for any properties in <code>logging.level.*</code></p>
-</li>
-</ul>
-</div>
-<div class="paragraph">
-<p>Note that the Config Client does not by default poll for changes in
-the <code>Environment</code>, and generally we would not recommend that approach
-for detecting changes (although you could set it up with a
-<code>@Scheduled</code> annotation). If you have a scaled-out client application
-then it is better to broadcast the <code>EnvironmentChangedEvent</code> to all
-the instances instead of having them polling for changes (e.g. using
-the <a href="https://github.com/spring-cloud/spring-cloud-bus">Spring Cloud
-Bus</a>).</p>
-</div>
-<div class="paragraph">
-<p>The <code>EnvironmentChangedEvent</code> covers a large class of refresh use
-cases, as long as you can actually make a change to the <code>Environment</code>
-and publish the event (those APIs are public and part of core
-Spring). You can verify the changes are bound to
-<code>@ConfigurationProperties</code> beans by visiting the <code>/configprops</code>
-endpoint (normal Spring Boot Actuator feature). For instance a
-<code>DataSource</code> can have its <code>maxPoolSize</code> changed at runtime (the
-default <code>DataSource</code> created by Spring Boot is an
-<code>@ConfigurationProperties</code> bean) and grow capacity
-dynamically. Re-binding <code>@ConfigurationProperties</code> does not cover
-another large class of use cases, where you need more control over the
-refresh, and where you need a change to be atomic over the whole
-<code>ApplicationContext</code>. To address those concerns we have
-<code>@RefreshScope</code>.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_refresh_scope">Refresh Scope</h3>
-<div class="paragraph">
-<p>A Spring <code>@Bean</code> that is marked as <code>@RefreshScope</code> will get special
-treatment when there is a configuration change. This addresses the
-problem of stateful beans that only get their configuration injected
-when they are initialized. For instance if a <code>DataSource</code> has open
-connections when the database URL is changed via the <code>Environment</code>, we
-probably want the holders of those connections to be able to complete
-what they are doing. Then the next time someone borrows a connection
-from the pool he gets one with the new URL.</p>
-</div>
-<div class="paragraph">
-<p>Refresh scope beans are lazy proxies that initialize when they are
-used (i.e. when a method is called), and the scope acts as a cache of
-initialized values. To force a bean to re-initialize on the next
-method call you just need to invalidate its cache entry.</p>
-</div>
-<div class="paragraph">
-<p>The <code>RefreshScope</code> is a bean in the context and it has a public method
-<code>refreshAll()</code> to refresh all beans in the scope by clearing the
-target cache. There is also a <code>refresh(String)</code> method to refresh an
-individual bean by name. This functionality is exposed in the
-<code>/refresh</code> endpoint (over HTTP or JMX).</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">
-<code>@RefreshScope</code> works (technically) on an <code>@Configuration</code>
-class, but it might lead to surprising behaviour: e.g. it does <strong>not</strong>
-mean that all the <code>@Beans</code> defined in that class are themselves
-<code>@RefreshScope</code>. Specifically, anything that depends on those beans
-cannot rely on them being updated when a refresh is initiated, unless
-it is itself in <code>@RefreshScope</code> (in which it will be rebuilt on a
-refresh and its dependencies re-injected, at which point they will be
-re-initialized from the refreshed <code>@Configuration</code>).
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_encryption_and_decryption">Encryption and Decryption</h3>
-<div class="paragraph">
-<p>The Config Client has an <code>Environment</code> pre-processor for decrypting
-property values locally. It follows the same rules as the Config
-Server, and has the same external configuration via <code>encrypt.*</code>. Thus
-you can use encrypted values in the form <code>{cipher}*</code> and as long as
-there is a valid key then they will be decrypted before the main
-application context gets the <code>Environment</code>. To use the encryption
-features in a client you need to include Spring Security RSA in your
-classpath (Maven co-ordinates
-"org.springframework.security:spring-security-rsa") and you also need
-the full strength JCE extensions in your JVM.</p>
-</div>
-<div class="paragraph">
-<p>include::jce.adoc</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_endpoints">Endpoints</h3>
-<div class="paragraph">
-<p>For a Spring Boot Actuator application there are some additional management endpoints:</p>
-</div>
-<div class="ulist">
-<ul>
-<li>
-<p>POST to <code>/env</code> to update the <code>Environment</code> and rebind <code>@ConfigurationProperties</code> and log levels</p>
-</li>
-<li>
-<p><code>/refresh</code> for re-loading the boot strap context and refreshing the <code>@RefreshScope</code> beans</p>
-</li>
-<li>
-<p><code>/restart</code> for closing the <code>ApplicationContext</code> and restarting it (disabled by default)</p>
-</li>
-<li>
-<p><code>/pause</code> and <code>/resume</code> for calling the <code>Lifecycle</code> methods (<code>stop()</code> and <code>start()</code> on the <code>ApplicationContext</code>)</p>
-</li>
-</ul>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_spring_cloud_commons_common_abstractions">Spring Cloud Commons: Common Abstractions</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Patterns such as service discovery, load balancing and circuit breakers lend themselves to a common abstraction layer that can be consumed by all Spring Cloud clients, independent of the implementation (e.g. discovery via Eureka or Consul).</p>
-</div>
-<div class="sect2">
-<h3 id="_spring_resttemplate_as_a_load_balancer_client">Spring RestTemplate as a Load Balancer Client</h3>
-<div class="paragraph">
-<p>You can use Ribbon indirectly via an autoconfigured <code>RestTemplate</code>
-when RestTemplate is on the classpath and a <code>LoadBalancerClient</code> bean is defined):</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-java" data-lang="java">public class MyClass {
-    @Autowired
-    private RestTemplate restTemplate;
-
-    public String doOtherStuff() {
-        String results = restTemplate.getForObject("http://stores/stores", String.class);
-        return results;
-    }
-}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The URI needs to use a virtual host name (ie. service name, not a host name).
-The Ribbon client is used to create a full physical address. See
-{github-code}/spring-cloud-netflix-core/src/main/java/org/springframework/cloud/netflix/ribbon/RibbonAutoConfiguration.java[RibbonAutoConfiguration]
-for details of how the <code>RestTemplate</code> is set up.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_multiple_resttemplate_objects">Multiple RestTemplate objects</h3>
-<div class="paragraph">
-<p>If you want a <code>RestTemplate</code> that is not load balanced, create a <code>RestTemplate</code>
-bean  and inject it as normal.  To access the load balanced <code>RestTemplate use
-the provided `@LoadBalanced</code> <code>Qualifier</code>:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-java" data-lang="java">public class MyClass {
-    @Autowired
-    private RestTemplate restTemplate;
-
-    @Autowired
-    @LoadBalanced
-    private RestTemplate loadBalanced;
-
-    public String doOtherStuff() {
-        return loadBalanced.getForObject("http://stores/stores", String.class);
-    }
-
-    public String doStuff() {
-        return restTemplate.getForObject("http://example.com", String.class);
-    }
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-</div>
 <h1 id="_spring_cloud_config" class="sect0">Spring Cloud Config</h1>
 <div class="openblock partintro">
 <div class="content">
-<div class="paragraph">
-<p>Spring Cloud Config provides server and client-side support for externalized configuration in a distributed system. With the Config Server you have a central place to manage external properties for applications across all environments. The concepts on both client and server map identically to the Spring <code>Environment</code> and <code>PropertySource</code> abstractions, so they fit very well with Spring applications, but can be used with any application running in any language. As an application moves through the deployment pipeline from dev to test and into production you can manage the configuration between those environments and be certain that applications have everything they need to run when they migrate. The default implementation of the server storage backend uses git so it easily supports labelled versions of configuration environments, as well as being accessible to a wide range of tooling for managing the content.  It is easy to add alternative implementations and plug them in with Spring configuration.</p>
-</div>
-<div class="paragraph">
-<p><a href="https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc" class="bare">https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc</a></p>
-</div>
+Spring Cloud Config provides server and client-side support for externalized configuration in a distributed system. With the Config Server you have a central place to manage external properties for applications across all environments. The concepts on both client and server map identically to the Spring <code>Environment</code> and <code>PropertySource</code> abstractions, so they fit very well with Spring applications, but can be used with any application running in any language. As an application moves through the deployment pipeline from dev to test and into production you can manage the configuration between those environments and be certain that applications have everything they need to run when they migrate. The default implementation of the server storage backend uses git so it easily supports labelled versions of configuration environments, as well as being accessible to a wide range of tooling for managing the content.  It is easy to add alternative implementations and plug them in with Spring configuration.
 </div>
 </div>
 <div class="sect1">
@@ -1162,7 +683,7 @@ from a git repository (which must be provided):</p>
 Boot application that depends on spring-cloud-config-client (e.g. see
 the test cases for the config-client, or the sample app). The most
 convenient way to add the dependency is via a Spring Boot starter
-<code>org.springframework.cloud:spring-cloud-starter-config</code>. There is also a
+<code>org.springframework.cloud:spring-cloud-starter</code>. There is also a
 parent pom and BOM (<code>spring-cloud-starter-parent</code>) for Maven users and a
 Spring IO version management properties file for Gradle and Spring CLI
 users. Example Maven configuration:</p>
@@ -1173,7 +694,7 @@ users. Example Maven configuration:</p>
 <pre class="highlight"><code class="language-xml" data-lang="xml">&lt;parent&gt;
     &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
     &lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;
-    &lt;version&gt;1.2.3.RELEASE&lt;/version&gt;
+    &lt;version&gt;1.1.7.RELEASE&lt;/version&gt;
     &lt;relativePath /&gt; &lt;!-- lookup parent from repository --&gt;
 &lt;/parent&gt;
 
@@ -1182,7 +703,7 @@ users. Example Maven configuration:</p>
         &lt;dependency&gt;
             &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
             &lt;artifactId&gt;spring-cloud-starter-parent&lt;/artifactId&gt;
-            &lt;version&gt;1.0.1.RELEASE&lt;/version&gt;
+            &lt;version&gt;1.0.0.BUILD-SNAPSHOT&lt;/version&gt;
             &lt;type&gt;pom&lt;/type&gt;
             &lt;scope&gt;import&lt;/scope&gt;
         &lt;/dependency&gt;
@@ -1192,7 +713,7 @@ users. Example Maven configuration:</p>
 &lt;dependencies&gt;
     &lt;dependency&gt;
         &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;
-        &lt;artifactId&gt;spring-cloud-starter-config&lt;/artifactId&gt;
+        &lt;artifactId&gt;spring-cloud-starter&lt;/artifactId&gt;
     &lt;/dependency&gt;
     &lt;dependency&gt;
         &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
@@ -1374,17 +895,17 @@ repositories:</p>
 <pre>spring:
   cloud:
     config:
-      server:
-        git:
-          uri: https://github.com/spring-cloud-samples/config-repo
-          repos:
-            simple: https://github.com/pattern1/config-repo
+    server:
+      git:
+        uri: https://github.com/spring-cloud-samples/config-repo
+        repos:
+          simple: https://github.com/pattern1/config-repo
             special:
               pattern: pattern*,*pattern1*
-              uri: https://github.com/pattern2/config-repo
-            local:
+            uri: https://github.com/pattern2/config-repo
+          local:
               pattern: local*
-              uri: file:/home/configsvc/config-repo</pre>
+            uri: file:/home/configsvc/config-repo</pre>
 </div>
 </div>
 <div class="paragraph">
@@ -1396,59 +917,6 @@ pattern format is a comma-separated list of application names with
 wildcards.</p>
 </div>
 <div class="paragraph">
-<p>Every repository can also optionally store config files in
-sub-directories, and patterns to search for those directories can be
-specified as <code>searchPaths</code>. For example at the top level:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>spring:
-  cloud:
-    config:
-      server:
-        git:
-          uri: https://github.com/spring-cloud-samples/config-repo
-          searchPaths: foo,bar*</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this example the server searches for config files in the top level
-and in the "foo/" sub-directory and also any sub-directory whose name
-begins with "bar".</p>
-</div>
-<div class="paragraph">
-<p>By default the server clones remote repositories when configuration
-is first requested. The server can be configured to clone the repositories
-at startup. For example at the top level:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>spring:
-  cloud:
-    config:
-      server:
-        git:
-          uri: https://git/common/config-repo.git
-          repos:
-            team-a:
-                pattern: team-a-*
-                cloneOnStart: true
-                uri: http://git/team-a/config-repo.git
-            team-b:
-                pattern: team-b-*
-                cloneOnStart: false
-                uri: http://git/team-b/config-repo.git
-            team-c:
-                pattern: team-c-*
-                uri: http://git/team-a/config-repo.git</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this example the server clones team-a&#8217;s config-repo on startup before it
-accepts any requests. All other repositories will not be cloned until
-configuration from the repository is requested.</p>
-</div>
-<div class="paragraph">
 <p>To use HTTP basic authentication on the remote repository add the
 "username" and "password" properties separately (not in the URL),
 e.g.</p>
@@ -1458,9 +926,9 @@ e.g.</p>
 <pre>spring:
   cloud:
     config:
-      server:
-        git:
-          uri: https://github.com/spring-cloud-samples/config-repo
+    server:
+      git:
+        uri: https://github.com/spring-cloud-samples/config-repo
           username: trolley
           password: strongpassword</pre>
 </div>
@@ -1468,7 +936,7 @@ e.g.</p>
 <div class="paragraph">
 <p>If you don&#8217;t use HTTPS and user credentials, SSH should also work out
 of the box when you store keys in the default directories (<code>~/.ssh</code>)
-and the uri points to an SSH location,
+and the uri is points to an SSH location,
 e.g. "<a href="mailto:git@github.com">git@github.com</a>:configuration/cloud-configuration". The
 repository is accessed using JGit, so any documentation you find on
 that should be applicable.</p>
@@ -1484,36 +952,6 @@ system (any static URL you want to point to with
 profile just launch the Config Server with
 "spring.profiles.active=native".</p>
 </div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Warning</div>
-</td>
-<td class="content">
-The default value of the <code>searchLocations</code> is identical to a
-local Spring Boot application (so
-<code>[classpath:/, classpath:/config, file:./, file:./config]</code>) which will
-expose the <code>application.properties</code> from the server to all clients.
-</td>
-</tr>
-</table>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-A filesystem backend is great for getting started quickly and
-for testing. To use it in production you need to be sure that the
-file system is reliable, and shared across all instances of the
-Config Server.
-</td>
-</tr>
-</table>
-</div>
 <div class="paragraph">
 <p>This repository implementation maps the <code>{label}</code> parameter of the
 HTTP resource to a suffix on the search path, so properties files are
@@ -1524,37 +962,6 @@ Spring Environment).</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_health_indicator">Health Indicator</h3>
-<div class="paragraph">
-<p>Config Server comes with a Health Indicator that checks if the configured
-<code>EnvironmentRepository</code> is working.  By default it asks the <code>EnvironmentRepository</code>
-for an application named <code>app</code>, the <code>default</code> profile and the default
-label provided by the <code>EnvironmentRepository</code> implementation.</p>
-</div>
-<div class="paragraph">
-<p>You can configure the Health Indicator to check more applications
-along with custom profiles and custom labels, e.g.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>spring:
-  cloud:
-    config:
-      server:
-        health:
-          repositories:
-            myservice:
-              label: mylabel
-            myservice-dev:
-              name: myservice
-              profiles: development</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>You can disable the Health Indicator by setting <code>spring.cloud.config.server.health.enabled=false</code>.</p>
-</div>
-</div>
-<div class="sect2">
 <h3 id="_security">Security</h3>
 <div class="paragraph">
 <p>You are free to secure your Config Server in any way that makes sense
@@ -1573,7 +980,7 @@ on how to do that).</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_encryption_and_decryption_2">Encryption and Decryption</h3>
+<h3 id="_encryption_and_decryption">Encryption and Decryption</h3>
 <div class="admonitionblock important">
 <table>
 <tr>
@@ -1591,13 +998,15 @@ in the JRE lib/security directory with the ones that you downloaded).
 </table>
 </div>
 <div class="paragraph">
-<p>If the remote property sources contain encryted content
+<p>The server exposes <code>/encrypt</code> and <code>/decrypt</code> endpoints (on the
+assumption that these will be secured and only accessed by authorized
+agents). If the remote property sources contain encryted content
 (values starting with <code>{cipher}</code>) they will be decrypted before
 sending to clients over HTTP. The main advantage of this set up is
 that the property values don&#8217;t have to be in plain text when they are
 "at rest" (e.g. in a git repository). If a value cannot be decrypted
 it is replaced with an empty string, largely to prevent cipher text
-being used as a password and accidentally leaking.</p>
+being used as a password in Spring Boot autconfigured HTTP basic.</p>
 </div>
 <div class="paragraph">
 <p>If you are setting up a remote config repository for config client
@@ -1610,7 +1019,7 @@ instance:</p>
 <pre>spring:
   datasource:
     username: dbuser
-    password: '{cipher}FKSAJDFGYOS8F7GLHAKERGFHLSAJ'</pre>
+    password: {cipher}FKSAJDFGYOS8F7GLHAKERGFHLSAJ</pre>
 </div>
 </div>
 <div class="paragraph">
@@ -1618,9 +1027,7 @@ instance:</p>
 secret password is protected.</p>
 </div>
 <div class="paragraph">
-<p>The server also exposes <code>/encrypt</code> and <code>/decrypt</code> endpoints (on the
-assumption that these will be secured and only accessed by authorized
-agents). If you are editing a remote config file you can use the Config Server
+<p>If you are editing a remote config file you can use the Config Server
 to encrypt values by POSTing to the <code>/encrypt</code> endpoint, e.g.</p>
 </div>
 <div class="listingblock">
@@ -1642,25 +1049,7 @@ mysecret</pre>
 <div class="paragraph">
 <p>Take the encypted value and add the <code>{cipher}</code> prefix before you put
 it in the YAML or properties file, and before you commit and push it
-to a remote, potentially insecure store. The <code>/encypt</code> and <code>/decrypt</code>
-endpoints also both accept paths of the form <code>/*/{name}/{profiles}</code>
-which can be used to control cryptography per application (name)
-and profile when clients call into the main Environment resource.</p>
-</div>
-<div class="admonitionblock note">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Note</div>
-</td>
-<td class="content">
-to control the cryptography in this granular way you must also
-provide a <code>@Bean</code> of type <code>TextEncryptorLocator</code> that creates a
-different encryptor per name and profiles. The one that is provided
-by default does not do this.
-</td>
-</tr>
-</table>
+to a remote, potentially insecure store.</p>
 </div>
 <div class="paragraph">
 <p>The <code>spring</code> command line client (with Spring Cloud CLI extensions
@@ -1699,7 +1088,9 @@ it is just a single property value to configure.</p>
 <div class="paragraph">
 <p>To configure a symmetric key you just need to set <code>encrypt.key</code> to a
 secret String (or use an enviroment variable <code>ENCRYPT_KEY</code> to keep it
-out of plain text configuration files).</p>
+out of plain text configuration files). You can also POST a key value
+to the <code>/key</code> endpoint (but that won&#8217;t change any existing encrypted
+values in remote repositories).</p>
 </div>
 <div class="paragraph">
 <p>To configure an asymmetric key you can either set the key as a
@@ -1754,64 +1145,12 @@ your <code>application.yml</code> for the Config Server:</p>
 <pre>encrypt:
   keyStore:
     location: classpath:/server.jks
-    password: letmein
     alias: mytestkey
-    secret: changeme</pre>
+    password: letmein</pre>
 </div>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_using_multiple_keys_and_key_rotation">Using Multiple Keys and Key Rotation</h3>
-<div class="paragraph">
-<p>In addition to the <code>{cipher}</code> prefix in encrypted property values, the
-Config Server looks for <code>{name:value}</code> prefixes (zero or many) before
-the start of the (Base64 encoded) cipher text. The keys are passed to
-a <code>TextEncryptorLocator</code> which can do whatever logic it needs to
-locate a <code>TextEncryptor</code> for the cipher. If you have configured a
-keystore (<code>encrypt.keystore.location</code>) the default locator will look
-for keys in the store with aliases as supplied by the "key" prefix,
-i.e. with a cipher text like this:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>foo:
-  bar: `{cipher}{key:testkey}...`</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>the locator will look for a key named "testkey". A secret can also be
-supplied via a <code>{secret:&#8230;&#8203;}</code> value in the prefix, but if it is not
-the default is to use the keystore password (which is what you get
-when you build a keytore and don&#8217;t specify a secret). If you <strong>do</strong>
-supply a secret it is recommended that you also encrypt the secrets
-using a custom <code>SecretLocator</code>.</p>
-</div>
-<div class="paragraph">
-<p>Key rotation is hardly ever necessary on cryptographic grounds if the
-keys are only being used to encrypt a few bytes of configuration data
-(i.e. they are not being used elsewhere), but occasionally you might
-need to change the keys if there is a security breach for instance. In
-that case all the clients would need to change their source config
-files (e.g. in git) and use a new <code>{key:&#8230;&#8203;}</code> prefix in all the
-ciphers, checking beforehand of course that the key alias is available
-in the Config Server keystore.</p>
-</div>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Tip</div>
-</td>
-<td class="content">
-the <code>{name:value}</code> prefixes can also be added to plaintext posted
-to the <code>/encrypt</code> endpoint, if you want to let the Config Server
-handle all encryption as well as decryption.
-</td>
-</tr>
-</table>
-</div>
-</div>
-<div class="sect2">
 <h3 id="_embedding_the_config_server">Embedding the Config Server</h3>
 <div class="paragraph">
 <p>The Config Server runs best as a standalone application, but if you
@@ -1821,12 +1160,7 @@ need to you can embed it in another application. Just use the
 to serve the resources under a prefix. The prefix should start but not
 end with a "/". It is applied to the <code>@RequestMappings</code> in the Config
 Server (i.e. underneath the Spring Boot prefixes <code>server.servletPath</code>
-and <code>server.contextPath</code>). Another optional property that can be
-useful in this case is <code>spring.cloud.config.server.bootstrap</code> which is
-a flag to indicate that the server should configure itself from its
-own remote repository. The flag is off by default because it can delay
-startup, but when embedded in another application it makes sense to
-initialize the same way as any other application.</p>
+and <code>server.contextPath</code>).</p>
 </div>
 </div>
 </div>
@@ -1889,9 +1223,140 @@ an Exception.</p>
 </div>
 </div>
 <div class="sect2">
+<h3 id="_environment_changes">Environment Changes</h3>
+<div class="paragraph">
+<p>The application will listen for an <code>EnvironmentChangedEvent</code> and react
+to the change in a couple of standard ways (additional
+<code>ApplicationListeners</code> can be added as <code>@Beans</code> by the user in the
+normal way). When an <code>EnvironmentChangedEvent</code> is observed it will
+have a list of key values that have changed, and the application will
+use those to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Re-bind any <code>@ConfigurationProperties</code> beans in the context</p>
+</li>
+<li>
+<p>Set the logger levels for any properties in <code>logging.level.*</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Note that the Config Client does not by default poll for changes in
+the <code>Environment</code>, and generally we would not recommend that approach
+for detecting changes (although you could set it up with a
+<code>@Scheduled</code> annotation). If you have a scaled-out client application
+then it is better to broadcast the <code>EnvironmentChangedEvent</code> to all
+the instances instead of having them polling for changes (e.g. using
+the <a href="https://github.com/spring-cloud/spring-cloud-bus">Spring Cloud
+Bus</a>).</p>
+</div>
+<div class="paragraph">
+<p>The <code>EnvironmentChangedEvent</code> covers a large class of refresh use
+cases, as long as you can actually make a change to the <code>Environment</code>
+and publish the event (those APIs are public and part of core
+Spring). You can verify the changes are bound to
+<code>@ConfigurationProperties</code> beans by visiting the <code>/configprops</code>
+endpoint (normal Spring Boot Actuator feature). For instance a
+<code>DataSource</code> can have its <code>maxPoolSize</code> changed at runtime (the
+default <code>DataSource</code> created by Spring Boot is an
+<code>@ConfigurationProperties</code> bean) and grow capacity
+dynamically. Re-binding <code>@ConfigurationProperties</code> does not cover
+another large class of use cases, where you need more control over the
+refresh, and where you need a change to be atomic over the whole
+<code>ApplicationContext</code>. To address those concerns we have
+<code>@RefreshScope</code>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_refresh_scope">Refresh Scope</h3>
+<div class="paragraph">
+<p>A Spring <code>@Bean</code> that is marked as <code>@RefreshScope</code> will get special
+treatment when there is a configuration change. This addresses the
+problem of stateful beans that only get their configuration injected
+when they are initialized. For instance if a <code>DataSource</code> has open
+connections when the database URL is changed via the <code>Environment</code>, we
+probably want the holders of those connections to be able to complete
+what they are doing. Then the next time someone borrows a connection
+from the pool he gets one with the new URL.</p>
+</div>
+<div class="paragraph">
+<p>Refresh scope beans are lazy proxies that initialize when they are
+used (i.e. when a method is called), and the scope acts as a cache of
+initialized values. To force a bean to re-initialize on the next
+method call you just need to invalidate its cache entry.</p>
+</div>
+<div class="paragraph">
+<p>The <code>RefreshScope</code> is a bean in the context and it has a public method
+<code>refreshAll()</code> to refresh all beans in the scope by clearing the
+target cache. There is also a <code>refresh(String)</code> method to refresh an
+individual bean by name. This functionality is exposed in the
+<code>/refresh</code> endpoint (over HTTP or JMX).</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">
+<code>@RefreshScope</code> works (technically) on an <code>@Configuration</code>
+class, but it might lead to surprising behaviour: e.g. it does <strong>not</strong>
+mean that all the <code>@Beans</code> defined in that class are themselves
+<code>@RefreshScope</code>. Specifically, anything that depends on those beans
+cannot rely on them being updated when a refresh is initiated, unless
+it is itself in <code>@RefreshScope</code> (in which it will be rebuilt on a
+refresh and its dependencies re-injected, at which point they will be
+re-initialized from the refreshed <code>@Configuration</code>).
+</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_encryption_and_decryption_2">Encryption and Decryption</h3>
+<div class="paragraph">
+<p>The Config Client has an <code>Environment</code> pre-processor for decrypting
+property values locally. It follows the same rules as the Config
+Server, and has the same external configuration via <code>encrypt.*</code>. Thus
+you can use encrypted values in the form <code>{cipher}*</code> and as long as
+there is a valid key then they will be decrypted before the main
+application context gets the <code>Environment</code>. To use the encryption
+features in a client you need to include Spring Security RSA in your
+classpath (Maven co-ordinates
+"org.springframework.security:spring-security-rsa") and you also need
+the full strength JCE extensions in your JVM (google it and download
+from Oracle).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_endpoints">Endpoints</h3>
+<div class="paragraph">
+<p>For a Spring Boot Actuator application there are some additional management endpoints:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>POST to <code>/env</code> to update the <code>Environment</code> and rebind <code>@ConfigurationProperties</code> and log levels</p>
+</li>
+<li>
+<p><code>/refresh</code> for re-loading the boot strap context and refreshing the <code>@RefreshScope</code> beans</p>
+</li>
+<li>
+<p><code>/restart</code> for closing the <code>ApplicationContext</code> and restarting it (disabled by default)</p>
+</li>
+<li>
+<p><code>/pause</code> and <code>/resume</code> for calling the <code>Lifecycle</code> methods (<code>stop()</code> and <code>start()</code> on the <code>ApplicationContext</code>)</p>
+</li>
+</ul>
+</div>
+</div>
+<div class="sect2">
 <h3 id="_locating_remote_configuration_resources">Locating Remote Configuration Resources</h3>
 <div class="paragraph">
-<p>The Config Service serves property sources from <code>/{name}/{env}/{label}</code>, where the default bindings in the client app are</p>
+<p>The Config Service serves property sources from <code>/{name}/{env}/{label}</code>, where the default bindings in the
+client app are</p>
 </div>
 <div class="ulist">
 <ul>
@@ -1911,11 +1376,201 @@ an Exception.</p>
 (where <code>*</code> is "name", "env" or "label"). The "label" is useful for
 rolling back to previous versions of configuration; with the default
 Config Server implementation it can be a git label, branch name or
-commit id. Label can also be provided as a comma-separated list, in
-which case the items in the list are tried on-by-one until one succeeds.
-This can be useful when working on a feature branch, for instance,
-when you might want to align the config label with your branch, but
-make it optional (e.g. <code>spring.cloud.config.label=myfeature,develop</code>).</p>
+commit id.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_the_bootstrap_application_context">The Bootstrap Application Context</h3>
+<div class="paragraph">
+<p>The Config Client operates by creating a "bootstrap" application
+context, which is a parent context for the main application. Out of
+the box it is responsible for loading configuration properties from
+the Config Server, and also decrypting properties in the local
+external configuration files. The two contexts share an <code>Environment</code>
+which is the source of external properties for any Spring
+application. Bootstrap properties are added with high precedence, so
+they cannot be overridden by local configuration.</p>
+</div>
+<div class="paragraph">
+<p>The bootstrap context uses a different convention for locating
+external configuration than the main application context, so instead
+of <code>application.yml</code> (or <code>.properties</code>) you use <code>bootstrap.yml</code>,
+keeping the external configuration for bootstrap and main context
+nicely separate. Example:</p>
+</div>
+<div class="listingblock">
+<div class="title">bootstrap.yml</div>
+<div class="content">
+<pre>spring:
+  application:
+    name: foo
+  cloud:
+    config:
+      uri: ${SPRING_CONFIG_URI:http://localhost:8888}</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It is a good idea to set the <code>spring.application.name</code> (in
+<code>bootstrap.yml</code> or <code>application.yml</code>) if your application needs any
+application-specific configuration from the server.</p>
+</div>
+<div class="paragraph">
+<p>You can disable the bootstrap process completely by setting
+<code>spring.cloud.bootstrap.enabled=false</code> (e.g. in System properties).</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_application_context_hierarchies">Application Context Hierarchies</h3>
+<div class="paragraph">
+<p>If you build an application context from <code>SpringApplication</code> or
+<code>SpringApplicationBuilder</code>, then the Bootstrap context is added as a
+parent to that context. It is a feature of Spring that child contexts
+inherit property sources and profiles from their parent, so the "main"
+application context will contain additional property sources, compared
+to building the same context without Spring Cloud Config. The
+additional property sources are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>"bootstrap": an optional <code>CompositePropertySource</code> appears with high
+priority if any <code>PropertySourceLocators</code> are found in the Bootstrap
+context, and they have non-empty properties. An example would be
+properties from the Spring Cloud Config Server. See
+<a href="#customizing-bootstrap-property-sources">below</a> for instructions
+on how to customize the contents of this property source.</p>
+</li>
+<li>
+<p>"applicationConfig: [classpath:bootstrap.yml]" (and friends if
+Spring profiles are active). If you have a <code>bootstrap.yml</code> (or
+properties) then those properties are used to configure the Bootstrap
+context, and then they get added to the child context when its parent
+is set. They have lower precedence than the <code>application.yml</code> (or
+properties) and any other property sources that are added to the child
+as a normal part of the process of creating a Spring Boot
+application. See <a href="#customizing-bootstrap-properties">below</a> for
+instructions on how to customize the contents of these property
+sources.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>Because of the ordering rules of property sources the "bootstrap"
+entries take precedence, but note that these do not contain any data
+from <code>bootstrap.yml</code>, which has very low precedence, but can be used
+to set defaults.</p>
+</div>
+<div class="paragraph">
+<p>You can extend the context hierarchy by simply setting the parent
+context of any <code>ApplicationContext</code> you create, e.g. using its own
+interface, or with the <code>SpringApplicationBuilder</code> convenience methods
+(<code>parent()</code>, <code>child()</code> and <code>sibling()</code>). The bootstrap context will be
+the parent of the most senior ancestor that you create yourself.
+Every context in the hierarchy will have its own "bootstrap" property
+source (possibly empty) to avoid promoting values inadvertently from
+parents down to their descendants.  Every context in the hierarchy can
+also (in principle) have a different <code>spring.application.name</code> and
+hence a different remote property source if there is a Config
+Server. Normal Spring application context behaviour rules apply to
+property resolution: properties from a child context override those in
+the parent, by name and also by property source name (if the child has
+a property source with the same name as the parent, the one from the
+parent is not included in the child).</p>
+</div>
+<div class="paragraph">
+<p>Note that the <code>SpringApplicationBuilder</code> allows you to share an
+<code>Environment</code> amongst the whole hierarchy, but that is not the
+default. Thus, sibling contexts in particular do not need to have the
+same profiles or property sources, even though they will share common
+things with their parent.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customizing-bootstrap-properties">Changing the Location of Bootstrap Properties</h3>
+<div class="paragraph">
+<p>The <code>bootstrap.yml</code> (or <code>.properties) location can be specified using
+`spring.cloud.bootstrap.name</code> (default "bootstrap") or
+<code>spring.cloud.bootstrap.location</code> (default empty), e.g. in System
+properties. Those properties behave like the <code>spring.config.*</code>
+variants with the same name, in fact they are used to set up the
+bootstrap <code>ApplicationContext</code> by setting those properties in its
+<code>Environment</code>. If there is an active profile (from
+<code>spring.profiles.active</code> or through the <code>Environment</code> API in the
+context you are building) then properties in that profile will be
+loaded as well, just like in a regular Spring Boot app, e.g. from
+<code>bootstrap-development.properties</code> for a "development" profile.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_customizing_the_bootstrap_configuration">Customizing the Bootstrap Configuration</h3>
+<div class="paragraph">
+<p>The bootstrap context can be trained to do anything you like by adding
+entries to <code>/META-INF/spring.factories</code> under the key
+<code>org.springframework.cloud.bootstrap.BootstrapConfiguration</code>. This is
+a comma-separated list of Spring <code>@Configuration</code> classes which will
+be used to create the context. Any beans that you want to be available
+to the main application context for autowiring can be created here,
+and also there is a special contract for <code>@Beans</code> of type
+<code>ApplicationContextInitializer</code>.</p>
+</div>
+<div class="paragraph">
+<p>The bootstrap process ends by injecting initializers into the main
+<code>SpringApplication</code> instance (i.e. the normal Spring Boot startup
+sequence, whether it is running as a standalone app or deployed in an
+application server). First a bootstrap context is created from the
+classes found in <code>spring.factories</code> and then all <code>@Beans</code> of type
+<code>ApplicationContextInitializer</code> are added to the main
+<code>SpringApplication</code> before it is started.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="customizing-bootstrap-property-sources">Customizing the Bootstrap Property Sources</h3>
+<div class="paragraph">
+<p>The default property source for external configuration added by the
+bootstrap process is the Config Server, but you can add additional
+sources by adding beans of type <code>PropertySourceLocator</code> to the
+bootstrap context (via <code>spring.factories</code>). You could use this to
+insert additional properties from a different server, or from a
+database, for instance.</p>
+</div>
+<div class="paragraph">
+<p>As an example, consider the following trivial custom locator:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">@Configuration
+public class CustomPropertySourceLocator implements PropertySourceLocator {
+
+    @Override
+    public PropertySource&lt;?&gt; locate(Environment environment) {
+        return new MapPropertySource("customProperty",
+                Collections.&lt;String, Object&gt;singletonMap("property.from.sample.custom.source", "worked as intended"));
+    }
+
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The <code>Environment</code> that is passed in is the one for the
+<code>ApplicationContext</code> about to be created, i.e. the one that we are
+supplying additional property sources for. It will already have its
+normal Spring Boot-provided property sources, so you can use those to
+locate a property source specific to this <code>Environment</code> (e.g. by
+keying it on the <code>spring.application.name</code>, as is done in the default
+Config Server property source locator).</p>
+</div>
+<div class="paragraph">
+<p>If you create a jar with this class in it and then add a
+<code>META-INF/spring.factories</code> containing:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>org.springframework.cloud.bootstrap.BootstrapConfiguration=sample.custom.CustomPropertySourceLocator</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>then the "customProperty" <code>PropertySource</code> will show up in any
+application that includes that jar on its classpath.</p>
 </div>
 </div>
 <div class="sect2">
@@ -1997,7 +1652,7 @@ Intelligent Routing (Zuul) and Client Side Load Balancing (Ribbon).
 <div class="sect2">
 <h3 id="_registering_with_eureka">Registering with Eureka</h3>
 <div class="paragraph">
-<p>When a client registers with Eureka, it provides meta-data about itself
+<p>When a client registers with Eureka, it provide meta-data about itself
 such as host and port, health indicator URL, home page etc.  Eureka
 receives heartbeat messages from each instance belonging to a service.
 If the heartbeat fails over a configurable timetable, the instance is
@@ -2106,9 +1761,9 @@ application, so it&#8217;s helpful if they are accurate.</p>
 <div class="content">
 <pre>eureka:
   instance:
-    hostname: ${vcap.application.uris[0]}
-    nonSecurePort: 80
     metadataMap:
+      hostname: ${vcap.application.uris[0]}
+      nonSecurePort: 80
       instanceId: ${vcap.application.instance_id:${spring.application.name}:${spring.application.instance_id:${server.port}}}</pre>
 </div>
 </div>
@@ -2131,7 +1786,7 @@ application, so it&#8217;s helpful if they are accurate.</p>
 </div>
 </div>
 <div class="paragraph">
-<p>With this metadata, and multiple service instances deployed on
+<p>With this meatdata, and multiple service instances deployed on
 localhost, the random value will kick in there to make the instance
 unique. In Cloudfoundry the <code>spring.application.instance_id</code> will be
 populated automatically in a Spring Boot Actuator application, so the
@@ -2143,9 +1798,7 @@ random value will not be needed.</p>
 <h3 id="_using_the_discoveryclient">Using the DiscoveryClient</h3>
 <div class="paragraph">
 <p>Once you have an app that is <code>@EnableEurekaClient</code> you can use it to
-discover service instances from the <a href="#spring-cloud-eureka-server">Eureka Server</a>. One way to do that is to use the native
-<code>com.netflix.discovery.DiscoveryClient</code> (as opposed to the Spring
-Cloud <code>DiscoveryClient</code>), e.g.</p>
+discover service instances from the <a href="#spring-cloud-eureka-server">Eureka Server</a>. One way to do that is to use the native <code>DiscoveryClient</code>, e.g.</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -2178,7 +1831,7 @@ another <code>SmartLifecycle</code> with higher phase.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_alternatives_to_the_native_netflix_discoveryclient">Alternatives to the native Netflix DiscoveryClient</h3>
+<h3 id="_alternatives_to_the_discoveryclient">Alternatives to the DiscoveryClient</h3>
 <div class="paragraph">
 <p>You don&#8217;t have to use the raw Netflix <code>DiscoveryClient</code> and usually it
 is more convenient to use it behind a wrapper of some sort. Spring
@@ -2190,25 +1843,6 @@ can simply set <code>&lt;client&gt;.ribbon.listOfServers</code> to a comma-separ
 list of physical addresses (or hostnames), where <code>&lt;client&gt;</code> is the ID
 of the client.</p>
 </div>
-<div class="paragraph">
-<p>You can also use the <code>org.springframework.cloud.client.discovery.DiscoveryClient</code>
-which provides a simple API for discovery clients that is not specific
-to Netflix, e.g.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>@Autowired
-private DiscoveryClient discoveryClient;
-
-public String serviceUrl() {
-    List&lt;ServiceInstance&gt; list = client.getInstances("STORES");
-    if (list != null &amp;&amp; list.size() &gt; 0 ) {
-        return list.get(0).getUri();
-    }
-    return null;
-}</pre>
-</div>
-</div>
 </div>
 <div class="sect2">
 <h3 id="_why_is_it_so_slow_to_register_a_service">Why is it so Slow to Register a Service?</h3>
@@ -2231,11 +1865,12 @@ assumptions about the lease renewal period.</p>
 <h2 id="spring-cloud-eureka-server">Service Discovery: Eureka Server</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>Example eureka server (e.g. using spring-cloud-starter-eureka-server to set up the classpath):</p>
+<p>Example eureka server:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code class="language-java" data-lang="java">@SpringBootApplication
+<pre class="highlight"><code class="language-java" data-lang="java">@Configuration
+@EnableAutoConfiguration
 @EnableEurekaServer
 public class Application {
 
@@ -2304,32 +1939,34 @@ springBoot {
 </tr>
 </table>
 </div>
-<div class="admonitionblock tip">
+<div class="admonitionblock note">
 <table>
 <tr>
 <td class="icon">
-<div class="title">Tip</div>
+<div class="title">Note</div>
 </td>
 <td class="content">
 <div class="paragraph">
-<p>Due to Gradle&#8217;s dependency resolution rules and the lack of a parent bom feature, simply depending on spring-cloud-starter-eureka-server can cause failures on application startup. To remedy this the Spring dependency management plugin must be added and the Spring cloud starter parent bom must be imported like so:</p>
+<p>The Eureka server is tied to log4j and doesn&#8217;t work with logback,
+so the dependency configuration
+has to be tweaked compared to a normal Spring Boot app. The
+<code>spring-cloud-starter-eureka-server</code> does this for you, but if you
+add logback transitively through another dependency you will need to
+exclude it manually, e.g. in Maven</p>
 </div>
 <div class="listingblock">
-<div class="title">build.gradle</div>
+<div class="title">pom.xml</div>
 <div class="content">
-<pre class="highlight"><code class="language-java" data-lang="java">buildscript {
-  dependencies {
-    classpath "io.spring.gradle:dependency-management-plugin:0.4.0.RELEASE"
-  }
-}
-
-apply plugin: "io.spring.dependency-management"
-
-dependencyManagement {
-  imports {
-    mavenBom 'org.springframework.cloud:spring-cloud-starter-parent:1.0.0.RELEASE'
-  }
-}</code></pre>
+<pre class="highlight"><code class="language-xml" data-lang="xml">&lt;dependency&gt;
+    &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
+    &lt;artifactId&gt;spring-boot-starter-web&lt;/artifactId&gt;
+    &lt;exclusions&gt;
+        &lt;exclusion&gt;
+            &lt;artifactId&gt;spring-boot-starter-logging&lt;/artifactId&gt;
+            &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;
+        &lt;/exclusion&gt;
+    &lt;/exclusions&gt;
+&lt;/dependency&gt;</code></pre>
 </div>
 </div>
 </td>
@@ -2477,8 +2114,9 @@ IP Address rather than its hostname.</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre>@SpringBootApplication
-@EnableCircuitBreaker
+<pre>@Configuration
+@EnableAutoConfiguration
+@EnableHystrix
 public class Application {
 
     public static void main(String[] args) {
@@ -2516,30 +2154,6 @@ attribute with a list of <code>@HystrixProperty</code> annotations.  See
 for more details.  See the <a href="https://github.com/Netflix/Hystrix/wiki/Configuration">Hystrix wiki</a>
 for details on the properties available.</p>
 </div>
-<div class="sect2">
-<h3 id="_propagating_the_security_context_or_using_spring_scopes">Propagating the Security Context or using Spring Scopes</h3>
-<div class="paragraph">
-<p>If you want some thread local context to propagate into a <code>@HystrixCommand</code> the default declaration will not work because it executes the command in a thread pool (in case of timeouts). You can switch Hystrix to use the same thread as the caller using some configuration, or directly in the annotation, by asking it to use a different "Isolation Strategy". For example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight"><code class="language-java" data-lang="java">@HystrixCommand(fallbackMethod = "stubMyService",
-    commandProperties = {
-      @HystrixProperty(name="execution.isolation.strategy", value="SEMAPHORE")
-    }
-)
-...</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>The same thing applies if you are using <code>@SessionScope</code> or <code>@RequestScope</code>. You will know when you need to do this because of a runtime exception that says it can&#8217;t find the scoped context.</p>
-</div>
-<div class="paragraph">
-<p>In particular you might be interested</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_health_indicator_2">Health Indicator</h3>
 <div class="paragraph">
 <p>The state of the connected circuit breakers are also exposed in the
 <code>/health</code> endpoint of the calling application.</p>
@@ -2557,7 +2171,6 @@ for details on the properties available.</p>
 }</code></pre>
 </div>
 </div>
-</div>
 <div class="sect2">
 <h3 id="_hystrix_metrics_stream">Hystrix Metrics Stream</h3>
 <div class="paragraph">
@@ -2592,10 +2205,10 @@ for details on the properties available.</p>
 <div class="sect2">
 <h3 id="_turbine">Turbine</h3>
 <div class="paragraph">
-<p>Looking at an individual instances Hystrix data is not very useful in terms of the overall health of the system.  <a href="https://github.com/Netflix/Turbine">Turbine</a> is an application that aggregates all of the relevant <code>/hystrix.stream</code> endpoints into a combined <code>/turbine.stream</code> for use in the Hystrix Dashboard.  Individual instances are located via Eureka.  Running Turbine is as simple as annotating your main class with the <code>@EnableTurbine</code> annotation  (e.g. using spring-cloud-starter-turbine to set up the classpath).  All of the documented configuration properties from <a href="https://github.com/Netflix/Turbine/wiki/Configuration-(1.x)">the Turbine 1 wiki</a> apply.  The only difference is that the <code>turbine.instanceUrlSuffix</code> does not need the port prepended as this is handled automatically unless <code>turbine.instanceInsertPort=false</code>.</p>
+<p>Looking at an individual instances Hystrix data is not very useful in terms of the overall health of the system.  <a href="https://github.com/Netflix/Turbine">Turbine</a> is an application that aggregates all of the relevant <code>/hystrix.stream</code> endpoints into a combined <code>/turbine.stream</code> for use in the Hystrix Dashboard.  Individual instances are located via Eureka.  Running Turbine is as simple as annotating your main class with the <code>@EnableTurbine</code> annotation.  All of the documented configuration properties from <a href="https://github.com/Netflix/Turbine/wiki/Configuration-(1.x)">the Turbine 1 wiki</a> apply.  The only difference is that the <code>turbine.instanceUrlSuffix</code> does not need the port prepended as this is handled automatically unless <code>turbine.instanceInsertPort=false</code>.</p>
 </div>
 <div class="paragraph">
-<p>The configuration key <code>turbine.appConfig</code> is a list of eureka serviceIds that turbine will use to lookup instances.  The turbine stream is then used in the Hystrix dashboard using a url that looks like: <code><a href="http://my.turbine.sever:8080/turbine.stream?cluster=&lt;CLUSTERNAME&gt" class="bare">http://my.turbine.sever:8080/turbine.stream?cluster=&lt;CLUSTERNAME&gt</a>;</code> (the cluster parameter can be omitted if the name is "default"). The <code>cluster</code> parameter must match an entry in <code>turbine.aggregator.clusterConfig</code>. Values returned from eureka are uppercase, thus we expect this example to work if there is an app registered with Eureka called "customers":</p>
+<p>Configuration key <code>turbine.appConfig</code> is a list of eureka serviceId&#8217;s that turbine will use to lookup instances.  The turbine stream is then used in the Hystrix dashboard using a url that looks like: <code><a href="http://my.turbine.sever:8080/turbine.stream?cluster=&lt;CLUSTERNAME&gt" class="bare">http://my.turbine.sever:8080/turbine.stream?cluster=&lt;CLUSTERNAME&gt</a>;</code> (the cluster parameter can be omitted if the name is "default"). The <code>cluster</code> parameter must match an entry in <code>turbine.aggregator.clusterConfig</code>. Value returned from eureka are uppercase, thus we expect this example to work if there is an app registered with Eureka called "customers":</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -2606,22 +2219,7 @@ for details on the properties available.</p>
 </div>
 </div>
 <div class="paragraph">
-<p>The <code>clusterName</code> can be customized by a SPEL expression in <code>turbine.clusterNameExpression</code> with root an instance of <code>InstanceInfo</code>. The default value is <code>appName</code>, which means that the Eureka serviceId ends up as the cluster key (i.e. the <code>InstanceInfo</code> for customers has an <code>appName</code> of "CUSTOMERS").  A different example would be <code>turbine.clusterNameExpression=aSGName</code>, which would get the cluster name from the AWS ASG name. Another example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>turbine:
-  aggregator:
-    clusterConfig: SYSTEM,USER
-  appConfig: customers,stores,ui,admin
-  clusterNameExpression: metadata.cluster</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>In this case, the cluster name from 4 services is pulled from their metadata map, and is expected to have values that include "SYSTEM" and "USER".</p>
-</div>
-<div class="paragraph">
-<p>To use the "default" cluster for all apps you need a string literal expression (with single quotes):</p>
+<p>The <code>clusterName</code> can be customized by a SPEL expression in <code>turbine.clusterNameExpression</code>.  For example, <code>turbine.clusterNameExpression=aSGName</code> would get the cluster name from the AWS ASG name. To use the "default" cluster for all apps you need a string literal expression (with single quotes):</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -2682,7 +2280,7 @@ so if you are using <code>@FeignClient</code> then this section also applies.</p
 <div class="paragraph">
 <p>A central concept in Ribbon is that of the named client. Each load
 balancer is part of an ensemble of components that work together to
-contact a remote server on demand, and the ensemble has a name that
+contact a remote server on demend, and the ensemble has a name that
 you give it as an application developer (e.g. using the <code>@FeignClient</code>
 annotation). Spring Cloud creates a new ensemble as an
 <code>ApplicationContext</code> on demand for each named client using
@@ -2717,24 +2315,6 @@ public class TestConfiguration {
 <code>RibbonClientConfiguration</code> together with any in <code>FooConfiguration</code>
 (where the latter generally will override the former).</p>
 </div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<div class="title">Warning</div>
-</td>
-<td class="content">
-The <code>FooConfiguration</code> has to be <code>@Configuration</code> but take
-care that it is not in a <code>@ComponentScan</code> for the main application
-context, otherwise it will be shared by all the <code>@RibbonClients</code>. If
-you use <code>@ComponentScan</code> (or <code>@SpringBootApplication</code>) you need to
-take steps to avoid it being included (for instance put it in a
-separate, non-overlapping package, or specify the packages to scan
-explicitly in the <code>@ComponentScan</code>).
-</td>
-</tr>
-</table>
-</div>
 <div class="paragraph">
 <p>Spring Cloud Netflix provides the following beans by default for ribbon
 (<code>BeanType</code> beanName: <code>ClassName</code>):</p>
@@ -2823,21 +2403,6 @@ configuration like this</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_example_disable_eureka_use_in_ribbon">Example: Disable Eureka use in Ribbon</h3>
-<div class="paragraph">
-<p>Setting the property <code>ribbon.eureka.enabled = false</code> will explicitly
-disable the use of Eureka in Ribbon.</p>
-</div>
-<div class="listingblock">
-<div class="title">application.yml</div>
-<div class="content">
-<pre>ribbon:
-  eureka:
-   enabled: false</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
 <h3 id="_using_the_ribbon_api_directly">Using the Ribbon API Directly</h3>
 <div class="paragraph">
 <p>You can also use the <code>LoadBalancerClient</code> directly. Example:</p>
@@ -2857,6 +2422,33 @@ disable the use of Eureka in Ribbon.</p>
 </div>
 </div>
 </div>
+<div class="sect2">
+<h3 id="_spring_resttemplate_as_a_ribbon_client">Spring RestTemplate as a Ribbon Client</h3>
+<div class="paragraph">
+<p>You can use Ribbon indirectly via an autoconfigured <code>RestTemplate</code>
+(provided Spring Cloud and Ribbon are both on the classpath):</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">public class MyClass {
+    @Autowired
+    private RestTemplate restTemplate;
+
+    public String doOtherStuff() {
+        String results = restTemplate.getForObject("http://stores/stores", String.class);
+        return results;
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The URI is inspected to see if it has a full host name, or a virtual
+one. If it is virtual the Ribbon client is used to create a full
+physical address. See
+<a href="http://github.com/{github-repo}/tree/{github-tag}/spring-cloud-netflix-core/src/main/java/org/springframework/cloud/netflix/ribbon/RibbonAutoConfiguration.java">RibbonAutoConfiguration</a>
+for details of how the <code>RestTemplate</code> is set up.</p>
+</div>
+</div>
 </div>
 </div>
 <div class="sect1">
@@ -3057,8 +2649,8 @@ and the serviceId independently:</p>
 <div class="paragraph">
 <p>This means that http calls to "/myusers" get forwarded to the
 "users_service" service.  The route has to have a "path" which can be
-specified as an ant-style pattern, so "/myusers/*" only matches one
-level, but "/myusers/**" matches hierarchically.</p>
+specified as an ant-style pattern, so "/myusers/<strong>" only matches one
+level, but "/myusers/</strong>*" matches hierarchically.</p>
 </div>
 <div class="paragraph">
 <p>The location of the backend can be specified as either a "serviceId"
@@ -3075,30 +2667,6 @@ level, but "/myusers/**" matches hierarchically.</p>
 </div>
 </div>
 <div class="paragraph">
-<p>These simple url-routes doesn&#8217;t get executed as HystrixCommand nor can you loadbalance multiple url with Ribbon.
-To achieve this specify a service-route and configure a Ribbon client for the
-serviceId (this currently requires disabling Eureka support in Ribbon:
-see <a href="#spring-cloud-ribbon-without-eureka">above for more information</a>), e.g.</p>
-</div>
-<div class="listingblock">
-<div class="title">application.yml</div>
-<div class="content">
-<pre class="highlight"><code class="language-yaml" data-lang="yaml">zuul:
-  routes:
-    users:
-      path: /myusers/**
-      serviceId: users
-
-ribbon:
-  eureka:
-    enabled: false
-
-users:
-  ribbon:
-    listOfServers: example.com,google.com</code></pre>
-</div>
-</div>
-<div class="paragraph">
 <p>To add a prefix to all mappings, set <code>zuul.prefix</code> to a value, such as
 <code>/api</code>. The proxy prefix is stripped from the request before the
 request is forwarded by default (switch this behaviour off with
@@ -3139,47 +2707,11 @@ server if you set a default route ("/"), for example <code>zuul.route.home:
 </div>
 </div>
 <div class="sect2">
-<h3 id="_uploading_files_through_zuul">Uploading Files through Zuul</h3>
-<div class="paragraph">
-<p>If you <code>@EnableZuulProxy</code> you can use the proxy paths to
-upload files and it should just work as long as the files
-are small. For large files there is an alternative path
-which bypasses the Spring <code>DispatcherServlet</code> (to
-avoid multipart processing) in "/zuul/<strong>". I.e. if
-<code>zuul.routes.customers=/customers/</strong>*</code> then you can
-POST large files to "/zuul/customers/*". The servlet
-path is externalized via <code>zuul.servletPath</code>. Extremely
-large files will also require elevated timeout settings
-if the proxy route takes you through a Ribbon load
-balancer, e.g.</p>
-</div>
-<div class="listingblock">
-<div class="title">application.yml</div>
-<div class="content">
-<pre class="highlight"><code class="language-yaml" data-lang="yaml">hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 60000
-ribbon:
-  ConnectTimeout: 3000
-  ReadTimeout: 60000</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Note that for streaming to work with large files, you need to use chunked encoding in the request (which some browsers
-do not do by default). E.g. on the command line:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>$ curl -v -H "Transfer-Encoding: chunked" \
-    -F "file=@mylarge.iso" localhost:9999/zuul/simple/file</pre>
-</div>
-</div>
-</div>
-<div class="sect2">
 <h3 id="_plain_embedded_zuul">Plain Embedded Zuul</h3>
 <div class="paragraph">
 <p>You can also run a Zuul server without the proxying, or switch on parts of the proxying platform selectively, if you
 use <code>@EnableZuulServer</code> (instead of <code>@EnableZuulProxy</code>). Any beans that you add to the application of type <code>ZuulFilter</code>
-will be installed automatically, as they are with <code>@EnableZuulProxy</code>, but without any of the proxy filters being added
-automatically.</p>
+will be installed automatically.</p>
 </div>
 <div class="paragraph">
 <p>In this case the routes into the Zuul server are
@@ -3199,18 +2731,6 @@ still specified by configuring "zuul.routes.*", but there is no service discover
 </div>
 </div>
 <div class="sect2">
-<h3 id="_disable_zuul_filters">Disable Zuul Filters</h3>
-<div class="paragraph">
-<p>Zuul for Spring Cloud comes with a number of <code>ZuulFilter</code> beans enabled by default
-in both proxy and server mode.  See <a href="https://github.com/spring-cloud/spring-cloud-netflix/tree/master/spring-cloud-netflix-core/src/main/java/org/springframework/cloud/netflix/zuul/filters">the zuul filters package</a> for the
-possible filters that are enabled.  If you want to disable one, simply set
-<code>zuul.&lt;SimpleClassName&gt;.&lt;filterType&gt;.disable=true</code>. By convention, the package after
-<code>filters</code> is the Zuul filter type. For example to disable
-<code>org.springframework.cloud.netflix.zuul.filters.post.SendResponseFilter</code> set
-<code>zuul.SendResponseFilter.post.disable=true</code>.</p>
-</div>
-</div>
-<div class="sect2">
 <h3 id="_polyglot_support_with_sidecar">Polyglot support with Sidecar</h3>
 <div class="paragraph">
 <p>Do you have non-jvm languages you want to take advantage of Eureka, Ribbon and
@@ -3322,12 +2842,7 @@ info:
 <h1 id="_spring_cloud_bus" class="sect0">Spring Cloud Bus</h1>
 <div class="openblock partintro">
 <div class="content">
-<div class="paragraph">
-<p>Spring Cloud Bus links nodes of a distributed system with a lightweight message broker. This can then be used to broadcast state changes (e.g. configuration changes) or other management instructions. A key idea is that the Bus is like a distributed Actuator for a Spring Boot application that is scaled out, but it can also be used as a communication channel between apps. The only implementation currently is with an AMQP broker as the transport, but the same basic feature set (and some more depending on the transport) is on the roadmap for other transports.</p>
-</div>
-<div class="paragraph">
-<p><a href="https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc" class="bare">https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc</a></p>
-</div>
+Spring Cloud Bus links nodes of a distributed system with a lightweight message broker. This can then be used to broadcast state changes (e.g. configuration changes) or other management instructions. A key idea is that the Bus is like a distributed Actuator for a Spring Boot application that is scaled out, but it can also be used as a communication channel between apps. The only implementation currently is with an AMQP broker as the transport, but the same basic feature set (and some more depending on the transport) is on the roadmap for other transports.
 </div>
 </div>
 <div class="sect1">
@@ -3353,30 +2868,6 @@ info:
 </div>
 </div>
 <div class="sect1">
-<h2 id="_addressing_an_instance">Addressing an Instance</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The HTTP endpoints accept a "destination" parameter, e.g. "/bus/refresh?destination=customers:9000", where the destination is an <code>ApplicationContext</code> ID. If the ID is owned by an instance on the Bus then it will process the message and all other instances will ignore it. Spring Boot sets the ID for you in the <code>ContextIdApplicationContextInitializer</code> to a combination of the <code>spring.application.name</code>, active profiles and <code>server.port</code> by default.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_addressing_all_instances_of_a_service">Addressing all instances of a service</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The "destination" parameter is used in a Spring <code>PathMatcher</code> (with the path separator as a colon <code>:</code>) to determine if an instance will process the message.   Using the example from above, "/bus/refresh?destination=customers:**" will  target  all instances of the "customers" service regardless of the profiles and ports set as the <code>ApplicationContext</code> ID.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_application_context_id_must_be_unique">Application Context ID must be unique</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The bus tries to eliminate processing an event twice, once from the original <code>ApplicationEvent</code> and once from the queue.  To do this, it checks the sending application context id againts the current application context id.  If multiple instances of a service have the same application context id, events will not be processed.  Running on a local machine, each service will be on a different port and that will be part of the application context id.  Cloud Foundry supplies an index to differentiate.  To ensure that the application context id is the unique, set <code>spring.application.index</code> to something unique for each instance of a service.  For example, in lattice, set <code>spring.application.index=${INSTANCE_INDEX}</code> in application.properties (or bootstrap.properties if using configserver).</p>
-</div>
-</div>
-</div>
-<div class="sect1">
 <h2 id="_customizing_the_amqp_connectionfactory_2">Customizing the AMQP ConnectionFactory</h2>
 <div class="sectionbody">
 <div class="paragraph">
@@ -3398,15 +2889,8 @@ and annotate them <code>@BusConnectionFactory</code> and <code>@Primary</code> r
 <h1 id="_spring_boot_cloud_cli" class="sect0">Spring Boot Cloud CLI</h1>
 <div class="openblock partintro">
 <div class="content">
-<div class="paragraph">
-<p>Spring Boot CLI provides <a href="http://projects.spring.io/spring-boot">Spring Boot</a> command line features for
-<a href="https://github.com/spring-cloud">Spring Cloud</a>. You can write Groovy scripts to run Spring Cloud component applications
-(e.g. <code>@EnableEurekaServer</code>). You can also easily do things like encryption and decryption to support Spring Cloud
-Config clients with secret configuration values.</p>
-</div>
-<div class="paragraph">
-<p><a href="https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc" class="bare">https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc</a></p>
-</div>
+Spring Boot command line features for
+<a href="https://github.com/spring-cloud">Spring Cloud</a>.
 </div>
 </div>
 <div class="sect1">
@@ -3421,7 +2905,7 @@ sure you have
 <div class="literalblock">
 <div class="content">
 <pre>$ spring version
-Spring CLI v1.2.3.RELEASE</pre>
+Spring CLI v1.2.1.RELEASE</pre>
 </div>
 </div>
 <div class="paragraph">
@@ -3429,8 +2913,8 @@ Spring CLI v1.2.3.RELEASE</pre>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlight"><code>$ gvm install springboot 1.2.3.RELEASE
-$ gvm use springboot 1.2.3.RELEASE</code></pre>
+<pre class="highlight"><code>$ gvm install springboot 1.2.1.RELEASE
+$ gvm use springboot 1.2.1.RELEASE</code></pre>
 </div>
 </div>
 <div class="paragraph">
@@ -3439,9 +2923,11 @@ $ gvm use springboot 1.2.3.RELEASE</code></pre>
 <div class="listingblock">
 <div class="content">
 <pre class="highlight"><code>$ mvn install
-$ spring install org.springframework.cloud:spring-cloud-cli:1.0.2.RELEASE</code></pre>
+$ spring install org.springframework.cloud:spring-cloud-cli:1.0.0.BUILD-SNAPSHOT</code></pre>
 </div>
 </div>
+<div class="sect2">
+<h3 id="_encryption_and_decryption_3">Encryption and Decryption</h3>
 <div class="admonitionblock important">
 <table>
 <tr>
@@ -3460,84 +2946,11 @@ in the JRE lib/security directory with the ones that you downloaded).
 </div>
 </div>
 </div>
-<div class="sect1">
-<h2 id="_writing_groovy_scripts_and_running_applications">Writing Groovy Scripts and Running Applications</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Spring Cloud CLI has support for most of the Spring Cloud declarative
-features, such as the <code>@Enable*</code> class of annotations. For example,
-here is a fully functional Eureka server</p>
-</div>
-<div class="listingblock">
-<div class="title">app.groovy</div>
-<div class="content">
-<pre class="highlight"><code class="language-groovy" data-lang="groovy">@EnableEurekaServer
-class Eureka {}</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>which you can run from the command line like this</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>$ spring run app.groovy</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To include additional dependencies, often it suffices just to add the
-appropriate feature-enabling annotation, e.g. <code>@EnableConfigServer</code>,
-<code>@EnableOAuth2Sso</code> or <code>@EnableEurekaClient</code>. To manually include a
-dependency you can use a <code>@Grab</code> with the special "Spring Boot" short
-style artifact co-ordinates, i.e. with just the artifact ID (no need
-for group or version information), e.g. to set up a client app to
-listen on AMQP for management events from the Spring CLoud Bus:</p>
-</div>
-<div class="listingblock">
-<div class="title">app.groovy</div>
-<div class="content">
-<pre class="highlight"><code class="language-groovy" data-lang="groovy">@Grab('spring-cloud-starter-bus-amqp')
-@RestController
-class Service {
-  @RequestMapping('/')
-  def home() { [message: 'Hello'] }
-}</code></pre>
-</div>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="_encryption_and_decryption_3">Encryption and Decryption</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The Spring Cloud CLI comes with an "encrypt" and a "decrypt"
-command. Both accept arguments in the same form with a key specified
-as a mandatory "--key", e.g.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>$ spring encrypt mysecret --key foo
-682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda
-$ spring decrypt --key foo 682bc583f4641835fa2db009355293665d2647dade3375c0ee201de2a49f7bda
-mysecret</pre>
-</div>
-</div>
-<div class="paragraph">
-<p>To use a key in a file (e.g. an RSA public key for encyption) prepend
-the key value with "@" and provide the file path, e.g.</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre>$ spring encrypt mysecret --key @${HOME}/.ssh/id_rsa.pub
-AQAjPgt3eFZQXwt8tsHAVv/QHiY5sI2dRcR+...</pre>
-</div>
-</div>
-</div>
 </div>
 <h1 id="_spring_cloud_security" class="sect0">Spring Cloud Security</h1>
 <div class="openblock partintro">
 <div class="content">
-<div class="paragraph">
-<p>Spring Cloud Security offers a set of primitives for building secure
+Spring Cloud Security offers a set of primitives for building secure
 applications and services with minimum fuss. A declarative model which
 can be heavily configured externally (or centrally) lends itself to
 the implementation of large systems of co-operating, remote components,
@@ -3545,11 +2958,7 @@ usually with a central indentity management service. It is also extremely
 easy to use in a service platform like Cloud Foundry. Building on
 Spring Boot and Spring Security OAuth2 we can quickly create systems that
 implement common patterns like single sign on, token relay and token
-exchange.</p>
-</div>
-<div class="paragraph">
-<p><a href="https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc" class="bare">https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing-docs.adoc</a></p>
-</div>
+exchange.
 </div>
 </div>
 <div class="sect1">
@@ -3611,17 +3020,16 @@ configuration:</p>
 <div class="listingblock">
 <div class="title">application.yml</div>
 <div class="content">
-<pre class="highlight"><code class="language-yaml" data-lang="yaml">spring:
-  oauth2:
-    client:
-      clientId: bd1c0a783ccdd1c9b9e4
-      clientSecret: 1a9030fbca47a5b2c28e92f19050bb77824b5ad1
-      accessTokenUri: https://github.com/login/oauth/access_token
-      userAuthorizationUri: https://github.com/login/oauth/authorize
-      clientAuthenticationScheme: form
-    resource:
-      userInfoUri: https://api.github.com/user
-      preferTokenInfo: false</code></pre>
+<pre class="highlight"><code class="language-yaml" data-lang="yaml">spring.oauth2:
+  client:
+    clientId: bd1c0a783ccdd1c9b9e4
+    clientSecret: 1a9030fbca47a5b2c28e92f19050bb77824b5ad1
+    tokenUri: https://github.com/login/oauth/access_token
+    authorizationUri: https://github.com/login/oauth/authorize
+    authenticationScheme: form
+  resource:
+    userInfoUri: https://api.github.com/user
+    preferTokenInfo: false</code></pre>
 </div>
 </div>
 <div class="paragraph">
@@ -3681,11 +3089,10 @@ class Application {
 <div class="listingblock">
 <div class="title">application.yml</div>
 <div class="content">
-<pre class="highlight"><code class="language-yaml" data-lang="yaml">spring:
-  oauth2:
-    resource:
-      userInfoUri: https://api.github.com/user
-      preferTokenInfo: false</code></pre>
+<pre class="highlight"><code class="language-yaml" data-lang="yaml">oauth2:
+  resource:
+    userInfoUri: https://api.github.com/user
+    preferTokenInfo: false</code></pre>
 </div>
 </div>
 </div>
@@ -3769,16 +3176,6 @@ of <code>AuthorizationCodeResourceDetails</code> so all its properties can be sp
 </div>
 </div>
 <div class="sect2">
-<h3 id="_token_type_in_user_info">Token Type in User Info</h3>
-<div class="paragraph">
-<p>Google (and certain other 3rd party identity providers) is more strict
-about the token type name that is sent in the headers to the user info
-endpoint. The default is "Bearer" which suits most providers and
-matches the spec, but if you need to change it you can set
-<code>spring.oauth2.resource.tokenType</code>.</p>
-</div>
-</div>
-<div class="sect2">
 <h3 id="_customizing_the_resttemplate">Customizing the RestTemplate</h3>
 <div class="paragraph">
 <p>The SSO (and Resource Server) features use an <code>OAuth2RestTemplate</code>
@@ -4017,7 +3414,7 @@ correct header.</p>
 traditional app), and that in turn triggers some autoconfiguration for
 a <code>ZuulFilter</code>, which itself is activated because Zuul is on the
 classpath (via <code>@EnableZuulProxy</code>). The
-{github}/tree/master/src/main/java/org/springframework/cloud/security/oauth2/proxy/OAuth2TokenRelayFilter.java[filter]
+<a href="https://github.com/spring-cloud/spring-cloud-security/tree/master/src/main/java/org/springframework/cloud/security/oauth2/proxy/OAuth2TokenRelayFilter.java">filter</a>
 just extracts an access token from the currently authenticated user,
 and puts it in a request header for the downstream requests.</p>
 </div>
@@ -4081,15 +3478,15 @@ relay if there is a token available, and passthru otherwise.</p>
 </div>
 <div class="paragraph">
 <p>See
-{github}/tree/master/src/main/java/org/springframework/cloud/security/oauth2/proxy/ProxyAuthenticationProperties[
-ProxyAuthenticationProperties] for full details.</p>
+<a href="https://github.com/spring-cloud/spring-cloud-security/tree/master/src/main/java/org/springframework/cloud/security/oauth2/proxy/ProxyAuthenticationProperties">
+ProxyAuthenticationProperties</a> for full details.</p>
 </div>
 </div>
 </div>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2015-06-19 15:18:07 UTC
+Last updated 2015-06-23 10:16:37 UTC
 </div>
 </div>
 </body>