通过将 git.skipSslValidation 属性设置为 true（默认为 false），可以禁用配置服务器对 Git 服务器的 SSL 证书的验证。

spring:
  cloud:
    config:
      server:
        git:
          uri: https://example.com/my/repo
          skipSslValidation: true

你可以配置配置服务器等待获取 HTTP 连接的时间，以秒为单位。使用 git.timeout 属性。

spring:
  cloud:
    config:
      server:
        git:
          uri: https://example.com/my/repo
          timeout: 4

Spring Cloud Config 服务器支持带有 {application} 和 {profile}（以及 {label} 占位符的 git 存储库 URL，如果你需要的话，请记住，标签是作为 git 标签应用的）。因此，你可以通过使用与以下类似的结构来支持“每个应用程序一个存储库”策略：

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

你还可以使用类似的模式支持“每个配置组一个存储库”策略，但是使用 {profile}。

此外，使用 {application} 参数中的特殊字符串 "(_)" 可以支持多个组织，如下面的示例所示：

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

{application} 在请求时以以下格式提供：organization(_)application。

Spring Cloud Config 还包括对应用程序和配置组名称进行模式匹配的更复杂需求的支持。模式格式是带有通配符的 {application}/{profile} 名称的逗号分隔列表（注意，可能需要引用以通配符开头的模式），如下面的示例所示：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          repos:
            simple: https://github.com/simple/config-repo
            special:
              pattern: special*/dev*,*special*/dev*
              uri: https://github.com/special/config-repo
            local:
              pattern: local*
              uri: file:/home/configsvc/config-repo

如果 {application}/{profile} 不匹配任何模式，则使用在 spring.cloud.config.server.git.uri。在上面的示例中，对于 “simple” 存储库，模式是 simple/*（它只匹配一个在所有配置组中名为 simple 的应用）。“local” 存储库匹配所有配置组中以 local 开头的所有应用名称（将 /* 后缀自动添加到没有配置组匹配器的任何模式中）。

	Note
	只有在要设置的唯一属性是 URI 时，才能使用 “simple” 示例中使用的 “one-liner” 快捷方式。如果需要设置其他内容（凭据、模式等），则需要使用完整的表单。

repo 中的 pattern 属性实际上是一个数组，因此可以使用 YAML 数组（或属性文件中的 [0]、[1] 等后缀）绑定到多个模式。如果要运行具有多个配置文件的应用程序，可能需要这样做，如下面的示例所示：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          repos:
            development:
              pattern:
                - '*/development'
                - '*/staging'
              uri: https://github.com/development/config-repo
            staging:
              pattern:
                - '*/qa'
                - '*/production'
              uri: https://github.com/staging/config-repo

	Note
	Spring Cloud 猜测一种模式包含的一个配置组不会以 * 结尾，这意味着你实际上是想匹配一组以该模式开头的配置组（因此 */staging 是 ["*/staging", "*/staging,*"] 等的快捷方式）。这种情况很常见，例如，你需要在 “development” 配置组中本地运行应用程序，但也需要在 “cloud” 配置组中远程运行应用程序。

每个存储库还可以选择性地将配置文件存储在子目录中，并且搜索这些目录的模式可以指定为 searchPaths。下面的示例展示了顶层的配置文件：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          searchPaths: foo,bar*

在前面的示例中，服务器在顶层和 foo/ 子目录以及名称以 bar 开头的任何子目录中搜索配置文件。

默认情况下，服务器在第一次请求配置时克隆远程存储库。服务器可以配置为在启动时克隆存储库，如下面的顶层示例所示：

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

在前面的示例中，服务器在启动时克隆 team-a 的 config-repo，然后接受任何请求。在请求来自存储库的配置之前，不会克隆所有其他存储库。

	Note
	在 Config Server 启动时设置要克隆的存储库可以帮助在 Config Server 启动时快速识别配置错误的配置源（例如无效的存储库 URI）。在配置源未启用 cloneOnStart 的情况下，Config Server 可能以配置错误或无效的配置源成功启动，并且直到应用程序请求来自该配置源的配置时才检测到错误。

要在远程存储库上使用 HTTP 基本身份验证，请分别添加 username 和 password 属性（不在 URL 中），如下面的示例所示：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          username: trolley
          password: strongpassword

如果不使用 HTTPS 和用户凭证，则在默认目录（~/.ssh）中存储密钥，并且 URI 指向 SSH 位置（如 git@github.com:configuration/cloud-configuration。Git 服务器的条目必须出现在 ~/.ssh/known_hosts 文件中，并且是 ssh-rsa 格式的。不支持其他格式（例如 ecdsa-sha2-nistp256）。为了避免意外，你应该确保 Git 服务器的 known_hosts 文件中只存在一个条目，并且它与你提供给配置服务器的 URL 相匹配。如果在 URL 中使用主机名，则需要在 known_hosts 文件中完全使用主机名（而不是 IP）。通过使用 JGit 访问存储库，因此你找到的任何文档都应该适用。HTTPS 代理设置可以在 ~/.git/config 中设置，或者（以与任何其他 JVM 进程相同的方式）使用系统属性（-Dhttps.proxyHost 和 -Dhttps.proxyPort）设置。

	Tip
	如果不知道 ~/.git 目录在哪里，可以使用 git config --global 来操作设置（例如，git config --global http.sslVerify false）。

Spring Cloud Config 服务还支持 AWS CodeCommit 认证。当从命令行使用 Git 时，AWS CodeCommit 使用认证助手。此助手不与 JGit 库一起使用，因此如果 Git URI 与 AWS CodeCommit 模式匹配，则创建用于 AWS CodeCommit 的 JGit CredentialProvider。AWS CodeCommit URI 遵循以下模式：//git-codecommit.${AWS_REGION}.amazonaws.com/${repopath}。

如果使用 AWS CodeCommit URI 提供用户名和密码，则它们必须是提供对存储库访问的 AWS accessKeyId 和 secretAccessKey。如果没有指定用户名和密码，则使用 AWS 默认凭证提供程序链检索 accessKeyId 和 secretAccessKey。

如果 Git URI 与 CodeCommit URI 模式匹配（如前所示），则必须在用户名和密码中或在默认凭证提供程序链支持的位置之一中提供有效的 AWS 凭证。AWS EC2 实例可以为 EC2 实例使用 IAM 角色。

	Note
	aws-java-sdk-core jar 是一个可选的依赖项。如果 aws-java-sdk-core jar 不在类路径上，则不创建 AWS 代码提交凭据提供程序，而不管 GIT 服务器 URI。

默认情况下，Spring Cloud Config 服务使用的 JGit 库在使用 SSH URI 连接到 Git 存储库时使用 SSH 配置文件，如 ~/.ssh/known_hosts 和 /etc/ssh/ssh_config。在云环境（如 Cloud Foundry）中，本地文件系统可能是短暂的或者不容易访问的。对于这些情况，可以使用 Java 属性设置 SSH 配置。为了激活基于属性的 SSH 配置，必须将 spring.cloud.config.server.git.ignoreLocalSshSettings 属性设置为 true，如下面的示例所示：

  spring:
    cloud:
      config:
        server:
          git:
            uri: git@gitserver.com:team/repo1.git
            ignoreLocalSshSettings: true
            hostKey: someHostKey
            hostKeyAlgorithm: ssh-rsa
            privateKey: |
                         -----BEGIN RSA PRIVATE KEY-----
                         MIIEpgIBAAKCAQEAx4UbaDzY5xjW6hc9jwN0mX33XpTDVW9WqHp5AKaRbtAC3DqX
                         IXFMPgw3K45jxRb93f8tv9vL3rD9CUG1Gv4FM+o7ds7FRES5RTjv2RT/JVNJCoqF
                         ol8+ngLqRZCyBtQN7zYByWMRirPGoDUqdPYrj2yq+ObBBNhg5N+hOwKjjpzdj2Ud
                         1l7R+wxIqmJo1IYyy16xS8WsjyQuyC0lL456qkd5BDZ0Ag8j2X9H9D5220Ln7s9i
                         oezTipXipS7p7Jekf3Ywx6abJwOmB0rX79dV4qiNcGgzATnG1PkXxqt76VhcGa0W
                         DDVHEEYGbSQ6hIGSh0I7BQun0aLRZojfE3gqHQIDAQABAoIBAQCZmGrk8BK6tXCd
                         fY6yTiKxFzwb38IQP0ojIUWNrq0+9Xt+NsypviLHkXfXXCKKU4zUHeIGVRq5MN9b
                         BO56/RrcQHHOoJdUWuOV2qMqJvPUtC0CpGkD+valhfD75MxoXU7s3FK7yjxy3rsG
                         EmfA6tHV8/4a5umo5TqSd2YTm5B19AhRqiuUVI1wTB41DjULUGiMYrnYrhzQlVvj
                         5MjnKTlYu3V8PoYDfv1GmxPPh6vlpafXEeEYN8VB97e5x3DGHjZ5UrurAmTLTdO8
                         +AahyoKsIY612TkkQthJlt7FJAwnCGMgY6podzzvzICLFmmTXYiZ/28I4BX/mOSe
                         pZVnfRixAoGBAO6Uiwt40/PKs53mCEWngslSCsh9oGAaLTf/XdvMns5VmuyyAyKG
                         ti8Ol5wqBMi4GIUzjbgUvSUt+IowIrG3f5tN85wpjQ1UGVcpTnl5Qo9xaS1PFScQ
                         xrtWZ9eNj2TsIAMp/svJsyGG3OibxfnuAIpSXNQiJPwRlW3irzpGgVx/AoGBANYW
                         dnhshUcEHMJi3aXwR12OTDnaLoanVGLwLnkqLSYUZA7ZegpKq90UAuBdcEfgdpyi
                         PhKpeaeIiAaNnFo8m9aoTKr+7I6/uMTlwrVnfrsVTZv3orxjwQV20YIBCVRKD1uX
                         VhE0ozPZxwwKSPAFocpyWpGHGreGF1AIYBE9UBtjAoGBAI8bfPgJpyFyMiGBjO6z
                         FwlJc/xlFqDusrcHL7abW5qq0L4v3R+FrJw3ZYufzLTVcKfdj6GelwJJO+8wBm+R
                         gTKYJItEhT48duLIfTDyIpHGVm9+I1MGhh5zKuCqIhxIYr9jHloBB7kRm0rPvYY4
                         VAykcNgyDvtAVODP+4m6JvhjAoGBALbtTqErKN47V0+JJpapLnF0KxGrqeGIjIRV
                         cYA6V4WYGr7NeIfesecfOC356PyhgPfpcVyEztwlvwTKb3RzIT1TZN8fH4YBr6Ee
                         KTbTjefRFhVUjQqnucAvfGi29f+9oE3Ei9f7wA+H35ocF6JvTYUsHNMIO/3gZ38N
                         CPjyCMa9AoGBAMhsITNe3QcbsXAbdUR00dDsIFVROzyFJ2m40i4KCRM35bC/BIBs
                         q0TY3we+ERB40U8Z2BvU61QuwaunJ2+uGadHo58VSVdggqAo0BSkH58innKKt96J
                         69pcVH/4rmLbXdcmNYGm6iu+MlPQk4BUZknHSmVHIFdJ0EPupVaQ8RHT
                         -----END RSA PRIVATE KEY-----

下表描述了 SSH 配置属性。

Spring Cloud Config 服务还支持 {application} 和 {profile}（以及 {label} 的搜索路径，如果需要的话)，如下面的示例所示：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          searchPaths: '{application}'

前面的清单在存储库中搜索与目录（以及顶层）同名的文件。通配符在具有占位符的搜索路径中也是有效的（搜索中包括任何匹配的目录）。

如前所述，在本地副本变脏（例如，OS 进程更改文件夹内容）的情况下，Spring Cloud Config 服务对远程 git 存储库进行克隆，使得 Spring Cloud Config 服务无法从远程存储库更新本地副本。

为了解决此问题，有一个 force-pull 属性，如果本地副本是脏的，则使 Spring Cloud Config 服务从远程存储库强制拉取，如下面的示例所示：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          force-pull: true

如果具有多个存储库配置，则可以配置每个存储库的 force-pull 属性，如下面的示例所示：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://git/common/config-repo.git
          force-pull: true
          repos:
            team-a:
                pattern: team-a-*
                uri: http://git/team-a/config-repo.git
                force-pull: true
            team-b:
                pattern: team-b-*
                uri: http://git/team-b/config-repo.git
                force-pull: true
            team-c:
                pattern: team-c-*
                uri: http://git/team-a/config-repo.git

	Note
	force-pull 属性的默认值是 false。

由于 Spring Cloud Config 服务在将分支签出到本地 repo（例如通过标签获取属性）之后具有远程 git 存储库的克隆，因此它将永远保留这个分支或者直到下一次服务器重新启动（创建新的本地 repo）。因此，可能存在远程分支被删除但本地副本仍然可用于获取的情况。如果 Spring Cloud Config 服务客户端服务以 --spring.cloud.config.label=deletedRemoteBranch,master 开始，则主服务器将从 deletedRemoteBranch 本地分支而不是从 master 获取属性。

为了保持本地存储库分支的整洁以及从远程更新 - 可以设置 deleteUntrackedBranches 属性。它将使 Spring Cloud Config 服务强制从本地存储库中删除未跟踪的分支。例如：

spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/spring-cloud-samples/config-repo
          deleteUntrackedBranches: true

	Note
	deleteUntrackedBranches 属性的默认值是 false。

可以使用 spring.cloud.config.server.git.refreshRate 控制配置服务器从 Git 后台获取更新的配置数据的频率。此属性的值以秒为单位指定。默认情况下，值为 0，这意味着配置服务器将在每次请求 Git repo 时从 Git repo 获取更新的配置。

使用 Vault 时，可以为应用程序提供多个属性源。例如，假设你已经将数据写入了 Vault 中的以下路径：

secret/myApp,dev
secret/myApp
secret/application,dev
secret/application

写入到 secret/application 的属性可用于使用配置服务的所有应用程序。名称为 myApp 的应用程序将具有写入 secret/myApp 和 secret/application的任何属性。当 myApp 启用了 dev 配置组时，写入上述所有路径的属性都可用，列表中第一路径中的属性优先于其他路径。

使用基于文件的（git、svn 和本地）存储库，所有客户端应用程序之间共享具有 application*（application.properties、application.yml、application-*.properties 等）文件名中的资源。可以使用具有这些文件名的资源来配置全局缺省值，并根据需要让应用程序特定的文件覆盖它们。

#_property_overrides[property overrides] 特性还可以用于设置全局默认值，允许使用占位符以便应用程序在本地覆盖它们。

	Tip
	对于 “native” 配置组（本地文件系统后台），应该使用不属于服务器自身配置的显式搜索位置。否则，默认搜索位置中的 application* 资源将被删除，因为它们是服务器的一部分。

当使用 Vault 作为后台时，可以通过将配置置于 secret/application 中来与所有应用程序共享配置。例如，如果运行以下 Vault 命令，则使用配置服务器的所有应用程序都将具有可用于它们的属性 foo 和 baz：

$ vault write secret/application foo=bar baz=bam

可以使用 UAA 作为提供者使用 OAuth 2.0 进行身份验证。

pom.xml. 

<dependencies>
	<dependency>
		<groupId>org.springframework.security</groupId>
		<artifactId>spring-security-config</artifactId>
	</dependency>
	<dependency>
		<groupId>org.springframework.security</groupId>
		<artifactId>spring-security-oauth2-client</artifactId>
	</dependency>
</dependencies>

以下配置使用 OAuth 2.0 和 UAA 访问 CredHub：

spring:
  profiles:
    active: credhub
  cloud:
    config:
      server:
        credhub:
          url: https://credhub:8844
          oauth2:
            registration-id: credhub-client
  security:
    oauth2:
      client:
        registration:
          credhub-client:
            provider: uaa
            client-id: credhub_config_server
            client-secret: asecret
            authorization-grant-type: client_credentials
        provider:
          uaa:
            token-uri: https://uaa:8443/oauth/token

	Note
	使用的 UAA client-id 应该具有 credhub.read 作为范围。

除了使用 Spring Cloud 的环境存储库之一，你还可以提供你自己的 EnvironmentRepository bean 作为复合环境的一部分被包含。为此，你的 bean 必须实现 EnvironmentRepository 接口。如果希望在复合环境中控制自定义 EnvironmentRepository 的优先级，还应该实现 Ordered 接口并重写 getOrdered 方法。如果不实现 Ordered 接口，则 EnvironmentRepository 具有最低的优先级。