diff --git a/docs/modules/ROOT/pages/_observability.adoc b/docs/modules/ROOT/pages/_observability.adoc index 2b4083fa..5eac1efb 100644 --- a/docs/modules/ROOT/pages/_observability.adoc +++ b/docs/modules/ROOT/pages/_observability.adoc @@ -2,6 +2,7 @@ [[observability]] = Observability metadata +:page-section-summary-toc: 1 include::{root-target}_metrics.adoc[] diff --git a/docs/modules/ROOT/pages/spring-cloud-config.adoc b/docs/modules/ROOT/pages/spring-cloud-config.adoc index e602d819..5b42f581 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config.adoc @@ -1,5 +1,6 @@ [[spring-cloud-config]] = Spring Cloud Config +:page-section-summary-toc: 1 :github: https://github.com/spring-cloud/spring-cloud-config :githubmaster: {github}/tree/master :docslink: {githubmaster}/docs/src/main/asciidoc diff --git a/docs/modules/ROOT/pages/spring-cloud-config/quick-start.adoc b/docs/modules/ROOT/pages/spring-cloud-config/quick-start.adoc index d79042e1..59e05139 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/quick-start.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/quick-start.adoc @@ -1,5 +1,6 @@ [[quick-start]] = Quick Start +:page-section-summary-toc: 1 include:../:quickstart.adoc[] diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/-aot-and-native-image-support.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/-aot-and-native-image-support.adoc index bb598a9f..ce7f15de 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/-aot-and-native-image-support.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/-aot-and-native-image-support.adoc @@ -1,5 +1,6 @@ [[-aot-and-native-image-support]] = AOT and Native Image Support +:page-section-summary-toc: 1 Since `4.0.0`, Spring Cloud Config Server supports Spring AOT transformations. However, for the time being, GraalVM native images are not supported. Implementing native image support is blocked by https://github.com/oracle/graal/issues/5134[graal#5134] and will likely require the completion of the work on https://github.com/graalvm/taming-build-time-initialization[https://github.com/graalvm/taming-build-time-initialization] to be fixed. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/actuator-and-security.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/actuator-and-security.adoc index 57147c25..80e8d8b7 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/actuator-and-security.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/actuator-and-security.adoc @@ -1,5 +1,6 @@ [[actuator-and-security]] = Actuator and Security +:page-section-summary-toc: 1 IMPORTANT: Some platforms configure health checks or something similar and point to `/actuator/health` or other actuator endpoints. If actuator is not a dependency of config server, requests to `/actuator/**` would match the config server API `/{application}/{label}` possibly leaking secure information. Remember to add the `spring-boot-starter-actuator` dependency in this case and configure the users such that the user that makes calls to `/actuator/**` does not have access to the config server API at `/{application}/{label}`. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/aws-parameter-store.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/aws-parameter-store.adoc index 9124418e..6383539f 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/aws-parameter-store.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/aws-parameter-store.adoc @@ -1,5 +1,6 @@ [[aws-parameter-store]] = AWS Parameter Store +:page-section-summary-toc: 1 When using AWS Parameter Store as a backend, you can share configuration with all applications by placing properties within the `/application` hierarchy. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/file-system-backend.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/file-system-backend.adoc index 10b3636e..5b2d7674 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/file-system-backend.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/file-system-backend.adoc @@ -1,5 +1,6 @@ [[file-system-backend]] = File System Backend +:page-section-summary-toc: 1 There is also a "`native`" profile in the Config Server that does not use Git but loads the config files from the local classpath or file system (any static URL you want to point to with `spring.cloud.config.server.native.searchLocations`). To use the native profile, launch the Config Server with `spring.profiles.active=native`. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/jdbc-backend.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/jdbc-backend.adoc index 12b52b52..f6963ed4 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/jdbc-backend.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/jdbc-backend.adoc @@ -1,5 +1,6 @@ [[jdbc-backend]] = JDBC Backend +:page-section-summary-toc: 1 Spring Cloud Config Server supports JDBC (relational database) as a backend for configuration properties. You can enable this feature by adding `spring-boot-starter-data-jdbc` to the classpath and using the `jdbc` profile or by adding a bean of type `JdbcEnvironmentRepository`. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-placeholders.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-placeholders.adoc index a0aa9c55..9fc7f2d9 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-placeholders.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-placeholders.adoc @@ -1,5 +1,6 @@ [[overriding-properties-using-placeholders]] = Overriding Properties Using Placeholders +:page-section-summary-toc: 1 A cleaner way to override properties without enabling config first bootstrap is to use property placeholders in the configuration coming from the config server. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-profiles.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-profiles.adoc index 8b0292a1..292d993e 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-profiles.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/overriding-properties-using-profiles.adoc @@ -1,5 +1,6 @@ [[overriding-properties-using-profiles]] = Overriding Properties Using Profiles +:page-section-summary-toc: 1 The final way to override properties coming from the config server is to specify them in profile specific configuration file within the client application. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/using-bootstrap-to-override-properties.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/using-bootstrap-to-override-properties.adoc index c175d364..02be41d4 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/using-bootstrap-to-override-properties.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/using-bootstrap-to-override-properties.adoc @@ -1,5 +1,6 @@ [[using-bootstrap-to-override-properties]] = Using Bootstrap To Override Properties +:page-section-summary-toc: 1 If you enable xref:spring-cloud-config/client.adoc#config-first-bootstrap[config first bootstrap], you can allow client applications to override configuration from the config server by placing two properties within the applications configuration coming from the config server. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/version-control-backend-filesystem-use.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/version-control-backend-filesystem-use.adoc index 0535f96b..49eda5ab 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/version-control-backend-filesystem-use.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/environment-repository/version-control-backend-filesystem-use.adoc @@ -1,5 +1,6 @@ [[version-control-backend-filesystem-use]] = Version Control Backend Filesystem Use +:page-section-summary-toc: 1 WARNING: With VCS-based backends (git, svn), files are checked out or cloned to the local filesystem. By default, they are put in the system temporary directory with a prefix of `config-repo-`. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/push-notifications-and-bus.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/push-notifications-and-bus.adoc index 8235bc44..a3ea89c1 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/push-notifications-and-bus.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/push-notifications-and-bus.adoc @@ -1,5 +1,6 @@ [[push-notifications-and-spring-cloud-bus]] = Push Notifications and Spring Cloud Bus +:page-section-summary-toc: 1 Many source code repository providers (such as Github, Gitlab, Gitea, Gitee, Gogs, or Bitbucket) notify you of changes in a repository through a webhook. You can configure the webhook through the provider's user interface as a URL and a set of events in which you are interested. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/security.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/security.adoc index 0834b77b..47b10c4f 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/security.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/security.adoc @@ -1,5 +1,6 @@ [[security]] = Security +:page-section-summary-toc: 1 You can secure your Config Server in any way that makes sense to you (from physical network security to OAuth2 bearer tokens), because Spring Security and Spring Boot offer support for many security arrangements. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/serving-alternative-formats.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/serving-alternative-formats.adoc index 578064d8..27e4afdc 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/serving-alternative-formats.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/serving-alternative-formats.adoc @@ -1,5 +1,6 @@ [[serving-alternative-formats]] = Serving Alternative Formats +:page-section-summary-toc: 1 The default JSON format from the environment endpoints is perfect for consumption by Spring applications, because it maps directly onto the `Environment` abstraction. If you prefer, you can consume the same data as YAML or Java properties by adding a suffix (".yml", ".yaml" or ".properties") to the resource path. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/serving-encrypted-properties.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/serving-encrypted-properties.adoc index fcec9de2..754ebfe2 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/serving-encrypted-properties.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/serving-encrypted-properties.adoc @@ -1,5 +1,6 @@ [[serving-encrypted-properties]] = Serving Encrypted Properties +:page-section-summary-toc: 1 Sometimes you want the clients to decrypt the configuration locally, instead of doing it in the server. In that case, if you provide the `encrypt.*` configuration to locate a key, you can still have `/encrypt` and `/decrypt` endpoints, but you need to explicitly switch off the decryption of outgoing properties by placing `spring.cloud.config.server.encrypt.enabled=false` in `bootstrap.[yml|properties]`. diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/serving-plain-text.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/serving-plain-text.adoc index a6e1d372..49c4c619 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/serving-plain-text.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/serving-plain-text.adoc @@ -1,5 +1,6 @@ [[serving-plain-text]] = Serving Plain Text +:page-section-summary-toc: 1 Instead of using the `Environment` abstraction (or one of the alternative representations of it in YAML or properties format), your applications might need generic plain-text configuration files that are tailored to their environment. The Config Server provides these through an additional endpoint at `/{application}/{profile}/{label}/{path}`, where `application`, `profile`, and `label` have the same meaning as the regular environment endpoint, but `path` is a path to a file name (such as `log.xml`). diff --git a/docs/modules/ROOT/pages/spring-cloud-config/server/using-multiple-keys-and-key-rotation.adoc b/docs/modules/ROOT/pages/spring-cloud-config/server/using-multiple-keys-and-key-rotation.adoc index 3b79ae4b..d69835fd 100644 --- a/docs/modules/ROOT/pages/spring-cloud-config/server/using-multiple-keys-and-key-rotation.adoc +++ b/docs/modules/ROOT/pages/spring-cloud-config/server/using-multiple-keys-and-key-rotation.adoc @@ -1,5 +1,6 @@ [[using-multiple-keys-and-key-rotation]] = Using Multiple Keys and Key Rotation +:page-section-summary-toc: 1 In addition to the `{cipher}` prefix in encrypted property values, the Config Server looks for zero or more `{name:value}` prefixes before the start of the (Base64 encoded) cipher text. The keys are passed to a `TextEncryptorLocator`, which can do whatever logic it needs to locate a `TextEncryptor` for the cipher.