From 079042dd412d6503959079e0bb87c05bf367647d Mon Sep 17 00:00:00 2001 From: buildmaster Date: Mon, 6 Nov 2017 20:01:37 +0000 Subject: [PATCH] Sync docs from master to gh-pages --- multi/multi__spring_cloud_config_server.html | 19 ++++++++++++++----- single/spring-cloud-config.html | 19 ++++++++++++++----- spring-cloud-config.xml | 18 +++++++++++++++--- 3 files changed, 43 insertions(+), 13 deletions(-) diff --git a/multi/multi__spring_cloud_config_server.html b/multi/multi__spring_cloud_config_server.html index 3071dc69..d264133b 100644 --- a/multi/multi__spring_cloud_config_server.html +++ b/multi/multi__spring_cloud_config_server.html @@ -82,9 +82,10 @@ git branch or tag name contains a slash ("/") then the label in the HTTP URL should be specified with the special string "(_)" instead (to avoid ambiguity with other URL paths). For example, if the label is foo/bar, replacing the slash would result in a label that looks like -foo(_)bar. Be careful with the brackets in -the URL if you are using a command line client like curl (e.g. escape -them from the shell with quotes '').

Placeholders in Git URI

Spring Cloud Config Server supports a git repository URL with +foo(_)bar. The inclusion of the special string "(\_)" can also be +applied to the {application} parameter. Be careful with the brackets +in the URL if you are using a command line client like curl (e.g. +escape them from the shell with quotes '').

Placeholders in Git URI

Spring Cloud Config Server supports a git repository URL with placeholders for the {application} and {profile} (and {label} if you need it, but remember that the label is applied as a git label anyway). So you can easily support a "one repo per application" policy @@ -94,7 +95,15 @@ using (for example):

      server:
         git:
           uri: https://github.com/myorg/{application}

or a "one repo per profile" policy using a similar pattern but with -{profile}.

Pattern Matching and Multiple Repositories

There is also support for more complex requirements with pattern +{profile}.

Additionally, using the special string "(\_)" within your +{application} parameters can enable support for multiple +organizations (for example):

spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/{application}

where {application} is provided at request time in the format +"organization(\_)application".

Pattern Matching and Multiple Repositories

There is also support for more complex requirements with pattern matching on the application and profile name. The pattern format is a comma-separated list of {application}/{profile} names with wildcards (where a pattern beginning with a wildcard may need to be @@ -251,7 +260,7 @@ Example:

69pcVH/4rmLbXdcmNYGm6iu+MlPQk4BUZknHSmVHIFdJ0EPupVaQ8RHT
-                         -----END RSA PRIVATE KEY-----

Table 2.1. SSH Configuration properties

Property NameRemarks

ignoreLocalSshSettings

If true, use property based SSH config instead of file based. Must be set at as spring.cloud.config.server.git.ignoreLocalSshSettings, not inside a repository definition.

privateKey

Valid SSH private key. Must be set if ignoreLocalSshSettings is true and Git URI is SSH format

hostKey

Valid SSH host key. Must be set if hostKeyAlgorithm is also set

hostKeyAlgorithm

One of ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 ,ecdsa-sha2-nistp521. Must be set if hostKey is also set

strictHostKeyChecking

true or false. If false, ignore errors with host key

knownHostsFile

Location of custom .known_hosts file

preferredAuthentications

Override server authentication method order. This should allow evade login prompts if server has keyboard-interactive authentication before publickey method.


Placeholders in Git Search Paths

Spring Cloud Config Server also supports a search path with + -----END RSA PRIVATE KEY-----

Table 2.1. SSH Configuration properties

Property NameRemarks

ignoreLocalSshSettings

If true, use property based SSH config instead of file based. Must be set at as spring.cloud.config.server.git.ignoreLocalSshSettings, not inside a repository definition.

privateKey

Valid SSH private key. Must be set if ignoreLocalSshSettings is true and Git URI is SSH format

hostKey

Valid SSH host key. Must be set if hostKeyAlgorithm is also set

hostKeyAlgorithm

One of ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 ,ecdsa-sha2-nistp521. Must be set if hostKey is also set

strictHostKeyChecking

true or false. If false, ignore errors with host key

knownHostsFile

Location of custom .known_hosts file

preferredAuthentications

Override server authentication method order. This should allow evade login prompts if server has keyboard-interactive authentication before publickey method.


Placeholders in Git Search Paths

Spring Cloud Config Server also supports a search path with placeholders for the {application} and {profile} (and {label} if you need it). Example:

spring:
   cloud:
diff --git a/single/spring-cloud-config.html b/single/spring-cloud-config.html
index 4e27f485..58ac76bb 100644
--- a/single/spring-cloud-config.html
+++ b/single/spring-cloud-config.html
@@ -184,9 +184,10 @@ git branch or tag name contains a slash ("/") then the label in the
 HTTP URL should be specified with the special string "(_)" instead (to
 avoid ambiguity with other URL paths).  For example, if the label is
 foo/bar, replacing the slash would result in a label that looks like
-foo(_)bar.  Be careful with the brackets in
-the URL if you are using a command line client like curl (e.g. escape
-them from the shell with quotes '').
Placeholders in Git URI
Spring Cloud Config Server supports a git repository URL with
+foo(_)bar.  The inclusion of the special string "(\_)" can also be
+applied to the {application} parameter. Be careful with the brackets
+in the URL if you are using a command line client like curl (e.g.
+escape them from the shell with quotes '').
Placeholders in Git URI
Spring Cloud Config Server supports a git repository URL with
 placeholders for the {application} and {profile} (and {label} if
 you need it, but remember that the label is applied as a git label
 anyway). So you can easily support a "one repo per application" policy
@@ -196,7 +197,15 @@ using (for example):
      server:
         git:
           uri: https://github.com/myorg/{application}
or a "one repo per profile" policy using a similar pattern but with
-{profile}.
Pattern Matching and Multiple Repositories
There is also support for more complex requirements with pattern
+{profile}.
Additionally, using the special string "(\_)" within your
+{application} parameters can enable support for multiple
+organizations (for example):
spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/{application}
where {application} is provided at request time in the format
+"organization(\_)application".
Pattern Matching and Multiple Repositories
There is also support for more complex requirements with pattern
 matching on the application and profile name. The pattern format is a
 comma-separated list of {application}/{profile} names with wildcards
 (where a pattern beginning with a wildcard may need to be
@@ -353,7 +362,7 @@ Example:
69pcVH/4rmLbXdcmNYGm6iu+MlPQk4BUZknHSmVHIFdJ0EPupVaQ8RHT
-                         -----END RSA PRIVATE KEY-----
Table 2.1. SSH Configuration properties
Property NameRemarks
ignoreLocalSshSettings
If true, use property based SSH config instead of file based. Must be set at as spring.cloud.config.server.git.ignoreLocalSshSettings, not inside a repository definition.
privateKey
Valid SSH private key. Must be set if ignoreLocalSshSettings is true and Git URI is SSH format
hostKey
Valid SSH host key. Must be set if hostKeyAlgorithm is also set
hostKeyAlgorithm
One of ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 ,ecdsa-sha2-nistp521. Must be set if hostKey is also set
strictHostKeyChecking
true or false. If false, ignore errors with host key
knownHostsFile
Location of custom .known_hosts file
preferredAuthentications
Override server authentication method order. This should allow evade login prompts if server has keyboard-interactive authentication before publickey method.

Placeholders in Git Search Paths
Spring Cloud Config Server also supports a search path with
+                         -----END RSA PRIVATE KEY-----

Table 2.1. SSH Configuration properties

Property NameRemarks

ignoreLocalSshSettings

If true, use property based SSH config instead of file based. Must be set at as spring.cloud.config.server.git.ignoreLocalSshSettings, not inside a repository definition.

privateKey

Valid SSH private key. Must be set if ignoreLocalSshSettings is true and Git URI is SSH format

hostKey

Valid SSH host key. Must be set if hostKeyAlgorithm is also set

hostKeyAlgorithm

One of ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 ,ecdsa-sha2-nistp521. Must be set if hostKey is also set

strictHostKeyChecking

true or false. If false, ignore errors with host key

knownHostsFile

Location of custom .known_hosts file

preferredAuthentications

Override server authentication method order. This should allow evade login prompts if server has keyboard-interactive authentication before publickey method.


Placeholders in Git Search Paths

Spring Cloud Config Server also supports a search path with placeholders for the {application} and {profile} (and {label} if you need it). Example:

spring:
   cloud:
diff --git a/spring-cloud-config.xml b/spring-cloud-config.xml
index 3cf6f670..efd35209 100644
--- a/spring-cloud-config.xml
+++ b/spring-cloud-config.xml
@@ -277,9 +277,10 @@ git branch or tag name contains a slash ("/") then the label in the
 HTTP URL should be specified with the special string "(_)" instead (to
 avoid ambiguity with other URL paths).  For example, if the label is
 foo/bar, replacing the slash would result in a label that looks like
-foo(_)bar.  Be careful with the brackets in
-the URL if you are using a command line client like curl (e.g. escape
-them from the shell with quotes '').
+foo(_)bar.  The inclusion of the special string "(\_)" can also be
+applied to the {application} parameter. Be careful with the brackets
+in the URL if you are using a command line client like curl (e.g.
+escape them from the shell with quotes '').
 

 Placeholders in Git URI
 Spring Cloud Config Server supports a git repository URL with
@@ -295,6 +296,17 @@ using (for example):
           uri: https://github.com/myorg/{application}
 or a "one repo per profile" policy using a similar pattern but with
 {profile}.
+Additionally, using the special string "(\_)" within your
+{application} parameters can enable support for multiple
+organizations (for example):
+spring:
+  cloud:
+    config:
+      server:
+        git:
+          uri: https://github.com/{application}
+where {application} is provided at request time in the format
+"organization(\_)application".
 

 

 Pattern Matching and Multiple Repositories