SpringCloud 学习（五）Zuul 和分布式配置

7. Netflix.Zuul

7.1 简介

• Zuul 包含路由和过滤两个功能

  • 路由负责将外部请求转发到具体的微服务实例，是实现外部访问入口统一的基础。
  • 过滤负责干预请求的处理过程，是实现请求校验，服务聚合等功能的基础。

• Zuul 与 Eureka 整合，Zuul 注册成为 Eureka 治理下的应用，从 Eureka 中获取其他微服务放入信息，进行微服务跳转。

• 代理 + 路由 + 过滤

• 官方文档：https://github.com/Netflix/zuul

7.1 搭建环境

(1) 新建 maven 模块

springcloud-zuul-9527

(2) 导入依赖

<dependencies>

    
    <dependency>
        <groupId>org.springframework.cloudgroupId>
        <artifactId>spring-cloud-starter-zuulartifactId>
        <version>1.4.6.RELEASEversion>
    dependency>

    
    
    
    
    
    
    

    
    
    
    
    
    

    
    
    
    
    
    
    

    
    
    <dependency>
        <groupId>org.springframework.cloudgroupId>
        <artifactId>spring-cloud-starter-eurekaartifactId>
        <version>1.4.6.RELEASEversion>
    dependency>

    
    <dependency>
        <groupId>org.examplegroupId>
        <artifactId>springcloud-apiartifactId>
        <version>1.0-SNAPSHOTversion>
    dependency>

    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-webartifactId>
    dependency>

    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-devtoolsartifactId>
    dependency>
dependencies>

(3) 编写应用配置

server:
  port: 9527
spring:
  application:
    name: springcloud-zuul

eureka:
  client:
    service-url:
      defaultZone: http://localhost:7001/eureka/,http://localhost:7002/eureka/,http://localhost:7003/eureka/
  instance:
    instance-id: zuul9527.com
    # 显示 ip
    prefer-ip-address: true
info:
  app.name: why-springcloud
  company.name: blog.why.com

(4) 编写启动类

@SpringBootApplication
// 开启 Zuul 服务代理
@EnableZuulProxy
public class ZuulApplication_9527 {
    public static void main(String[] args) {
        SpringApplication.run(ZuulApplication_9527.class, args);
    }
}

(5) 测试路由

启动 springcloud-eureka-7001

启动 springcloud-provider-dept-hystrix-8001

启动 springcloud-zuul-9527

确保服务注册成功

通过服务 springcloud-zuul-9527 调用服务 springcloud-provider-dept-hystrix-8001 的方法

(6) 隐藏真实路由

● 添加应用配置

# zuul
zuul:
  # 路由
  routes:
    # 应用名
    mydept.serviceId: springcloud-provider-dept
    # 自定义路径
    mydept.path: /mydept/**
  # 禁止通过此路径访问，若不禁止依然可用此路径
  ignored-services: springcloud-provider-dept
  # 设置公共前缀
  # prefix: /provider

● 测试隐藏路由

启动 springcloud-eureka-7001

启动 springcloud-provider-dept-hystrix-8001

启动 springcloud-zuul-9527

8. SpringCloud Config 分布式配置

8.1 简介

(1) 分布式系统的配置文件问题

• 微服务架构下的每一个子服务都需要必要的配置信息才能运行，当服务过多时，需要一套集中式的，动态的配置管理设施。
• SpringCloud Config 基于是 CS 架构，C-S-GIT

(2) 分布式配置中心

Spring Cloud Config 为微服务架构中的各个服务提供集中化的外部配置支持，配置服务器为各个不同的微服务应用的所有环节提供了一个中心化的外部配置。

• Spring Cloud Config 分为服务端和客户端两部分
  • 服务端也称为分布式配置中心，它是一个独立的微服务应用，用来连接配置服务器并为客户端提供获取配置信息，加密，解密信息等访问接口。
  • 客户端则是通过指定的配置中心来管理应用资源，以及与业务相关的配置内容，并在启动的时候从配置中心获取和加载配置信息。配置服务器默认采用 git 来存储配置信息，这样有助于对环境配置进行版本管理。并可以通过 git 客户端工具来方便的管理和访问配置内容。

(3) 分布式控制中心能干什么

• 集中管理配置文件
• 动态化配置更新，不需要在每个服务器部署的机器上编写配置文件，服务会向配置中心统一拉取自己的配置信息
• 分环境部署，如 /dev /test /prod /beta /release …
• 无需重启服务即可感知变动的配置进行应用
• 将配置信息以 REST 接口的形式暴露

8.2 远程仓库搭建

(1) 下载 Git

下载地址：https://git-scm.com/downloads

(2) 配置 Git 的用户名和邮箱

# 配置用户名
git config --global user.name "why"
# 配置邮箱
git config --global user.email "[email protected]
# 查看当前配置
git config --list

(3) 配置 SSH 公钥

# 生成秘钥
ssh-keygen -t rsa -C "[email protected]"   

(4) 新建 仓库

(5) 克隆码云仓库到本地

• 复制 SSH 地址

  

• 克隆仓库

  git clone [email protected]:wahoy/springcloud-config.git  
  

  

  

(6) 提交文件到码云

• 新建文件

  

  spring:
    profiles:
      active: dev
  
  ---
  
  spring:
    profiles: dev
    application:
      name: springcloud-config-dev
  
  ---
  
  spring:
    profiles: test
    application:
      name: springcloud-config-test
  

• 进入 springcloud-config 主目录

  cd springcloud-config/
  

  

• 将修改的文件提交到暂存区

  git add .
  

  

• 查看暂存区状态

  git status
  

  

• 提交文件

  git commit -m "first commit"
  

  

• 发布文件

  git push origin master
  

  

  

8.3 创建配置服务器

(1) 创建 maven 模块

(2) 导入依赖

<dependencies>

    
    <dependency>
        <groupId>org.springframework.cloudgroupId>
        <artifactId>spring-cloud-config-serverartifactId>
        <version>2.1.1.RELEASEversion>
    dependency>

    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-webartifactId>
    dependency>

dependencies>

(3) 编写应用配置

# application.yml
server:
  port: 3344

spring:
  application:
    name: springcloud-config-server

  # 连接远程仓库
  cloud:
    config:
      server:
        git:
          # git 仓库的 https 下载地址
          uri: https://gitee.com/wahoy/springcloud-config.git

(4) 编写启动类

@SpringBootApplication
// 标识此应用为配置服务器
@EnableConfigServer
public class ConfigServer_3344 {
    public static void main(String[] args) {
        SpringApplication.run(ConfigServer_3344.class, args);
    }
}

(5) 读取远程仓库文件

启动服务 springcloud-config-server-3344

8.4 创建配置客户端

(1) 在远程仓库添加配置文件

spring:
  profiles:
    active: dev

---

server:
  port: 8201

# spring
spring:
  profiles: dev
  application:
    name: springcloud-provider-dept-dev

# eureka
eureka:
  client:
    service-url:
      defaultZone: http://eureka7001.com:7001/eureka/

---

server:
  port: 8202

# spring
spring:
  profiles: test
  application:
    name: springcloud-provider-dept-test

# eureka
eureka:
  client:
    service-url:
      defaultZone: http://eureka7001.com:7001/eureka/

(2) 创建 maven 模块

springcloud-config-client-3355

(3) 导入依赖

<dependencies>

    
    
    <dependency>
        <groupId>org.springframework.cloudgroupId>
        <artifactId>spring-cloud-starter-configartifactId>
        <version>2.1.1.RELEASEversion>
    dependency>

    
    <dependency>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-webartifactId>
    dependency>

dependencies>

(4) 编写配置文件

# application.yml
# 用户级别配置
spring:
  application:
    name: springcloud-config-client-820_

# bootstrap.yml
# 系统级配置
spring:
  cloud:
    config:
      # 需要远程读取的资源名称，无需后缀
      name: config-client
      profile: test
      label: master
      uri: http://localhost:3344

(5) 编写控制器

@RestController
public class ConfigClientController {

    @Value("${spring.application.name}")
    private String applicationName;

    @Value("${eureka.client.service-url.defaultZone}")
    private String eurekaServer;

    @Value("${server.port}")
    private String port;

    @RequestMapping("/getConfig")
    public String getConfig() {
        return "application: " + applicationName + "
" +
                "eurekaServer: " + eurekaServer + "
" +
                "port: " + port;
    }

}

(6) 编写启动类

@SpringBootApplication
public class ConfigClient_820_ {
    public static void main(String[] args) {
        SpringApplication.run(ConfigClient_820_.class, args);
    }
}

(7) 测试

• 启动 springcloud-config-server-3344

  http://localhost:8001:3344/master/config-client-dev.yml

  

• 启动 springcloud-config-client-820_

  http://localhost:8202/getConfig

  

8.5 远程配置实战测试

(1) 添加远程配置文件

# config-dept.yml
spring:
  profiles:
    active: dev

---

server:
  port: 8001
# mybatis
mybatis:
  type-aliases-package: com.why.springcloud.pojo
  config-location: classpath:mybatis/mybatis-config.xml
  mapper-locations: classpath:mybatis/mapper/*.xml

# spring
spring:
  profiles: dev
  application:
    name: springcloud-config-dept
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: org.gjt.mm.mysql.Driver
    url: jdbc:mysql://localhost:3306/cloud01?useUnicode=true&characterEncoding=utf-8
    username: root
    password: 981030

# eureka
eureka:
  client:
    service-url:
      # 注册中心的地址
      # 将此服务注册到下面的注册中心中
      defaultZone: http://localhost:7001/eureka/
  instance:
    # 修改服务实例描述
    instance-id: springcloud-config-dept8001

# info
info:
  app.name: why-springcloud
  company.name: blog.why.com

---

server:
  port: 8001
# mybatis
mybatis:
  type-aliases-package: com.why.springcloud.pojo
  config-location: classpath:mybatis/mybatis-config.xml
  mapper-locations: classpath:mybatis/mapper/*.xml

# spring
spring:
  profiles: test
  application:
    name: springcloud-config-dept
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: org.gjt.mm.mysql.Driver
    url: jdbc:mysql://localhost:3306/cloud02?useUnicode=true&characterEncoding=utf-8
    username: root
    password: 981030

# eureka
eureka:
  client:
    service-url:
      # 注册中心的地址
      # 将此服务注册到下面的注册中心中
      defaultZone: http://localhost:7001/eureka/
  instance:
    # 修改服务实例描述
    instance-id: springcloud-config-dept8001

# info
info:
  app.name: why-springcloud
  company.name: blog.why.com

# config-eureka.yml
spring:
  profiles:
    active: dev

---

server:
  port: 7001

# spring
spring:
  profiles: dev
  application:
    name: springcloud-config-eureka

# eureka 
eureka: 
  instance:
    hostname: eureka7001.com
  client:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://eureka7002.com:7002/eureka/,http://eureka7003.com:7003/eureka/

---

server:
  port: 7001

# spring
spring:
  profiles: test
  application:
    name: springcloud-config-eureka

# eureka 
eureka: 
  instance:
    hostname: eureka7001.com
  client:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://eureka7002.com:7002/eureka/,http://eureka7003.com:7003/eureka/
  

(2) 新建 maven 模块

• 新建 springcloud-config-eureka-7001模块

• 拷贝 springcloud-eureka-7001 模块的依赖，java 目录和 resources 目录

• 添加依赖

  
  
  <dependency>
      <groupId>org.springframework.cloudgroupId>
      <artifactId>spring-cloud-starter-configartifactId>
      <version>2.1.1.RELEASEversion>
  dependency>
  

• 修改 application.yml 的配置

  spring:
    application:
      name: springcloud-config-eureka-7001
  

• 新建 bootstrap.yml 配置文件

  spring:
    cloud:
      config:
        # 远程文件
        name: config-eureka
        # 远程目录
        label: master
        # 远程环境
        profile: dev
        # 服务端 url
        uri: http://localhost:3344
  

(3) 测试

• 启动 springcloud-config-server-3344

• 启动 springcloud-config-eureka-7001

• 尝试读取远程配置文件

  http://localhost:3344/master/config-eureka-dev.yml

  

• 访问 erureka7001:7001

  

• 远程配置成功

(4) 新建 maven 模块

添加服务 springcloud-config-dept-8001

• 拷贝服务 springcloud-provider-dept-8001 到本服务

• 添加依赖

  <!--config-->
  <!-- https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-starter-config -->
  >
      >org.springframework.cloud>
      >spring-cloud-starter-config>
      >2.1.1.RELEASE>
  >
  

• 修改 application 配置

  # spring
  spring:
    application:
      name: springcloud-config-dept-8001
  

• 新建 bootstrap.yml 文件

  # 获取远程配置
  spring:
    cloud:
      config:
        # 远程文件
        name: config-dept
        # 远程目录
        label: master
        # 远程环境
        profile: dev
        # 服务端 url
        uri: http://localhost:3344
  

(5) 测试

• 启动 springcloud-config-server-3344

• 启动 springcloud-config-eureka-7001

• 启动 springcloud-config-dept-8001

• 尝试读取 config-eureka.yml 文件

  

  

• 尝试读取 config-dept.yml 文件